1ustr(1)                   Ustr String Library, tools                   ustr(1)
2
3
4

NAME

6       ustr-import - ustr string library import tool
7

SYNOPSIS

9       ustr-import [--32|--64] [-d][d] [-c] [-b x] [-e 1|0] [-s 1|0] section
10
11

DESCRIPTION

13        This tool lets you use the Ustr string library without incuring
14       dependancies on the library itself, so API/ABI compatability is 100%
15       (nothing changes unless you do it) and installing your application
16       doesn't require the library to be pre-installed.
17

OPTIONS

19       --32   If you installed with multilib, this runs the 32 bit varient
20              (and installs the variable multilib build code as ustr-conf.h).
21
22
23       --64   If you installed with multilib, this runs the 64 bit varient
24              (and installs the variable multilib build code as ustr-conf.h).
25
26
27       -d     Turn debugging on, USTR_ASSERT() now runs code etc.
28
29
30       -d     Turn extra debugging on, including End of String (EOS) markers
31              that takeup space. Note that you can do -dd to add both at once.
32
33
34       -c     Use C files, this requires that you alter the build system to
35              compile the C files and link them into your application. The
36              default is to just provide headers that you can just include.
37
38
39       -b     Specify the default reference count byte size: 0, 1, 2 or 4 (or
40              8 on 64 bit platforms). Note that 2 bytes is the minimum if you
41              have explicit size storage.
42
43
44       -e     Specify the default exact sized allocations flag, without this
45              flag allocations are rounded up to the neared half power of two.
46
47
48       -s     Specify the default explicit size storage flag, without this
49              flag allocations have an implicit size based on their length
50              with it a size value is stored with the string (thus taking
51              significantly larger space for small strings, but this doesn't
52              require reallocating the string when growing and shrinking the
53              string). Note that turning this on also increases the minimum
54              sizes for length and reference count storage.
55
56

SECTIONS

58       all    All of the following sections are included.
59
60
61       b      Working with binary numbers in NBO format.
62
63
64       cmp    Comparing, strcmp() for Ustr's, although the Ustr versions are
65              safer and much faster.
66
67
68       cntl   Control options dynamically.
69
70
71       fmt    Formatted output, sprintf() for Ustr's.
72
73
74       gdb    Copy just the .gdbinit file to the local dir.
75
76
77       io     Input Output.
78
79
80       ins    Inserting data.
81
82
83       main   The core functions, including strcat(), strdup() and delete for
84              Ustr's. Always safer and often much faster.
85
86
87       parse  Parsing integers, Ie. Nice versions of strtol().
88
89
90       pool   A bundled memory pool API, to use with the ustrp functions.
91
92
93       replace
94              Replacing all occurances of data.
95
96
97       sc     Shortcut functions for Ustr's.
98
99
100       set    Setting data, strcpy() for Ustr's.
101
102
103       split  Slit the data, strtok() / strsep() for Ustr's.
104
105
106       spn    Spanning, strspn() / strcspn() for Ustr's.
107
108
109       srch   Searching, strchr() / strrchr() / strstr() for Ustr's, although
110              the Ustr versions are safer and much faster.
111
112
113       sub    Substituting data.
114
115
116       utf8   Working with UTF8.
117
118

FILES

120       /ustr/include/ustr-conf.h /ustr/include/ustr-conf-debug.h
121              In multilib. this is the header to choose the correct conf.h
122              header based on the byte size.
123
124
125       /ustr/include/ustr*.h
126              The default "extern" header files.
127
128
129       /usr/share/ustr-*/ustr-*-internal.h
130              Internal functions, used the implement the public interfaces.
131
132
133       /usr/share/ustr-*/ustr-*-code.h
134              The code behind the public interfaces.
135
136
137       /usr/share/ustr-*/ustr-*-code.c
138              The C files, which use the code header files to create objects.
139
140
141       /usr/share/ustr-*/.gdbinit
142              The GDB init file containing macros to help inspect Ustr's in
143              the debugger.
144
145

SEE ALSO

147       ustr(3),ustr_const(3)
148
149
150
151ustr-import 1.0.4                 03-Aug-2007                          ustr(1)