summaryrefslogtreecommitdiff
path: root/gas/sb.h
diff options
context:
space:
mode:
authorLorry Tar Creator <lorry-tar-importer@baserock.org>2014-12-23 14:38:46 +0000
committer <>2015-05-26 15:48:41 +0000
commit5500a97a2ad1735db5b35bc51cfb825c1f4c38df (patch)
treecc6e777c26142b88456ff03a672e1cb69215fc32 /gas/sb.h
downloadbinutils-tarball-master.tar.gz
Imported from /home/lorry/working-area/delta_binutils-tarball/binutils-2.25.tar.bz2.HEADbinutils-2.25master
Diffstat (limited to 'gas/sb.h')
-rw-r--r--gas/sb.h70
1 files changed, 70 insertions, 0 deletions
diff --git a/gas/sb.h b/gas/sb.h
new file mode 100644
index 0000000..5efb5b5
--- /dev/null
+++ b/gas/sb.h
@@ -0,0 +1,70 @@
+/* sb.h - header file for string buffer manipulation routines
+ Copyright (C) 1994-2014 Free Software Foundation, Inc.
+
+ Written by Steve and Judy Chamberlain of Cygnus Support,
+ sac@cygnus.com
+
+ This file is part of GAS, the GNU Assembler.
+
+ GAS is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 3, or (at your option)
+ any later version.
+
+ GAS is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with GAS; see the file COPYING. If not, write to the Free
+ Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
+ 02110-1301, USA. */
+
+#ifndef SB_H
+
+#define SB_H
+
+/* String blocks
+
+ I had a couple of choices when deciding upon this data structure.
+ gas uses null terminated strings for all its internal work. This
+ often means that parts of the program that want to examine
+ substrings have to manipulate the data in the string to do the
+ right thing (a common operation is to single out a bit of text by
+ saving away the character after it, nulling it out, operating on
+ the substring and then replacing the character which was under the
+ null). This is a pain and I remember a load of problems that I had with
+ code in gas which almost got this right. Also, it's harder to grow and
+ allocate null terminated strings efficiently.
+
+ Obstacks provide all the functionality needed, but are too
+ complicated, hence the sb.
+
+ An sb is allocated by the caller. */
+
+typedef struct sb
+{
+ char *ptr; /* Points to the current block. */
+ size_t len; /* How much is used. */
+ size_t max; /* The maximum length. */
+}
+sb;
+
+extern void sb_new (sb *);
+extern void sb_build (sb *, size_t);
+extern void sb_kill (sb *);
+extern void sb_add_sb (sb *, sb *);
+extern void sb_scrub_and_add_sb (sb *, sb *);
+extern void sb_reset (sb *);
+extern void sb_add_char (sb *, size_t);
+extern void sb_add_string (sb *, const char *);
+extern void sb_add_buffer (sb *, const char *, size_t);
+extern char *sb_terminate (sb *);
+extern size_t sb_skip_white (size_t, sb *);
+extern size_t sb_skip_comma (size_t, sb *);
+
+/* Actually in input-scrub.c. */
+extern void input_scrub_include_sb (sb *, char *, int);
+
+#endif /* SB_H */