diff options
author | nicm <> | 2011-07-09 16:32:11 +0000 |
---|---|---|
committer | nicm <> | 2011-07-09 16:32:11 +0000 |
commit | fca8d05c769a8158bda24aac39207cc8aef2509f (patch) | |
tree | 702909b7bb989911d78cfc56420d666b979f44a2 /src/lib/libc/string/wmemchr.3 | |
parent | 3ce64b158507a9265ab433ea859d7a9ddadaa934 (diff) | |
download | openbsd-fca8d05c769a8158bda24aac39207cc8aef2509f.tar.gz openbsd-fca8d05c769a8158bda24aac39207cc8aef2509f.tar.bz2 openbsd-fca8d05c769a8158bda24aac39207cc8aef2509f.zip |
Instead of documenting all the wide string functions in wmemchr(3), add
individual pages (based on the existing string man pages). By Tim van
der Molen (tbvdm at xs4all dot nl) after a suggestion by millert@.
ok deraadt
Diffstat (limited to 'src/lib/libc/string/wmemchr.3')
-rw-r--r-- | src/lib/libc/string/wmemchr.3 | 150 |
1 files changed, 34 insertions, 116 deletions
diff --git a/src/lib/libc/string/wmemchr.3 b/src/lib/libc/string/wmemchr.3 index 529f27b05b..40a68bf28d 100644 --- a/src/lib/libc/string/wmemchr.3 +++ b/src/lib/libc/string/wmemchr.3 | |||
@@ -1,9 +1,5 @@ | |||
1 | .\" $OpenBSD: wmemchr.3,v 1.6 2011/05/28 17:12:43 jmc Exp $ | 1 | .\" Copyright (c) 1990, 1991 The Regents of the University of California. |
2 | .\" | 2 | .\" All rights reserved. |
3 | .\" $NetBSD: wmemchr.3,v 1.9 2003/09/08 17:54:33 wiz Exp $ | ||
4 | .\" | ||
5 | .\" Copyright (c) 1990, 1991, 1993 | ||
6 | .\" The Regents of the University of California. All rights reserved. | ||
7 | .\" | 3 | .\" |
8 | .\" This code is derived from software contributed to Berkeley by | 4 | .\" This code is derived from software contributed to Berkeley by |
9 | .\" Chris Torek and the American National Standards Committee X3, | 5 | .\" Chris Torek and the American National Standards Committee X3, |
@@ -33,123 +29,45 @@ | |||
33 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | 29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
34 | .\" SUCH DAMAGE. | 30 | .\" SUCH DAMAGE. |
35 | .\" | 31 | .\" |
36 | .\" from: @(#)strcpy.3 8.1 (Berkeley) 6/4/93 | 32 | .\" $OpenBSD: wmemchr.3,v 1.7 2011/07/09 16:32:11 nicm Exp $ |
37 | .\" | 33 | .\" |
38 | .Dd $Mdocdate: May 28 2011 $ | 34 | .Dd $Mdocdate: July 9 2011 $ |
39 | .Dt WMEMCHR 3 | 35 | .Dt WMEMCHR 3 |
40 | .Os | 36 | .Os |
41 | .Sh NAME | 37 | .Sh NAME |
42 | .Nm wmemchr , | 38 | .Nm wmemchr |
43 | .Nm wmemcmp , | 39 | .Nd locate wide character in wide string |
44 | .Nm wmemcpy , | ||
45 | .Nm wmemmove , | ||
46 | .Nm wmemset , | ||
47 | .Nm wcscat , | ||
48 | .Nm wcschr , | ||
49 | .Nm wcscmp , | ||
50 | .Nm wcscasecmp , | ||
51 | .Nm wcscpy , | ||
52 | .Nm wcscspn , | ||
53 | .Nm wcslcat , | ||
54 | .Nm wcslcpy , | ||
55 | .Nm wcslen , | ||
56 | .Nm wcsncat , | ||
57 | .Nm wcsncmp , | ||
58 | .Nm wcsncasecmp , | ||
59 | .Nm wcsncpy , | ||
60 | .Nm wcspbrk , | ||
61 | .Nm wcsrchr , | ||
62 | .Nm wcsspn , | ||
63 | .Nm wcsstr | ||
64 | .Nd wide-character string manipulation operations | ||
65 | .Sh SYNOPSIS | 40 | .Sh SYNOPSIS |
66 | .In wchar.h | 41 | .Fd #include <wchar.h> |
67 | .Ft wchar_t * | ||
68 | .Fn wmemchr "const wchar_t *s" "wchar_t c" "size_t n" | ||
69 | .Ft int | ||
70 | .Fn wmemcmp "const wchar_t *s1" "const wchar_t *s2" "size_t n" | ||
71 | .Ft wchar_t * | ||
72 | .Fn wmemcpy "wchar_t * restrict s1" "const wchar_t * restrict s2" "size_t n" | ||
73 | .Ft wchar_t * | ||
74 | .Fn wmemmove "wchar_t *s1" "const wchar_t *s2" "size_t n" | ||
75 | .Ft wchar_t * | ||
76 | .Fn wmemset "wchar_t *s" "wchar_t c" "size_t n" | ||
77 | .Ft wchar_t * | ||
78 | .Fn wcscat "wchar_t * restrict s1" "const wchar_t * restrict s2" | ||
79 | .Ft wchar_t * | ||
80 | .Fn wcschr "const wchar_t *s" "wchar_t c" | ||
81 | .Ft int | ||
82 | .Fn wcscmp "const wchar_t *s1" "const wchar_t *s2" | ||
83 | .Ft int | ||
84 | .Fn wcscasecmp "const wchar_t *s1" "const wchar_t *s2" | ||
85 | .Ft wchar_t * | ||
86 | .Fn wcscpy "wchar_t * restrict s1" "const wchar_t * restrict s2" | ||
87 | .Ft size_t | ||
88 | .Fn wcscspn "const wchar_t *s1" "const wchar_t *s2" | ||
89 | .Ft size_t | ||
90 | .Fn wcslcat "wchar_t *s1" "const wchar_t *s2" "size_t n" | ||
91 | .Ft size_t | ||
92 | .Fn wcslcpy "wchar_t *s1" "const wchar_t *s2" "size_t n" | ||
93 | .Ft size_t | ||
94 | .Fn wcslen "const wchar_t *s" | ||
95 | .Ft wchar_t * | ||
96 | .Fn wcsncat "wchar_t * restrict s1" "const wchar_t * restrict s2" "size_t n" | ||
97 | .Ft int | ||
98 | .Fn wcsncmp "const wchar_t *s1" "const wchar_t * s2" "size_t n" | ||
99 | .Ft int | ||
100 | .Fn wcsncasecmp "const wchar_t *s1" "const wchar_t * s2" "size_t n" | ||
101 | .Ft wchar_t * | ||
102 | .Fn wcsncpy "wchar_t * restrict s1" "const wchar_t * restrict s2" "size_t n" | ||
103 | .Ft wchar_t * | ||
104 | .Fn wcspbrk "const wchar_t *s1" "const wchar_t *s2" | ||
105 | .Ft wchar_t * | ||
106 | .Fn wcsrchr "const wchar_t *s" "wchar_t c" | ||
107 | .Ft size_t | ||
108 | .Fn wcsspn "const wchar_t *s1" "const wchar_t *s2" | ||
109 | .Ft wchar_t * | 42 | .Ft wchar_t * |
110 | .Fn wcsstr "const wchar_t *s1" "const wchar_t *s2" | 43 | .Fn memchr "const wchar_t *b" "wchar_t c" "size_t len" |
111 | .Sh DESCRIPTION | 44 | .Sh DESCRIPTION |
112 | These functions implement string manipulation operations over wide-character | 45 | The |
113 | strings. | 46 | .Fn wmemchr |
114 | For a detailed description, refer to documents for the respective single-byte | 47 | function locates the first occurrence of |
115 | counterpart, such as | 48 | .Fa c |
116 | .Xr memchr 3 . | 49 | in wide string |
50 | .Fa b . | ||
51 | .Sh RETURN VALUES | ||
52 | The | ||
53 | .Fn wmemchr | ||
54 | function returns a pointer to the wide character located, or | ||
55 | .Dv NULL | ||
56 | if no such wide character exists within | ||
57 | .Fa len | ||
58 | wide characters. | ||
117 | .Sh SEE ALSO | 59 | .Sh SEE ALSO |
118 | .Xr memchr 3 , | 60 | .Xr wcschr 3 , |
119 | .Xr memcmp 3 , | 61 | .Xr wcscspn 3 , |
120 | .Xr memcpy 3 , | 62 | .Xr wcspbrk 3 , |
121 | .Xr memmove 3 , | 63 | .Xr wcsrchr 3 , |
122 | .Xr memset 3 , | 64 | .Xr wcsspn 3 , |
123 | .Xr strcasecmp 3 , | 65 | .Xr wcsstr 3 , |
124 | .Xr strcat 3 , | 66 | .Xr wcstok 3 |
125 | .Xr strchr 3 , | ||
126 | .Xr strcmp 3 , | ||
127 | .Xr strcpy 3 , | ||
128 | .Xr strcspn 3 , | ||
129 | .Xr strlcat 3 , | ||
130 | .Xr strlcpy 3 , | ||
131 | .Xr strlen 3 , | ||
132 | .Xr strncasecmp 3 , | ||
133 | .Xr strncat 3 , | ||
134 | .Xr strncmp 3 , | ||
135 | .Xr strncpy 3 , | ||
136 | .Xr strpbrk 3 , | ||
137 | .Xr strrchr 3 , | ||
138 | .Xr strspn 3 , | ||
139 | .Xr strstr 3 | ||
140 | .Sh STANDARDS | 67 | .Sh STANDARDS |
141 | These functions conform to | 68 | The |
69 | .Fn memchr | ||
70 | function conforms to | ||
142 | .St -isoC-99 | 71 | .St -isoC-99 |
143 | and were first introduced in | 72 | and was first introduced in |
144 | .St -isoC-amd1 , | 73 | .St -isoC-amd1 . |
145 | except for | ||
146 | .Fn wcscasecmp | ||
147 | and | ||
148 | .Fn wcsncasecmp , | ||
149 | which conform to | ||
150 | .St -p1003.1-2008 , | ||
151 | and | ||
152 | .Fn wcslcat | ||
153 | and | ||
154 | .Fn wcslcpy , | ||
155 | which are extensions. | ||