Libc-498.1.7.tar.gz

[apple/libc.git] / string / FreeBSD / strchr.3

diff --git a/string/FreeBSD/strchr.3 b/string/FreeBSD/strchr.3
index 6f8d3fa698945edb957db143e14a792b7bd023b5..f6780e0826d7499c22253dd9c4763730e4493a61 100644 (file)
--- a/string/FreeBSD/strchr.3
+++ b/string/FreeBSD/strchr.3
@@ -34,55 +34,65 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)strchr.3   8.2 (Berkeley) 4/19/94
-.\" $FreeBSD: src/lib/libc/string/strchr.3,v 1.9 2002/12/18 13:33:03 ru Exp $
+.\" $FreeBSD: src/lib/libc/string/strchr.3,v 1.11 2003/09/04 20:36:54 simon Exp $
 .\"
 .Dd April 19, 1994
 .Dt STRCHR 3
 .Os
 .Sh NAME
-.Nm strchr
+.Nm strchr , strrchr
 .Nd locate character in string
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In string.h
-.Ft char *
+.Ft "char *"
 .Fn strchr "const char *s" "int c"
+.Ft "char *"
+.Fn strrchr "const char *s" "int c"
 .Sh DESCRIPTION
 The
 .Fn strchr
 function locates the first occurrence of
 .Fa c
+(converted to a
+.Vt char )
 in the string pointed to by
 .Fa s .
-The terminating
-.Dv NUL
-character is considered part of the string.
-If
+The terminating null character is considered part of the string;
+therefore if
 .Fa c
 is
 .Ql \e0 ,
-.Fn strchr
-locates the terminating
+the functions locate the terminating
 .Ql \e0 .
+.Pp
+The
+.Fn strrchr
+function is identical to
+.Fn strchr
+except it locates the last occurrence of
+.Fa c .
 .Sh RETURN VALUES
-The function
+The functions
 .Fn strchr
-returns a pointer to the located character, or
+and
+.Fn strrchr
+return a pointer to the located character, or
 .Dv NULL
 if the character does not appear in the string.
 .Sh SEE ALSO
 .Xr memchr 3 ,
 .Xr strcspn 3 ,
 .Xr strpbrk 3 ,
-.Xr strrchr 3 ,
 .Xr strsep 3 ,
 .Xr strspn 3 ,
 .Xr strstr 3 ,
 .Xr strtok 3
 .Sh STANDARDS
-The
+The functions
 .Fn strchr
-function
-conforms to
+and
+.Fn strrchr
+conform to
 .St -isoC .