xref: /csrg-svn/lib/libc/string/string.3 (revision 48350)
1*48350Scael.\" Copyright (c) 1990, 1991 The Regents of the University of California.
241987Sbostic.\" All rights reserved.
320458Smckusick.\"
441987Sbostic.\" This code is derived from software contributed to Berkeley by
541987Sbostic.\" Chris Torek.
641987Sbostic.\" %sccs.include.redist.man%
741987Sbostic.\"
8*48350Scael.\"     @(#)string.3	6.9 (Berkeley) 04/19/91
941987Sbostic.\"
10*48350Scael.Dd
11*48350Scael.Dt STRING 3
12*48350Scael.Os BSD 4
13*48350Scael.Sh NAME
14*48350Scael.Nm strcat ,
15*48350Scael.Nm strncat ,
16*48350Scael.Nm strchr ,
17*48350Scael.Nm strrchr ,
18*48350Scael.Nm strcmp ,
19*48350Scael.Nm strncmp ,
20*48350Scael.Nm strcasecmp,
21*48350Scael.Nm strncasecmp ,
22*48350Scael.Nm strcpy ,
23*48350Scael.Nm strncpy ,
24*48350Scael.Nm strerror ,
25*48350Scael.Nm strlen ,
26*48350Scael.Nm strpbrk ,
27*48350Scael.Nm strsep,
28*48350Scael.Nm strspn ,
29*48350Scael.Nm strcspn ,
30*48350Scael.Nm strstr ,
31*48350Scael.Nm strtok ,
32*48350Scael.Nm index ,
33*48350Scael.Nm rindex
34*48350Scael.Nd string specific functions
35*48350Scael.Sh SYNOPSIS
36*48350Scael.Fd #include <string.h>
37*48350Scael.Ft char *
38*48350Scael.Fn strcat "char *s" "const char * append"
39*48350Scael.Ft char *
40*48350Scael.Fn strncat "char *s" "const char *append" "size_t count"
41*48350Scael.Ft char *
42*48350Scael.Fn strchr "const char *s" "int c"
43*48350Scael.Ft char *
44*48350Scael.Fn strrchr "const char *s" "int c"
45*48350Scael.Ft int
46*48350Scael.Fn strcmp "const char *s1" "const char *s2"
47*48350Scael.Ft int
48*48350Scael.Fn strncmp "const char *s1" "const char *s2" "size_t count"
49*48350Scael.Ft int
50*48350Scael.Fn strcasecmp "const char *s1" "const char *s2"
51*48350Scael.Ft int
52*48350Scael.Fn strncasecmp "const char *s1" "const char *s2" "size_t count"
53*48350Scael.Ft char *
54*48350Scael.Fn strcpy "char *dst" "const char *src"
55*48350Scael.Ft char *
56*48350Scael.Fn strncpy "char *dst" "const char *src" "size_t count"
57*48350Scael.Ft char *
58*48350Scael.Fn strerror "int errno"
59*48350Scael.Ft size_t
60*48350Scael.Fn strlen "const char *s"
61*48350Scael.Ft char *
62*48350Scael.Fn strpbrk "const char *s" "const char *charset"
63*48350Scael.Ft char *
64*48350Scael.Fn strsep "char **stringp" "const char *delim"
65*48350Scael.Ft size_t
66*48350Scael.Fn strspn "const char *s" "const char *charset"
67*48350Scael.Ft size_t
68*48350Scael.Fn strcspn "const char *s" "const char *charset"
69*48350Scael.Ft char *
70*48350Scael.Fn strstr "const char *big" "const char *little"
71*48350Scael.Ft char *
72*48350Scael.Fn strtok "char *s" "const char *delim"
73*48350Scael.Ft char *
74*48350Scael.Fn index "const char *s" "int c"
75*48350Scael.Ft char *
76*48350Scael.Fn rindex "const char *s" "int c"
77*48350Scael.Sh DESCRIPTION
78*48350ScaelThe string functions
79*48350Scaelfunctions manipulate strings terminated by a
80*48350Scaelnull byte.
81*48350Scael.Pp
8241987SbosticSee the specific manual pages for more information.
83*48350ScaelFor manipulating variable length generic objects as byte
84*48350Scaelstrings (without the null byte check), see
85*48350Scael.Xr bstring 3 .
86*48350Scael.Pp
8741987SbosticExcept as noted in their specific manual pages,
88*48350Scaelthe string functions do not test the destination
89*48350Scaelfor size limitations.
90*48350Scael.Sh SEE ALSO
91*48350Scael.Xr index 3 ,
92*48350Scael.Xr strcat 3 ,
93*48350Scael.Xr strchr 3 ,
94*48350Scael.Xr strrchr 3 ,
95*48350Scael.Xr strcmp 3 ,
96*48350Scael.Xr strcasecmp 3 ,
97*48350Scael.Xr strcpy 3 ,
98*48350Scael.Xr strerror 3 ,
99*48350Scael.Xr strlen 3 ,
100*48350Scael.Xr strpbrk 3 ,
101*48350Scael.Xr strsep 3 ,
102*48350Scael.Xr strspn 3 ,
103*48350Scael.Xr strcspn 3 ,
104*48350Scael.Xr strstr 3 ,
105*48350Scael.Xr strtok 3 ,
106*48350Scael.Xr rindex 3
107*48350Scael.Xr bstring 3
108*48350Scael.Sh STANDARDS
109*48350ScaelThe
110*48350Scael.Fn strcat ,
111*48350Scael.Fn strncat ,
112*48350Scael.Fn strchr ,
113*48350Scael.Fn strrchr ,
114*48350Scael.Fn strcmp ,
115*48350Scael.Fn strncmp ,
116*48350Scael.Fn strcpy ,
117*48350Scael.Fn strncpy ,
118*48350Scael.Fn strerror ,
119*48350Scael.Fn strlen ,
120*48350Scael.Fn strpbrk ,
121*48350Scael.Fn strsep ,
122*48350Scael.Fn strspn ,
123*48350Scael.Fn strcspn ,
124*48350Scael.Fn strstr ,
12541987Sbosticand
126*48350Scael.Fn strtok
127*48350Scaelfunctions
128*48350Scaelconform to
129*48350Scael.St -ansiC .
130