1 /* xbt_str.cpp - various helping functions to deal with strings */
3 /* Copyright (c) 2007-2020. The SimGrid Team. All rights reserved. */
5 /* This program is free software; you can redistribute it and/or modify it
6 * under the terms of the license (GNU LGPL) which comes with this package. */
8 #include "simgrid/Exception.hpp"
10 #include "xbt/str.h" /* headers of these functions */
11 #include "xbt/string.hpp"
14 /** @brief Just like @ref xbt_str_split_quoted (Splits a string into a dynar of strings), but without memory allocation
16 * The string passed as argument must be writable (not const)
17 * The elements of the dynar are just parts of the string passed as argument.
18 * So if you don't store that argument elsewhere, you should free it in addition to freeing the dynar. This can be done
19 * by simply freeing the first argument of the dynar:
20 * free(xbt_dynar_get_ptr(dynar,0));
22 * Actually this function puts a bunch of \0 in the memory area you passed as argument to separate the elements, and
23 * pushes the address of each chunk in the resulting dynar. Yes, that's uneven. Yes, that's gory. But that's efficient.
25 xbt_dynar_t xbt_str_split_quoted_in_place(char *s) {
26 xbt_dynar_t res = xbt_dynar_new(sizeof(char *), nullptr);
28 char* end; /* pointers around the parsed chunk */
29 bool in_simple_quote = false;
30 bool in_double_quote = false;
32 bool ctn = false; /* Got something in this block */
39 /* do not trim leading spaces: caller responsibility to clean his cruft */
46 /* Protected char; move it closer */
47 memmove(end, end + 1, strlen(end));
49 throw std::invalid_argument("String ends with \\");
50 end++; /* Pass the protected char */
54 if (not in_double_quote) {
55 in_simple_quote = not in_simple_quote;
56 memmove(end, end + 1, strlen(end));
58 /* simple quote protected by double ones */
64 if (not in_simple_quote) {
65 in_double_quote = not in_double_quote;
66 memmove(end, end + 1, strlen(end));
68 /* double quote protected by simple ones */
76 if (*end == '\0' && (in_simple_quote || in_double_quote)) {
77 throw std::invalid_argument(simgrid::xbt::string_printf("End of string found while searching for %c in %s",
78 (in_simple_quote ? '\'' : '"'), s));
80 if (in_simple_quote || in_double_quote) {
89 /* Found a separator. Push the string if contains something */
90 xbt_dynar_push(res, &beg);
98 /* trim within the string, manually to speed things up */
111 /** @brief Splits a string into a dynar of strings, taking quotes into account
113 * It basically does the same argument separation than the shell, where white spaces can be escaped and where arguments
114 * are never split within a quote group.
115 * Several subsequent spaces are ignored (unless within quotes, of course).
116 * You may want to trim the input string, if you want to avoid empty entries
118 xbt_dynar_t xbt_str_split_quoted(const char *s)
120 xbt_dynar_t res = xbt_dynar_new(sizeof(char *), &xbt_free_ref);
122 char *str_to_free; /* we have to copy the string before, to handle backslashes */
128 str_to_free = xbt_strdup(s);
130 parsed = xbt_str_split_quoted_in_place(str_to_free);
131 xbt_dynar_foreach(parsed,cursor,p) {
132 char *q=xbt_strdup(p);
133 xbt_dynar_push(res,&q);
135 xbt_free(str_to_free);
136 xbt_dynar_shrink(res, 0);
137 xbt_dynar_free(&parsed);
141 /** @brief Parse an integer out of a string, or raise an error
143 * The @a str is passed as argument to your @a error_msg, as follows:
144 * @verbatim throw std::invalid_argument(simgrid::xbt::string_printf(error_msg, str)); @endverbatim
146 long int xbt_str_parse_int(const char* str, const char* error_msg)
149 if (str == nullptr || str[0] == '\0')
150 throw std::invalid_argument(simgrid::xbt::string_printf(error_msg, str));
152 long int res = strtol(str, &endptr, 10);
153 if (endptr[0] != '\0')
154 throw std::invalid_argument(simgrid::xbt::string_printf(error_msg, str));
159 /** @brief Parse a double out of a string, or raise an error
161 * The @a str is passed as argument to your @a error_msg, as follows:
162 * @verbatim throw std::invalid_argument(simgrid::xbt::string_printf(error_msg, str)); @endverbatim
164 double xbt_str_parse_double(const char* str, const char* error_msg)
167 if (str == nullptr || str[0] == '\0')
168 throw std::invalid_argument(simgrid::xbt::string_printf(error_msg, str));
170 double res = strtod(str, &endptr);
171 if (endptr[0] != '\0')
172 throw std::invalid_argument(simgrid::xbt::string_printf(error_msg, str));