xref: /csrg-svn/lib/libc/string/string.3 (revision 61193)
1*61193Sbostic.\" Copyright (c) 1990, 1991, 1993
2*61193Sbostic.\"	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*61193Sbostic.\"     @(#)string.3	8.1 (Berkeley) 06/04/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
7848350ScaelThe string functions
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