xref: /csrg-svn/lib/libc/string/string.3 (revision 65099)
161193Sbostic.\" Copyright (c) 1990, 1991, 1993
261193Sbostic.\"	The Regents of the University of California.  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*65099Smckusick.\"     @(#)string.3	8.2 (Berkeley) 12/11/93
941987Sbostic.\"
1048350Scael.Dd
1148350Scael.Dt STRING 3
1248350Scael.Os BSD 4
1348350Scael.Sh NAME
1448350Scael.Nm strcat ,
1548350Scael.Nm strncat ,
1648350Scael.Nm strchr ,
1748350Scael.Nm strrchr ,
1848350Scael.Nm strcmp ,
1948350Scael.Nm strncmp ,
2048350Scael.Nm strcasecmp,
2148350Scael.Nm strncasecmp ,
2248350Scael.Nm strcpy ,
2348350Scael.Nm strncpy ,
2448350Scael.Nm strerror ,
2548350Scael.Nm strlen ,
2648350Scael.Nm strpbrk ,
2748350Scael.Nm strsep,
2848350Scael.Nm strspn ,
2948350Scael.Nm strcspn ,
3048350Scael.Nm strstr ,
3148350Scael.Nm strtok ,
3248350Scael.Nm index ,
3348350Scael.Nm rindex
3448350Scael.Nd string specific functions
3548350Scael.Sh SYNOPSIS
3648350Scael.Fd #include <string.h>
3748350Scael.Ft char *
3848350Scael.Fn strcat "char *s" "const char * append"
3948350Scael.Ft char *
4048350Scael.Fn strncat "char *s" "const char *append" "size_t count"
4148350Scael.Ft char *
4248350Scael.Fn strchr "const char *s" "int c"
4348350Scael.Ft char *
4448350Scael.Fn strrchr "const char *s" "int c"
4548350Scael.Ft int
4648350Scael.Fn strcmp "const char *s1" "const char *s2"
4748350Scael.Ft int
4848350Scael.Fn strncmp "const char *s1" "const char *s2" "size_t count"
4948350Scael.Ft int
5048350Scael.Fn strcasecmp "const char *s1" "const char *s2"
5148350Scael.Ft int
5248350Scael.Fn strncasecmp "const char *s1" "const char *s2" "size_t count"
5348350Scael.Ft char *
5448350Scael.Fn strcpy "char *dst" "const char *src"
5548350Scael.Ft char *
5648350Scael.Fn strncpy "char *dst" "const char *src" "size_t count"
5748350Scael.Ft char *
5848350Scael.Fn strerror "int errno"
5948350Scael.Ft size_t
6048350Scael.Fn strlen "const char *s"
6148350Scael.Ft char *
6248350Scael.Fn strpbrk "const char *s" "const char *charset"
6348350Scael.Ft char *
6448350Scael.Fn strsep "char **stringp" "const char *delim"
6548350Scael.Ft size_t
6648350Scael.Fn strspn "const char *s" "const char *charset"
6748350Scael.Ft size_t
6848350Scael.Fn strcspn "const char *s" "const char *charset"
6948350Scael.Ft char *
7048350Scael.Fn strstr "const char *big" "const char *little"
7148350Scael.Ft char *
7248350Scael.Fn strtok "char *s" "const char *delim"
7348350Scael.Ft char *
7448350Scael.Fn index "const char *s" "int c"
7548350Scael.Ft char *
7648350Scael.Fn rindex "const char *s" "int c"
7748350Scael.Sh DESCRIPTION
78*65099SmckusickThe string
7948350Scaelfunctions manipulate strings terminated by a
8048350Scaelnull byte.
8148350Scael.Pp
8241987SbosticSee the specific manual pages for more information.
8348350ScaelFor manipulating variable length generic objects as byte
8448350Scaelstrings (without the null byte check), see
8548350Scael.Xr bstring 3 .
8648350Scael.Pp
8741987SbosticExcept as noted in their specific manual pages,
8848350Scaelthe string functions do not test the destination
8948350Scaelfor size limitations.
9048350Scael.Sh SEE ALSO
9148350Scael.Xr index 3 ,
9248350Scael.Xr strcat 3 ,
9348350Scael.Xr strchr 3 ,
9448350Scael.Xr strrchr 3 ,
9548350Scael.Xr strcmp 3 ,
9648350Scael.Xr strcasecmp 3 ,
9748350Scael.Xr strcpy 3 ,
9848350Scael.Xr strerror 3 ,
9948350Scael.Xr strlen 3 ,
10048350Scael.Xr strpbrk 3 ,
10148350Scael.Xr strsep 3 ,
10248350Scael.Xr strspn 3 ,
10348350Scael.Xr strcspn 3 ,
10448350Scael.Xr strstr 3 ,
10548350Scael.Xr strtok 3 ,
10648350Scael.Xr rindex 3
10748350Scael.Xr bstring 3
10848350Scael.Sh STANDARDS
10948350ScaelThe
11048350Scael.Fn strcat ,
11148350Scael.Fn strncat ,
11248350Scael.Fn strchr ,
11348350Scael.Fn strrchr ,
11448350Scael.Fn strcmp ,
11548350Scael.Fn strncmp ,
11648350Scael.Fn strcpy ,
11748350Scael.Fn strncpy ,
11848350Scael.Fn strerror ,
11948350Scael.Fn strlen ,
12048350Scael.Fn strpbrk ,
12148350Scael.Fn strsep ,
12248350Scael.Fn strspn ,
12348350Scael.Fn strcspn ,
12448350Scael.Fn strstr ,
12541987Sbosticand
12648350Scael.Fn strtok
12748350Scaelfunctions
12848350Scaelconform to
12948350Scael.St -ansiC .
130