2 * gstr.c: String Utility Functions.
5 * Miguel de Icaza (miguel@novell.com)
6 * Aaron Bockover (abockover@novell.com)
8 * (C) 2006 Novell, Inc.
10 * Permission is hereby granted, free of charge, to any person obtaining
11 * a copy of this software and associated documentation files (the
12 * "Software"), to deal in the Software without restriction, including
13 * without limitation the rights to use, copy, modify, merge, publish,
14 * distribute, sublicense, and/or sell copies of the Software, and to
15 * permit persons to whom the Software is furnished to do so, subject to
16 * the following conditions:
18 * The above copyright notice and this permission notice shall be
19 * included in all copies or substantial portions of the Software.
21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
22 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
23 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
24 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
25 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
26 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
27 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
35 /* This is not a macro, because I dont want to put _GNU_SOURCE in the glib.h header */
37 g_strndup (const gchar *str, gsize n)
40 return strndup (str, n);
43 char *retval = g_malloc(n+1);
45 strncpy(retval, str, n)[n] = 0;
54 g_strfreev (gchar **str_array)
56 gchar **orig = str_array;
57 if (str_array == NULL)
59 while (*str_array != NULL){
67 g_strdupv (gchar **str_array)
76 length = g_strv_length(str_array);
77 ret = g_new0(gchar *, length + 1);
78 for (i = 0; str_array[i]; i++) {
79 ret[i] = g_strdup(str_array[i]);
86 g_strv_length(gchar **str_array)
89 g_return_val_if_fail(str_array != NULL, 0);
90 for(length = 0; str_array[length] != NULL; length++);
95 g_str_has_suffix(const gchar *str, const gchar *suffix)
100 g_return_val_if_fail(str != NULL, FALSE);
101 g_return_val_if_fail(suffix != NULL, FALSE);
103 str_length = strlen(str);
104 suffix_length = strlen(suffix);
106 return suffix_length <= str_length ?
107 strncmp(str + str_length - suffix_length, suffix, suffix_length) == 0 :
112 g_str_has_prefix(const gchar *str, const gchar *prefix)
115 size_t prefix_length;
117 g_return_val_if_fail(str != NULL, FALSE);
118 g_return_val_if_fail(prefix != NULL, FALSE);
120 str_length = strlen(str);
121 prefix_length = strlen(prefix);
123 return prefix_length <= str_length ?
124 strncmp(str, prefix, prefix_length) == 0 :
129 g_strdup_vprintf (const gchar *format, va_list args)
134 n = vasprintf (&ret, format, args);
142 g_strdup_printf (const gchar *format, ...)
148 va_start (args, format);
149 n = vasprintf (&ret, format, args);
158 g_strerror (gint errnum)
160 return strerror (errnum);
164 g_strconcat (const gchar *first, ...)
169 g_return_val_if_fail (first != NULL, NULL);
171 total += strlen (first);
172 va_start (args, first);
173 for (s = va_arg (args, char *); s != NULL; s = va_arg(args, char *)){
178 ret = g_malloc (total + 1);
184 va_start (args, first);
185 for (s = va_arg (args, char *); s != NULL; s = va_arg(args, char *)){
194 add_to_vector (gchar ***vector, int size, gchar *token)
196 *vector = *vector == NULL ?
197 (gchar **)g_malloc(2 * sizeof(*vector)) :
198 (gchar **)g_realloc(*vector, (size + 1) * sizeof(*vector));
200 (*vector)[size - 1] = token;
204 g_strsplit (const gchar *string, const gchar *delimiter, gint max_tokens)
207 gchar *token, **vector;
210 g_return_val_if_fail (string != NULL, NULL);
211 g_return_val_if_fail (delimiter != NULL, NULL);
212 g_return_val_if_fail (delimiter[0] != 0, NULL);
214 if (strncmp (string, delimiter, strlen (delimiter)) == 0) {
215 vector = (gchar **)g_malloc (2 * sizeof(vector));
216 vector[0] = g_strdup ("");
218 string += strlen (delimiter);
223 while (*string && !(max_tokens > 0 && size >= max_tokens)) {
225 if (strncmp (string, delimiter, strlen (delimiter)) == 0) {
226 token = g_strdup ("");
227 string += strlen (delimiter);
229 while (*string && strncmp (string, delimiter, strlen (delimiter)) != 0) {
234 gsize toklen = (string - c);
235 token = g_strndup (c, toklen);
237 /* Need to leave a trailing empty
238 * token if the delimiter is the last
241 if (strcmp (string, delimiter) != 0) {
242 string += strlen (delimiter);
245 token = g_strdup (c);
249 add_to_vector (&vector, size, token);
254 /* Add the rest of the string as the last element */
255 add_to_vector (&vector, size, g_strdup (string));
259 if (vector == NULL) {
260 vector = (gchar **) g_malloc (2 * sizeof (vector));
262 } else if (size > 0) {
263 vector[size - 1] = NULL;
270 charcmp (gchar testchar, const gchar *compare)
273 if (*compare == testchar) {
283 g_strsplit_set (const gchar *string, const gchar *delimiter, gint max_tokens)
286 gchar *token, **vector;
289 g_return_val_if_fail (string != NULL, NULL);
290 g_return_val_if_fail (delimiter != NULL, NULL);
291 g_return_val_if_fail (delimiter[0] != 0, NULL);
293 if (charcmp (*string, delimiter)) {
294 vector = (gchar **)g_malloc (2 * sizeof(vector));
295 vector[0] = g_strdup ("");
303 while (*string && !(max_tokens > 0 && size >= max_tokens)) {
304 if (charcmp (*string, delimiter)) {
305 gsize toklen = (string - c);
307 token = g_strdup ("");
309 token = g_strndup (c, toklen);
314 add_to_vector (&vector, size, token);
321 if (max_tokens > 0 && size >= max_tokens) {
323 /* Add the rest of the string as the last element */
324 add_to_vector (&vector, size, g_strdup (string));
329 /* Fill in the trailing last token */
330 add_to_vector (&vector, size, g_strdup (c));
333 /* Need to leave a trailing empty token if the
334 * delimiter is the last part of the string
336 add_to_vector (&vector, size, g_strdup (""));
341 if (vector == NULL) {
342 vector = (gchar **) g_malloc (2 * sizeof (vector));
344 } else if (size > 0) {
345 vector[size - 1] = NULL;
352 g_strreverse (gchar *str)
360 for (i = 0, j = strlen (str) - 1; i < j; i++, j--) {
370 g_strjoin (const gchar *separator, ...)
376 if (separator != NULL)
377 slen = strlen (separator);
382 va_start (args, separator);
383 for (s = va_arg (args, char *); s != NULL; s = va_arg (args, char *)){
390 return g_strdup ("");
392 /* Remove the last separator */
393 if (slen > 0 && len > 0)
396 r = res = g_malloc (len + 1);
397 va_start (args, separator);
398 for (s = va_arg (args, char *); s != NULL; s = va_arg (args, char *)){
399 if (separator != NULL)
400 r = g_stpcpy (r, separator);
409 g_strjoinv (const gchar *separator, gchar **str_array)
414 if (separator != NULL)
415 slen = strlen (separator);
420 for (i = 0; str_array [i] != NULL; i++){
421 len += strlen (str_array [i]);
426 return g_strdup ("");
428 if (slen > 0 && len > 0)
431 r = res = g_malloc (len + 1);
432 for (i = 0; str_array [i] != NULL; i++){
433 if (separator != NULL)
434 r = g_stpcpy (r, separator);
435 r = g_stpcpy (r, str_array [i]);
442 g_strchug (gchar *str)
451 while (*tmp && isspace (*tmp)) tmp++;
453 len = strlen (str) - (tmp - str - 1);
454 memmove (str, tmp, len);
460 g_strchomp (gchar *str)
467 tmp = str + strlen (str) - 1;
468 while (*tmp && isspace (*tmp)) tmp--;
474 g_printf(gchar const *format, ...)
479 va_start(args, format);
480 ret = vprintf(format, args);
487 g_fprintf(FILE *file, gchar const *format, ...)
492 va_start(args, format);
493 ret = vfprintf(file, format, args);
500 g_sprintf(gchar *string, gchar const *format, ...)
505 va_start(args, format);
506 ret = vsprintf(string, format, args);
513 g_snprintf(gchar *string, gulong n, gchar const *format, ...)
518 va_start(args, format);
519 ret = vsnprintf(string, n, format, args);
525 static const char hx [] = { '0', '1', '2', '3', '4', '5', '6', '7',
526 '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
529 char_needs_encoding (char c)
531 if (((unsigned char)c) >= 0x80)
534 if ((c >= '@' && c <= 'Z') ||
535 (c >= 'a' && c <= 'z') ||
536 (c >= '&' && c < 0x3b) ||
537 (c == '!') || (c == '$') || (c == '_') || (c == '=') || (c == '~'))
543 g_filename_to_uri (const gchar *filename, const gchar *hostname, GError **error)
549 const char *uriPrefix = "file:///";
551 const char *uriPrefix = "file://";
554 g_return_val_if_fail (filename != NULL, NULL);
556 if (hostname != NULL)
557 g_warning ("%s", "eglib: g_filename_to_uri: hostname not handled");
559 if (!g_path_is_absolute (filename)){
561 *error = g_error_new (NULL, 2, "Not an absolute filename");
566 n = strlen (uriPrefix) + 1;
567 for (p = filename; *p; p++){
574 if (char_needs_encoding (*p))
580 strcpy (ret, uriPrefix);
581 for (p = filename, rp = ret + strlen (ret); *p; p++){
588 if (char_needs_encoding (*p)){
590 *rp++ = hx [((unsigned char)(*p)) >> 4];
591 *rp++ = hx [((unsigned char)(*p)) & 0xf];
602 if (p >= '0' && p <= '9')
604 if (p >= 'A' && p <= 'F')
606 if (p >= 'a' && p <= 'f')
608 g_assert_not_reached ();
613 g_filename_from_uri (const gchar *uri, gchar **hostname, GError **error)
619 g_return_val_if_fail (uri != NULL, NULL);
621 if (hostname != NULL)
622 g_warning ("%s", "eglib: g_filename_from_uri: hostname not handled");
624 if (strncmp (uri, "file:///", 8) != 0){
626 *error = g_error_new (NULL, 2, "URI does not start with the file: scheme");
630 for (p = uri + 8; *p; p++){
632 if (p [1] && p [2] && isxdigit (p [1]) && isxdigit (p [2])){
636 *error = g_error_new (NULL, 2, "URI contains an invalid escape sequence");
646 result = g_malloc (flen + 1);
656 for (p = uri + 8; *p; p++){
658 *r++ = (char)((decode (p [1]) << 4) | decode (p [2]));
668 g_strdown (gchar *string)
670 g_return_if_fail (string != NULL);
673 *string = (gchar)tolower (*string);
679 g_ascii_tolower (gchar c)
681 return c >= 'A' && c <= 'Z' ? c + ('a' - 'A') : c;
685 g_ascii_strdown (const gchar *str, gssize len)
690 g_return_val_if_fail (str != NULL, NULL);
695 ret = g_malloc (len + 1);
696 for (i = 0; i < len; i++)
697 ret [i] = (guchar) g_ascii_tolower (str [i]);
704 g_ascii_strncasecmp (const gchar *s1, const gchar *s2, gsize n)
708 g_return_val_if_fail (s1 != NULL, 0);
709 g_return_val_if_fail (s2 != NULL, 0);
711 for (i = 0; i < n; i++){
712 gchar c1 = g_ascii_tolower (*s1++);
713 gchar c2 = g_ascii_tolower (*s2++);
728 g_strdelimit (gchar *string, const gchar *delimiters, gchar new_delimiter)
732 g_return_val_if_fail (string != NULL, NULL);
734 if (delimiters == NULL)
735 delimiters = G_STR_DELIMITERS;
737 for (ptr = string; *ptr; ptr++) {
738 if (strchr (delimiters, *ptr))
739 *ptr = new_delimiter;
746 g_strlcpy (gchar *dest, const gchar *src, gsize dest_size)
749 return strlcpy (dest, src, dest_size);
756 g_return_val_if_fail (src != NULL, 0);
757 g_return_val_if_fail (dest != NULL, 0);
769 return (dest_size - len - 1);
772 /* len is 0 i we get here */
774 /* we need to return the length of src here */
775 while (*s++) ; /* instead of a plain strlen, we use 's' */
781 g_stpcpy (gchar *dest, const char *src)
783 g_return_val_if_fail (dest != NULL, dest);
784 g_return_val_if_fail (src != NULL, dest);
787 return stpcpy (dest, src);
790 return dest + strlen (src);
794 static const gchar escaped_dflt [256] = {
795 1, 1, 1, 1, 1, 1, 1, 1, 'b', 't', 'n', 1, 'f', 'r', 1, 1,
796 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
797 0, 0, '"', 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
798 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
799 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
800 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, '\\', 0, 0, 0,
801 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
802 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
803 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
804 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
805 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
806 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
807 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
808 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
809 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
810 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
814 g_strescape (const gchar *source, const gchar *exceptions)
823 g_return_val_if_fail (source != NULL, NULL);
825 memcpy (escaped, escaped_dflt, 256);
826 if (exceptions != NULL) {
827 for (ptr = exceptions; *ptr; ptr++)
828 escaped [(int) *ptr] = 0;
830 result = g_malloc (strlen (source) * 4 + 1); /* Worst case: everything octal. */
832 for (ptr = source; *ptr; ptr++) {
834 op = escaped [(int) c];
842 *res_ptr++ = '0' + ((c >> 6) & 3);
843 *res_ptr++ = '0' + ((c >> 3) & 7);
844 *res_ptr++ = '0' + (c & 7);
853 g_ascii_xdigit_value (gchar c)
855 return ((isxdigit (c) == 0) ? -1 :
856 ((c >= '0' && c <= '9') ? (c - '0') :
857 ((c >= 'a' && c <= 'f') ? (c - 'a' + 10) :
862 g_strnfill (gsize length, gchar fill_char)
864 gchar *ret = g_new (gchar, length + 1);
866 memset (ret, fill_char, length);