2 This file is part of systemd.
4 Copyright 2010 Lennart Poettering
6 systemd is free software; you can redistribute it and/or modify it
7 under the terms of the GNU Lesser General Public License as published by
8 the Free Software Foundation; either version 2.1 of the License, or
9 (at your option) any later version.
11 systemd is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with systemd; If not, see <http://www.gnu.org/licenses/>.
27 #include "alloc-util.h"
30 #include "string-util.h"
34 int strcmp_ptr(const char *a, const char *b) {
36 /* Like strcmp(), but tries to make sense of NULL pointers */
49 char* endswith(const char *s, const char *postfix) {
59 return (char*) s + sl;
64 if (memcmp(s + sl - pl, postfix, pl) != 0)
67 return (char*) s + sl - pl;
70 char* endswith_no_case(const char *s, const char *postfix) {
80 return (char*) s + sl;
85 if (strcasecmp(s + sl - pl, postfix) != 0)
88 return (char*) s + sl - pl;
91 char* first_word(const char *s, const char *word) {
98 /* Checks if the string starts with the specified word, either
99 * followed by NUL or by whitespace. Returns a pointer to the
100 * NUL or the first character after the whitespace. */
111 if (memcmp(s, word, wl) != 0)
118 if (!strchr(WHITESPACE, *p))
121 p += strspn(p, WHITESPACE);
125 static size_t strcspn_escaped(const char *s, const char *reject) {
126 bool escaped = false;
129 for (n=0; s[n]; n++) {
132 else if (s[n] == '\\')
134 else if (strchr(reject, s[n]))
138 /* if s ends in \, return index of previous char */
142 /* Split a string into words. */
143 const char* split(const char **state, size_t *l, const char *separator, bool quoted) {
149 assert(**state == '\0');
153 current += strspn(current, separator);
159 if (quoted && strchr("\'\"", *current)) {
160 char quotechars[2] = {*current, '\0'};
162 *l = strcspn_escaped(current + 1, quotechars);
163 if (current[*l + 1] == '\0' || current[*l + 1] != quotechars[0] ||
164 (current[*l + 2] && !strchr(separator, current[*l + 2]))) {
165 /* right quote missing or garbage at the end */
169 *state = current++ + *l + 2;
171 *l = strcspn_escaped(current, separator);
172 if (current[*l] && !strchr(separator, current[*l])) {
173 /* unfinished escape */
177 *state = current + *l;
179 *l = strcspn(current, separator);
180 *state = current + *l;
186 char *strnappend(const char *s, const char *suffix, size_t b) {
194 return strndup(suffix, b);
203 if (b > ((size_t) -1) - a)
206 r = new(char, a+b+1);
211 memcpy(r+a, suffix, b);
217 char *strappend(const char *s, const char *suffix) {
218 return strnappend(s, suffix, suffix ? strlen(suffix) : 0);
221 char *strjoin_real(const char *x, ...) {
235 t = va_arg(ap, const char *);
240 if (n > ((size_t) -1) - l) {
264 t = va_arg(ap, const char *);
278 char *strstrip(char *s) {
281 /* Drops trailing whitespace. Modifies the string in
282 * place. Returns pointer to first non-space character */
284 s += strspn(s, WHITESPACE);
286 for (e = strchr(s, 0); e > s; e --)
287 if (!strchr(WHITESPACE, e[-1]))
295 #if 0 /// UNNEEDED by elogind
296 char *delete_chars(char *s, const char *bad) {
299 /* Drops all whitespace, regardless where in the string */
301 for (f = s, t = s; *f; f++) {
314 char *truncate_nl(char *s) {
317 s[strcspn(s, NEWLINE)] = 0;
321 #if 0 /// UNNEEDED by elogind
322 char ascii_tolower(char x) {
324 if (x >= 'A' && x <= 'Z')
325 return x - 'A' + 'a';
330 char ascii_toupper(char x) {
332 if (x >= 'a' && x <= 'z')
333 return x - 'a' + 'A';
338 char *ascii_strlower(char *t) {
344 *p = ascii_tolower(*p);
349 char *ascii_strupper(char *t) {
355 *p = ascii_toupper(*p);
360 char *ascii_strlower_n(char *t, size_t n) {
366 for (i = 0; i < n; i++)
367 t[i] = ascii_tolower(t[i]);
372 int ascii_strcasecmp_n(const char *a, const char *b, size_t n) {
374 for (; n > 0; a++, b++, n--) {
377 x = (int) (uint8_t) ascii_tolower(*a);
378 y = (int) (uint8_t) ascii_tolower(*b);
387 int ascii_strcasecmp_nn(const char *a, size_t n, const char *b, size_t m) {
390 r = ascii_strcasecmp_n(a, b, MIN(n, m));
402 bool chars_intersect(const char *a, const char *b) {
405 /* Returns true if any of the chars in a are in b. */
414 bool string_has_cc(const char *p, const char *ok) {
420 * Check if a string contains control characters. If 'ok' is
421 * non-NULL it may be a string containing additional CCs to be
425 for (t = p; *t; t++) {
426 if (ok && strchr(ok, *t))
429 if (*t > 0 && *t < ' ')
439 static char *ascii_ellipsize_mem(const char *s, size_t old_length, size_t new_length, unsigned percent) {
444 assert(percent <= 100);
445 assert(new_length >= 3);
447 if (old_length <= 3 || old_length <= new_length)
448 return strndup(s, old_length);
450 r = new0(char, new_length+3);
454 x = (new_length * percent) / 100;
456 if (x > new_length - 3)
460 r[x] = 0xe2; /* tri-dot ellipsis: … */
464 s + old_length - (new_length - x - 1),
470 char *ellipsize_mem(const char *s, size_t old_length, size_t new_length, unsigned percent) {
474 unsigned k, len, len2;
478 assert(percent <= 100);
479 assert(new_length >= 3);
481 /* if no multibyte characters use ascii_ellipsize_mem for speed */
482 if (ascii_is_valid(s))
483 return ascii_ellipsize_mem(s, old_length, new_length, percent);
485 if (old_length <= 3 || old_length <= new_length)
486 return strndup(s, old_length);
488 x = (new_length * percent) / 100;
490 if (x > new_length - 3)
494 for (i = s; k < x && i < s + old_length; i = utf8_next_char(i)) {
497 r = utf8_encoded_to_unichar(i, &c);
500 k += unichar_iswide(c) ? 2 : 1;
503 if (k > x) /* last character was wide and went over quota */
506 for (j = s + old_length; k < new_length && j > i; ) {
509 j = utf8_prev_char(j);
510 r = utf8_encoded_to_unichar(j, &c);
513 k += unichar_iswide(c) ? 2 : 1;
517 /* we don't actually need to ellipsize */
519 return memdup(s, old_length + 1);
521 /* make space for ellipsis */
522 j = utf8_next_char(j);
525 len2 = s + old_length - j;
526 e = new(char, len + 3 + len2 + 1);
531 printf("old_length=%zu new_length=%zu x=%zu len=%u len2=%u k=%u\n",
532 old_length, new_length, x, len, len2, k);
536 e[len] = 0xe2; /* tri-dot ellipsis: … */
540 memcpy(e + len + 3, j, len2 + 1);
545 char *ellipsize(const char *s, size_t length, unsigned percent) {
546 return ellipsize_mem(s, strlen(s), length, percent);
549 bool nulstr_contains(const char*nulstr, const char *needle) {
555 NULSTR_FOREACH(i, nulstr)
556 if (streq(i, needle))
562 char* strshorten(char *s, size_t l) {
571 char *strreplace(const char *text, const char *old_string, const char *new_string) {
574 size_t l, old_len, new_len;
580 old_len = strlen(old_string);
581 new_len = strlen(new_string);
594 if (!startswith(f, old_string)) {
600 nl = l - old_len + new_len;
601 a = realloc(r, nl + 1);
609 t = stpcpy(t, new_string);
620 char *strip_tab_ansi(char **ibuf, size_t *_isz) {
621 const char *i, *begin = NULL;
626 } state = STATE_OTHER;
634 /* Strips ANSI color and replaces TABs by 8 spaces */
636 isz = _isz ? *_isz : strlen(*ibuf);
638 f = open_memstream(&obuf, &osz);
642 for (i = *ibuf; i < *ibuf + isz + 1; i++) {
647 if (i >= *ibuf + isz) /* EOT */
649 else if (*i == '\x1B')
650 state = STATE_ESCAPE;
658 if (i >= *ibuf + isz) { /* EOT */
661 } else if (*i == '[') {
662 state = STATE_BRACKET;
674 if (i >= *ibuf + isz || /* EOT */
675 (!(*i >= '0' && *i <= '9') && *i != ';' && *i != 'm')) {
680 } else if (*i == 'm')
702 char *strextend(char **x, ...) {
709 l = f = *x ? strlen(*x) : 0;
716 t = va_arg(ap, const char *);
721 if (n > ((size_t) -1) - l) {
730 r = realloc(*x, l+1);
740 t = va_arg(ap, const char *);
754 char *strrep(const char *s, unsigned n) {
762 p = r = malloc(l * n + 1);
766 for (i = 0; i < n; i++)
773 int split_pair(const char *s, const char *sep, char **l, char **r) {
788 a = strndup(s, x - s);
792 b = strdup(x + strlen(sep));
804 int free_and_strdup(char **p, const char *s) {
809 /* Replaces a string pointer with an strdup()ed new string,
810 * possibly freeing the old one. */
812 if (streq_ptr(*p, s))
828 #if !HAVE_DECL_EXPLICIT_BZERO
830 * Pointer to memset is volatile so that compiler must de-reference
831 * the pointer and can't assume that it points to any function in
832 * particular (such as memset, which it then might further "optimize")
833 * This approach is inspired by openssl's crypto/mem_clr.c.
835 typedef void *(*memset_t)(void *,int,size_t);
837 static volatile memset_t memset_func = memset;
839 void explicit_bzero(void *p, size_t l) {
840 memset_func(p, '\0', l);
844 char* string_erase(char *x) {
848 /* A delicious drop of snake-oil! To be called on memory where
849 * we stored passphrases or so, after we used them. */
850 explicit_bzero(x, strlen(x));
854 char *string_free_erase(char *s) {
855 return mfree(string_erase(s));
858 bool string_is_safe(const char *p) {
864 for (t = p; *t; t++) {
865 if (*t > 0 && *t < ' ') /* no control characters */
868 if (strchr(QUOTES "\\\x7f", *t))