1#
2#Copyright (c) 1994 Cygnus Support.
3#All rights reserved.
4#
5#Redistribution and use in source and binary forms are permitted
6#provided that the above copyright notice and this paragraph are
7#duplicated in all such forms and that any documentation,
8#and/or other materials related to such
9#distribution and use acknowledge that the software was developed
10#at Cygnus Support, Inc.  Cygnus Support, Inc. may not be used to
11#endorse or promote products derived from this software without
12#specific prior written permission.
13#THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
14#IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
15#WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
16#
17@node Strings
18@chapter Strings and Memory (@file{string.h})
19
20This chapter describes string-handling functions and functions for
21managing areas of memory.  The corresponding declarations are in
22@file{string.h}.
23
24@menu
25* Function bcmp::        Compare two memory areas
26* Function bcopy::       Copy memory regions
27* Function bzero::       Initialize memory to zero
28* Function index::       Search for character in string
29* Function memccpy::     Copy memory regions up to end-token
30* Function memchr::      Find character in memory
31* Function memcmp::      Compare two memory areas
32* Function memcpy::      Copy memory regions
33* Function memmem::      Find memory segment
34* Function memmove::     Move possibly overlapping memory
35* Function mempcpy::     Copy memory regions and locate end
36* Function memrchr::     Reverse search for character in memory
37* Function memset::      Set an area of memory
38* Function rawmemchr::   Find character in memory
39* Function rindex::      Reverse search for character in string
40* Function stpcpy::      Copy string returning a pointer to its end
41* Function stpncpy::     Counted copy string returning a pointer to its end
42* Function strcasecmp::  Compare strings ignoring case
43* Function strcasestr::  Find string segment ignoring case
44* Function strcat::      Concatenate strings
45* Function strchr::      Search for character in string
46* Function strchrnul::   Search for character in string
47* Function strcmp::      Character string compare
48* Function strcoll::     Locale-specific character string compare
49* Function strcpy::      Copy string
50* Function strcspn::     Count chars not in string
51* Function strerror::    Convert error number to string (strerror, strerror_l)
52* Function strerror_r::  Convert error number to string
53* Function strlen::      Character string length
54* Function strlwr::      Convert string to lowercase
55* Function strncasecmp:: Compare strings ignoring case
56* Function strncat::     Concatenate strings
57* Function strncmp::     Character string compare
58* Function strncpy::     Counted copy string
59* Function strnstr::     Find string segment
60* Function strnlen::     Character string length
61* Function strpbrk::     Find chars in string
62* Function strrchr::     Reverse search for character in string
63* Function strsignal::   Return signal message string
64* Function strspn::      Find initial match
65* Function strstr::      Find string segment
66* Function strtok::      Get next token from a string
67* Function strupr::      Convert string to upper case
68* Function strverscmp::  Compare version strings
69* Function strxfrm::     Transform string
70* Function swab::        Swap adjacent bytes
71* Function wcscasecmp::  Compare wide character strings ignoring case
72* Function wcsdup::      Wide character string duplicate
73* Function wcsncasecmp:: Compare wide character strings ignoring case
74@end menu
75
76@page
77@include string/bcmp.def
78
79@page
80@include string/bcopy.def
81
82@page
83@include string/bzero.def
84
85@page
86@include string/index.def
87
88@page
89@include string/memccpy.def
90
91@page
92@include string/memchr.def
93
94@page
95@include string/memcmp.def
96
97@page
98@include string/memcpy.def
99
100@page
101@include string/memmem.def
102
103@page
104@include string/memmove.def
105
106@page
107@include string/mempcpy.def
108
109@page
110@include string/memrchr.def
111
112@page
113@include string/memset.def
114
115@page
116@include string/rawmemchr.def
117
118@page
119@include string/rindex.def
120
121@page
122@include string/stpcpy.def
123
124@page
125@include string/stpncpy.def
126
127@page
128@include string/strcasecmp.def
129
130@page
131@include string/strcasestr.def
132
133@page
134@include string/strcat.def
135
136@page
137@include string/strchr.def
138
139@page
140@include string/strchrnul.def
141
142@page
143@include string/strcmp.def
144
145@page
146@include string/strcoll.def
147
148@page
149@include string/strcpy.def
150
151@page
152@include string/strcspn.def
153
154@page
155@include string/strerror.def
156
157@page
158@include string/strerror_r.def
159
160@page
161@include string/strlen.def
162
163@page
164@include string/strlwr.def
165
166@page
167@include string/strncasecmp.def
168
169@page
170@include string/strncat.def
171
172@page
173@include string/strncmp.def
174
175@page
176@include string/strncpy.def
177
178@page
179@include string/strnstr.def
180
181@page
182@include string/strnlen.def
183
184@page
185@include string/strpbrk.def
186
187@page
188@include string/strrchr.def
189
190@page
191@include string/strsignal.def
192
193@page
194@include string/strspn.def
195
196@page
197@include string/strstr.def
198
199@page
200@include string/strtok.def
201
202@page
203@include string/strupr.def
204
205@page
206@include string/strverscmp.def
207
208@page
209@include string/strxfrm.def
210
211@page
212@include string/swab.def
213
214@page
215@include string/wcscasecmp.def
216
217@page
218@include string/wcsdup.def
219
220@page
221@include string/wcsncasecmp.def
222