xref: /freebsd/lib/libc/string/wmemchr.3 (revision 9829d36a8683ded23a8c7cbc12dac15ceb045e0a)
19829d36aSTakuya SHIOZAKI.\"	$NetBSD: wmemchr.3,v 1.4 2001/01/02 11:26:23 itojun Exp $
29829d36aSTakuya SHIOZAKI.\"
39829d36aSTakuya SHIOZAKI.\" Copyright (c) 1990, 1991, 1993
49829d36aSTakuya SHIOZAKI.\"	The Regents of the University of California.  All rights reserved.
59829d36aSTakuya SHIOZAKI.\"
69829d36aSTakuya SHIOZAKI.\" This code is derived from software contributed to Berkeley by
79829d36aSTakuya SHIOZAKI.\" Chris Torek and the American National Standards Committee X3,
89829d36aSTakuya SHIOZAKI.\" on Information Processing Systems.
99829d36aSTakuya SHIOZAKI.\"
109829d36aSTakuya SHIOZAKI.\" Redistribution and use in source and binary forms, with or without
119829d36aSTakuya SHIOZAKI.\" modification, are permitted provided that the following conditions
129829d36aSTakuya SHIOZAKI.\" are met:
139829d36aSTakuya SHIOZAKI.\" 1. Redistributions of source code must retain the above copyright
149829d36aSTakuya SHIOZAKI.\"    notice, this list of conditions and the following disclaimer.
159829d36aSTakuya SHIOZAKI.\" 2. Redistributions in binary form must reproduce the above copyright
169829d36aSTakuya SHIOZAKI.\"    notice, this list of conditions and the following disclaimer in the
179829d36aSTakuya SHIOZAKI.\"    documentation and/or other materials provided with the distribution.
189829d36aSTakuya SHIOZAKI.\" 3. All advertising materials mentioning features or use of this software
199829d36aSTakuya SHIOZAKI.\"    must display the following acknowledgement:
209829d36aSTakuya SHIOZAKI.\"	This product includes software developed by the University of
219829d36aSTakuya SHIOZAKI.\"	California, Berkeley and its contributors.
229829d36aSTakuya SHIOZAKI.\" 4. Neither the name of the University nor the names of its contributors
239829d36aSTakuya SHIOZAKI.\"    may be used to endorse or promote products derived from this software
249829d36aSTakuya SHIOZAKI.\"    without specific prior written permission.
259829d36aSTakuya SHIOZAKI.\"
269829d36aSTakuya SHIOZAKI.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
279829d36aSTakuya SHIOZAKI.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
289829d36aSTakuya SHIOZAKI.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
299829d36aSTakuya SHIOZAKI.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
309829d36aSTakuya SHIOZAKI.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
319829d36aSTakuya SHIOZAKI.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
329829d36aSTakuya SHIOZAKI.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
339829d36aSTakuya SHIOZAKI.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
349829d36aSTakuya SHIOZAKI.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
359829d36aSTakuya SHIOZAKI.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
369829d36aSTakuya SHIOZAKI.\" SUCH DAMAGE.
379829d36aSTakuya SHIOZAKI.\"
389829d36aSTakuya SHIOZAKI.\"     from: @(#)strcpy.3	8.1 (Berkeley) 6/4/93
399829d36aSTakuya SHIOZAKI.\"
409829d36aSTakuya SHIOZAKI.\" $FreeBSD$
419829d36aSTakuya SHIOZAKI.\"
429829d36aSTakuya SHIOZAKI.Dd December 22, 2000
439829d36aSTakuya SHIOZAKI.Dt WMEMCHR 3
449829d36aSTakuya SHIOZAKI.Os
459829d36aSTakuya SHIOZAKI.Sh NAME
469829d36aSTakuya SHIOZAKI.Nm wmemchr ,
479829d36aSTakuya SHIOZAKI.Nm wmemcmp ,
489829d36aSTakuya SHIOZAKI.Nm wmemcpy ,
499829d36aSTakuya SHIOZAKI.Nm wmemmove ,
509829d36aSTakuya SHIOZAKI.Nm wmemset ,
519829d36aSTakuya SHIOZAKI.Nm wcscat ,
529829d36aSTakuya SHIOZAKI.Nm wcschr ,
539829d36aSTakuya SHIOZAKI.Nm wcscmp ,
549829d36aSTakuya SHIOZAKI.Nm wcscpy ,
559829d36aSTakuya SHIOZAKI.Nm wcscspn ,
569829d36aSTakuya SHIOZAKI.Nm wcslcat ,
579829d36aSTakuya SHIOZAKI.Nm wcslcpy ,
589829d36aSTakuya SHIOZAKI.Nm wcslen ,
599829d36aSTakuya SHIOZAKI.Nm wcsncat ,
609829d36aSTakuya SHIOZAKI.Nm wcsncmp ,
619829d36aSTakuya SHIOZAKI.Nm wcsncpy ,
629829d36aSTakuya SHIOZAKI.Nm wcspbrk ,
639829d36aSTakuya SHIOZAKI.Nm wcsrchr ,
649829d36aSTakuya SHIOZAKI.Nm wcsspn ,
659829d36aSTakuya SHIOZAKI.Nm wcsstr
669829d36aSTakuya SHIOZAKI.Nd wide character string manipulation operations
679829d36aSTakuya SHIOZAKI.Sh LIBRARY
689829d36aSTakuya SHIOZAKI.Lb libc
699829d36aSTakuya SHIOZAKI.Sh SYNOPSIS
709829d36aSTakuya SHIOZAKI.Fd #include <wchar.h>
719829d36aSTakuya SHIOZAKI.Ft wchar_t *
729829d36aSTakuya SHIOZAKI.Fn wmemchr "const wchar_t *s" "wchar_t c" "size_t n"
739829d36aSTakuya SHIOZAKI.Ft int
749829d36aSTakuya SHIOZAKI.Fn wmemcmp "const wchar_t *s1" "const wchar_t *s2" "size_t n"
759829d36aSTakuya SHIOZAKI.Ft wchar_t *
769829d36aSTakuya SHIOZAKI.Fn wmemcpy "wchar_t * restrict s1" "const wchar_t * restrict s2" "size_t n"
779829d36aSTakuya SHIOZAKI.Ft wchar_t *
789829d36aSTakuya SHIOZAKI.Fn wmemmove "wchar_t *s1" "const wchar_t *s2" "size_t n"
799829d36aSTakuya SHIOZAKI.Ft wchar_t *
809829d36aSTakuya SHIOZAKI.Fn wmemset "wchar_t *s" "wchar_t c" "size_t n"
819829d36aSTakuya SHIOZAKI.Ft wchar_t *
829829d36aSTakuya SHIOZAKI.Fn wcscat "wchar_t * restrict s1" "const wchar_t * restrict s2"
839829d36aSTakuya SHIOZAKI.Ft wchar_t *
849829d36aSTakuya SHIOZAKI.Fn wcschr "const wchar_t *s" "wchar_t c"
859829d36aSTakuya SHIOZAKI.Ft int
869829d36aSTakuya SHIOZAKI.Fn wcscmp "const wchar_t *s1" "const wchar_t *s2"
879829d36aSTakuya SHIOZAKI.Ft wchar_t *
889829d36aSTakuya SHIOZAKI.Fn wcscpy "wchar_t * restrict s1" "const wchar_t * restrict s2"
899829d36aSTakuya SHIOZAKI.Ft size_t
909829d36aSTakuya SHIOZAKI.Fn wcscspn "const wchar_t *s1" "const wchar_t *s2"
919829d36aSTakuya SHIOZAKI.Ft size_t
929829d36aSTakuya SHIOZAKI.Fn wcslcat "wchar_t *s1" "const wchar_t *s2" "size_t n"
939829d36aSTakuya SHIOZAKI.Ft size_t
949829d36aSTakuya SHIOZAKI.Fn wcslcpy "wchar_t *s1" "const wchar_t *s2" "size_t n"
959829d36aSTakuya SHIOZAKI.Ft size_t
969829d36aSTakuya SHIOZAKI.Fn wcslen "const wchar_t *s"
979829d36aSTakuya SHIOZAKI.Ft wchar_t *
989829d36aSTakuya SHIOZAKI.Fn wcsncat "wchar_t * restrict s1" "const wchar_t * restrict s2" "size_t n"
999829d36aSTakuya SHIOZAKI.Ft int
1009829d36aSTakuya SHIOZAKI.Fn wcsncmp "const wchar_t *s1" "const wchar_t * s2" "size_t n"
1019829d36aSTakuya SHIOZAKI.Ft wchar_t *
1029829d36aSTakuya SHIOZAKI.Fn wcsncpy "wchar_t * restrict s1" "const wchar_t * restrict s2" "size_t n"
1039829d36aSTakuya SHIOZAKI.Ft wchar_t *
1049829d36aSTakuya SHIOZAKI.Fn wcspbrk "const wchar_t *s1" "const wchar_t *s2"
1059829d36aSTakuya SHIOZAKI.Ft wchar_t *
1069829d36aSTakuya SHIOZAKI.Fn wcsrchr "const wchar_t *s" "wchar_t c"
1079829d36aSTakuya SHIOZAKI.Ft size_t
1089829d36aSTakuya SHIOZAKI.Fn wcsspn "const wchar_t *s1" "const wchar_t *s2"
1099829d36aSTakuya SHIOZAKI.Ft wchar_t *
1109829d36aSTakuya SHIOZAKI.Fn wcsstr "const wchar_t *s1" "const wchar_t *s2"
1119829d36aSTakuya SHIOZAKI.Sh DESCRIPTION
1129829d36aSTakuya SHIOZAKIThe functions implement string manipulation operations over wide character
1139829d36aSTakuya SHIOZAKIstrings.
1149829d36aSTakuya SHIOZAKIFor a detailed description, refer to documents for the respective single-byte
1159829d36aSTakuya SHIOZAKIcounterpart, such as
1169829d36aSTakuya SHIOZAKI.Xr memchr 3 .
1179829d36aSTakuya SHIOZAKI.Sh SEE ALSO
1189829d36aSTakuya SHIOZAKI.Xr memchr 3 ,
1199829d36aSTakuya SHIOZAKI.Xr memcmp 3 ,
1209829d36aSTakuya SHIOZAKI.Xr memcpy 3 ,
1219829d36aSTakuya SHIOZAKI.Xr memmove 3 ,
1229829d36aSTakuya SHIOZAKI.Xr memset 3 ,
1239829d36aSTakuya SHIOZAKI.Xr strcat 3 ,
1249829d36aSTakuya SHIOZAKI.Xr strchr 3 ,
1259829d36aSTakuya SHIOZAKI.Xr strcmp 3 ,
1269829d36aSTakuya SHIOZAKI.Xr strcpy 3 ,
1279829d36aSTakuya SHIOZAKI.Xr strcspn 3 ,
1289829d36aSTakuya SHIOZAKI.Xr strlcat 3 ,
1299829d36aSTakuya SHIOZAKI.Xr strlcpy 3 ,
1309829d36aSTakuya SHIOZAKI.Xr strlen 3 ,
1319829d36aSTakuya SHIOZAKI.Xr strncat 3 ,
1329829d36aSTakuya SHIOZAKI.Xr strncmp 3 ,
1339829d36aSTakuya SHIOZAKI.Xr strncpy 3 ,
1349829d36aSTakuya SHIOZAKI.Xr strpbrk 3 ,
1359829d36aSTakuya SHIOZAKI.Xr strrchr 3 ,
1369829d36aSTakuya SHIOZAKI.Xr strspn 3 ,
1379829d36aSTakuya SHIOZAKI.Xr strstr 3
1389829d36aSTakuya SHIOZAKI.Sh STANDARDS
1399829d36aSTakuya SHIOZAKIThese functions conform to
1409829d36aSTakuya SHIOZAKI.St -isoC99
1419829d36aSTakuya SHIOZAKIand were first introduced in
1429829d36aSTakuya SHIOZAKI.St -isoC-amd1 ,
1439829d36aSTakuya SHIOZAKIwith the exception of
1449829d36aSTakuya SHIOZAKI.Fn wcslcat
1459829d36aSTakuya SHIOZAKIand
1469829d36aSTakuya SHIOZAKI.Fn wcslcpy ,
1479829d36aSTakuya SHIOZAKIwhich are extensions.
148