2 Unix SMB/CIFS implementation.
3 Samba utility functions
5 Copyright (C) Andrew Tridgell 1992-2001
6 Copyright (C) Simo Sorce 2001-2002
7 Copyright (C) Martin Pool 2003
8 Copyright (C) James Peach 2005
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
25 #include "system/locale.h"
31 * @brief String utilities.
35 * Parse a string containing a boolean value.
37 * val will be set to the read value.
39 * @retval true if a boolean value was parsed, false otherwise.
41 _PUBLIC_ bool conv_str_bool(const char * str, bool * val)
46 if (str == NULL || *str == '\0') {
50 lval = strtol(str, &end, 10 /* base */);
51 if (end == NULL || *end != '\0' || end == str) {
52 return set_boolean(str, val);
55 *val = (lval) ? true : false;
60 * Convert a size specification like 16K into an integral number of bytes.
62 _PUBLIC_ bool conv_str_size_error(const char * str, uint64_t * val)
65 unsigned long long lval;
67 if (str == NULL || *str == '\0') {
71 lval = strtoull(str, &end, 10 /* base */);
72 if (end == NULL || end == str) {
77 if (strwicmp(end, "K") == 0) {
79 } else if (strwicmp(end, "M") == 0) {
80 lval *= (1024ULL * 1024ULL);
81 } else if (strwicmp(end, "G") == 0) {
82 lval *= (1024ULL * 1024ULL * 1024ULL);
83 } else if (strwicmp(end, "T") == 0) {
84 lval *= (1024ULL * 1024ULL * 1024ULL * 1024ULL);
85 } else if (strwicmp(end, "P") == 0) {
86 lval *= (1024ULL * 1024ULL * 1024ULL * 1024ULL * 1024ULL);
92 *val = (uint64_t)lval;
97 * Parse a uint64_t value from a string
99 * val will be set to the value read.
101 * @retval true if parsing was successful, false otherwise
103 _PUBLIC_ bool conv_str_u64(const char * str, uint64_t * val)
106 unsigned long long lval;
108 if (str == NULL || *str == '\0') {
112 lval = strtoull(str, &end, 10 /* base */);
113 if (end == NULL || *end != '\0' || end == str) {
117 *val = (uint64_t)lval;
124 * @note The comparison is case-insensitive.
126 _PUBLIC_ bool strequal(const char *s1, const char *s2)
133 return strcasecmp_m(s1,s2) == 0;
138 * @brief String utilities.
141 static bool next_token_internal_talloc(TALLOC_CTX *ctx,
160 /* default to simple separators */
165 /* find the first non sep char, if left-trimming is requested */
167 while (*s && strchr_m(sep,*s)) {
177 /* When restarting we need to go from here. */
180 /* Work out the length needed. */
181 for (quoted = false; *s &&
182 (quoted || !strchr_m(sep,*s)); s++) {
190 /* We started with len = 1 so we have space for the nul. */
191 *pp_buff = talloc_array(ctx, char, len);
196 /* copy over the token */
199 for (quoted = false; *s &&
200 (quoted || !strchr_m(sep,*s)); s++) {
208 *ptr = (*s) ? s+1 : s;
214 bool next_token_talloc(TALLOC_CTX *ctx,
219 return next_token_internal_talloc(ctx, ptr, pp_buff, sep, true);
223 * Get the next token from a string, return false if none found. Handles
224 * double-quotes. This version does not trim leading separator characters
225 * before looking for a token.
228 bool next_token_no_ltrim_talloc(TALLOC_CTX *ctx,
233 return next_token_internal_talloc(ctx, ptr, pp_buff, sep, false);
237 * Get the next token from a string, return False if none found.
238 * Handles double-quotes.
240 * Based on a routine by GJC@VILLAGE.COM.
241 * Extensively modified by Andrew.Tridgell@anu.edu.au
243 _PUBLIC_ bool next_token(const char **ptr,char *buff, const char *sep, size_t bufsize)
254 /* default to simple separators */
258 /* find the first non sep char */
259 while (*s && strchr_m(sep,*s))
266 /* copy over the token */
267 for (quoted = false; len < bufsize && *s && (quoted || !strchr_m(sep,*s)); s++) {
276 *ptr = (*s) ? s+1 : s;
283 Set a boolean variable from the text value stored in the passed string.
284 Returns true in success, false if the passed string does not correctly
288 _PUBLIC_ bool set_boolean(const char *boolean_string, bool *boolean)
290 if (strwicmp(boolean_string, "yes") == 0 ||
291 strwicmp(boolean_string, "true") == 0 ||
292 strwicmp(boolean_string, "on") == 0 ||
293 strwicmp(boolean_string, "1") == 0) {
296 } else if (strwicmp(boolean_string, "no") == 0 ||
297 strwicmp(boolean_string, "false") == 0 ||
298 strwicmp(boolean_string, "off") == 0 ||
299 strwicmp(boolean_string, "0") == 0) {
307 return the number of bytes occupied by a buffer in CH_UTF16 format
308 the result includes the null termination
310 _PUBLIC_ size_t utf16_len(const void *buf)
314 for (len = 0; SVAL(buf,len); len += 2) ;
320 return the number of bytes occupied by a buffer in CH_UTF16 format
321 the result includes the null termination
324 _PUBLIC_ size_t utf16_len_n(const void *src, size_t n)
328 for (len = 0; (len+2 < n) && SVAL(src, len); len += 2) ;