xref: /openbsd-src/gnu/lib/libiberty/include/dyn-string.h (revision 150b7e42cfa21e6546d96ae514ca23e80d970ac7)
1 /* An abstract string datatype.
2    Copyright (C) 1998, 1999, 2000, 2002, 2004 Free Software Foundation, Inc.
3    Contributed by Mark Mitchell (mark@markmitchell.com).
4 
5 This file is part of GCC.
6 
7 GCC is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
11 
12 GCC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 GNU General Public License for more details.
16 
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING.  If not, write to
19 the Free Software Foundation, 51 Franklin Street - Fifth Floor,
20 Boston, MA 02110-1301, USA.  */
21 
22 
23 typedef struct dyn_string
24 {
25   int allocated;	/* The amount of space allocated for the string.  */
26   int length;		/* The actual length of the string.  */
27   char *s;		/* The string itself, NUL-terminated.  */
28 }* dyn_string_t;
29 
30 /* The length STR, in bytes, not including the terminating NUL.  */
31 #define dyn_string_length(STR)                                          \
32   ((STR)->length)
33 
34 /* The NTBS in which the contents of STR are stored.  */
35 #define dyn_string_buf(STR)                                             \
36   ((STR)->s)
37 
38 /* Compare DS1 to DS2 with strcmp.  */
39 #define dyn_string_compare(DS1, DS2)                                    \
40   (strcmp ((DS1)->s, (DS2)->s))
41 
42 
43 /* dyn_string functions are used in the demangling implementation
44    included in the G++ runtime library.  To prevent collisions with
45    names in user programs, the functions that are used in the
46    demangler are given implementation-reserved names.  */
47 
48 #if defined(IN_LIBGCC2) || defined(IN_GLIBCPP_V3)
49 
50 #define dyn_string_init                 __cxa_dyn_string_init
51 #define dyn_string_new                  __cxa_dyn_string_new
52 #define dyn_string_delete               __cxa_dyn_string_delete
53 #define dyn_string_release              __cxa_dyn_string_release
54 #define dyn_string_resize               __cxa_dyn_string_resize
55 #define dyn_string_clear                __cxa_dyn_string_clear
56 #define dyn_string_copy                 __cxa_dyn_string_copy
57 #define dyn_string_copy_cstr            __cxa_dyn_string_copy_cstr
58 #define dyn_string_prepend              __cxa_dyn_string_prepend
59 #define dyn_string_prepend_cstr         __cxa_dyn_string_prepend_cstr
60 #define dyn_string_insert               __cxa_dyn_string_insert
61 #define dyn_string_insert_cstr          __cxa_dyn_string_insert_cstr
62 #define dyn_string_insert_char          __cxa_dyn_string_insert_char
63 #define dyn_string_append               __cxa_dyn_string_append
64 #define dyn_string_append_cstr          __cxa_dyn_string_append_cstr
65 #define dyn_string_append_char          __cxa_dyn_string_append_char
66 #define dyn_string_substring            __cxa_dyn_string_substring
67 #define dyn_string_eq                   __cxa_dyn_string_eq
68 
69 #endif /* IN_LIBGCC2 || IN_GLIBCPP_V3 */
70 
71 
72 extern int dyn_string_init (struct dyn_string *, int);
73 extern dyn_string_t dyn_string_new (int);
74 extern void dyn_string_delete (dyn_string_t);
75 extern char *dyn_string_release (dyn_string_t);
76 extern dyn_string_t dyn_string_resize (dyn_string_t, int);
77 extern void dyn_string_clear (dyn_string_t);
78 extern int dyn_string_copy (dyn_string_t, dyn_string_t);
79 extern int dyn_string_copy_cstr (dyn_string_t, const char *);
80 extern int dyn_string_prepend (dyn_string_t, dyn_string_t);
81 extern int dyn_string_prepend_cstr (dyn_string_t, const char *);
82 extern int dyn_string_insert (dyn_string_t, int, dyn_string_t);
83 extern int dyn_string_insert_cstr (dyn_string_t, int, const char *);
84 extern int dyn_string_insert_char (dyn_string_t, int, int);
85 extern int dyn_string_append (dyn_string_t, dyn_string_t);
86 extern int dyn_string_append_cstr (dyn_string_t, const char *);
87 extern int dyn_string_append_char (dyn_string_t, int);
88 extern int dyn_string_substring (dyn_string_t,  dyn_string_t, int, int);
89 extern int dyn_string_eq (dyn_string_t, dyn_string_t);
90