Make this i386-compatible; massive clean-up.

[unix-history] / usr / src / lib / libc / string / string.3

diff --git a/usr/src/lib/libc/string/string.3 b/usr/src/lib/libc/string/string.3
index 04f7f92..33a8994 100644 (file)
--- a/usr/src/lib/libc/string/string.3
+++ b/usr/src/lib/libc/string/string.3
@@ -1,97 +1,109 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)string.3    5.1 (Berkeley) %G%
+.\" This code is derived from software contributed to Berkeley by
+.\" Chris Torek.

 .\"
 .\"

-.TH STRING 3  "19 January 1983"
+.\" %sccs.include.redist.man%
+.\"
+.\"    @(#)string.3    6.8 (Berkeley) %G%
+.\"
+.TH STRING 3 ""

 .UC 4
 .SH NAME
 .UC 4
 .SH NAME

-strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, index, rindex \- string operations
+strcat, strncat, strchr, strrchr, strcmp, strncmp, strcasecmp,
+strncasecmp, strcpy, strncpy, strerror, strlen, strpbrk, strsep,
+strspn, strcspn, strstr, strtok, index, rindex \- string operations

 .SH SYNOPSIS
 .nf
 .SH SYNOPSIS
 .nf

-.B #include <strings.h>
-.PP
-.B char *strcat(s1, s2)
-.B char *s1, *s2;
-.PP
-.B char *strncat(s1, s2, n)
-.B char *s1, *s2;
-.PP
-.B strcmp(s1, s2)
-.B char *s1, *s2;
-.PP
-.B strncmp(s1, s2, n)
-.B char *s1, *s2;
-.PP
-.B char *strcpy(s1, s2)
-.B char *s1, *s2;
-.PP
-.B char *strncpy(s1, s2, n)
-.B char *s1, *s2;
-.PP
-.B strlen(s)
-.B char *s;
-.PP
-.B char *index(s, c)
-.B char *s, c;
-.PP
-.B char *rindex(s, c)
-.B char *s, c;
+.ft B
+#include <string.h>
+
+char *
+strcat(char *s, const char * append);
+
+char *
+strncat(char *s, const char *append, size_t count);
+
+char *
+strchr(const char *s, int c);
+
+char *
+strrchr(const char *s, int c);
+
+strcmp(const char *s1, const char *s2);
+
+strncmp(const char *s1, const char *s2, size_t count);
+
+strcasecmp(const char *s1, const char *s2);
+
+strncasecmp(const char *s1, const char *s2, size_t count);
+
+char *
+strcpy(char *dst, const char *src);
+
+char *
+strncpy(char *dst, const char *src, size_t count);
+
+char *
+strerror(int errno);
+
+size_t
+strlen(const char *s);
+
+char *
+strpbrk(const char *s, const char *charset);
+
+char *
+strsep(char **stringp, const char *delim);
+
+size_t
+strspn(const char *s, const char *charset);
+
+size_t
+strcspn(const char *s, const char *charset);
+
+char *
+strstr(const char *big, const char *little);
+
+char *
+strtok(char *s, const char *delim);
+
+char *
+index(const char *s, int c);
+
+char *
+rindex(const char *s, int c);
+.ft R

 .fi
 .SH DESCRIPTION
 These functions operate on null-terminated strings.
 .fi
 .SH DESCRIPTION
 These functions operate on null-terminated strings.

-They do not check for overflow of any receiving string.
-.PP
-.I Strcat
-appends a copy of string
-.I s2
-to the end of string
-.IR s1 .
-.I Strncat
-copies at most
-.I n
-characters.  Both return a pointer to the null-terminated result.
-.PP
-.I Strcmp
-compares its arguments and returns an integer
-greater than, equal to, or less than 0, according as
-.I s1
-is lexicographically greater than, equal to, or less than
-.IR s2 .
-.I Strncmp
-makes the same comparison but looks at at most
-.I n
-characters.
-.PP
-.I Strcpy
-copies string
-.I s2
-to
-.I s1,
-stopping after the null character has been moved.
-.I Strncpy
-copies exactly
-.I n
-characters, truncating or null-padding
-.I s2;
-the target may not be null-terminated if the length of
-.I s2
-is
-.I n
-or more.  Both return
-.IR s1 .

 .PP
 .PP

-.I Strlen
-returns the number of non-null characters in
-.IR s .
+See the specific manual pages for more information.

 .PP
 .PP

-.I Index
-.RI ( rindex )
-returns a pointer to the first (last) occurrence of character 
-.I c
-in string
-.I s,
-or zero if
-.I c
-does not occur in  the string.
+Except as noted in their specific manual pages,
+they do not check for overflow of any destination
+string.
+.SH SEE\ ALSO
+index(3), strcat(3), strchr(3), strrchr(3), strcmp(3), strcasecmp(3),
+strcpy(3), strerror(3), strlen(3), strpbrk(3), strsep(3), strspn(3),
+strcspn(3), strstr(3), strtok(3), rindex(3)
+.SH STANDARDS
+.IR Strcat ,
+.IR strncat ,
+.IR strchr ,
+.IR strrchr ,
+.IR strcmp ,
+.IR strncmp ,
+.IR strcpy ,
+.IR strncpy ,
+.IR strerror ,
+.IR strlen ,
+.IR strpbrk ,
+.IR strsep ,
+.IR strspn ,
+.IR strcspn ,
+.IR strstr ,
+and
+.IR strtok
+conform to ANSI X3.159-1989 (``ANSI C'').