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
)
364 for (i
= 0; i
< half
; i
++, len
--) {
373 g_strjoin (const gchar
*separator
, ...)
379 if (separator
!= NULL
)
380 slen
= strlen (separator
);
384 va_start (args
, separator
);
385 for (s
= va_arg (args
, char *); s
!= NULL
; s
= va_arg (args
, char *)){
391 return g_strdup ("");
393 /* Remove the last separator */
394 if (slen
> 0 && len
> 0)
397 res
= g_malloc (len
);
398 va_start (args
, separator
);
399 s
= va_arg (args
, char *);
401 for (s
= va_arg (args
, char *); s
!= NULL
; s
= va_arg (args
, char *)){
402 if (separator
!= NULL
)
403 strcat (res
, separator
);
412 g_strjoinv (const gchar
*separator
, gchar
**str_array
)
417 if (separator
!= NULL
)
418 slen
= strlen (separator
);
423 for (i
= 0; str_array
[i
] != NULL
; i
++){
424 len
+= strlen (str_array
[i
]);
428 return g_strdup ("");
429 if (slen
> 0 && len
> 0)
432 res
= g_malloc (len
);
433 strcpy (res
, str_array
[0]);
434 for (i
= 1; str_array
[i
] != NULL
; i
++){
435 if (separator
!= NULL
)
436 strcat (res
, separator
);
437 strcat (res
, str_array
[i
]);
443 g_strchug (gchar
*str
)
452 while (*tmp
&& isspace (*tmp
)) tmp
++;
454 len
= strlen (str
) - (tmp
- str
- 1);
455 memmove (str
, tmp
, len
);
461 g_strchomp (gchar
*str
)
468 tmp
= str
+ strlen (str
) - 1;
469 while (*tmp
&& isspace (*tmp
)) tmp
--;
475 g_printf(gchar
const *format
, ...)
480 va_start(args
, format
);
481 ret
= vprintf(format
, args
);
488 g_fprintf(FILE *file
, gchar
const *format
, ...)
493 va_start(args
, format
);
494 ret
= vfprintf(file
, format
, args
);
501 g_sprintf(gchar
*string
, gchar
const *format
, ...)
506 va_start(args
, format
);
507 ret
= vsprintf(string
, format
, args
);
514 g_snprintf(gchar
*string
, gulong n
, gchar
const *format
, ...)
519 va_start(args
, format
);
520 ret
= vsnprintf(string
, n
, format
, args
);
526 static const char hx
[] = { '0', '1', '2', '3', '4', '5', '6', '7',
527 '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
530 char_needs_encoding (char c
)
532 if (((unsigned char)c
) >= 0x80)
535 if ((c
>= '@' && c
<= 'Z') ||
536 (c
>= 'a' && c
<= 'z') ||
537 (c
>= '&' && c
< 0x3b) ||
538 (c
== '!') || (c
== '$') || (c
== '_') || (c
== '=') || (c
== '~'))
544 g_filename_to_uri (const gchar
*filename
, const gchar
*hostname
, GError
**error
)
550 const char *uriPrefix
= "file:///";
552 const char *uriPrefix
= "file://";
555 g_return_val_if_fail (filename
!= NULL
, NULL
);
557 if (hostname
!= NULL
)
558 g_warning ("%s", "eglib: g_filename_to_uri: hostname not handled");
560 if (!g_path_is_absolute (filename
)){
562 *error
= g_error_new (NULL
, 2, "Not an absolute filename");
567 n
= strlen (uriPrefix
) + 1;
568 for (p
= filename
; *p
; p
++){
575 if (char_needs_encoding (*p
))
581 strcpy (ret
, uriPrefix
);
582 for (p
= filename
, rp
= ret
+ strlen (ret
); *p
; p
++){
589 if (char_needs_encoding (*p
)){
591 *rp
++ = hx
[((unsigned char)(*p
)) >> 4];
592 *rp
++ = hx
[((unsigned char)(*p
)) & 0xf];
603 if (p
>= '0' && p
<= '9')
605 if (p
>= 'A' && p
<= 'F')
607 if (p
>= 'a' && p
<= 'f')
609 g_assert_not_reached ();
614 g_filename_from_uri (const gchar
*uri
, gchar
**hostname
, GError
**error
)
620 g_return_val_if_fail (uri
!= NULL
, NULL
);
622 if (hostname
!= NULL
)
623 g_warning ("%s", "eglib: g_filename_from_uri: hostname not handled");
625 if (strncmp (uri
, "file:///", 8) != 0){
627 *error
= g_error_new (NULL
, 2, "URI does not start with the file: scheme");
631 for (p
= uri
+ 8; *p
; p
++){
633 if (p
[1] && p
[2] && isxdigit (p
[1]) && isxdigit (p
[2])){
637 *error
= g_error_new (NULL
, 2, "URI contains an invalid escape sequence");
647 result
= g_malloc (flen
+ 1);
657 for (p
= uri
+ 8; *p
; p
++){
659 *r
++ = (char)((decode (p
[1]) << 4) | decode (p
[2]));
669 g_strdown (gchar
*string
)
671 g_return_if_fail (string
!= NULL
);
674 *string
= (gchar
)tolower (*string
);
680 g_ascii_tolower (gchar c
)
682 return c
>= 'A' && c
<= 'Z' ? c
+ ('a' - 'A') : c
;
686 g_ascii_strdown (const gchar
*str
, gssize len
)
691 g_return_val_if_fail (str
!= NULL
, NULL
);
696 ret
= g_malloc (len
+ 1);
697 for (i
= 0; i
< len
; i
++)
698 ret
[i
] = (guchar
) g_ascii_tolower (str
[i
]);
705 g_ascii_strncasecmp (const gchar
*s1
, const gchar
*s2
, gsize n
)
709 g_return_val_if_fail (s1
!= NULL
, 0);
710 g_return_val_if_fail (s2
!= NULL
, 0);
712 for (i
= 0; i
< n
; i
++){
713 gchar c1
= g_ascii_tolower (*s1
++);
714 gchar c2
= g_ascii_tolower (*s2
++);
729 g_strdelimit (gchar
*string
, const gchar
*delimiters
, gchar new_delimiter
)
733 g_return_val_if_fail (string
!= NULL
, NULL
);
735 if (delimiters
== NULL
)
736 delimiters
= G_STR_DELIMITERS
;
738 for (ptr
= string
; *ptr
; ptr
++) {
739 if (strchr (delimiters
, *ptr
))
740 *ptr
= new_delimiter
;
747 g_strlcpy (gchar
*dest
, const gchar
*src
, gsize dest_size
)
750 return strlcpy (dest
, src
, dest_size
);
757 g_return_val_if_fail (src
!= NULL
, 0);
758 g_return_val_if_fail (dest
!= NULL
, 0);
770 return (dest_size
- len
- 1);
773 /* len is 0 i we get here */
775 /* we need to return the length of src here */
776 while (*s
++) ; /* instead of a plain strlen, we use 's' */
781 static const gchar escaped_dflt
[256] = {
782 1, 1, 1, 1, 1, 1, 1, 1, 'b', 't', 'n', 1, 'f', 'r', 1, 1,
783 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
784 0, 0, '"', 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
785 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
786 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
787 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, '\\', 0, 0, 0,
788 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
789 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
790 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
791 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
792 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
793 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
794 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
795 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
796 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
797 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
801 g_strescape (const gchar
*source
, const gchar
*exceptions
)
810 g_return_val_if_fail (source
!= NULL
, NULL
);
812 memcpy (escaped
, escaped_dflt
, 256);
813 if (exceptions
!= NULL
) {
814 for (ptr
= exceptions
; *ptr
; ptr
++)
815 escaped
[(int) *ptr
] = 0;
817 result
= g_malloc (strlen (source
) * 4 + 1); /* Worst case: everything octal. */
819 for (ptr
= source
; *ptr
; ptr
++) {
821 op
= escaped
[(int) c
];
829 *res_ptr
++ = '0' + ((c
>> 6) & 3);
830 *res_ptr
++ = '0' + ((c
>> 3) & 7);
831 *res_ptr
++ = '0' + (c
& 7);
840 g_ascii_xdigit_value (gchar c
)
842 return ((isxdigit (c
) == 0) ? -1 :
843 ((c
>= '0' && c
<= '9') ? (c
- '0') :
844 ((c
>= 'a' && c
<= 'f') ? (c
- 'a' + 10) :
849 g_strnfill (gsize length
, gchar fill_char
)
851 gchar
*ret
= g_new (gchar
, length
+ 1);
853 memset (ret
, fill_char
, length
);