1 /* GLIB - Library of useful routines for C programming
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 * Portions Copyright (C) 1999 Tony Gale
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Library General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Library General Public License for more details.
15 * You should have received a copy of the GNU Library General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
22 * Modified by the GLib Team and others 1997-1999. See the AUTHORS
23 * file for a list of people on the GLib Team. See the ChangeLog
24 * files for a list of changes. These files are distributed with
25 * GLib at ftp://ftp.gtk.org/pub/gtk/.
46 #define G_STRING_BLOCK_SIZE 512
48 typedef struct _GRealStringChunk GRealStringChunk;
49 typedef struct _GRealString GRealString;
51 struct _GRealStringChunk
53 GHashTable *const_table;
67 G_LOCK_DEFINE_STATIC (string_mem_chunk);
68 static GMemChunk *string_mem_chunk = NULL;
74 g_str_equal (gconstpointer v, gconstpointer v2)
76 return strcmp ((const gchar*) v, (const gchar*)v2) == 0;
79 /* a char* hash function from ASU */
81 g_str_hash (gconstpointer v)
83 const char *s = (char*)v;
87 for(p = s; *p != '\0'; p += 1) {
89 if ( ( g = h & 0xf0000000 ) ) {
103 g_string_chunk_new (gint default_size)
105 GRealStringChunk *new_chunk = g_new (GRealStringChunk, 1);
108 while (size < default_size)
111 new_chunk->const_table = NULL;
112 new_chunk->storage_list = NULL;
113 new_chunk->storage_next = size;
114 new_chunk->default_size = size;
115 new_chunk->this_size = size;
117 return (GStringChunk*) new_chunk;
121 g_string_chunk_free (GStringChunk *fchunk)
123 GRealStringChunk *chunk = (GRealStringChunk*) fchunk;
126 g_return_if_fail (chunk != NULL);
128 if (chunk->storage_list)
130 for (tmp_list = chunk->storage_list; tmp_list; tmp_list = tmp_list->next)
131 g_free (tmp_list->data);
133 g_slist_free (chunk->storage_list);
136 if (chunk->const_table)
137 g_hash_table_destroy (chunk->const_table);
143 g_string_chunk_insert (GStringChunk *fchunk,
146 GRealStringChunk *chunk = (GRealStringChunk*) fchunk;
147 gint len = strlen (string);
150 g_return_val_if_fail (chunk != NULL, NULL);
152 if ((chunk->storage_next + len + 1) > chunk->this_size)
154 gint new_size = chunk->default_size;
156 while (new_size < len+1)
159 chunk->storage_list = g_slist_prepend (chunk->storage_list,
160 g_new (char, new_size));
162 chunk->this_size = new_size;
163 chunk->storage_next = 0;
166 pos = ((char*)chunk->storage_list->data) + chunk->storage_next;
168 strcpy (pos, string);
170 chunk->storage_next += len + 1;
176 g_string_chunk_insert_const (GStringChunk *fchunk,
179 GRealStringChunk *chunk = (GRealStringChunk*) fchunk;
182 g_return_val_if_fail (chunk != NULL, NULL);
184 if (!chunk->const_table)
185 chunk->const_table = g_hash_table_new (g_str_hash, g_str_equal);
187 lookup = (char*) g_hash_table_lookup (chunk->const_table, (gchar *)string);
191 lookup = g_string_chunk_insert (fchunk, string);
192 g_hash_table_insert (chunk->const_table, lookup, lookup);
201 nearest_power (gint num)
212 nearest_multiple (int num, const int block)
223 g_string_maybe_expand (GRealString* string, gint len)
225 if (string->len + len >= string->alloc)
227 string->alloc = nearest_power (string->len + len + 1);
228 string->str = g_realloc (string->str, string->alloc);
233 g_string_set_size (GRealString* string, gint size)
235 if (string->alloc <= size) {
236 string->alloc = nearest_power(size + 1);
237 string->str = g_realloc (string->str, string->alloc);
242 g_string_sized_new (guint dfl_size)
246 G_LOCK (string_mem_chunk);
247 if (!string_mem_chunk)
248 string_mem_chunk = g_mem_chunk_new ("string mem chunk",
249 sizeof (GRealString),
250 1024, G_ALLOC_AND_FREE);
252 string = g_chunk_new (GRealString, string_mem_chunk);
253 G_UNLOCK (string_mem_chunk);
259 g_string_maybe_expand (string, MAX (dfl_size, 2));
262 return (GString*) string;
266 g_string_new (const gchar *init)
270 string = g_string_sized_new (2);
273 g_string_append (string, init);
279 g_string_free (GString *string,
282 g_return_if_fail (string != NULL);
285 g_free (string->str);
287 G_LOCK (string_mem_chunk);
288 g_mem_chunk_free (string_mem_chunk, string);
289 G_UNLOCK (string_mem_chunk);
293 g_string_assign (GString *lval,
296 g_string_truncate (lval, 0);
297 g_string_append (lval, rval);
303 g_string_truncate (GString* fstring,
306 GRealString *string = (GRealString*)fstring;
308 g_return_val_if_fail (string != NULL, NULL);
312 string->str[len] = 0;
318 g_string_append (GString *fstring,
321 GRealString *string = (GRealString*)fstring;
324 g_return_val_if_fail (string != NULL, NULL);
325 g_return_val_if_fail (val != NULL, fstring);
328 g_string_maybe_expand (string, len);
330 strcpy (string->str + string->len, val);
338 g_string_append_c (GString *fstring,
341 GRealString *string = (GRealString*)fstring;
343 g_return_val_if_fail (string != NULL, NULL);
344 g_string_maybe_expand (string, 1);
346 string->str[string->len++] = c;
347 string->str[string->len] = 0;
353 g_string_prepend (GString *fstring,
356 GRealString *string = (GRealString*)fstring;
359 g_return_val_if_fail (string != NULL, NULL);
360 g_return_val_if_fail (val != NULL, fstring);
363 g_string_maybe_expand (string, len);
365 g_memmove (string->str + len, string->str, string->len);
367 strncpy (string->str, val, len);
371 string->str[string->len] = 0;
377 g_string_prepend_c (GString *fstring,
380 GRealString *string = (GRealString*)fstring;
382 g_return_val_if_fail (string != NULL, NULL);
383 g_string_maybe_expand (string, 1);
385 g_memmove (string->str + 1, string->str, string->len);
391 string->str[string->len] = 0;
397 g_string_insert (GString *fstring,
401 GRealString *string = (GRealString*)fstring;
404 g_return_val_if_fail (string != NULL, NULL);
405 g_return_val_if_fail (val != NULL, fstring);
406 g_return_val_if_fail (pos >= 0, fstring);
407 g_return_val_if_fail (pos <= string->len, fstring);
410 g_string_maybe_expand (string, len);
412 g_memmove (string->str + pos + len, string->str + pos, string->len - pos);
414 strncpy (string->str + pos, val, len);
418 string->str[string->len] = 0;
424 g_string_insert_c (GString *fstring,
428 GRealString *string = (GRealString*)fstring;
430 g_return_val_if_fail (string != NULL, NULL);
431 g_return_val_if_fail (pos <= string->len, fstring);
433 g_string_maybe_expand (string, 1);
435 g_memmove (string->str + pos + 1, string->str + pos, string->len - pos);
437 string->str[pos] = c;
441 string->str[string->len] = 0;
447 g_string_erase (GString *fstring,
451 GRealString *string = (GRealString*)fstring;
453 g_return_val_if_fail (string != NULL, NULL);
454 g_return_val_if_fail (len >= 0, fstring);
455 g_return_val_if_fail (pos >= 0, fstring);
456 g_return_val_if_fail (pos <= string->len, fstring);
457 g_return_val_if_fail (pos + len <= string->len, fstring);
459 if (pos + len < string->len)
460 g_memmove (string->str + pos, string->str + pos + len, string->len - (pos + len));
464 string->str[string->len] = 0;
470 g_string_down (GString *fstring)
472 GRealString *string = (GRealString*)fstring;
475 g_return_val_if_fail (string != NULL, NULL);
489 g_string_up (GString *fstring)
491 GRealString *string = (GRealString*)fstring;
494 g_return_val_if_fail (string != NULL, NULL);
508 g_string_sprintfa_int (GString *string,
514 buffer = g_strdup_vprintf (fmt, args);
515 g_string_append (string, buffer);
520 g_string_sprintf (GString *string,
526 g_string_truncate (string, 0);
528 va_start (args, fmt);
529 g_string_sprintfa_int (string, fmt, args);
534 g_string_sprintfa (GString *string,
540 va_start (args, fmt);
541 g_string_sprintfa_int (string, fmt, args);
546 g_string_readline (GString *dest_str,
550 gint count=0, retval;
553 g_return_val_if_fail (dest_str != NULL, G_STRING_ERROR_INVAL);
554 g_return_val_if_fail (max_length > 0, G_STRING_ERROR_INVAL);
555 g_string_truncate(dest_str, 0);
557 for (count = 0; count < max_length; count++) {
558 if ( (retval = read(fd, &c, 1)) == 1 ) {
563 return(G_STRING_ERROR_NONE);
565 g_string_maybe_expand ((GRealString *) dest_str, 1);
566 dest_str->str[dest_str->len++] = c;
567 dest_str->str[dest_str->len] = 0;
568 } else if (retval == 0) {
569 return(G_STRING_ERROR_NODATA);
571 return(G_STRING_ERROR_READ);
574 return(G_STRING_ERROR_LENGTH);
578 g_string_readline_buffered (GString *dest_str,
584 guint count, i=0, buff_size;
586 g_return_val_if_fail (dest_str != NULL, G_STRING_ERROR_INVAL);
587 g_return_val_if_fail (buff_str != NULL, G_STRING_ERROR_INVAL);
588 g_return_val_if_fail (max_length > 0, G_STRING_ERROR_INVAL);
590 /* Make the buffer a multiple of G_STRING_BLOCK_SIZE and
591 * bigger then max_length */
592 buff_size = nearest_multiple(max_length, G_STRING_BLOCK_SIZE);
593 g_string_set_size( (GRealString *) buff_str, buff_size);
596 /* Allow the buffer to empty before reading more data.
597 * Prevents blocking on read() when data in the buffer */
599 if (buff_str->len != 0) {
600 /* Search for a CRLF, CR or LF */
601 for (i = 0; i < max_length-1; i++) {
604 if (buff_str->str[i] == '\r') {
607 if (buff_str->str[i+1] == '\n') {
608 buff_str->str[i] = '\0';
610 } else if (match_bare_cr) {
611 buff_str->str[i] = '\0';
616 /* Copy the line to the destination string and
617 * remove it from the buffer */
618 g_string_assign( dest_str, buff_str->str );
619 g_string_erase( buff_str, 0, i+1);
620 return (G_STRING_ERROR_NONE);
624 if (buff_str->str[i] == '\n') {
625 buff_str->str[i] = '\0';
627 /* Copy the line to the destination string and
628 * remove it from the buffer */
629 g_string_assign( dest_str, buff_str->str );
630 g_string_erase( buff_str, 0, i+1);
631 return (G_STRING_ERROR_NONE);
634 /* If we hit a '\0' then we've exhausted the buffer */
635 if (buff_str->str[i] == '\0') {
641 /* Read in a block of data, appending it to the buffer */
642 if ( (count = read(fd, buff_str->str + buff_str->len,
643 buff_size - buff_str->len - 1)) < 0) {
644 return (G_STRING_ERROR_READ);
645 } else if (count == 0) {
646 return (G_STRING_ERROR_NODATA);
648 /* Fix up the buffer */
649 buff_str->len += count;
650 buff_str->str[buff_str->len] = '\0';
653 } while (i != max_length-1);
655 /* If we get here then we have reached max_length */
656 g_string_assign (dest_str, buff_str->str);
657 g_string_truncate (dest_str, max_length-1);
658 g_string_erase (buff_str, 0, max_length-1);
660 return (G_STRING_ERROR_LENGTH);
664 g_string_tokenise (GString *string,
671 gchar *current, *start, c;
674 g_return_val_if_fail (string != NULL, NULL);
675 g_return_val_if_fail (delims != NULL, NULL);
677 if (max_tokens < 1) {
678 max_tokens = G_MAXINT;
681 current = string->str;
683 /* Remove any leading delimiters */
685 while ( *current && (strchr(delims, *current) != NULL) ) {
690 /* If we've reached max_tokens, use the remaining input string
691 * as the last token */
692 if (count == max_tokens) {
693 token = g_string_new(current);
694 tokens = g_list_append(tokens, token);
698 /* Find the extent of the current token */
701 while ( *current && (strchr(delims, *current) == NULL) ) {
706 token = g_string_new( start );
708 tokens = g_list_append(tokens, token);
720 g_string_tokenise_free (GList *tokens,
726 g_string_free( (GString *) tokens->data, TRUE );
727 tokens = g_list_next(tokens);