1.\" $MirOS: src/lib/libc/string/wmemchr.3,v 1.5 2014/02/09 23:19:58 tg Exp $ 2.\" $OpenBSD: wmemchr.3,v 1.2 2005/04/13 20:42:48 jmc Exp $ 3.\" 4.\" $NetBSD: wmemchr.3,v 1.9 2003/09/08 17:54:33 wiz Exp $ 5.\" 6.\" Copyright (c) 1990, 1991, 1993 7.\" The Regents of the University of California. All rights reserved. 8.\" 9.\" This code is derived from software contributed to Berkeley by 10.\" Chris Torek and the American National Standards Committee X3, 11.\" on Information Processing Systems. 12.\" 13.\" Redistribution and use in source and binary forms, with or without 14.\" modification, are permitted provided that the following conditions 15.\" are met: 16.\" 1. Redistributions of source code must retain the above copyright 17.\" notice, this list of conditions and the following disclaimer. 18.\" 2. Redistributions in binary form must reproduce the above copyright 19.\" notice, this list of conditions and the following disclaimer in the 20.\" documentation and/or other materials provided with the distribution. 21.\" 3. Neither the name of the University nor the names of its contributors 22.\" may be used to endorse or promote products derived from this software 23.\" without specific prior written permission. 24.\" 25.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 26.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 27.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 28.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 29.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 30.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 31.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 32.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 33.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 34.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 35.\" SUCH DAMAGE. 36.\" 37.\" from: @(#)strcpy.3 8.1 (Berkeley) 6/4/93 38.\" 39.Dd $Mdocdate: February 9 2014 $ 40.Dt WMEMCHR 3 41.Os 42.Sh NAME 43.Nm wcscasecmp , 44.Nm wcscat , 45.Nm wcschr , 46.Nm wcscmp , 47.Nm wcscoll , 48.Nm wcscpy , 49.Nm wcscspn , 50.Nm wcsdup , 51.Nm wcsftime , 52.Nm wcslcat , 53.Nm wcslcpy , 54.Nm wcslen , 55.Nm wcsncasecmp , 56.Nm wcsncat , 57.Nm wcsncmp , 58.Nm wcsncpy , 59.Nm wcsndup , 60.Nm wcspbrk , 61.Nm wcsrchr , 62.Nm wcsspn , 63.Nm wcsstr , 64.Nm wcstod , 65.Nm wcstof , 66.Nm wcstol , 67.Nm wcstoll , 68.Nm wcstoul , 69.Nm wcstoull , 70.Nm wcswcs , 71.Nm wcsxfrm , 72.Nm wmemchr , 73.Nm wmemcmp , 74.Nm wmemcpy , 75.Nm wmemmove , 76.Nm wmemset 77.Nd wide character string manipulation operations 78.Sh SYNOPSIS 79.In wchar.h 80.Ft int 81.Fn wcscasecmp "const wchar_t *" "const wchar_t *" 82.Ft wchar_t * 83.Fn wcscat "wchar_t *s1" "const wchar_t *s2" 84.Ft wchar_t * 85.Fn wcschr "const wchar_t *s" "wchar_t c" 86.Ft int 87.Fn wcscmp "const wchar_t *s1" "const wchar_t *s2" 88.Ft int 89.Fn wcscoll "const wchar_t *" "const wchar_t *" 90.Ft wchar_t * 91.Fn wcscpy "wchar_t *s1" "const wchar_t *s2" 92.Ft size_t 93.Fn wcscspn "const wchar_t *s1" "const wchar_t *s2" 94.Ft wchar_t * 95.Fn wcsdup "const wchar_t *" 96.Ft size_t 97.Fn wcsftime "wchar_t *" "size_t" "const wchar_t *" "const struct tm *" 98.Ft size_t 99.Fn wcslcat "wchar_t *s1" "const wchar_t *s2" "size_t n" 100.Ft size_t 101.Fn wcslcpy "wchar_t *s1" "const wchar_t *s2" "size_t n" 102.Ft size_t 103.Fn wcslen "const wchar_t *s" 104.Ft int 105.Fn wcsncasecmp "const wchar_t *" "const wchar_t *" "size_t" 106.Ft wchar_t * 107.Fn wcsncat "wchar_t *s1" "const wchar_t *s2" "size_t n" 108.Ft int 109.Fn wcsncmp "const wchar_t *s1" "const wchar_t * s2" "size_t n" 110.Ft wchar_t * 111.Fn wcsncpy "wchar_t *s1" "const wchar_t *s2" "size_t n" 112.Ft wchar_t * 113.Fn wcsndup "const wchar_t *" "size_t" 114.Ft wchar_t * 115.Fn wcspbrk "const wchar_t *s1" "const wchar_t *s2" 116.Ft wchar_t * 117.Fn wcsrchr "const wchar_t *s" "wchar_t c" 118.Ft size_t 119.Fn wcsspn "const wchar_t *s1" "const wchar_t *s2" 120.Ft wchar_t * 121.Fn wcsstr "const wchar_t *s1" "const wchar_t *s2" 122.Ft double 123.Fn wcstod "const wchar_t *" "wchar_t **" 124.Ft float 125.Fn wcstof "const wchar_t *" "wchar_t **" 126.Ft long 127.Fn wcstol "const wchar_t *" "wchar_t **" "int" 128.Ft long long 129.Fn wcstoll "const wchar_t *" "wchar_t **" "int" 130.Ft unsigned long 131.Fn wcstoul "const wchar_t *" "wchar_t **" "int" 132.Ft unsigned long long 133.Fn wcstoull "const wchar_t *" "wchar_t **" "int" 134.Ft wchar_t * 135.Fn wcswcs "const wchar_t *" "const wchar_t *" 136.Ft size_t 137.Fn wcsxfrm "wchar_t *" "const wchar_t *" "size_t" 138.Ft wchar_t * 139.Fn wmemchr "const wchar_t *s" "wchar_t c" "size_t n" 140.Ft int 141.Fn wmemcmp "const wchar_t *s1" "const wchar_t *s2" "size_t n" 142.Ft wchar_t * 143.Fn wmemcpy "wchar_t *s1" "const wchar_t *s2" "size_t n" 144.Ft wchar_t * 145.Fn wmemmove "wchar_t *s1" "const wchar_t *s2" "size_t n" 146.Ft wchar_t * 147.Fn wmemset "wchar_t *s" "wchar_t c" "size_t n" 148.Sh DESCRIPTION 149These functions implement string manipulation operations over wide character 150strings. 151For a detailed description, refer to documents for the respective single-byte 152counterpart, such as 153.Xr memchr 3 . 154.Sh SEE ALSO 155.Xr memchr 3 , 156.Xr memcmp 3 , 157.Xr memcpy 3 , 158.Xr memmove 3 , 159.Xr memset 3 , 160.Xr strcasecmp 3 , 161.Xr strcat 3 , 162.Xr strchr 3 , 163.Xr strcmp 3 , 164.Xr strcoll 3 , 165.Xr strcpy 3 , 166.Xr strcspn 3 , 167.Xr strdup 3 , 168.Xr strftime 3 , 169.Xr strlcat 3 , 170.Xr strlcpy 3 , 171.Xr strlen 3 , 172.Xr strncasecmp 3 , 173.Xr strncat 3 , 174.Xr strncmp 3 , 175.Xr strncpy 3 , 176.Xr strndup 3 , 177.Xr strpbrk 3 , 178.Xr strrchr 3 , 179.Xr strspn 3 , 180.Xr strstr 3 , 181.Xr strtod 3 , 182.Xr strtol 3 , 183.Xr strtoll 3 , 184.Xr strtoul 3 , 185.Xr strtoull 3 , 186.Xr strxfrm 3 187.Sh STANDARDS 188These functions conform to 189.St -isoC-99 190and were first introduced in 191.St -isoC-amd1 , 192with the exception of 193.Fn wcslcat 194and 195.Fn wcslcpy , 196which are BSD extensions, and 197.Fn wcsndup , 198which is a GNU extension. 199.Pp 200.Fn wcswcs 201is a historic name for 202.Fn wcsstr , 203programmers are urged to not use it in new code. 204.Pp 205.Fn wcstof 206is a less-precise version of 207.Fn wcstod . 208