po4a/wchar/po/wchar.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2012-04-25 05:37+0900\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=CHARSET\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: build/C/man3/btowc.3:14
  21 #, no-wrap
  22 msgid "BTOWC"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man3/btowc.3:14 build/C/man3/wctob.3:14
  27 #, no-wrap
  28 msgid "2011-09-22"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man3/btowc.3:14 build/C/man3/fgetws.3:16 build/C/man3/fputws.3:14 build/C/man3/fwide.3:14 build/C/man3/getwchar.3:15 build/C/man3/mbrlen.3:14 build/C/man3/mbrtowc.3:15 build/C/man3/mbsinit.3:14 build/C/man3/mbsnrtowcs.3:13 build/C/man3/mbsrtowcs.3:14 build/C/man3/putwchar.3:15 build/C/man3/ungetwc.3:14 build/C/man3/wcpcpy.3:13 build/C/man3/wcpncpy.3:13 build/C/man3/wcrtomb.3:14 build/C/man3/wcscasecmp.3:13 build/C/man3/wcscat.3:14 build/C/man3/wcschr.3:14 build/C/man3/wcscmp.3:14 build/C/man3/wcscpy.3:14 build/C/man3/wcscspn.3:14 build/C/man3/wcsdup.3:13 build/C/man3/wcslen.3:14 build/C/man3/wcsncasecmp.3:13 build/C/man3/wcsncat.3:14 build/C/man3/wcsncmp.3:14 build/C/man3/wcsncpy.3:14 build/C/man3/wcsnlen.3:13 build/C/man3/wcsnrtombs.3:13 build/C/man3/wcspbrk.3:14 build/C/man3/wcsrchr.3:14 build/C/man3/wcsrtombs.3:14 build/C/man3/wcsspn.3:14 build/C/man3/wcsstr.3:14 build/C/man3/wcstok.3:14 build/C/man3/wcswidth.3:13 build/C/man3/wctob.3:14 build/C/man3/wcwidth.3:13 build/C/man3/wmemchr.3:14 build/C/man3/wmemcmp.3:13 build/C/man3/wmemcpy.3:14 build/C/man3/wmemmove.3:14 build/C/man3/wmemset.3:14
  33 #, no-wrap
  34 msgid "GNU"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man3/btowc.3:14 build/C/man3/fgetws.3:16 build/C/man3/fputws.3:14 build/C/man3/fwide.3:14 build/C/man3/getwchar.3:15 build/C/man3/mbrlen.3:14 build/C/man3/mbrtowc.3:15 build/C/man3/mbsinit.3:14 build/C/man3/mbsnrtowcs.3:13 build/C/man3/mbsrtowcs.3:14 build/C/man3/putwchar.3:15 build/C/man3/ungetwc.3:14 build/C/man3/wcpcpy.3:13 build/C/man3/wcpncpy.3:13 build/C/man3/wcrtomb.3:14 build/C/man3/wcscasecmp.3:13 build/C/man3/wcscat.3:14 build/C/man3/wcschr.3:14 build/C/man3/wcscmp.3:14 build/C/man3/wcscpy.3:14 build/C/man3/wcscspn.3:14 build/C/man3/wcsdup.3:13 build/C/man3/wcslen.3:14 build/C/man3/wcsncasecmp.3:13 build/C/man3/wcsncat.3:14 build/C/man3/wcsncmp.3:14 build/C/man3/wcsncpy.3:14 build/C/man3/wcsnlen.3:13 build/C/man3/wcsnrtombs.3:13 build/C/man3/wcspbrk.3:14 build/C/man3/wcsrchr.3:14 build/C/man3/wcsrtombs.3:14 build/C/man3/wcsspn.3:14 build/C/man3/wcsstr.3:14 build/C/man3/wcstoimax.3:23 build/C/man3/wcstok.3:14 build/C/man3/wcswidth.3:13 build/C/man3/wctob.3:14 build/C/man3/wcwidth.3:13 build/C/man3/wmemchr.3:14 build/C/man3/wmemcmp.3:13 build/C/man3/wmemcpy.3:14 build/C/man3/wmemmove.3:14 build/C/man3/wmemset.3:14
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man3/btowc.3:15 build/C/man3/fgetws.3:17 build/C/man3/fputws.3:15 build/C/man3/fwide.3:15 build/C/man3/getwchar.3:16 build/C/man3/mbrlen.3:15 build/C/man3/mbrtowc.3:16 build/C/man3/mbsinit.3:15 build/C/man3/mbsnrtowcs.3:14 build/C/man3/mbsrtowcs.3:15 build/C/man3/putwchar.3:16 build/C/man3/ungetwc.3:15 build/C/man3/wcpcpy.3:14 build/C/man3/wcpncpy.3:14 build/C/man3/wcrtomb.3:15 build/C/man3/wcscasecmp.3:14 build/C/man3/wcscat.3:15 build/C/man3/wcschr.3:15 build/C/man3/wcscmp.3:15 build/C/man3/wcscpy.3:15 build/C/man3/wcscspn.3:15 build/C/man3/wcsdup.3:14 build/C/man3/wcslen.3:15 build/C/man3/wcsncasecmp.3:14 build/C/man3/wcsncat.3:15 build/C/man3/wcsncmp.3:15 build/C/man3/wcsncpy.3:15 build/C/man3/wcsnlen.3:14 build/C/man3/wcsnrtombs.3:14 build/C/man3/wcspbrk.3:15 build/C/man3/wcsrchr.3:15 build/C/man3/wcsrtombs.3:15 build/C/man3/wcsspn.3:15 build/C/man3/wcsstr.3:15 build/C/man3/wcstoimax.3:24 build/C/man3/wcstok.3:15 build/C/man3/wcswidth.3:14 build/C/man3/wctob.3:15 build/C/man3/wcwidth.3:14 build/C/man3/wmemchr.3:15 build/C/man3/wmemcmp.3:14 build/C/man3/wmemcpy.3:15 build/C/man3/wmemmove.3:15 build/C/man3/wmemset.3:15
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man3/btowc.3:17
  51 msgid "btowc - convert single byte to wide character"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man3/btowc.3:17 build/C/man3/fgetws.3:19 build/C/man3/fputws.3:17 build/C/man3/fwide.3:17 build/C/man3/getwchar.3:18 build/C/man3/mbrlen.3:17 build/C/man3/mbrtowc.3:18 build/C/man3/mbsinit.3:17 build/C/man3/mbsnrtowcs.3:16 build/C/man3/mbsrtowcs.3:17 build/C/man3/putwchar.3:18 build/C/man3/ungetwc.3:17 build/C/man3/wcpcpy.3:16 build/C/man3/wcpncpy.3:17 build/C/man3/wcrtomb.3:17 build/C/man3/wcscasecmp.3:16 build/C/man3/wcscat.3:17 build/C/man3/wcschr.3:17 build/C/man3/wcscmp.3:17 build/C/man3/wcscpy.3:17 build/C/man3/wcscspn.3:17 build/C/man3/wcsdup.3:16 build/C/man3/wcslen.3:17 build/C/man3/wcsncasecmp.3:16 build/C/man3/wcsncat.3:17 build/C/man3/wcsncmp.3:17 build/C/man3/wcsncpy.3:17 build/C/man3/wcsnlen.3:16 build/C/man3/wcsnrtombs.3:16 build/C/man3/wcspbrk.3:17 build/C/man3/wcsrchr.3:17 build/C/man3/wcsrtombs.3:17 build/C/man3/wcsspn.3:18 build/C/man3/wcsstr.3:17 build/C/man3/wcstoimax.3:26 build/C/man3/wcstok.3:17 build/C/man3/wcswidth.3:16 build/C/man3/wctob.3:17 build/C/man3/wcwidth.3:16 build/C/man3/wmemchr.3:17 build/C/man3/wmemcmp.3:16 build/C/man3/wmemcpy.3:17 build/C/man3/wmemmove.3:17 build/C/man3/wmemset.3:17
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man3/btowc.3:20 build/C/man3/fgetws.3:22 build/C/man3/fputws.3:20 build/C/man3/fwide.3:20 build/C/man3/getwchar.3:21 build/C/man3/mbrlen.3:20 build/C/man3/mbrtowc.3:21 build/C/man3/mbsinit.3:20 build/C/man3/mbsnrtowcs.3:19 build/C/man3/mbsrtowcs.3:20 build/C/man3/putwchar.3:21 build/C/man3/ungetwc.3:20 build/C/man3/wcpcpy.3:19 build/C/man3/wcpncpy.3:20 build/C/man3/wcrtomb.3:20 build/C/man3/wcscasecmp.3:19 build/C/man3/wcscat.3:20 build/C/man3/wcschr.3:20 build/C/man3/wcscmp.3:20 build/C/man3/wcscpy.3:20 build/C/man3/wcscspn.3:20 build/C/man3/wcsdup.3:19 build/C/man3/wcslen.3:20 build/C/man3/wcsncasecmp.3:19 build/C/man3/wcsncat.3:20 build/C/man3/wcsncmp.3:20 build/C/man3/wcsncpy.3:20 build/C/man3/wcsnlen.3:19 build/C/man3/wcsnrtombs.3:19 build/C/man3/wcspbrk.3:20 build/C/man3/wcsrchr.3:20 build/C/man3/wcsrtombs.3:20 build/C/man3/wcsspn.3:21 build/C/man3/wcsstr.3:20 build/C/man3/wcstok.3:20 build/C/man3/wctob.3:20 build/C/man3/wmemchr.3:20 build/C/man3/wmemcmp.3:19 build/C/man3/wmemcpy.3:20 build/C/man3/wmemmove.3:20 build/C/man3/wmemset.3:20
  62 #, no-wrap
  63 msgid "B<#include E<lt>wchar.hE<gt>>\n"
  64 msgstr ""
  65
  66 #. type: Plain text
  67 #: build/C/man3/btowc.3:22
  68 #, no-wrap
  69 msgid "B<wint_t btowc(int >I<c>B<);>\n"
  70 msgstr ""
  71
  72 #. type: SH
  73 #: build/C/man3/btowc.3:23 build/C/man3/fgetws.3:25 build/C/man3/fputws.3:23 build/C/man3/fwide.3:42 build/C/man3/getwchar.3:24 build/C/man3/mbrlen.3:23 build/C/man3/mbrtowc.3:25 build/C/man3/mbsinit.3:23 build/C/man3/mbsnrtowcs.3:42 build/C/man3/mbsrtowcs.3:24 build/C/man3/putwchar.3:24 build/C/man3/ungetwc.3:23 build/C/man3/wcpcpy.3:41 build/C/man3/wcpncpy.3:42 build/C/man3/wcrtomb.3:23 build/C/man3/wcscasecmp.3:41 build/C/man3/wcscat.3:23 build/C/man3/wcschr.3:23 build/C/man3/wcscmp.3:23 build/C/man3/wcscpy.3:23 build/C/man3/wcscspn.3:23 build/C/man3/wcsdup.3:41 build/C/man3/wcslen.3:23 build/C/man3/wcsncasecmp.3:41 build/C/man3/wcsncat.3:23 build/C/man3/wcsncmp.3:23 build/C/man3/wcsncpy.3:23 build/C/man3/wcsnlen.3:41 build/C/man3/wcsnrtombs.3:42 build/C/man3/wcspbrk.3:23 build/C/man3/wcsrchr.3:23 build/C/man3/wcsrtombs.3:24 build/C/man3/wcsspn.3:24 build/C/man3/wcsstr.3:23 build/C/man3/wcstoimax.3:38 build/C/man3/wcstok.3:24 build/C/man3/wcswidth.3:23 build/C/man3/wctob.3:23 build/C/man3/wcwidth.3:23 build/C/man3/wmemchr.3:23 build/C/man3/wmemcmp.3:22 build/C/man3/wmemcpy.3:23 build/C/man3/wmemmove.3:23 build/C/man3/wmemset.3:23
  74 #, no-wrap
  75 msgid "DESCRIPTION"
  76 msgstr ""
  77
  78 #. type: Plain text
  79 #: build/C/man3/btowc.3:37
  80 msgid ""
  81 "The B<btowc>()  function converts I<c>, interpreted as a multibyte sequence "
  82 "of length 1, starting in the initial shift state, to a wide character and "
  83 "returns it.  If I<c> is B<EOF> or not a valid multibyte sequence of length "
  84 "1, the B<btowc>()  function returns B<WEOF>."
  85 msgstr ""
  86
  87 #. type: SH
  88 #: build/C/man3/btowc.3:37 build/C/man3/fgetws.3:44 build/C/man3/fputws.3:35 build/C/man3/fwide.3:69 build/C/man3/getwchar.3:41 build/C/man3/mbrlen.3:54 build/C/man3/mbrtowc.3:88 build/C/man3/mbsinit.3:69 build/C/man3/mbsnrtowcs.3:101 build/C/man3/mbsrtowcs.3:74 build/C/man3/putwchar.3:40 build/C/man3/ungetwc.3:48 build/C/man3/wcpcpy.3:57 build/C/man3/wcpncpy.3:66 build/C/man3/wcrtomb.3:67 build/C/man3/wcscasecmp.3:52 build/C/man3/wcscat.3:38 build/C/man3/wcschr.3:32 build/C/man3/wcscmp.3:32 build/C/man3/wcscpy.3:40 build/C/man3/wcscspn.3:36 build/C/man3/wcsdup.3:56 build/C/man3/wcslen.3:32 build/C/man3/wcsncasecmp.3:53 build/C/man3/wcsncat.3:37 build/C/man3/wcsncmp.3:34 build/C/man3/wcsncpy.3:47 build/C/man3/wcsnlen.3:57 build/C/man3/wcsnrtombs.3:104 build/C/man3/wcspbrk.3:34 build/C/man3/wcsrchr.3:32 build/C/man3/wcsrtombs.3:79 build/C/man3/wcsspn.3:36 build/C/man3/wcsstr.3:32 build/C/man3/wcstok.3:55 build/C/man3/wcswidth.3:32 build/C/man3/wctob.3:38 build/C/man3/wcwidth.3:32 build/C/man3/wmemchr.3:31 build/C/man3/wmemcmp.3:30 build/C/man3/wmemcpy.3:39 build/C/man3/wmemmove.3:36 build/C/man3/wmemset.3:31
  89 #, no-wrap
  90 msgid "RETURN VALUE"
  91 msgstr ""
  92
  93 #. type: Plain text
  94 #: build/C/man3/btowc.3:47
  95 msgid ""
  96 "The B<btowc>()  function returns the wide character converted from the "
  97 "single byte I<c>.  If I<c> is B<EOF> or not a valid multibyte sequence of "
  98 "length 1, it returns B<WEOF>."
  99 msgstr ""
 100
 101 #. type: SH
 102 #: build/C/man3/btowc.3:47 build/C/man3/fgetws.3:50 build/C/man3/fputws.3:41 build/C/man3/fwide.3:77 build/C/man3/getwchar.3:47 build/C/man3/mbrlen.3:67 build/C/man3/mbrtowc.3:101 build/C/man3/mbsinit.3:74 build/C/man3/mbsnrtowcs.3:111 build/C/man3/mbsrtowcs.3:84 build/C/man3/putwchar.3:46 build/C/man3/ungetwc.3:53 build/C/man3/wcpcpy.3:61 build/C/man3/wcpncpy.3:70 build/C/man3/wcrtomb.3:77 build/C/man3/wcscasecmp.3:66 build/C/man3/wcscat.3:41 build/C/man3/wcschr.3:38 build/C/man3/wcscmp.3:43 build/C/man3/wcscpy.3:43 build/C/man3/wcscspn.3:48 build/C/man3/wcsdup.3:66 build/C/man3/wcslen.3:37 build/C/man3/wcsncasecmp.3:69 build/C/man3/wcsncat.3:40 build/C/man3/wcsncmp.3:46 build/C/man3/wcsncpy.3:50 build/C/man3/wcsnlen.3:67 build/C/man3/wcsnrtombs.3:115 build/C/man3/wcspbrk.3:41 build/C/man3/wcsrchr.3:38 build/C/man3/wcsrtombs.3:92 build/C/man3/wcsspn.3:47 build/C/man3/wcsstr.3:43 build/C/man3/wcstoimax.3:48 build/C/man3/wcstok.3:60 build/C/man3/wcswidth.3:38 build/C/man3/wctob.3:43 build/C/man3/wcwidth.3:37 build/C/man3/wmemchr.3:37 build/C/man3/wmemcmp.3:44 build/C/man3/wmemcpy.3:42 build/C/man3/wmemmove.3:39 build/C/man3/wmemset.3:34
 103 #, no-wrap
 104 msgid "CONFORMING TO"
 105 msgstr ""
 106
 107 #. type: Plain text
 108 #: build/C/man3/btowc.3:49 build/C/man3/fgetws.3:52 build/C/man3/fputws.3:43 build/C/man3/fwide.3:79
 109 msgid "C99, POSIX.1-2001."
 110 msgstr ""
 111
 112 #. type: SH
 113 #: build/C/man3/btowc.3:49 build/C/man3/fgetws.3:52 build/C/man3/fputws.3:43 build/C/man3/fwide.3:79 build/C/man3/getwchar.3:49 build/C/man3/mbrlen.3:69 build/C/man3/mbrtowc.3:103 build/C/man3/mbsinit.3:76 build/C/man3/mbsnrtowcs.3:113 build/C/man3/mbsrtowcs.3:86 build/C/man3/putwchar.3:48 build/C/man3/ungetwc.3:55 build/C/man3/wcrtomb.3:79 build/C/man3/wcscasecmp.3:70 build/C/man3/wcsncasecmp.3:73 build/C/man3/wcsnrtombs.3:117 build/C/man3/wcsrtombs.3:94 build/C/man3/wcstok.3:62 build/C/man3/wcswidth.3:40 build/C/man3/wctob.3:45 build/C/man3/wcwidth.3:45
 114 #, no-wrap
 115 msgid "NOTES"
 116 msgstr ""
 117
 118 #. type: Plain text
 119 #: build/C/man3/btowc.3:56
 120 msgid ""
 121 "The behavior of B<btowc>()  depends on the B<LC_CTYPE> category of the "
 122 "current locale."
 123 msgstr ""
 124
 125 #. type: Plain text
 126 #: build/C/man3/btowc.3:66
 127 msgid ""
 128 "This function should never be used.  It does not work for encodings which "
 129 "have state, and unnecessarily treats single bytes differently from multibyte "
 130 "sequences.  Use either B<mbtowc>(3)  or the thread-safe B<mbrtowc>(3)  "
 131 "instead."
 132 msgstr ""
 133
 134 #. type: SH
 135 #: build/C/man3/btowc.3:66 build/C/man3/fgetws.3:71 build/C/man3/fputws.3:58 build/C/man3/fwide.3:96 build/C/man3/getwchar.3:62 build/C/man3/mbrlen.3:76 build/C/man3/mbrtowc.3:110 build/C/man3/mbsinit.3:83 build/C/man3/mbsnrtowcs.3:122 build/C/man3/mbsrtowcs.3:95 build/C/man3/putwchar.3:60 build/C/man3/ungetwc.3:62 build/C/man3/wcpcpy.3:63 build/C/man3/wcpncpy.3:72 build/C/man3/wcrtomb.3:88 build/C/man3/wcscasecmp.3:77 build/C/man3/wcscat.3:43 build/C/man3/wcschr.3:40 build/C/man3/wcscmp.3:45 build/C/man3/wcscpy.3:45 build/C/man3/wcscspn.3:50 build/C/man3/wcsdup.3:71 build/C/man3/wcslen.3:39 build/C/man3/wcsncasecmp.3:80 build/C/man3/wcsncat.3:42 build/C/man3/wcsncmp.3:48 build/C/man3/wcsncpy.3:52 build/C/man3/wcsnlen.3:69 build/C/man3/wcsnrtombs.3:126 build/C/man3/wcspbrk.3:43 build/C/man3/wcsrchr.3:40 build/C/man3/wcsrtombs.3:103 build/C/man3/wcsspn.3:49 build/C/man3/wcsstr.3:45 build/C/man3/wcstoimax.3:50 build/C/man3/wcstok.3:78 build/C/man3/wcswidth.3:47 build/C/man3/wctob.3:61 build/C/man3/wcwidth.3:52 build/C/man3/wmemchr.3:39 build/C/man3/wmemcmp.3:46 build/C/man3/wmemcpy.3:44 build/C/man3/wmemmove.3:41 build/C/man3/wmemset.3:36
 136 #, no-wrap
 137 msgid "SEE ALSO"
 138 msgstr ""
 139
 140 #. type: Plain text
 141 #: build/C/man3/btowc.3:69
 142 msgid "B<mbrtowc>(3), B<mbtowc>(3), B<wctob>(3)"
 143 msgstr ""
 144
 145 #. type: TH
 146 #: build/C/man3/fgetws.3:16
 147 #, no-wrap
 148 msgid "FGETWS"
 149 msgstr ""
 150
 151 #. type: TH
 152 #: build/C/man3/fgetws.3:16 build/C/man3/fputws.3:14 build/C/man3/mbrtowc.3:15 build/C/man3/mbsrtowcs.3:14 build/C/man3/wcrtomb.3:14 build/C/man3/wcscat.3:14 build/C/man3/wcscpy.3:14 build/C/man3/wcslen.3:14 build/C/man3/wcsncat.3:14 build/C/man3/wcsncmp.3:14 build/C/man3/wcsncpy.3:14 build/C/man3/wcsstr.3:14 build/C/man3/wcstok.3:14 build/C/man3/wcwidth.3:13
 153 #, no-wrap
 154 msgid "2011-09-28"
 155 msgstr ""
 156
 157 #. type: Plain text
 158 #: build/C/man3/fgetws.3:19
 159 msgid "fgetws - read a wide-character string from a FILE stream"
 160 msgstr ""
 161
 162 #. type: Plain text
 163 #: build/C/man3/fgetws.3:24
 164 #, no-wrap
 165 msgid "B<wchar_t *fgetws(wchar_t *>I<ws>B<, int >I<n>B<, FILE *>I<stream>B<);>\n"
 166 msgstr ""
 167
 168 #. type: Plain text
 169 #: build/C/man3/fgetws.3:38
 170 msgid ""
 171 "The B<fgetws>()  function is the wide-character equivalent of the "
 172 "B<fgets>(3)  function.  It reads a string of at most I<n-1> wide characters "
 173 "into the wide-character array pointed to by I<ws>, and adds a terminating "
 174 "null wide character (L\\(aq\\e0\\(aq).  It stops reading wide characters "
 175 "after it has encountered and stored a newline wide character.  It also stops "
 176 "when end of stream is reached."
 177 msgstr ""
 178
 179 #. type: Plain text
 180 #: build/C/man3/fgetws.3:41
 181 msgid ""
 182 "The programmer must ensure that there is room for at least I<n> wide "
 183 "characters at I<ws>."
 184 msgstr ""
 185
 186 #. type: Plain text
 187 #: build/C/man3/fgetws.3:44 build/C/man3/fputws.3:35 build/C/man3/getwchar.3:41 build/C/man3/putwchar.3:40
 188 msgid "For a nonlocking counterpart, see B<unlocked_stdio>(3)."
 189 msgstr ""
 190
 191 #. type: Plain text
 192 #: build/C/man3/fgetws.3:50
 193 msgid ""
 194 "The B<fgetws>()  function, if successful, returns I<ws>.  If end of stream "
 195 "was already reached or if an error occurred, it returns NULL."
 196 msgstr ""
 197
 198 #. type: Plain text
 199 #: build/C/man3/fgetws.3:59
 200 msgid ""
 201 "The behavior of B<fgetws>()  depends on the B<LC_CTYPE> category of the "
 202 "current locale."
 203 msgstr ""
 204
 205 #. type: Plain text
 206 #: build/C/man3/fgetws.3:67
 207 msgid ""
 208 "In the absence of additional information passed to the B<fopen>(3)  call, it "
 209 "is reasonable to expect that B<fgetws>()  will actually read a multibyte "
 210 "string from the stream and then convert it to a wide-character string."
 211 msgstr ""
 212
 213 #. type: Plain text
 214 #: build/C/man3/fgetws.3:71
 215 msgid ""
 216 "This function is unreliable, because it does not permit to deal properly "
 217 "with null wide characters that may be present in the input."
 218 msgstr ""
 219
 220 #. type: Plain text
 221 #: build/C/man3/fgetws.3:73 build/C/man3/getwchar.3:64
 222 msgid "B<fgetwc>(3), B<unlocked_stdio>(3)"
 223 msgstr ""
 224
 225 #. type: TH
 226 #: build/C/man3/fputws.3:14
 227 #, no-wrap
 228 msgid "FPUTWS"
 229 msgstr ""
 230
 231 #. type: Plain text
 232 #: build/C/man3/fputws.3:17
 233 msgid "fputws - write a wide-character string to a FILE stream"
 234 msgstr ""
 235
 236 #. type: Plain text
 237 #: build/C/man3/fputws.3:22
 238 #, no-wrap
 239 msgid "B<int fputws(const wchar_t *>I<ws>B<, FILE *>I<stream>B<);>\n"
 240 msgstr ""
 241
 242 #. type: Plain text
 243 #: build/C/man3/fputws.3:32
 244 msgid ""
 245 "The B<fputws>()  function is the wide-character equivalent of the "
 246 "B<fputs>(3)  function.  It writes the wide-character string starting at "
 247 "I<ws>, up to but not including the terminating null wide character "
 248 "(L\\(aq\\e0\\(aq), to I<stream>."
 249 msgstr ""
 250
 251 #. type: Plain text
 252 #: build/C/man3/fputws.3:41
 253 msgid ""
 254 "The B<fputws>()  function returns a nonnegative integer if the operation was "
 255 "successful, or -1 to indicate an error."
 256 msgstr ""
 257
 258 #. type: Plain text
 259 #: build/C/man3/fputws.3:50
 260 msgid ""
 261 "The behavior of B<fputws>()  depends on the B<LC_CTYPE> category of the "
 262 "current locale."
 263 msgstr ""
 264
 265 #. type: Plain text
 266 #: build/C/man3/fputws.3:58
 267 msgid ""
 268 "In the absence of additional information passed to the B<fopen>(3)  call, it "
 269 "is reasonable to expect that B<fputws>()  will actually write the multibyte "
 270 "string corresponding to the wide-character string I<ws>."
 271 msgstr ""
 272
 273 #. type: Plain text
 274 #: build/C/man3/fputws.3:60 build/C/man3/putwchar.3:62
 275 msgid "B<fputwc>(3), B<unlocked_stdio>(3)"
 276 msgstr ""
 277
 278 #. type: TH
 279 #: build/C/man3/fwide.3:14
 280 #, no-wrap
 281 msgid "FWIDE"
 282 msgstr ""
 283
 284 #. type: TH
 285 #: build/C/man3/fwide.3:14
 286 #, no-wrap
 287 msgid "2011-09-17"
 288 msgstr ""
 289
 290 #. type: Plain text
 291 #: build/C/man3/fwide.3:17
 292 msgid "fwide - set and determine the orientation of a FILE stream"
 293 msgstr ""
 294
 295 #. type: Plain text
 296 #: build/C/man3/fwide.3:22
 297 #, no-wrap
 298 msgid "B<int fwide(FILE *>I<stream>B<, int >I<mode>B<);>\n"
 299 msgstr ""
 300
 301 #. type: Plain text
 302 #: build/C/man3/fwide.3:27 build/C/man3/mbsnrtowcs.3:27 build/C/man3/wcpcpy.3:26 build/C/man3/wcpncpy.3:27 build/C/man3/wcscasecmp.3:26 build/C/man3/wcsdup.3:26 build/C/man3/wcsncasecmp.3:26 build/C/man3/wcsnlen.3:26 build/C/man3/wcsnrtombs.3:27
 303 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
 304 msgstr ""
 305
 306 #. type: Plain text
 307 #: build/C/man3/fwide.3:31
 308 msgid "B<fwide>():"
 309 msgstr ""
 310
 311 #. type: Plain text
 312 #: build/C/man3/fwide.3:33
 313 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 500 || _ISOC99_SOURCE ||"
 314 msgstr ""
 315
 316 #. type: Plain text
 317 #: build/C/man3/fwide.3:35
 318 msgid "_ISOC95_SOURCE /* Since glibc 2.12 */ ||"
 319 msgstr ""
 320
 321 #. type: Plain text
 322 #: build/C/man3/fwide.3:37
 323 msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
 324 msgstr ""
 325
 326 #. type: Plain text
 327 #: build/C/man3/fwide.3:40
 328 msgid "or I<cc\\ -std=c99>"
 329 msgstr ""
 330
 331 #. type: Plain text
 332 #: build/C/man3/fwide.3:57
 333 msgid ""
 334 "When I<mode> is zero, the B<fwide>()  function determines the current "
 335 "orientation of I<stream>.  It returns a positive value if I<stream> is "
 336 "wide-character oriented, that is, if wide-character I/O is permitted but "
 337 "char I/O is disallowed.  It returns a negative value if I<stream> is byte "
 338 "oriented, i.e., if char I/O is permitted but wide-character I/O is "
 339 "disallowed.  It returns zero if I<stream> has no orientation yet; in this "
 340 "case the next I/O operation might change the orientation (to byte oriented "
 341 "if it is a char I/O operation, or to wide-character oriented if it is a "
 342 "wide-character I/O operation)."
 343 msgstr ""
 344
 345 #. type: Plain text
 346 #: build/C/man3/fwide.3:60
 347 msgid ""
 348 "Once a stream has an orientation, it cannot be changed and persists until "
 349 "the stream is closed."
 350 msgstr ""
 351
 352 #. type: Plain text
 353 #: build/C/man3/fwide.3:69
 354 msgid ""
 355 "When I<mode> is nonzero, the B<fwide>()  function first attempts to set "
 356 "I<stream>'s orientation (to wide-character oriented if I<mode> is greater "
 357 "than 0, or to byte oriented if I<mode> is less than 0).  It then returns a "
 358 "value denoting the current orientation, as above."
 359 msgstr ""
 360
 361 #. type: Plain text
 362 #: build/C/man3/fwide.3:77
 363 msgid ""
 364 "The B<fwide>()  function returns the stream's orientation, after possibly "
 365 "changing it.  A positive return value means wide-character oriented.  A "
 366 "negative return value means byte oriented.  A return value of zero means "
 367 "undecided."
 368 msgstr ""
 369
 370 #. type: Plain text
 371 #: build/C/man3/fwide.3:87
 372 msgid ""
 373 "Wide-character output to a byte oriented stream can be performed through the "
 374 "B<fprintf>(3)  function with the B<%lc> and B<%ls> directives."
 375 msgstr ""
 376
 377 #. type: Plain text
 378 #: build/C/man3/fwide.3:96
 379 msgid ""
 380 "Char oriented output to a wide-character oriented stream can be performed "
 381 "through the B<fwprintf>(3)  function with the B<%c> and B<%s> directives."
 382 msgstr ""
 383
 384 #. type: Plain text
 385 #: build/C/man3/fwide.3:98
 386 msgid "B<fprintf>(3), B<fwprintf>(3)"
 387 msgstr ""
 388
 389 #. type: TH
 390 #: build/C/man3/getwchar.3:15
 391 #, no-wrap
 392 msgid "GETWCHAR"
 393 msgstr ""
 394
 395 #. type: TH
 396 #: build/C/man3/getwchar.3:15 build/C/man3/mbrlen.3:14 build/C/man3/putwchar.3:15 build/C/man3/wcschr.3:14 build/C/man3/wcscmp.3:14 build/C/man3/wcscspn.3:14 build/C/man3/wcspbrk.3:14 build/C/man3/wcsrchr.3:14 build/C/man3/wcsspn.3:14 build/C/man3/wmemchr.3:14 build/C/man3/wmemcmp.3:13 build/C/man3/wmemcpy.3:14 build/C/man3/wmemmove.3:14 build/C/man3/wmemset.3:14
 397 #, no-wrap
 398 msgid "1999-07-25"
 399 msgstr ""
 400
 401 #. type: Plain text
 402 #: build/C/man3/getwchar.3:18
 403 msgid "getwchar - read a wide character from standard input"
 404 msgstr ""
 405
 406 #. type: Plain text
 407 #: build/C/man3/getwchar.3:23
 408 #, no-wrap
 409 msgid "B<wint_t getwchar(void);>\n"
 410 msgstr ""
 411
 412 #. type: Plain text
 413 #: build/C/man3/getwchar.3:38
 414 msgid ""
 415 "The B<getwchar>()  function is the wide-character equivalent of the "
 416 "B<getchar>(3)  function.  It reads a wide character from I<stdin> and "
 417 "returns it.  If the end of stream is reached, or if I<ferror(stdin)> becomes "
 418 "true, it returns B<WEOF>.  If a wide-character conversion error occurs, it "
 419 "sets I<errno> to B<EILSEQ> and returns B<WEOF>."
 420 msgstr ""
 421
 422 #. type: Plain text
 423 #: build/C/man3/getwchar.3:47
 424 msgid ""
 425 "The B<getwchar>()  function returns the next wide-character from standard "
 426 "input, or B<WEOF>."
 427 msgstr ""
 428
 429 #. type: Plain text
 430 #: build/C/man3/getwchar.3:49 build/C/man3/mbrlen.3:69 build/C/man3/mbrtowc.3:103 build/C/man3/mbsinit.3:76 build/C/man3/mbsrtowcs.3:86 build/C/man3/putwchar.3:48 build/C/man3/ungetwc.3:55 build/C/man3/wcrtomb.3:79 build/C/man3/wcscat.3:43 build/C/man3/wcschr.3:40 build/C/man3/wcscmp.3:45 build/C/man3/wcscpy.3:45 build/C/man3/wcscspn.3:50 build/C/man3/wcslen.3:39 build/C/man3/wcsncat.3:42 build/C/man3/wcsncmp.3:48 build/C/man3/wcsncpy.3:52 build/C/man3/wcspbrk.3:43 build/C/man3/wcsrchr.3:40 build/C/man3/wcsrtombs.3:94 build/C/man3/wcsspn.3:49 build/C/man3/wcsstr.3:45 build/C/man3/wcstoimax.3:50 build/C/man3/wcstok.3:62 build/C/man3/wctob.3:45 build/C/man3/wmemchr.3:39 build/C/man3/wmemcmp.3:46 build/C/man3/wmemcpy.3:44 build/C/man3/wmemmove.3:41 build/C/man3/wmemset.3:36
 431 msgid "C99."
 432 msgstr ""
 433
 434 #. type: Plain text
 435 #: build/C/man3/getwchar.3:56
 436 msgid ""
 437 "The behavior of B<getwchar>()  depends on the B<LC_CTYPE> category of the "
 438 "current locale."
 439 msgstr ""
 440
 441 #. type: Plain text
 442 #: build/C/man3/getwchar.3:62
 443 msgid ""
 444 "It is reasonable to expect that B<getwchar>()  will actually read a "
 445 "multibyte sequence from standard input and then convert it to a wide "
 446 "character."
 447 msgstr ""
 448
 449 #. type: TH
 450 #: build/C/man3/mbrlen.3:14
 451 #, no-wrap
 452 msgid "MBRLEN"
 453 msgstr ""
 454
 455 #. type: Plain text
 456 #: build/C/man3/mbrlen.3:17
 457 msgid "mbrlen - determine number of bytes in next multibyte character"
 458 msgstr ""
 459
 460 #. type: Plain text
 461 #: build/C/man3/mbrlen.3:22
 462 #, no-wrap
 463 msgid ""
 464 "B<size_t mbrlen(const char *>I<s>B<, size_t >I<n>B<, mbstate_t "
 465 "*>I<ps>B<);>\n"
 466 msgstr ""
 467
 468 #. type: Plain text
 469 #: build/C/man3/mbrlen.3:34
 470 msgid ""
 471 "The B<mbrlen>()  function inspects at most I<n> bytes of the multibyte "
 472 "string starting at I<s> and extracts the next complete multibyte character.  "
 473 "It updates the shift state I<*ps>.  If the multibyte character is not the "
 474 "null wide character, it returns the number of bytes that were consumed from "
 475 "I<s>.  If the multibyte character is the null wide character, it resets the "
 476 "shift state I<*ps> to the initial state and returns 0."
 477 msgstr ""
 478
 479 #. type: Plain text
 480 #: build/C/man3/mbrlen.3:42
 481 msgid ""
 482 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
 483 "character, B<mbrlen>()  returns I<(size_t)\\ -2>.  This can happen even if "
 484 "I<n> E<gt>= I<MB_CUR_MAX>, if the multibyte string contains redundant shift "
 485 "sequences."
 486 msgstr ""
 487
 488 #. type: Plain text
 489 #: build/C/man3/mbrlen.3:50
 490 msgid ""
 491 "If the multibyte string starting at I<s> contains an invalid multibyte "
 492 "sequence before the next complete character, B<mbrlen>()  returns "
 493 "I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>.  In this case, the effects "
 494 "on I<*ps> are undefined."
 495 msgstr ""
 496
 497 #. type: Plain text
 498 #: build/C/man3/mbrlen.3:54
 499 msgid ""
 500 "If I<ps> is a NULL pointer, a static anonymous state only known to the "
 501 "B<mbrlen>()  function is used instead."
 502 msgstr ""
 503
 504 #. type: Plain text
 505 #: build/C/man3/mbrlen.3:67
 506 msgid ""
 507 "The B<mbrlen>()  function returns the number of bytes parsed from the "
 508 "multibyte sequence starting at I<s>, if a non-null wide character was "
 509 "recognized.  It returns 0, if a null wide character was recognized.  It "
 510 "returns I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>, if an invalid "
 511 "multibyte sequence was encountered.  It returns I<(size_t)\\ -2> if it "
 512 "couldn't parse a complete multibyte character, meaning that I<n> should be "
 513 "increased."
 514 msgstr ""
 515
 516 #. type: Plain text
 517 #: build/C/man3/mbrlen.3:76
 518 msgid ""
 519 "The behavior of B<mbrlen>()  depends on the B<LC_CTYPE> category of the "
 520 "current locale."
 521 msgstr ""
 522
 523 #. type: Plain text
 524 #: build/C/man3/mbrlen.3:77
 525 msgid "B<mbrtowc>(3)"
 526 msgstr ""
 527
 528 #. type: TH
 529 #: build/C/man3/mbrtowc.3:15
 530 #, no-wrap
 531 msgid "MBRTOWC"
 532 msgstr ""
 533
 534 #. type: Plain text
 535 #: build/C/man3/mbrtowc.3:18
 536 msgid "mbrtowc - convert a multibyte sequence to a wide character"
 537 msgstr ""
 538
 539 #. type: Plain text
 540 #: build/C/man3/mbrtowc.3:24
 541 #, no-wrap
 542 msgid ""
 543 "B<size_t mbrtowc(wchar_t *>I<pwc>B<, const char *>I<s>B<, size_t >I<n>B<, "
 544 "mbstate_t *>I<ps>B<);>\n"
 545 msgstr ""
 546
 547 #. type: Plain text
 548 #: build/C/man3/mbrtowc.3:41
 549 msgid ""
 550 "The main case for this function is when I<s> is not NULL and I<pwc> is not "
 551 "NULL.  In this case, the B<mbrtowc>()  function inspects at most I<n> bytes "
 552 "of the multibyte string starting at I<s>, extracts the next complete "
 553 "multibyte character, converts it to a wide character and stores it at "
 554 "I<*pwc>.  It updates the shift state I<*ps>.  If the converted wide "
 555 "character is not L\\(aq\\e0\\(aq (the null wide character), it returns the "
 556 "number of bytes that were consumed from I<s>.  If the converted wide "
 557 "character is L\\(aq\\e0\\(aq, it resets the shift state I<*ps> to the "
 558 "initial state and returns 0."
 559 msgstr ""
 560
 561 #. type: Plain text
 562 #: build/C/man3/mbrtowc.3:49
 563 msgid ""
 564 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
 565 "character, B<mbrtowc>()  returns I<(size_t)\\ -2>.  This can happen even if "
 566 "I<n> E<gt>= I<MB_CUR_MAX>, if the multibyte string contains redundant shift "
 567 "sequences."
 568 msgstr ""
 569
 570 #. type: Plain text
 571 #: build/C/man3/mbrtowc.3:57
 572 msgid ""
 573 "If the multibyte string starting at I<s> contains an invalid multibyte "
 574 "sequence before the next complete character, B<mbrtowc>()  returns "
 575 "I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>.  In this case, the effects "
 576 "on I<*ps> are undefined."
 577 msgstr ""
 578
 579 #. type: Plain text
 580 #: build/C/man3/mbrtowc.3:64
 581 msgid ""
 582 "A different case is when I<s> is not NULL but I<pwc> is NULL.  In this case "
 583 "the B<mbrtowc>()  function behaves as above, except that it does not store "
 584 "the converted wide character in memory."
 585 msgstr ""
 586
 587 #. type: Plain text
 588 #: build/C/man3/mbrtowc.3:78
 589 msgid ""
 590 "A third case is when I<s> is NULL.  In this case, I<pwc> and I<n> are "
 591 "ignored.  If the conversion state represented by I<*ps> denotes an "
 592 "incomplete multibyte character conversion, the B<mbrtowc>()  function "
 593 "returns I<(size_t)\\ -1>, sets I<errno> to B<EILSEQ>, and leaves I<*ps> in "
 594 "an undefined state.  Otherwise, the B<mbrtowc>()  function puts I<*ps> in "
 595 "the initial state and returns 0."
 596 msgstr ""
 597
 598 #. type: Plain text
 599 #: build/C/man3/mbrtowc.3:84
 600 msgid ""
 601 "In all of the above cases, if I<ps> is a NULL pointer, a static anonymous "
 602 "state only known to the mbrtowc function is used instead.  Otherwise, I<*ps> "
 603 "must be a valid I<mbstate_t> object.  An I<mbstate_t> object I<a> can be "
 604 "initialized to the initial state by zeroing it, for example using"
 605 msgstr ""
 606
 607 #. type: Plain text
 608 #: build/C/man3/mbrtowc.3:87
 609 msgid "memset(&a, 0, sizeof(a));"
 610 msgstr ""
 611
 612 #. type: Plain text
 613 #: build/C/man3/mbrtowc.3:101
 614 msgid ""
 615 "The B<mbrtowc>()  function returns the number of bytes parsed from the "
 616 "multibyte sequence starting at I<s>, if a non-L\\(aq\\e0\\(aq wide character "
 617 "was recognized.  It returns 0, if a L\\(aq\\e0\\(aq wide character was "
 618 "recognized.  It returns I<(size_t)\\ -1> and sets I<errno> to B<EILSEQ>, if "
 619 "an invalid multibyte sequence was encountered.  It returns I<(size_t)\\ -2> "
 620 "if it couldn't parse a complete multibyte character, meaning that I<n> "
 621 "should be increased."
 622 msgstr ""
 623
 624 #. type: Plain text
 625 #: build/C/man3/mbrtowc.3:110
 626 msgid ""
 627 "The behavior of B<mbrtowc>()  depends on the B<LC_CTYPE> category of the "
 628 "current locale."
 629 msgstr ""
 630
 631 #. type: Plain text
 632 #: build/C/man3/mbrtowc.3:111
 633 msgid "B<mbsrtowcs>(3)"
 634 msgstr ""
 635
 636 #. type: TH
 637 #: build/C/man3/mbsinit.3:14
 638 #, no-wrap
 639 msgid "MBSINIT"
 640 msgstr ""
 641
 642 #. type: TH
 643 #: build/C/man3/mbsinit.3:14
 644 #, no-wrap
 645 msgid "2000-11-20"
 646 msgstr ""
 647
 648 #. type: Plain text
 649 #: build/C/man3/mbsinit.3:17
 650 msgid "mbsinit - test for initial shift state"
 651 msgstr ""
 652
 653 #. type: Plain text
 654 #: build/C/man3/mbsinit.3:22
 655 #, no-wrap
 656 msgid "B<int mbsinit(const mbstate_t *>I<ps>B<);>\n"
 657 msgstr ""
 658
 659 #. type: Plain text
 660 #: build/C/man3/mbsinit.3:31
 661 msgid ""
 662 "Character conversion between the multibyte representation and the wide "
 663 "character representation uses conversion state, of type I<mbstate_t>.  "
 664 "Conversion of a string uses a finite-state machine; when it is interrupted "
 665 "after the complete conversion of a number of characters, it may need to save "
 666 "a state for processing the remaining characters.  Such a conversion state is "
 667 "needed for the sake of encodings such as ISO-2022 and UTF-7."
 668 msgstr ""
 669
 670 #. type: Plain text
 671 #: build/C/man3/mbsinit.3:41
 672 msgid ""
 673 "The initial state is the state at the beginning of conversion of a string.  "
 674 "There are two kinds of state: The one used by multibyte to wide character "
 675 "conversion functions, such as B<mbsrtowcs>(3), and the one used by wide "
 676 "character to multibyte conversion functions, such as B<wcsrtombs>(3), but "
 677 "they both fit in a I<mbstate_t>, and they both have the same representation "
 678 "for an initial state."
 679 msgstr ""
 680
 681 #. type: Plain text
 682 #: build/C/man3/mbsinit.3:49
 683 msgid ""
 684 "For 8-bit encodings, all states are equivalent to the initial state.  For "
 685 "multibyte encodings like UTF-8, EUC-*, BIG5 or SJIS, the wide character to "
 686 "multibyte conversion functions never produce non-initial states, but the "
 687 "multibyte to wide-character conversion functions like B<mbrtowc>(3)  do "
 688 "produce non-initial states when interrupted in the middle of a character."
 689 msgstr ""
 690
 691 #. type: Plain text
 692 #: build/C/man3/mbsinit.3:53
 693 msgid ""
 694 "One possible way to create an I<mbstate_t> in initial state is to set it to "
 695 "zero:"
 696 msgstr ""
 697
 698 #. type: Plain text
 699 #: build/C/man3/mbsinit.3:57
 700 #, no-wrap
 701 msgid ""
 702 "    mbstate_t state;\n"
 703 "    memset(&state,0,sizeof(mbstate_t));\n"
 704 msgstr ""
 705
 706 #. type: Plain text
 707 #: build/C/man3/mbsinit.3:60
 708 msgid "On Linux, the following works as well, but might generate compiler warnings:"
 709 msgstr ""
 710
 711 #. type: Plain text
 712 #: build/C/man3/mbsinit.3:63
 713 #, no-wrap
 714 msgid "    mbstate_t state = { 0 };\n"
 715 msgstr ""
 716
 717 #. type: Plain text
 718 #: build/C/man3/mbsinit.3:69
 719 msgid ""
 720 "The function B<mbsinit>()  tests whether I<*ps> corresponds to an initial "
 721 "state."
 722 msgstr ""
 723
 724 #. type: Plain text
 725 #: build/C/man3/mbsinit.3:74
 726 msgid ""
 727 "B<mbsinit>()  returns nonzero if I<*ps> is an initial state, or if I<ps> is "
 728 "a NULL pointer.  Otherwise it returns 0."
 729 msgstr ""
 730
 731 #. type: Plain text
 732 #: build/C/man3/mbsinit.3:83
 733 msgid ""
 734 "The behavior of B<mbsinit>()  depends on the B<LC_CTYPE> category of the "
 735 "current locale."
 736 msgstr ""
 737
 738 #. type: Plain text
 739 #: build/C/man3/mbsinit.3:85
 740 msgid "B<mbsrtowcs>(3), B<wcsrtombs>(3)"
 741 msgstr ""
 742
 743 #. type: TH
 744 #: build/C/man3/mbsnrtowcs.3:13
 745 #, no-wrap
 746 msgid "MBSNRTOWCS"
 747 msgstr ""
 748
 749 #. type: TH
 750 #: build/C/man3/mbsnrtowcs.3:13 build/C/man3/wcpcpy.3:13 build/C/man3/wcpncpy.3:13 build/C/man3/wcsnlen.3:13
 751 #, no-wrap
 752 msgid "2011-10-01"
 753 msgstr ""
 754
 755 #. type: Plain text
 756 #: build/C/man3/mbsnrtowcs.3:16
 757 msgid "mbsnrtowcs - convert a multibyte string to a wide-character string"
 758 msgstr ""
 759
 760 #. type: Plain text
 761 #: build/C/man3/mbsnrtowcs.3:22
 762 #, no-wrap
 763 msgid ""
 764 "B<size_t mbsnrtowcs(wchar_t *>I<dest>B<, const char **>I<src>B<,>\n"
 765 "B<                  size_t >I<nms>B<, size_t >I<len>B<, mbstate_t "
 766 "*>I<ps>B<);>\n"
 767 msgstr ""
 768
 769 #. type: Plain text
 770 #: build/C/man3/mbsnrtowcs.3:30
 771 msgid "B<mbsnrtowcs>():"
 772 msgstr ""
 773
 774 #. type: TP
 775 #: build/C/man3/mbsnrtowcs.3:33 build/C/man3/wcpcpy.3:32 build/C/man3/wcpncpy.3:33 build/C/man3/wcscasecmp.3:32 build/C/man3/wcsdup.3:32 build/C/man3/wcsncasecmp.3:32 build/C/man3/wcsnlen.3:32 build/C/man3/wcsnrtombs.3:33
 776 #, no-wrap
 777 msgid "Since glibc 2.10:"
 778 msgstr ""
 779
 780 #. type: Plain text
 781 #: build/C/man3/mbsnrtowcs.3:36 build/C/man3/wcpcpy.3:35 build/C/man3/wcpncpy.3:36 build/C/man3/wcscasecmp.3:35 build/C/man3/wcsdup.3:35 build/C/man3/wcsncasecmp.3:35 build/C/man3/wcsnlen.3:35 build/C/man3/wcsnrtombs.3:36
 782 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
 783 msgstr ""
 784
 785 #. type: TP
 786 #: build/C/man3/mbsnrtowcs.3:36 build/C/man3/wcpcpy.3:35 build/C/man3/wcpncpy.3:36 build/C/man3/wcscasecmp.3:35 build/C/man3/wcsdup.3:35 build/C/man3/wcsncasecmp.3:35 build/C/man3/wcsnlen.3:35 build/C/man3/wcsnrtombs.3:36
 787 #, no-wrap
 788 msgid "Before glibc 2.10:"
 789 msgstr ""
 790
 791 #. type: Plain text
 792 #: build/C/man3/mbsnrtowcs.3:39 build/C/man3/wcpcpy.3:38 build/C/man3/wcpncpy.3:39 build/C/man3/wcscasecmp.3:38 build/C/man3/wcsdup.3:38 build/C/man3/wcsncasecmp.3:38 build/C/man3/wcsnlen.3:38 build/C/man3/wcsnrtombs.3:39
 793 msgid "_GNU_SOURCE"
 794 msgstr ""
 795
 796 #. type: Plain text
 797 #: build/C/man3/mbsnrtowcs.3:50
 798 msgid ""
 799 "The B<mbsnrtowcs>()  function is like the B<mbsrtowcs>(3)  function, except "
 800 "that the number of bytes to be converted, starting at I<*src>, is limited to "
 801 "I<nms>."
 802 msgstr ""
 803
 804 #. type: Plain text
 805 #: build/C/man3/mbsnrtowcs.3:67
 806 msgid ""
 807 "If I<dest> is not a NULL pointer, the B<mbsnrtowcs>()  function converts at "
 808 "most I<nms> bytes from the multibyte string I<*src> to a wide-character "
 809 "string starting at I<dest>.  At most I<len> wide characters are written to "
 810 "I<dest>.  The shift state I<*ps> is updated.  The conversion is effectively "
 811 "performed by repeatedly calling I<mbrtowc(dest, *src, n, ps)> where I<n> is "
 812 "some positive number, as long as this call succeeds, and then incrementing "
 813 "I<dest> by one and I<*src> by the number of bytes consumed.  The conversion "
 814 "can stop for three reasons:"
 815 msgstr ""
 816
 817 #. type: IP
 818 #: build/C/man3/mbsnrtowcs.3:67 build/C/man3/mbsrtowcs.3:39
 819 #, no-wrap
 820 msgid "1."
 821 msgstr ""
 822
 823 #. type: Plain text
 824 #: build/C/man3/mbsnrtowcs.3:74 build/C/man3/mbsrtowcs.3:46
 825 msgid ""
 826 "An invalid multibyte sequence has been encountered.  In this case I<*src> is "
 827 "left pointing to the invalid multibyte sequence, I<(size_t)\\ -1> is "
 828 "returned, and I<errno> is set to B<EILSEQ>."
 829 msgstr ""
 830
 831 #. type: IP
 832 #: build/C/man3/mbsnrtowcs.3:74 build/C/man3/mbsrtowcs.3:46
 833 #, no-wrap
 834 msgid "2."
 835 msgstr ""
 836
 837 #. type: Plain text
 838 #: build/C/man3/mbsnrtowcs.3:81
 839 msgid ""
 840 "The I<nms> limit forces a stop, or I<len> non-L\\(aq\\e0\\(aq wide "
 841 "characters have been stored at I<dest>.  In this case I<*src> is left "
 842 "pointing to the next multibyte sequence to be converted, and the number of "
 843 "wide characters written to I<dest> is returned."
 844 msgstr ""
 845
 846 #. type: IP
 847 #: build/C/man3/mbsnrtowcs.3:81 build/C/man3/mbsrtowcs.3:52
 848 #, no-wrap
 849 msgid "3."
 850 msgstr ""
 851
 852 #. type: Plain text
 853 #: build/C/man3/mbsnrtowcs.3:90
 854 msgid ""
 855 "The multibyte string has been completely converted, including the "
 856 "terminating null wide character (\\(aq\\e0\\(aq)  (which has the side effect "
 857 "of bringing back I<*ps> to the initial state).  In this case I<*src> is set "
 858 "to NULL, and the number of wide characters written to I<dest>, excluding the "
 859 "terminating null wide character, is returned."
 860 msgstr ""
 861
 862 #. type: Plain text
 863 #: build/C/man3/mbsnrtowcs.3:95
 864 msgid ""
 865 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
 866 "except that the converted wide characters are not written out to memory, and "
 867 "that no destination length limit exists."
 868 msgstr ""
 869
 870 #. type: Plain text
 871 #: build/C/man3/mbsnrtowcs.3:98
 872 msgid ""
 873 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
 874 "state only known to the mbsnrtowcs function is used instead."
 875 msgstr ""
 876
 877 #. type: Plain text
 878 #: build/C/man3/mbsnrtowcs.3:101 build/C/man3/mbsrtowcs.3:74
 879 msgid ""
 880 "The programmer must ensure that there is room for at least I<len> wide "
 881 "characters at I<dest>."
 882 msgstr ""
 883
 884 #. type: Plain text
 885 #: build/C/man3/mbsnrtowcs.3:111
 886 msgid ""
 887 "The B<mbsnrtowcs>()  function returns the number of wide characters that "
 888 "make up the converted part of the wide-character string, not including the "
 889 "terminating null wide character.  If an invalid multibyte sequence was "
 890 "encountered, I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
 891 msgstr ""
 892
 893 #. type: Plain text
 894 #: build/C/man3/mbsnrtowcs.3:113 build/C/man3/wcpcpy.3:63 build/C/man3/wcpncpy.3:72 build/C/man3/wcsnlen.3:69 build/C/man3/wcsnrtombs.3:117
 895 msgid "POSIX.1-2008."
 896 msgstr ""
 897
 898 #. type: Plain text
 899 #: build/C/man3/mbsnrtowcs.3:120
 900 msgid ""
 901 "The behavior of B<mbsnrtowcs>()  depends on the B<LC_CTYPE> category of the "
 902 "current locale."
 903 msgstr ""
 904
 905 #. type: Plain text
 906 #: build/C/man3/mbsnrtowcs.3:122 build/C/man3/mbsrtowcs.3:95 build/C/man3/wcrtomb.3:88 build/C/man3/wcsnrtombs.3:126 build/C/man3/wcsrtombs.3:103
 907 msgid "Passing NULL as I<ps> is not multithread safe."
 908 msgstr ""
 909
 910 #. type: Plain text
 911 #: build/C/man3/mbsnrtowcs.3:124
 912 msgid "B<iconv>(3), B<mbsrtowcs>(3)"
 913 msgstr ""
 914
 915 #. type: TH
 916 #: build/C/man3/mbsrtowcs.3:14
 917 #, no-wrap
 918 msgid "MBSRTOWCS"
 919 msgstr ""
 920
 921 #. type: Plain text
 922 #: build/C/man3/mbsrtowcs.3:17
 923 msgid "mbsrtowcs - convert a multibyte string to a wide-character string"
 924 msgstr ""
 925
 926 #. type: Plain text
 927 #: build/C/man3/mbsrtowcs.3:23
 928 #, no-wrap
 929 msgid ""
 930 "B<size_t mbsrtowcs(wchar_t *>I<dest>B<, const char **>I<src>B<,>\n"
 931 "B<                  size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
 932 msgstr ""
 933
 934 #. type: Plain text
 935 #: build/C/man3/mbsrtowcs.3:39
 936 msgid ""
 937 "If I<dest> is not a NULL pointer, the B<mbsrtowcs>()  function converts the "
 938 "multibyte string I<*src> to a wide-character string starting at I<dest>.  At "
 939 "most I<len> wide characters are written to I<dest>.  The shift state I<*ps> "
 940 "is updated.  The conversion is effectively performed by repeatedly calling "
 941 "I<mbrtowc(dest, *src, n, ps)> where I<n> is some positive number, as long as "
 942 "this call succeeds, and then incrementing I<dest> by one and I<*src> by the "
 943 "number of bytes consumed.  The conversion can stop for three reasons:"
 944 msgstr ""
 945
 946 #. type: Plain text
 947 #: build/C/man3/mbsrtowcs.3:52
 948 msgid ""
 949 "I<len> non-L\\(aq\\e0\\(aq wide characters have been stored at I<dest>.  In "
 950 "this case I<*src> is left pointing to the next multibyte sequence to be "
 951 "converted, and the number of wide characters written to I<dest> is returned."
 952 msgstr ""
 953
 954 #. type: Plain text
 955 #: build/C/man3/mbsrtowcs.3:60
 956 msgid ""
 957 "The multibyte string has been completely converted, including the "
 958 "terminating null wide character (\\(aq\\e0\\(aq), which has the side effect "
 959 "of bringing back I<*ps> to the initial state.  In this case I<*src> is set "
 960 "to NULL, and the number of wide characters written to I<dest>, excluding the "
 961 "terminating null wide character, is returned."
 962 msgstr ""
 963
 964 #. type: Plain text
 965 #: build/C/man3/mbsrtowcs.3:65
 966 msgid ""
 967 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
 968 "except that the converted wide characters are not written out to memory, and "
 969 "that no length limit exists."
 970 msgstr ""
 971
 972 #. type: Plain text
 973 #: build/C/man3/mbsrtowcs.3:71
 974 msgid ""
 975 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
 976 "state only known to the B<mbsrtowcs>()  function is used instead."
 977 msgstr ""
 978
 979 #. type: Plain text
 980 #: build/C/man3/mbsrtowcs.3:84
 981 msgid ""
 982 "The B<mbsrtowcs>()  function returns the number of wide characters that make "
 983 "up the converted part of the wide-character string, not including the "
 984 "terminating null wide character.  If an invalid multibyte sequence was "
 985 "encountered, I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
 986 msgstr ""
 987
 988 #. type: Plain text
 989 #: build/C/man3/mbsrtowcs.3:93
 990 msgid ""
 991 "The behavior of B<mbsrtowcs>()  depends on the B<LC_CTYPE> category of the "
 992 "current locale."
 993 msgstr ""
 994
 995 #. type: Plain text
 996 #: build/C/man3/mbsrtowcs.3:98
 997 msgid "B<iconv>(3), B<mbsnrtowcs>(3), B<mbstowcs>(3)"
 998 msgstr ""
 999
1000 #. type: TH
1001 #: build/C/man3/putwchar.3:15
1002 #, no-wrap
1003 msgid "PUTWCHAR"
1004 msgstr ""
1005
1006 #. type: Plain text
1007 #: build/C/man3/putwchar.3:18
1008 msgid "putwchar - write a wide character to standard output"
1009 msgstr ""
1010
1011 #. type: Plain text
1012 #: build/C/man3/putwchar.3:23
1013 #, no-wrap
1014 msgid "B<wint_t putwchar(wchar_t >I<wc>B<);>\n"
1015 msgstr ""
1016
1017 #. type: Plain text
1018 #: build/C/man3/putwchar.3:37
1019 msgid ""
1020 "The B<putwchar>()  function is the wide-character equivalent of the "
1021 "B<putchar>(3)  function.  It writes the wide character I<wc> to I<stdout>.  "
1022 "If I<ferror(stdout)> becomes true, it returns B<WEOF>.  If a wide character "
1023 "conversion error occurs, it sets I<errno> to B<EILSEQ> and returns B<WEOF>.  "
1024 "Otherwise it returns I<wc>."
1025 msgstr ""
1026
1027 #. type: Plain text
1028 #: build/C/man3/putwchar.3:46
1029 msgid ""
1030 "The B<putwchar>()  function returns I<wc> if no error occurred, or B<WEOF> "
1031 "to indicate an error."
1032 msgstr ""
1033
1034 #. type: Plain text
1035 #: build/C/man3/putwchar.3:55
1036 msgid ""
1037 "The behavior of B<putwchar>()  depends on the B<LC_CTYPE> category of the "
1038 "current locale."
1039 msgstr ""
1040
1041 #. type: Plain text
1042 #: build/C/man3/putwchar.3:60
1043 msgid ""
1044 "It is reasonable to expect that B<putwchar>()  will actually write the "
1045 "multibyte sequence corresponding to the wide character I<wc>."
1046 msgstr ""
1047
1048 #. type: TH
1049 #: build/C/man3/ungetwc.3:14
1050 #, no-wrap
1051 msgid "UNGETWC"
1052 msgstr ""
1053
1054 #. type: TH
1055 #: build/C/man3/ungetwc.3:14
1056 #, no-wrap
1057 msgid "1999-09-19"
1058 msgstr ""
1059
1060 #. type: Plain text
1061 #: build/C/man3/ungetwc.3:17
1062 msgid "ungetwc - push back a wide character onto a FILE stream"
1063 msgstr ""
1064
1065 #. type: Plain text
1066 #: build/C/man3/ungetwc.3:22
1067 #, no-wrap
1068 msgid "B<wint_t ungetwc(wint_t >I<wc>B<, FILE *>I<stream>B<);>\n"
1069 msgstr ""
1070
1071 #. type: Plain text
1072 #: build/C/man3/ungetwc.3:30
1073 msgid ""
1074 "The B<ungetwc>()  function is the wide-character equivalent of the "
1075 "B<ungetc>(3)  function.  It pushes back a wide character onto I<stream> and "
1076 "returns it."
1077 msgstr ""
1078
1079 #. type: Plain text
1080 #: build/C/man3/ungetwc.3:34
1081 msgid ""
1082 "If I<wc> is B<WEOF>, it returns B<WEOF>.  If I<wc> is an invalid wide "
1083 "character, it sets I<errno> to B<EILSEQ> and returns B<WEOF>."
1084 msgstr ""
1085
1086 #. type: Plain text
1087 #: build/C/man3/ungetwc.3:41
1088 msgid ""
1089 "If I<wc> is a valid wide character, it is pushed back onto the stream and "
1090 "thus becomes available for future wide-character read operations.  The "
1091 "file-position indicator is decremented by one or more.  The end-of-file "
1092 "indicator is cleared.  The backing storage of the file is not affected."
1093 msgstr ""
1094
1095 #. type: Plain text
1096 #: build/C/man3/ungetwc.3:44
1097 msgid ""
1098 "Note: I<wc> need not be the last wide-character read from the stream; it can "
1099 "be any other valid wide character."
1100 msgstr ""
1101
1102 #. type: Plain text
1103 #: build/C/man3/ungetwc.3:48
1104 msgid ""
1105 "If the implementation supports multiple push-back operations in a row, the "
1106 "pushed-back wide characters will be read in reverse order; however, only one "
1107 "level of push-back is guaranteed."
1108 msgstr ""
1109
1110 #. type: Plain text
1111 #: build/C/man3/ungetwc.3:53
1112 msgid ""
1113 "The B<ungetwc>()  function returns I<wc> when successful, or B<WEOF> upon "
1114 "failure."
1115 msgstr ""
1116
1117 #. type: Plain text
1118 #: build/C/man3/ungetwc.3:62
1119 msgid ""
1120 "The behavior of B<ungetwc>()  depends on the B<LC_CTYPE> category of the "
1121 "current locale."
1122 msgstr ""
1123
1124 #. type: Plain text
1125 #: build/C/man3/ungetwc.3:63
1126 msgid "B<fgetwc>(3)"
1127 msgstr ""
1128
1129 #. type: TH
1130 #: build/C/man3/wcpcpy.3:13
1131 #, no-wrap
1132 msgid "WCPCPY"
1133 msgstr ""
1134
1135 #. type: Plain text
1136 #: build/C/man3/wcpcpy.3:16
1137 msgid "wcpcpy - copy a wide-character string, returning a pointer to its end"
1138 msgstr ""
1139
1140 #. type: Plain text
1141 #: build/C/man3/wcpcpy.3:21
1142 #, no-wrap
1143 msgid "B<wchar_t *wcpcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1144 msgstr ""
1145
1146 #. type: Plain text
1147 #: build/C/man3/wcpcpy.3:29
1148 msgid "B<wcpcpy>():"
1149 msgstr ""
1150
1151 #. type: Plain text
1152 #: build/C/man3/wcpcpy.3:51
1153 msgid ""
1154 "The B<wcpcpy>()  function is the wide-character equivalent of the "
1155 "B<stpcpy>(3)  function.  It copies the wide-character string pointed to by "
1156 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1157 "the array pointed to by I<dest>."
1158 msgstr ""
1159
1160 #. type: Plain text
1161 #: build/C/man3/wcpcpy.3:53 build/C/man3/wcpncpy.3:63 build/C/man3/wcscat.3:35 build/C/man3/wcscpy.3:36 build/C/man3/wcsncat.3:34 build/C/man3/wcsncpy.3:44
1162 msgid "The strings may not overlap."
1163 msgstr ""
1164
1165 #. type: Plain text
1166 #: build/C/man3/wcpcpy.3:57 build/C/man3/wcscpy.3:40
1167 msgid ""
1168 "The programmer must ensure that there is room for at least I<wcslen(src)+1> "
1169 "wide characters at I<dest>."
1170 msgstr ""
1171
1172 #. type: Plain text
1173 #: build/C/man3/wcpcpy.3:61
1174 msgid ""
1175 "B<wcpcpy>()  returns a pointer to the end of the wide-character string "
1176 "I<dest>, that is, a pointer to the terminating null wide character."
1177 msgstr ""
1178
1179 #. type: Plain text
1180 #: build/C/man3/wcpcpy.3:65
1181 msgid "B<strcpy>(3), B<wcscpy>(3)"
1182 msgstr ""
1183
1184 #. type: TH
1185 #: build/C/man3/wcpncpy.3:13
1186 #, no-wrap
1187 msgid "WCPNCPY"
1188 msgstr ""
1189
1190 #. type: Plain text
1191 #: build/C/man3/wcpncpy.3:17
1192 msgid ""
1193 "wcpncpy - copy a fixed-size string of wide characters, returning a pointer "
1194 "to its end"
1195 msgstr ""
1196
1197 #. type: Plain text
1198 #: build/C/man3/wcpncpy.3:22
1199 #, no-wrap
1200 msgid ""
1201 "B<wchar_t *wcpncpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1202 ">I<n>B<);>\n"
1203 msgstr ""
1204
1205 #. type: Plain text
1206 #: build/C/man3/wcpncpy.3:30
1207 msgid "B<wcpncpy>():"
1208 msgstr ""
1209
1210 #. type: Plain text
1211 #: build/C/man3/wcpncpy.3:61
1212 msgid ""
1213 "The B<wcpncpy>()  function is the wide-character equivalent of the "
1214 "B<stpncpy>(3)  function.  It copies at most I<n> wide characters from the "
1215 "wide-character string pointed to by I<src>, including the terminating null "
1216 "wide (L\\(aq\\e0\\(aq), to the array pointed to by I<dest>.  Exactly I<n> "
1217 "wide characters are written at I<dest>.  If the length I<wcslen(src)> is "
1218 "smaller than I<n>, the remaining wide characters in the array pointed to by "
1219 "I<dest> are filled with L\\(aq\\e0\\(aq characters.  If the length "
1220 "I<wcslen(src)> is greater or equal to I<n>, the string pointed to by I<dest> "
1221 "will not be L\\(aq\\e0\\(aq terminated."
1222 msgstr ""
1223
1224 #. type: Plain text
1225 #: build/C/man3/wcpncpy.3:66 build/C/man3/wcsncpy.3:47 build/C/man3/wmemcpy.3:39 build/C/man3/wmemmove.3:36
1226 msgid ""
1227 "The programmer must ensure that there is room for at least I<n> wide "
1228 "characters at I<dest>."
1229 msgstr ""
1230
1231 #. type: Plain text
1232 #: build/C/man3/wcpncpy.3:70
1233 msgid ""
1234 "B<wcpncpy>()  returns a pointer to the last wide character written, that is, "
1235 "I<dest + n - 1>."
1236 msgstr ""
1237
1238 #. type: Plain text
1239 #: build/C/man3/wcpncpy.3:74
1240 msgid "B<stpncpy>(3), B<wcsncpy>(3)"
1241 msgstr ""
1242
1243 #. type: TH
1244 #: build/C/man3/wcrtomb.3:14
1245 #, no-wrap
1246 msgid "WCRTOMB"
1247 msgstr ""
1248
1249 #. type: Plain text
1250 #: build/C/man3/wcrtomb.3:17
1251 msgid "wcrtomb - convert a wide character to a multibyte sequence"
1252 msgstr ""
1253
1254 #. type: Plain text
1255 #: build/C/man3/wcrtomb.3:22
1256 #, no-wrap
1257 msgid "B<size_t wcrtomb(char *>I<s>B<, wchar_t >I<wc>B<, mbstate_t *>I<ps>B<);>\n"
1258 msgstr ""
1259
1260 #. type: Plain text
1261 #: build/C/man3/wcrtomb.3:37
1262 msgid ""
1263 "The main case for this function is when I<s> is not NULL and I<wc> is not a "
1264 "null wide character (L\\(aq\\e0\\(aq).  In this case, the B<wcrtomb>()  "
1265 "function converts the wide character I<wc> to its multibyte representation "
1266 "and stores it at the beginning of the character array pointed to by I<s>.  "
1267 "It updates the shift state I<*ps>, and returns the length of said multibyte "
1268 "representation, that is, the number of bytes written at I<s>."
1269 msgstr ""
1270
1271 #. type: Plain text
1272 #: build/C/man3/wcrtomb.3:52
1273 msgid ""
1274 "A different case is when I<s> is not NULL, but I<wc> is a null wide "
1275 "character (L\\(aq\\e0\\(aq).  In this case the B<wcrtomb>()  function stores "
1276 "at the character array pointed to by I<s> the shift sequence needed to bring "
1277 "I<*ps> back to the initial state, followed by a \\(aq\\e0\\(aq byte.  It "
1278 "updates the shift state I<*ps> (i.e., brings it into the initial state), and "
1279 "returns the length of the shift sequence plus one, that is, the number of "
1280 "bytes written at I<s>."
1281 msgstr ""
1282
1283 #. type: Plain text
1284 #: build/C/man3/wcrtomb.3:56
1285 msgid ""
1286 "A third case is when I<s> is NULL.  In this case I<wc> is ignored, and the "
1287 "function effectively returns"
1288 msgstr ""
1289
1290 #. type: Plain text
1291 #: build/C/man3/wcrtomb.3:58
1292 #, no-wrap
1293 msgid "    wcrtomb(buf, L\\(aq\\e0\\(aq, ps)\n"
1294 msgstr ""
1295
1296 #. type: Plain text
1297 #: build/C/man3/wcrtomb.3:62
1298 msgid "where I<buf> is an internal anonymous buffer."
1299 msgstr ""
1300
1301 #. type: Plain text
1302 #: build/C/man3/wcrtomb.3:67
1303 msgid ""
1304 "In all of the above cases, if I<ps> is a NULL pointer, a static anonymous "
1305 "state only known to the B<wcrtomb>()  function is used instead."
1306 msgstr ""
1307
1308 #. type: Plain text
1309 #: build/C/man3/wcrtomb.3:77
1310 msgid ""
1311 "The B<wcrtomb>()  function returns the number of bytes that have been or "
1312 "would have been written to the byte array at I<s>.  If I<wc> can not be "
1313 "represented as a multibyte sequence (according to the current locale), "
1314 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
1315 msgstr ""
1316
1317 #. type: Plain text
1318 #: build/C/man3/wcrtomb.3:86
1319 msgid ""
1320 "The behavior of B<wcrtomb>()  depends on the B<LC_CTYPE> category of the "
1321 "current locale."
1322 msgstr ""
1323
1324 #. type: Plain text
1325 #: build/C/man3/wcrtomb.3:89
1326 msgid "B<wcsrtombs>(3)"
1327 msgstr ""
1328
1329 #. type: TH
1330 #: build/C/man3/wcscasecmp.3:13
1331 #, no-wrap
1332 msgid "WCSCASECMP"
1333 msgstr ""
1334
1335 #. type: TH
1336 #: build/C/man3/wcscasecmp.3:13 build/C/man3/wcsdup.3:13 build/C/man3/wcsncasecmp.3:13
1337 #, no-wrap
1338 msgid "2010-09-15"
1339 msgstr ""
1340
1341 #. type: Plain text
1342 #: build/C/man3/wcscasecmp.3:16
1343 msgid "wcscasecmp - compare two wide-character strings, ignoring case"
1344 msgstr ""
1345
1346 #. type: Plain text
1347 #: build/C/man3/wcscasecmp.3:21
1348 #, no-wrap
1349 msgid "B<int wcscasecmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<);>\n"
1350 msgstr ""
1351
1352 #. type: Plain text
1353 #: build/C/man3/wcscasecmp.3:29
1354 msgid "B<wcscasecmp>():"
1355 msgstr ""
1356
1357 #. type: Plain text
1358 #: build/C/man3/wcscasecmp.3:52
1359 msgid ""
1360 "The B<wcscasecmp>()  function is the wide-character equivalent of the "
1361 "B<strcasecmp>(3)  function.  It compares the wide-character string pointed "
1362 "to by I<s1> and the wide-character string pointed to by I<s2>, ignoring case "
1363 "differences (B<towupper>(3), B<towlower>(3))."
1364 msgstr ""
1365
1366 #. type: Plain text
1367 #: build/C/man3/wcscasecmp.3:62
1368 msgid ""
1369 "The B<wcscasecmp>()  function returns zero if the wide-character strings at "
1370 "I<s1> and I<s2> are equal except for case distinctions.  It returns a "
1371 "positive integer if I<s1> is greater than I<s2>, ignoring case.  It returns "
1372 "a negative integer if I<s1> is smaller than I<s2>, ignoring case."
1373 msgstr ""
1374
1375 #. type: SH
1376 #: build/C/man3/wcscasecmp.3:62 build/C/man3/wcsncasecmp.3:65 build/C/man3/wcsnlen.3:63
1377 #, no-wrap
1378 msgid "VERSIONS"
1379 msgstr ""
1380
1381 #. type: Plain text
1382 #: build/C/man3/wcscasecmp.3:66
1383 msgid "The B<wcscasecmp>()  function is provided in glibc since version 2.1."
1384 msgstr ""
1385
1386 #. type: Plain text
1387 #: build/C/man3/wcscasecmp.3:70 build/C/man3/wcsdup.3:71 build/C/man3/wcsncasecmp.3:73
1388 msgid ""
1389 "POSIX.1-2008.  This function is not specified in POSIX.1-2001, and is not "
1390 "widely available on other systems."
1391 msgstr ""
1392
1393 #. type: Plain text
1394 #: build/C/man3/wcscasecmp.3:77
1395 msgid ""
1396 "The behavior of B<wcscasecmp>()  depends on the B<LC_CTYPE> category of the "
1397 "current locale."
1398 msgstr ""
1399
1400 #. type: Plain text
1401 #: build/C/man3/wcscasecmp.3:79
1402 msgid "B<strcasecmp>(3), B<wcscmp>(3)"
1403 msgstr ""
1404
1405 #. type: TH
1406 #: build/C/man3/wcscat.3:14
1407 #, no-wrap
1408 msgid "WCSCAT"
1409 msgstr ""
1410
1411 #. type: Plain text
1412 #: build/C/man3/wcscat.3:17
1413 msgid "wcscat - concatenate two wide-character strings"
1414 msgstr ""
1415
1416 #. type: Plain text
1417 #: build/C/man3/wcscat.3:22
1418 #, no-wrap
1419 msgid "B<wchar_t *wcscat(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1420 msgstr ""
1421
1422 #. type: Plain text
1423 #: build/C/man3/wcscat.3:33
1424 msgid ""
1425 "The B<wcscat>()  function is the wide-character equivalent of the "
1426 "B<strcat>(3)  function.  It copies the wide-character string pointed to by "
1427 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1428 "the end of the wide-character string pointed to by I<dest>."
1429 msgstr ""
1430
1431 #. type: Plain text
1432 #: build/C/man3/wcscat.3:38
1433 msgid ""
1434 "The programmer must ensure that there is room for at least I<wcslen(dest) + "
1435 "wcslen(src) + 1> wide characters at I<dest>."
1436 msgstr ""
1437
1438 #. type: Plain text
1439 #: build/C/man3/wcscat.3:41
1440 msgid "B<wcscat>()  returns I<dest>."
1441 msgstr ""
1442
1443 #. type: Plain text
1444 #: build/C/man3/wcscat.3:47
1445 msgid "B<strcat>(3), B<wcpcpy>(3), B<wcscpy>(3), B<wcsncat>(3)"
1446 msgstr ""
1447
1448 #. type: TH
1449 #: build/C/man3/wcschr.3:14
1450 #, no-wrap
1451 msgid "WCSCHR"
1452 msgstr ""
1453
1454 #. type: Plain text
1455 #: build/C/man3/wcschr.3:17
1456 msgid "wcschr - search a wide character in a wide-character string"
1457 msgstr ""
1458
1459 #. type: Plain text
1460 #: build/C/man3/wcschr.3:22
1461 #, no-wrap
1462 msgid "B<wchar_t *wcschr(const wchar_t *>I<wcs>B<, wchar_t >I<wc>B<);>\n"
1463 msgstr ""
1464
1465 #. type: Plain text
1466 #: build/C/man3/wcschr.3:32
1467 msgid ""
1468 "The B<wcschr>()  function is the wide-character equivalent of the "
1469 "B<strchr>(3)  function.  It searches the first occurrence of I<wc> in the "
1470 "wide-character string pointed to by I<wcs>."
1471 msgstr ""
1472
1473 #. type: Plain text
1474 #: build/C/man3/wcschr.3:38
1475 msgid ""
1476 "The B<wcschr>()  function returns a pointer to the first occurrence of I<wc> "
1477 "in the wide-character string pointed to by I<wcs>, or NULL if I<wc> does not "
1478 "occur in the string."
1479 msgstr ""
1480
1481 #. type: Plain text
1482 #: build/C/man3/wcschr.3:45
1483 msgid "B<strchr>(3), B<wcspbrk>(3), B<wcsrchr>(3), B<wcsstr>(3), B<wmemchr>(3)"
1484 msgstr ""
1485
1486 #. type: TH
1487 #: build/C/man3/wcscmp.3:14
1488 #, no-wrap
1489 msgid "WCSCMP"
1490 msgstr ""
1491
1492 #. type: Plain text
1493 #: build/C/man3/wcscmp.3:17
1494 msgid "wcscmp - compare two wide-character strings"
1495 msgstr ""
1496
1497 #. type: Plain text
1498 #: build/C/man3/wcscmp.3:22
1499 #, no-wrap
1500 msgid "B<int wcscmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<);>\n"
1501 msgstr ""
1502
1503 #. type: Plain text
1504 #: build/C/man3/wcscmp.3:32
1505 msgid ""
1506 "The B<wcscmp>()  function is the wide-character equivalent of the "
1507 "B<strcmp>(3)  function.  It compares the wide-character string pointed to by "
1508 "I<s1> and the wide-character string pointed to by I<s2>."
1509 msgstr ""
1510
1511 #. type: Plain text
1512 #: build/C/man3/wcscmp.3:43
1513 msgid ""
1514 "The B<wcscmp>()  function returns zero if the wide-character strings at "
1515 "I<s1> and I<s2> are equal.  It returns an integer greater than zero if at "
1516 "the first differing position I<i>, the corresponding wide-character I<s1[i]> "
1517 "is greater than I<s2[i]>.  It returns an integer less than zero if at the "
1518 "first differing position I<i>, the corresponding wide-character I<s1[i]> is "
1519 "less than I<s2[i]>."
1520 msgstr ""
1521
1522 #. type: Plain text
1523 #: build/C/man3/wcscmp.3:48
1524 msgid "B<strcmp>(3), B<wcscasecmp>(3), B<wmemcmp>(3)"
1525 msgstr ""
1526
1527 #. type: TH
1528 #: build/C/man3/wcscpy.3:14
1529 #, no-wrap
1530 msgid "WCSCPY"
1531 msgstr ""
1532
1533 #. type: Plain text
1534 #: build/C/man3/wcscpy.3:17
1535 msgid "wcscpy - copy a wide-character string"
1536 msgstr ""
1537
1538 #. type: Plain text
1539 #: build/C/man3/wcscpy.3:22
1540 #, no-wrap
1541 msgid "B<wchar_t *wcscpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<);>\n"
1542 msgstr ""
1543
1544 #. type: Plain text
1545 #: build/C/man3/wcscpy.3:34
1546 msgid ""
1547 "The B<wcscpy>()  function is the wide-character equivalent of the "
1548 "B<strcpy>(3)  function.  It copies the wide-character string pointed to by "
1549 "I<src>, including the terminating null wide character (L\\(aq\\e0\\(aq), to "
1550 "the array pointed to by I<dest>."
1551 msgstr ""
1552
1553 #. type: Plain text
1554 #: build/C/man3/wcscpy.3:43
1555 msgid "B<wcscpy>()  returns I<dest>."
1556 msgstr ""
1557
1558 #. type: Plain text
1559 #: build/C/man3/wcscpy.3:50
1560 msgid "B<strcpy>(3), B<wcpcpy>(3), B<wcscat>(3), B<wcsdup>(3), B<wmemcpy>(3)"
1561 msgstr ""
1562
1563 #. type: TH
1564 #: build/C/man3/wcscspn.3:14
1565 #, no-wrap
1566 msgid "WCSCSPN"
1567 msgstr ""
1568
1569 #. type: Plain text
1570 #: build/C/man3/wcscspn.3:17
1571 msgid "wcscspn - search a wide-character string for any of a set of wide characters"
1572 msgstr ""
1573
1574 #. type: Plain text
1575 #: build/C/man3/wcscspn.3:22
1576 #, no-wrap
1577 msgid "B<size_t wcscspn(const wchar_t *>I<wcs>B<, const wchar_t *>I<reject>B<);>\n"
1578 msgstr ""
1579
1580 #. type: Plain text
1581 #: build/C/man3/wcscspn.3:36
1582 msgid ""
1583 "The B<wcscspn>()  function is the wide-character equivalent of the "
1584 "B<strcspn>(3)  function.  It determines the length of the longest initial "
1585 "segment of I<wcs> which consists entirely of wide-characters not listed in "
1586 "I<reject>.  In other words, it searches for the first occurrence in the "
1587 "wide-character string I<wcs> of any of the characters in the wide-character "
1588 "string I<reject>."
1589 msgstr ""
1590
1591 #. type: Plain text
1592 #: build/C/man3/wcscspn.3:48
1593 msgid ""
1594 "The B<wcscspn>()  function returns the number of wide characters in the "
1595 "longest initial segment of I<wcs> which consists entirely of wide-characters "
1596 "not listed in I<reject>.  In other words, it returns the position of the "
1597 "first occurrence in the wide-character string I<wcs> of any of the "
1598 "characters in the wide-character string I<reject>, or I<wcslen(wcs)> if "
1599 "there is none."
1600 msgstr ""
1601
1602 #. type: Plain text
1603 #: build/C/man3/wcscspn.3:53
1604 msgid "B<strcspn>(3), B<wcspbrk>(3), B<wcsspn>(3)"
1605 msgstr ""
1606
1607 #. type: TH
1608 #: build/C/man3/wcsdup.3:13
1609 #, no-wrap
1610 msgid "WCSDUP"
1611 msgstr ""
1612
1613 #. type: Plain text
1614 #: build/C/man3/wcsdup.3:16
1615 msgid "wcsdup - duplicate a wide-character string"
1616 msgstr ""
1617
1618 #. type: Plain text
1619 #: build/C/man3/wcsdup.3:21
1620 #, no-wrap
1621 msgid "B<wchar_t *wcsdup(const wchar_t *>I<s>B<);>\n"
1622 msgstr ""
1623
1624 #. type: Plain text
1625 #: build/C/man3/wcsdup.3:29
1626 msgid "B<wcsdup>():"
1627 msgstr ""
1628
1629 #. type: Plain text
1630 #: build/C/man3/wcsdup.3:50
1631 msgid ""
1632 "The B<wcsdup>()  function is the wide-character equivalent of the "
1633 "B<strdup>(3)  function.  It allocates and returns a new wide-character "
1634 "string whose initial contents is a duplicate of the wide-character string "
1635 "pointed to by I<s>."
1636 msgstr ""
1637
1638 #. type: Plain text
1639 #: build/C/man3/wcsdup.3:56
1640 msgid ""
1641 "Memory for the new wide-character string is obtained with B<malloc>(3), and "
1642 "should be freed with B<free>(3)."
1643 msgstr ""
1644
1645 #. type: Plain text
1646 #: build/C/man3/wcsdup.3:62
1647 msgid ""
1648 "The B<wcsdup>()  function returns a pointer to the new wide-character "
1649 "string, or NULL if sufficient memory was not available."
1650 msgstr ""
1651
1652 #. type: SH
1653 #: build/C/man3/wcsdup.3:62
1654 #, no-wrap
1655 msgid "ERRORS"
1656 msgstr ""
1657
1658 #. type: TP
1659 #: build/C/man3/wcsdup.3:63
1660 #, no-wrap
1661 msgid "B<ENOMEM>"
1662 msgstr ""
1663
1664 #. type: Plain text
1665 #: build/C/man3/wcsdup.3:66
1666 msgid "Insufficient memory available to allocate duplicate string."
1667 msgstr ""
1668
1669 #. type: Plain text
1670 #: build/C/man3/wcsdup.3:73
1671 msgid "B<strdup>(3), B<wcscpy>(3)"
1672 msgstr ""
1673
1674 #. type: TH
1675 #: build/C/man3/wcslen.3:14
1676 #, no-wrap
1677 msgid "WCSLEN"
1678 msgstr ""
1679
1680 #. type: Plain text
1681 #: build/C/man3/wcslen.3:17
1682 msgid "wcslen - determine the length of a wide-character string"
1683 msgstr ""
1684
1685 #. type: Plain text
1686 #: build/C/man3/wcslen.3:22
1687 #, no-wrap
1688 msgid "B<size_t wcslen(const wchar_t *>I<s>B<);>\n"
1689 msgstr ""
1690
1691 #. type: Plain text
1692 #: build/C/man3/wcslen.3:32
1693 msgid ""
1694 "The B<wcslen>()  function is the wide-character equivalent of the "
1695 "B<strlen>(3)  function.  It determines the length of the wide-character "
1696 "string pointed to by I<s>, excluding the terminating null wide character "
1697 "(L\\(aq\\e0\\(aq)."
1698 msgstr ""
1699
1700 #. type: Plain text
1701 #: build/C/man3/wcslen.3:37
1702 msgid "The B<wcslen>()  function returns the number of wide characters in I<s>."
1703 msgstr ""
1704
1705 #. type: Plain text
1706 #: build/C/man3/wcslen.3:40
1707 msgid "B<strlen>(3)"
1708 msgstr ""
1709
1710 #. type: TH
1711 #: build/C/man3/wcsncasecmp.3:13
1712 #, no-wrap
1713 msgid "WCSNCASECMP"
1714 msgstr ""
1715
1716 #. type: Plain text
1717 #: build/C/man3/wcsncasecmp.3:16
1718 msgid "wcsncasecmp - compare two fixed-size wide-character strings, ignoring case"
1719 msgstr ""
1720
1721 #. type: Plain text
1722 #: build/C/man3/wcsncasecmp.3:21
1723 #, no-wrap
1724 msgid ""
1725 "B<int wcsncasecmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
1726 ">I<n>B<);>\n"
1727 msgstr ""
1728
1729 #. type: Plain text
1730 #: build/C/man3/wcsncasecmp.3:29
1731 msgid "B<wcsncasecmp>():"
1732 msgstr ""
1733
1734 #. type: Plain text
1735 #: build/C/man3/wcsncasecmp.3:53
1736 msgid ""
1737 "The B<wcsncasecmp>()  function is the wide-character equivalent of the "
1738 "B<strncasecmp>(3)  function.  It compares the wide-character string pointed "
1739 "to by I<s1> and the wide-character string pointed to by I<s2>, but at most "
1740 "I<n> wide characters from each string, ignoring case differences "
1741 "(B<towupper>(3), B<towlower>(3))."
1742 msgstr ""
1743
1744 #. type: Plain text
1745 #: build/C/man3/wcsncasecmp.3:65
1746 msgid ""
1747 "The B<wcsncasecmp>()  function returns zero if the wide-character strings at "
1748 "I<s1> and I<s2>, truncated to at most length I<n>, are equal except for case "
1749 "distinctions.  It returns a positive integer if truncated I<s1> is greater "
1750 "than truncated I<s2>, ignoring case.  It returns a negative integer if "
1751 "truncated I<s1> is smaller than truncated I<s2>, ignoring case."
1752 msgstr ""
1753
1754 #. type: Plain text
1755 #: build/C/man3/wcsncasecmp.3:69
1756 msgid "The B<wcsncasecmp>()  function is provided in glibc since version 2.1."
1757 msgstr ""
1758
1759 #. type: Plain text
1760 #: build/C/man3/wcsncasecmp.3:80
1761 msgid ""
1762 "The behavior of B<wcsncasecmp>()  depends on the B<LC_CTYPE> category of the "
1763 "current locale."
1764 msgstr ""
1765
1766 #. type: Plain text
1767 #: build/C/man3/wcsncasecmp.3:82
1768 msgid "B<strncasecmp>(3), B<wcsncmp>(3)"
1769 msgstr ""
1770
1771 #. type: TH
1772 #: build/C/man3/wcsncat.3:14
1773 #, no-wrap
1774 msgid "WCSNCAT"
1775 msgstr ""
1776
1777 #. type: Plain text
1778 #: build/C/man3/wcsncat.3:17
1779 msgid "wcsncat - concatenate two wide-character strings"
1780 msgstr ""
1781
1782 #. type: Plain text
1783 #: build/C/man3/wcsncat.3:22
1784 #, no-wrap
1785 msgid ""
1786 "B<wchar_t *wcsncat(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1787 ">I<n>B<);>\n"
1788 msgstr ""
1789
1790 #. type: Plain text
1791 #: build/C/man3/wcsncat.3:32
1792 msgid ""
1793 "The B<wcsncat>()  function is the wide-character equivalent of the "
1794 "B<strncat>(3)  function.  It copies at most I<n> wide characters from the "
1795 "wide-character string pointed to by I<src> to the end of the wide-character "
1796 "string pointed to by I<dest>, and adds a terminating null wide character "
1797 "(L\\(aq\\e0\\(aq)."
1798 msgstr ""
1799
1800 #. type: Plain text
1801 #: build/C/man3/wcsncat.3:37
1802 msgid ""
1803 "The programmer must ensure that there is room for at least I<wcslen(dest) + "
1804 "n + 1> wide characters at I<dest>."
1805 msgstr ""
1806
1807 #. type: Plain text
1808 #: build/C/man3/wcsncat.3:40
1809 msgid "B<wcsncat>()  returns I<dest>."
1810 msgstr ""
1811
1812 #. type: Plain text
1813 #: build/C/man3/wcsncat.3:44
1814 msgid "B<strncat>(3), B<wcscat>(3)"
1815 msgstr ""
1816
1817 #. type: TH
1818 #: build/C/man3/wcsncmp.3:14
1819 #, no-wrap
1820 msgid "WCSNCMP"
1821 msgstr ""
1822
1823 #. type: Plain text
1824 #: build/C/man3/wcsncmp.3:17
1825 msgid "wcsncmp - compare two fixed-size wide-character strings"
1826 msgstr ""
1827
1828 #. type: Plain text
1829 #: build/C/man3/wcsncmp.3:22
1830 #, no-wrap
1831 msgid ""
1832 "B<int wcsncmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
1833 ">I<n>B<);>\n"
1834 msgstr ""
1835
1836 #. type: Plain text
1837 #: build/C/man3/wcsncmp.3:34
1838 msgid ""
1839 "The B<wcsncmp>()  function is the wide-character equivalent of the "
1840 "B<strncmp>(3)  function.  It compares the wide-character string pointed to "
1841 "by I<s1> and the wide-character string pointed to by I<s2>, but at most I<n> "
1842 "wide characters from each string.  In each string, the comparison extends "
1843 "only up to the first occurrence of a nulll wide character (L\\(aq\\e0\\(aq), "
1844 "if any."
1845 msgstr ""
1846
1847 #. type: Plain text
1848 #: build/C/man3/wcsncmp.3:46
1849 msgid ""
1850 "The B<wcsncmp>()  function returns zero if the wide-character strings at "
1851 "I<s1> and I<s2>, truncated to at most length I<n>, are equal.  It returns an "
1852 "integer greater than zero if at the first differing position I<i> (I<i> "
1853 "E<lt> I<n>), the corresponding wide-character I<s1[i]> is greater than "
1854 "I<s2[i]>.  It returns an integer less than zero if at the first differing "
1855 "position I<i> (I<i> E<lt> I<n>), the corresponding wide-character I<s1[i]> "
1856 "is less than I<s2[i]>."
1857 msgstr ""
1858
1859 #. type: Plain text
1860 #: build/C/man3/wcsncmp.3:50
1861 msgid "B<strncmp>(3), B<wcsncasecmp>(3)"
1862 msgstr ""
1863
1864 #. type: TH
1865 #: build/C/man3/wcsncpy.3:14
1866 #, no-wrap
1867 msgid "WCSNCPY"
1868 msgstr ""
1869
1870 #. type: Plain text
1871 #: build/C/man3/wcsncpy.3:17
1872 msgid "wcsncpy - copy a fixed-size string of wide characters"
1873 msgstr ""
1874
1875 #. type: Plain text
1876 #: build/C/man3/wcsncpy.3:22
1877 #, no-wrap
1878 msgid ""
1879 "B<wchar_t *wcsncpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
1880 ">I<n>B<);>\n"
1881 msgstr ""
1882
1883 #. type: Plain text
1884 #: build/C/man3/wcsncpy.3:42
1885 msgid ""
1886 "The B<wcsncpy>()  function is the wide-character equivalent of the "
1887 "B<strncpy>(3)  function.  It copies at most I<n> wide characters from the "
1888 "wide-character string pointed to by I<src>, including the terminating null "
1889 "wide character (L\\(aq\\e0\\(aq), to the array pointed to by I<dest>.  "
1890 "Exactly I<n> wide characters are written at I<dest>.  If the length "
1891 "I<wcslen(src)> is smaller than I<n>, the remaining wide characters in the "
1892 "array pointed to by I<dest> are filled with null wide characters.  If the "
1893 "length I<wcslen(src)> is greater or equal to I<n>, the string pointed to by "
1894 "I<dest> will not be terminated by a null wide character."
1895 msgstr ""
1896
1897 #. type: Plain text
1898 #: build/C/man3/wcsncpy.3:50
1899 msgid "B<wcsncpy>()  returns I<dest>."
1900 msgstr ""
1901
1902 #. type: Plain text
1903 #: build/C/man3/wcsncpy.3:53
1904 msgid "B<strncpy>(3)"
1905 msgstr ""
1906
1907 #. type: TH
1908 #: build/C/man3/wcsnlen.3:13
1909 #, no-wrap
1910 msgid "WCSNLEN"
1911 msgstr ""
1912
1913 #. type: Plain text
1914 #: build/C/man3/wcsnlen.3:16
1915 msgid "wcsnlen - determine the length of a fixed-size wide-character string"
1916 msgstr ""
1917
1918 #. type: Plain text
1919 #: build/C/man3/wcsnlen.3:21
1920 #, no-wrap
1921 msgid "B<size_t wcsnlen(const wchar_t *>I<s>B<, size_t >I<maxlen>B<);>\n"
1922 msgstr ""
1923
1924 #. type: Plain text
1925 #: build/C/man3/wcsnlen.3:29
1926 msgid "B<wcsnlen>():"
1927 msgstr ""
1928
1929 #. type: Plain text
1930 #: build/C/man3/wcsnlen.3:57
1931 msgid ""
1932 "The B<wcsnlen>()  function is the wide-character equivalent of the "
1933 "B<strnlen>(3)  function.  It returns the number of wide-characters in the "
1934 "string pointed to by I<s>, not including the terminating null wide character "
1935 "(L\\(aq\\e0\\(aq), but at most I<maxlen> wide characters (note: this "
1936 "parameter is not a byte count).  In doing this, B<wcsnlen>()  looks only at "
1937 "the first I<maxlen> wide characters at I<s> and never beyond I<s+maxlen>."
1938 msgstr ""
1939
1940 #. type: Plain text
1941 #: build/C/man3/wcsnlen.3:63
1942 msgid ""
1943 "The B<wcsnlen>()  function returns I<wcslen(s)>, if that is less than "
1944 "I<maxlen>, or I<maxlen> if there is no null wide character among the first "
1945 "I<maxlen> wide characters pointed to by I<s>."
1946 msgstr ""
1947
1948 #. type: Plain text
1949 #: build/C/man3/wcsnlen.3:67
1950 msgid "The B<wcsnlen>()  function is provided in glibc since version 2.1."
1951 msgstr ""
1952
1953 #. type: Plain text
1954 #: build/C/man3/wcsnlen.3:71
1955 msgid "B<strnlen>(3), B<wcslen>(3)"
1956 msgstr ""
1957
1958 #. type: TH
1959 #: build/C/man3/wcsnrtombs.3:13
1960 #, no-wrap
1961 msgid "WCSNRTOMBS"
1962 msgstr ""
1963
1964 #. type: TH
1965 #: build/C/man3/wcsnrtombs.3:13 build/C/man3/wcsrtombs.3:14
1966 #, no-wrap
1967 msgid "2011-10-16"
1968 msgstr ""
1969
1970 #. type: Plain text
1971 #: build/C/man3/wcsnrtombs.3:16
1972 msgid "wcsnrtombs - convert a wide-character string to a multibyte string"
1973 msgstr ""
1974
1975 #. type: Plain text
1976 #: build/C/man3/wcsnrtombs.3:22
1977 #, no-wrap
1978 msgid ""
1979 "B<size_t wcsnrtombs(char *>I<dest>B<, const wchar_t **>I<src>B<, size_t "
1980 ">I<nwc>B<,>\n"
1981 "B<                  size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
1982 msgstr ""
1983
1984 #. type: Plain text
1985 #: build/C/man3/wcsnrtombs.3:30
1986 msgid "B<wcsnrtombs>():"
1987 msgstr ""
1988
1989 #. type: Plain text
1990 #: build/C/man3/wcsnrtombs.3:50
1991 msgid ""
1992 "The B<wcsnrtombs>()  function is like the B<wcsrtombs>(3)  function, except "
1993 "that the number of wide characters to be converted, starting at I<*src>, is "
1994 "limited to I<nwc>."
1995 msgstr ""
1996
1997 #. type: Plain text
1998 #: build/C/man3/wcsnrtombs.3:69
1999 msgid ""
2000 "If I<dest> is not a NULL pointer, the B<wcsnrtombs>()  function converts at "
2001 "most I<nwc> wide characters from the wide-character string I<*src> to a "
2002 "multibyte string starting at I<dest>.  At most I<len> bytes are written to "
2003 "I<dest>.  The shift state I<*ps> is updated.  The conversion is effectively "
2004 "performed by repeatedly calling I<wcrtomb(dest, *src, ps)>, as long as this "
2005 "call succeeds, and then incrementing I<dest> by the number of bytes written "
2006 "and I<*src> by one.  The conversion can stop for three reasons:"
2007 msgstr ""
2008
2009 #. type: Plain text
2010 #: build/C/man3/wcsnrtombs.3:77 build/C/man3/wcsrtombs.3:52
2011 msgid ""
2012 "1. A wide character has been encountered that can not be represented as a "
2013 "multibyte sequence (according to the current locale).  In this case I<*src> "
2014 "is left pointing to the invalid wide character, I<(size_t)\\ -1> is "
2015 "returned, and I<errno> is set to B<EILSEQ>."
2016 msgstr ""
2017
2018 #. type: Plain text
2019 #: build/C/man3/wcsnrtombs.3:84
2020 msgid ""
2021 "2. I<nwc> wide characters have been converted without encountering a null "
2022 "wide character (L\\(aq\\e0\\(aq), or the length limit forces a stop.  In "
2023 "this case I<*src> is left pointing to the next wide character to be "
2024 "converted, and the number of bytes written to I<dest> is returned."
2025 msgstr ""
2026
2027 #. type: Plain text
2028 #: build/C/man3/wcsnrtombs.3:92
2029 msgid ""
2030 "3. The wide-character string has been completely converted, including the "
2031 "terminating null wide character (which has the side effect of bringing back "
2032 "I<*ps> to the initial state).  In this case I<*src> is set to NULL, and the "
2033 "number of bytes written to I<dest>, excluding the terminating null byte "
2034 "(\\(aq\\e0\\(aq), is returned."
2035 msgstr ""
2036
2037 #. type: Plain text
2038 #: build/C/man3/wcsnrtombs.3:97
2039 msgid ""
2040 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
2041 "except that the converted bytes are not written out to memory, and that no "
2042 "destination length limit exists."
2043 msgstr ""
2044
2045 #. type: Plain text
2046 #: build/C/man3/wcsnrtombs.3:101
2047 msgid ""
2048 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
2049 "state only known to the wcsnrtombs function is used instead."
2050 msgstr ""
2051
2052 #. type: Plain text
2053 #: build/C/man3/wcsnrtombs.3:104 build/C/man3/wcsrtombs.3:79
2054 msgid ""
2055 "The programmer must ensure that there is room for at least I<len> bytes at "
2056 "I<dest>."
2057 msgstr ""
2058
2059 #. type: Plain text
2060 #: build/C/man3/wcsnrtombs.3:115
2061 msgid ""
2062 "The B<wcsnrtombs>()  function returns the number of bytes that make up the "
2063 "converted part of multibyte sequence, not including the terminating null "
2064 "byte.  If a wide character was encountered which could not be converted, "
2065 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
2066 msgstr ""
2067
2068 #. type: Plain text
2069 #: build/C/man3/wcsnrtombs.3:124
2070 msgid ""
2071 "The behavior of B<wcsnrtombs>()  depends on the B<LC_CTYPE> category of the "
2072 "current locale."
2073 msgstr ""
2074
2075 #. type: Plain text
2076 #: build/C/man3/wcsnrtombs.3:128
2077 msgid "B<iconv>(3), B<wcsrtombs>(3)"
2078 msgstr ""
2079
2080 #. type: TH
2081 #: build/C/man3/wcspbrk.3:14
2082 #, no-wrap
2083 msgid "WCSPBRK"
2084 msgstr ""
2085
2086 #. type: Plain text
2087 #: build/C/man3/wcspbrk.3:17
2088 msgid "wcspbrk - search a wide-character string for any of a set of wide characters"
2089 msgstr ""
2090
2091 #. type: Plain text
2092 #: build/C/man3/wcspbrk.3:22
2093 #, no-wrap
2094 msgid ""
2095 "B<wchar_t *wcspbrk(const wchar_t *>I<wcs>B<, const wchar_t "
2096 "*>I<accept>B<);>\n"
2097 msgstr ""
2098
2099 #. type: Plain text
2100 #: build/C/man3/wcspbrk.3:34
2101 msgid ""
2102 "The B<wcspbrk>()  function is the wide-character equivalent of the "
2103 "B<strpbrk>(3)  function.  It searches for the first occurrence in the "
2104 "wide-character string pointed to by I<wcs> of any of the characters in the "
2105 "wide-character string pointed to by I<accept>."
2106 msgstr ""
2107
2108 #. type: Plain text
2109 #: build/C/man3/wcspbrk.3:41
2110 msgid ""
2111 "The B<wcspbrk>()  function returns a pointer to the first occurrence in "
2112 "I<wcs> of any of the characters listed in I<accept>.  If I<wcs> contains "
2113 "none of these characters, NULL is returned."
2114 msgstr ""
2115
2116 #. type: Plain text
2117 #: build/C/man3/wcspbrk.3:46
2118 msgid "B<strpbrk>(3), B<wcschr>(3), B<wcscspn>(3)"
2119 msgstr ""
2120
2121 #. type: TH
2122 #: build/C/man3/wcsrchr.3:14
2123 #, no-wrap
2124 msgid "WCSRCHR"
2125 msgstr ""
2126
2127 #. type: Plain text
2128 #: build/C/man3/wcsrchr.3:17
2129 msgid "wcsrchr - search a wide character in a wide-character string"
2130 msgstr ""
2131
2132 #. type: Plain text
2133 #: build/C/man3/wcsrchr.3:22
2134 #, no-wrap
2135 msgid "B<wchar_t *wcsrchr(const wchar_t *>I<wcs>B<, wchar_t >I<wc>B<);>\n"
2136 msgstr ""
2137
2138 #. type: Plain text
2139 #: build/C/man3/wcsrchr.3:32
2140 msgid ""
2141 "The B<wcsrchr>()  function is the wide-character equivalent of the "
2142 "B<strrchr>(3)  function.  It searches the last occurrence of I<wc> in the "
2143 "wide-character string pointed to by I<wcs>."
2144 msgstr ""
2145
2146 #. type: Plain text
2147 #: build/C/man3/wcsrchr.3:38
2148 msgid ""
2149 "The B<wcsrchr>()  function returns a pointer to the last occurrence of I<wc> "
2150 "in the wide-character string pointed to by I<wcs>, or NULL if I<wc> does not "
2151 "occur in the string."
2152 msgstr ""
2153
2154 #. type: Plain text
2155 #: build/C/man3/wcsrchr.3:42
2156 msgid "B<strrchr>(3), B<wcschr>(3)"
2157 msgstr ""
2158
2159 #. type: TH
2160 #: build/C/man3/wcsrtombs.3:14
2161 #, no-wrap
2162 msgid "WCSRTOMBS"
2163 msgstr ""
2164
2165 #. type: Plain text
2166 #: build/C/man3/wcsrtombs.3:17
2167 msgid "wcsrtombs - convert a wide-character string to a multibyte string"
2168 msgstr ""
2169
2170 #. type: Plain text
2171 #: build/C/man3/wcsrtombs.3:23
2172 #, no-wrap
2173 msgid ""
2174 "B<size_t wcsrtombs(char *>I<dest>B<, const wchar_t **>I<src>B<,>\n"
2175 "B<                 size_t >I<len>B<, mbstate_t *>I<ps>B<);>\n"
2176 msgstr ""
2177
2178 #. type: Plain text
2179 #: build/C/man3/wcsrtombs.3:42
2180 msgid ""
2181 "If I<dest> is not a NULL pointer, the B<wcsrtombs>()  function converts the "
2182 "wide-character string I<*src> to a multibyte string starting at I<dest>.  At "
2183 "most I<len> bytes are written to I<dest>.  The shift state I<*ps> is "
2184 "updated.  The conversion is effectively performed by repeatedly calling "
2185 "I<wcrtomb(dest, *src, ps)>, as long as this call succeeds, and then "
2186 "incrementing I<dest> by the number of bytes written and I<*src> by one.  The "
2187 "conversion can stop for three reasons:"
2188 msgstr ""
2189
2190 #. type: Plain text
2191 #: build/C/man3/wcsrtombs.3:58
2192 msgid ""
2193 "2. The length limit forces a stop.  In this case I<*src> is left pointing to "
2194 "the next wide character to be converted, and the number of bytes written to "
2195 "I<dest> is returned."
2196 msgstr ""
2197
2198 #. type: Plain text
2199 #: build/C/man3/wcsrtombs.3:67
2200 msgid ""
2201 "3. The wide-character string has been completely converted, including the "
2202 "terminating null wide character (L\\(aq\\e0\\(aq), which has the side effect "
2203 "of bringing back I<*ps> to the initial state.  In this case I<*src> is set "
2204 "to NULL, and the number of bytes written to I<dest>, excluding the "
2205 "terminating null byte (\\(aq\\e0\\(aq), is returned."
2206 msgstr ""
2207
2208 #. type: Plain text
2209 #: build/C/man3/wcsrtombs.3:72
2210 msgid ""
2211 "If I<dest> is NULL, I<len> is ignored, and the conversion proceeds as above, "
2212 "except that the converted bytes are not written out to memory, and that no "
2213 "length limit exists."
2214 msgstr ""
2215
2216 #. type: Plain text
2217 #: build/C/man3/wcsrtombs.3:76
2218 msgid ""
2219 "In both of the above cases, if I<ps> is a NULL pointer, a static anonymous "
2220 "state only known to the wcsrtombs function is used instead."
2221 msgstr ""
2222
2223 #. type: Plain text
2224 #: build/C/man3/wcsrtombs.3:92
2225 msgid ""
2226 "The B<wcsrtombs>()  function returns the number of bytes that make up the "
2227 "converted part of multibyte sequence, not including the terminating null "
2228 "byte.  If a wide character was encountered which could not be converted, "
2229 "I<(size_t)\\ -1> is returned, and I<errno> set to B<EILSEQ>."
2230 msgstr ""
2231
2232 #. type: Plain text
2233 #: build/C/man3/wcsrtombs.3:101
2234 msgid ""
2235 "The behavior of B<wcsrtombs>()  depends on the B<LC_CTYPE> category of the "
2236 "current locale."
2237 msgstr ""
2238
2239 #. type: Plain text
2240 #: build/C/man3/wcsrtombs.3:106
2241 msgid "B<iconv>(3), B<wcsnrtombs>(3), B<wcstombs>(3)"
2242 msgstr ""
2243
2244 #. type: TH
2245 #: build/C/man3/wcsspn.3:14
2246 #, no-wrap
2247 msgid "WCSSPN"
2248 msgstr ""
2249
2250 #. type: Plain text
2251 #: build/C/man3/wcsspn.3:18
2252 msgid ""
2253 "wcsspn - advance in a wide-character string, skipping any of a set of wide "
2254 "characters"
2255 msgstr ""
2256
2257 #. type: Plain text
2258 #: build/C/man3/wcsspn.3:23
2259 #, no-wrap
2260 msgid "B<size_t wcsspn(const wchar_t *>I<wcs>B<, const wchar_t *>I<accept>B<);>\n"
2261 msgstr ""
2262
2263 #. type: Plain text
2264 #: build/C/man3/wcsspn.3:36
2265 msgid ""
2266 "The B<wcsspn>()  function is the wide-character equivalent of the "
2267 "B<strspn>(3)  function.  It determines the length of the longest initial "
2268 "segment of I<wcs> which consists entirely of wide-characters listed in "
2269 "I<accept>.  In other words, it searches for the first occurrence in the "
2270 "wide-character string I<wcs> of a wide-character not contained in the "
2271 "wide-character string I<accept>."
2272 msgstr ""
2273
2274 #. type: Plain text
2275 #: build/C/man3/wcsspn.3:47
2276 msgid ""
2277 "The B<wcsspn>()  function returns the number of wide characters in the "
2278 "longest initial segment of I<wcs> which consists entirely of wide-characters "
2279 "listed in I<accept>.  In other words, it returns the position of the first "
2280 "occurrence in the wide-character string I<wcs> of a wide-character not "
2281 "contained in the wide-character string I<accept>, or I<wcslen(wcs)> if there "
2282 "is none."
2283 msgstr ""
2284
2285 #. type: Plain text
2286 #: build/C/man3/wcsspn.3:51
2287 msgid "B<strspn>(3), B<wcscspn>(3)"
2288 msgstr ""
2289
2290 #. type: TH
2291 #: build/C/man3/wcsstr.3:14
2292 #, no-wrap
2293 msgid "WCSSTR"
2294 msgstr ""
2295
2296 #. type: Plain text
2297 #: build/C/man3/wcsstr.3:17
2298 msgid "wcsstr - locate a substring in a wide-character string"
2299 msgstr ""
2300
2301 #. type: Plain text
2302 #: build/C/man3/wcsstr.3:22
2303 #, no-wrap
2304 msgid ""
2305 "B<wchar_t *wcsstr(const wchar_t *>I<haystack>B<, const wchar_t "
2306 "*>I<needle>B<);>\n"
2307 msgstr ""
2308
2309 #. type: Plain text
2310 #: build/C/man3/wcsstr.3:32
2311 msgid ""
2312 "The B<wcsstr>()  function is the wide-character equivalent of the "
2313 "B<strstr>(3)  function.  It searches for the first occurrence of the "
2314 "wide-character string I<needle> (without its terminating null wide character "
2315 "(L\\(aq\\e0\\(aq))  as a substring in the wide-character string I<haystack>."
2316 msgstr ""
2317
2318 #. type: Plain text
2319 #: build/C/man3/wcsstr.3:39
2320 msgid ""
2321 "The B<wcsstr>()  function returns a pointer to the first occurrence of "
2322 "I<needle> in I<haystack>.  It returns NULL if I<needle> does not occur as a "
2323 "substring in I<haystack>."
2324 msgstr ""
2325
2326 #. type: Plain text
2327 #: build/C/man3/wcsstr.3:43
2328 msgid ""
2329 "Note the special case: If I<needle> is the empty wide-character string, the "
2330 "return value is always I<haystack> itself."
2331 msgstr ""
2332
2333 #. type: Plain text
2334 #: build/C/man3/wcsstr.3:47
2335 msgid "B<strstr>(3), B<wcschr>(3)"
2336 msgstr ""
2337
2338 #. type: TH
2339 #: build/C/man3/wcstoimax.3:23
2340 #, no-wrap
2341 msgid "WCSTOIMAX"
2342 msgstr ""
2343
2344 #. type: TH
2345 #: build/C/man3/wcstoimax.3:23
2346 #, no-wrap
2347 msgid "2003-11-01"
2348 msgstr ""
2349
2350 #. type: Plain text
2351 #: build/C/man3/wcstoimax.3:26
2352 msgid "wcstoimax, wcstoumax - convert wide-character string to integer"
2353 msgstr ""
2354
2355 #. type: Plain text
2356 #: build/C/man3/wcstoimax.3:29
2357 #, no-wrap
2358 msgid "B<#include E<lt>stddef.hE<gt>>\n"
2359 msgstr ""
2360
2361 #. type: Plain text
2362 #: build/C/man3/wcstoimax.3:31
2363 #, no-wrap
2364 msgid "B<#include E<lt>inttypes.hE<gt>>\n"
2365 msgstr ""
2366
2367 #. type: Plain text
2368 #: build/C/man3/wcstoimax.3:34
2369 #, no-wrap
2370 msgid ""
2371 "B<intmax_t wcstoimax(const wchar_t *>I<nptr>B<, wchar_t **>I<endptr>B<, int "
2372 ">I<base>B<);>\n"
2373 msgstr ""
2374
2375 #. type: Plain text
2376 #: build/C/man3/wcstoimax.3:37
2377 #, no-wrap
2378 msgid ""
2379 "B<uintmax_t wcstoumax(const wchar_t *>I<nptr>B<, wchar_t **>I<endptr>B<, int "
2380 ">I<base>B<);>\n"
2381 msgstr ""
2382
2383 #. type: Plain text
2384 #: build/C/man3/wcstoimax.3:48
2385 msgid ""
2386 "These functions are just like B<wcstol>(3)  and B<wcstoul>(3), except that "
2387 "they return a value of type I<intmax_t> and I<uintmax_t>, respectively."
2388 msgstr ""
2389
2390 #.  FIXME . the pages referred to by the following xrefs are not yet written
2391 #. type: Plain text
2392 #: build/C/man3/wcstoimax.3:57
2393 msgid ""
2394 "B<imaxabs>(3), B<imaxdiv>(3), B<strtoimax>(3), B<strtoumax>(3), "
2395 "B<wcstol>(3), B<wcstoul>(3)"
2396 msgstr ""
2397
2398 #. type: TH
2399 #: build/C/man3/wcstok.3:14
2400 #, no-wrap
2401 msgid "WCSTOK"
2402 msgstr ""
2403
2404 #. type: Plain text
2405 #: build/C/man3/wcstok.3:17
2406 msgid "wcstok - split wide-character string into tokens"
2407 msgstr ""
2408
2409 #. type: Plain text
2410 #: build/C/man3/wcstok.3:23
2411 #, no-wrap
2412 msgid ""
2413 "B<wchar_t *wcstok(wchar_t *>I<wcs>B<, const wchar_t *>I<delim>B<, wchar_t "
2414 "**>I<ptr>B<);>\n"
2415 msgstr ""
2416
2417 #. type: Plain text
2418 #: build/C/man3/wcstok.3:34
2419 msgid ""
2420 "The B<wcstok>()  function is the wide-character equivalent of the "
2421 "B<strtok>(3)  function, with an added argument to make it multithread-safe.  "
2422 "It can be used to split a wide-character string I<wcs> into tokens, where a "
2423 "token is defined as a substring not containing any wide-characters from "
2424 "I<delim>."
2425 msgstr ""
2426
2427 #. type: Plain text
2428 #: build/C/man3/wcstok.3:55
2429 msgid ""
2430 "The search starts at I<wcs>, if I<wcs> is not NULL, or at I<*ptr>, if I<wcs> "
2431 "is NULL.  First, any delimiter wide-characters are skipped, that is, the "
2432 "pointer is advanced beyond any wide-characters which occur in I<delim>.  If "
2433 "the end of the wide-character string is now reached, B<wcstok>()  returns "
2434 "NULL, to indicate that no tokens were found, and stores an appropriate value "
2435 "in I<*ptr>, so that subsequent calls to B<wcstok>()  will continue to return "
2436 "NULL.  Otherwise, the B<wcstok>()  function recognizes the beginning of a "
2437 "token and returns a pointer to it, but before doing that, it zero-terminates "
2438 "the token by replacing the next wide-character which occurs in I<delim> with "
2439 "a null wide character (L\\(aq\\e0\\(aq), and it updates I<*ptr> so that "
2440 "subsequent calls will continue searching after the end of recognized token."
2441 msgstr ""
2442
2443 #. type: Plain text
2444 #: build/C/man3/wcstok.3:60
2445 msgid ""
2446 "The B<wcstok>()  function returns a pointer to the next token, or NULL if no "
2447 "further token was found."
2448 msgstr ""
2449
2450 #. type: Plain text
2451 #: build/C/man3/wcstok.3:65
2452 msgid ""
2453 "The original I<wcs> wide-character string is destructively modified during "
2454 "the operation."
2455 msgstr ""
2456
2457 #. type: SH
2458 #: build/C/man3/wcstok.3:65
2459 #, no-wrap
2460 msgid "EXAMPLE"
2461 msgstr ""
2462
2463 #. type: Plain text
2464 #: build/C/man3/wcstok.3:67
2465 msgid ""
2466 "The following code loops over the tokens contained in a wide-character "
2467 "string."
2468 msgstr ""
2469
2470 #. type: Plain text
2471 #: build/C/man3/wcstok.3:77
2472 #, no-wrap
2473 msgid ""
2474 "wchar_t *wcs = ...;\n"
2475 "wchar_t *token;\n"
2476 "wchar_t *state;\n"
2477 "for (token = wcstok(wcs, \" \\et\\en\", &state);\n"
2478 "    token != NULL;\n"
2479 "    token = wcstok(NULL, \" \\et\\en\", &state)) {\n"
2480 "    ...\n"
2481 "}\n"
2482 msgstr ""
2483
2484 #. type: Plain text
2485 #: build/C/man3/wcstok.3:80
2486 msgid "B<strtok>(3), B<wcschr>(3)"
2487 msgstr ""
2488
2489 #. type: TH
2490 #: build/C/man3/wcswidth.3:13
2491 #, no-wrap
2492 msgid "WCSWIDTH"
2493 msgstr ""
2494
2495 #. type: TH
2496 #: build/C/man3/wcswidth.3:13
2497 #, no-wrap
2498 msgid "2010-09-10"
2499 msgstr ""
2500
2501 #. type: Plain text
2502 #: build/C/man3/wcswidth.3:16
2503 msgid "wcswidth - determine columns needed for a fixed-size wide-character string"
2504 msgstr ""
2505
2506 #. type: Plain text
2507 #: build/C/man3/wcswidth.3:20
2508 #, no-wrap
2509 msgid ""
2510 "B<#define _XOPEN_SOURCE>             /* See feature_test_macros(7) */\n"
2511 "B<#include E<lt>wchar.hE<gt>>\n"
2512 msgstr ""
2513
2514 #. type: Plain text
2515 #: build/C/man3/wcswidth.3:22
2516 #, no-wrap
2517 msgid "B<int wcswidth(const wchar_t *>I<s>B<, size_t >I<n>B<);>\n"
2518 msgstr ""
2519
2520 #. type: Plain text
2521 #: build/C/man3/wcswidth.3:32
2522 msgid ""
2523 "The B<wcswidth>()  function returns the number of columns needed to "
2524 "represent the wide-character string pointed to by I<s>, but at most I<n> "
2525 "wide characters.  If a nonprintable wide character occurs among these "
2526 "characters, -1 is returned."
2527 msgstr ""
2528
2529 #. type: Plain text
2530 #: build/C/man3/wcswidth.3:38
2531 msgid ""
2532 "The B<wcswidth>()  function returns the number of column positions for the "
2533 "wide-character string I<s>, truncated to at most length I<n>."
2534 msgstr ""
2535
2536 #. type: Plain text
2537 #: build/C/man3/wcswidth.3:40 build/C/man3/wcwidth.3:39
2538 msgid "POSIX.1-2001."
2539 msgstr ""
2540
2541 #. type: Plain text
2542 #: build/C/man3/wcswidth.3:47
2543 msgid ""
2544 "The behavior of B<wcswidth>()  depends on the B<LC_CTYPE> category of the "
2545 "current locale."
2546 msgstr ""
2547
2548 #. type: Plain text
2549 #: build/C/man3/wcswidth.3:49
2550 msgid "B<iswprint>(3), B<wcwidth>(3)"
2551 msgstr ""
2552
2553 #. type: TH
2554 #: build/C/man3/wctob.3:14
2555 #, no-wrap
2556 msgid "WCTOB"
2557 msgstr ""
2558
2559 #. type: Plain text
2560 #: build/C/man3/wctob.3:17
2561 msgid "wctob - try to represent a wide character as a single byte"
2562 msgstr ""
2563
2564 #. type: Plain text
2565 #: build/C/man3/wctob.3:22
2566 #, no-wrap
2567 msgid "B<int wctob(wint_t >I<c>B<);>\n"
2568 msgstr ""
2569
2570 #. type: Plain text
2571 #: build/C/man3/wctob.3:32
2572 msgid ""
2573 "The B<wctob>()  function tests whether the multibyte representation of the "
2574 "wide character I<c>, starting in the initial state, consists of a single "
2575 "byte.  If so, it is returned as an I<unsigned char>."
2576 msgstr ""
2577
2578 #. type: Plain text
2579 #: build/C/man3/wctob.3:38
2580 msgid ""
2581 "Never use this function.  It cannot help you in writing internationalized "
2582 "programs.  Internationalized programs must never distinguish single-byte and "
2583 "multibyte characters."
2584 msgstr ""
2585
2586 #. type: Plain text
2587 #: build/C/man3/wctob.3:43
2588 msgid ""
2589 "The B<wctob>()  function returns the single-byte representation of I<c>, if "
2590 "it exists, of B<EOF> otherwise."
2591 msgstr ""
2592
2593 #. type: Plain text
2594 #: build/C/man3/wctob.3:52
2595 msgid ""
2596 "The behavior of B<wctob>()  depends on the B<LC_CTYPE> category of the "
2597 "current locale."
2598 msgstr ""
2599
2600 #. type: Plain text
2601 #: build/C/man3/wctob.3:61
2602 msgid ""
2603 "This function should never be used.  Internationalized programs must never "
2604 "distinguish single-byte and multibyte characters.  Use either B<wctomb>(3)  "
2605 "or the thread-safe B<wcrtomb>(3)  instead."
2606 msgstr ""
2607
2608 #. type: Plain text
2609 #: build/C/man3/wctob.3:64
2610 msgid "B<btowc>(3), B<wcrtomb>(3), B<wctomb>(3)"
2611 msgstr ""
2612
2613 #. type: TH
2614 #: build/C/man3/wcwidth.3:13
2615 #, no-wrap
2616 msgid "WCWIDTH"
2617 msgstr ""
2618
2619 #. type: Plain text
2620 #: build/C/man3/wcwidth.3:16
2621 msgid "wcwidth - determine columns needed for a wide character"
2622 msgstr ""
2623
2624 #. type: Plain text
2625 #: build/C/man3/wcwidth.3:20
2626 #, no-wrap
2627 msgid ""
2628 "B<#define _XOPEN_SOURCE>       /* See feature_test_macros(7) */\n"
2629 "B<#include E<lt>wchar.hE<gt>>\n"
2630 msgstr ""
2631
2632 #. type: Plain text
2633 #: build/C/man3/wcwidth.3:22
2634 #, no-wrap
2635 msgid "B<int wcwidth(wchar_t >I<c>B<);>\n"
2636 msgstr ""
2637
2638 #. type: Plain text
2639 #: build/C/man3/wcwidth.3:32
2640 msgid ""
2641 "The B<wcwidth>()  function returns the number of columns needed to represent "
2642 "the wide character I<c>.  If I<c> is a printable wide character, the value "
2643 "is at least 0.  If I<c> is null wide character (L\\(aq\\e0\\(aq), the value "
2644 "is 0.  Otherwise -1 is returned."
2645 msgstr ""
2646
2647 #. type: Plain text
2648 #: build/C/man3/wcwidth.3:37
2649 msgid "The B<wcwidth>()  function returns the number of column positions for I<c>."
2650 msgstr ""
2651
2652 #. type: Plain text
2653 #: build/C/man3/wcwidth.3:41
2654 msgid "Note that glibc before 2.2.5 used the prototype"
2655 msgstr ""
2656
2657 #. type: Plain text
2658 #: build/C/man3/wcwidth.3:44
2659 #, no-wrap
2660 msgid "B<int wcwidth(wint_t >I<c>B<);>\n"
2661 msgstr ""
2662
2663 #. type: Plain text
2664 #: build/C/man3/wcwidth.3:52
2665 msgid ""
2666 "The behavior of B<wcwidth>()  depends on the B<LC_CTYPE> category of the "
2667 "current locale."
2668 msgstr ""
2669
2670 #. type: Plain text
2671 #: build/C/man3/wcwidth.3:54
2672 msgid "B<iswprint>(3), B<wcswidth>(3)"
2673 msgstr ""
2674
2675 #. type: TH
2676 #: build/C/man3/wmemchr.3:14
2677 #, no-wrap
2678 msgid "WMEMCHR"
2679 msgstr ""
2680
2681 #. type: Plain text
2682 #: build/C/man3/wmemchr.3:17
2683 msgid "wmemchr - search a wide character in a wide-character array"
2684 msgstr ""
2685
2686 #. type: Plain text
2687 #: build/C/man3/wmemchr.3:22
2688 #, no-wrap
2689 msgid ""
2690 "B<wchar_t *wmemchr(const wchar_t *>I<s>B<, wchar_t >I<c>B<, size_t "
2691 ">I<n>B<);>\n"
2692 msgstr ""
2693
2694 #. type: Plain text
2695 #: build/C/man3/wmemchr.3:31
2696 msgid ""
2697 "The B<wmemchr>()  function is the wide-character equivalent of the "
2698 "B<memchr>(3)  function.  It searches the I<n> wide characters starting at "
2699 "I<s> for the first occurrence of the wide character I<c>."
2700 msgstr ""
2701
2702 #. type: Plain text
2703 #: build/C/man3/wmemchr.3:37
2704 msgid ""
2705 "The B<wmemchr>()  function returns a pointer to the first occurrence of I<c> "
2706 "among the I<n> wide characters starting at I<s>, or NULL if I<c> does not "
2707 "occur among these."
2708 msgstr ""
2709
2710 #. type: Plain text
2711 #: build/C/man3/wmemchr.3:41
2712 msgid "B<memchr>(3), B<wcschr>(3)"
2713 msgstr ""
2714
2715 #. type: TH
2716 #: build/C/man3/wmemcmp.3:13
2717 #, no-wrap
2718 msgid "WMEMCMP"
2719 msgstr ""
2720
2721 #. type: Plain text
2722 #: build/C/man3/wmemcmp.3:16
2723 msgid "wmemcmp - compare two arrays of wide-characters"
2724 msgstr ""
2725
2726 #. type: Plain text
2727 #: build/C/man3/wmemcmp.3:21
2728 #, no-wrap
2729 msgid ""
2730 "B<int wmemcmp(const wchar_t *>I<s1>B<, const wchar_t *>I<s2>B<, size_t "
2731 ">I<n>B<);>\n"
2732 msgstr ""
2733
2734 #. type: Plain text
2735 #: build/C/man3/wmemcmp.3:30
2736 msgid ""
2737 "The B<wmemcmp>()  function is the wide-character equivalent of the "
2738 "B<memcmp>(3)  function.  It compares the I<n> wide-characters starting at "
2739 "I<s1> and the I<n> wide-characters starting at I<s2>."
2740 msgstr ""
2741
2742 #. type: Plain text
2743 #: build/C/man3/wmemcmp.3:44
2744 msgid ""
2745 "The B<wmemcmp>()  function returns zero if the wide-character arrays of size "
2746 "I<n> at I<s1> and I<s2> are equal.  It returns an integer greater than zero "
2747 "if at the first differing position I<i> (I<i> E<lt> I<n>), the corresponding "
2748 "wide-character I<s1[i]> is greater than I<s2[i]>.  It returns an integer "
2749 "less than zero if at the first differing position I<i> (I<i> E<lt> I<n>), "
2750 "the corresponding wide-character I<s1[i]> is less than I<s2[i]>."
2751 msgstr ""
2752
2753 #. type: Plain text
2754 #: build/C/man3/wmemcmp.3:48
2755 msgid "B<memcmp>(3), B<wcscmp>(3)"
2756 msgstr ""
2757
2758 #. type: TH
2759 #: build/C/man3/wmemcpy.3:14
2760 #, no-wrap
2761 msgid "WMEMCPY"
2762 msgstr ""
2763
2764 #. type: Plain text
2765 #: build/C/man3/wmemcpy.3:17
2766 msgid "wmemcpy - copy an array of wide-characters"
2767 msgstr ""
2768
2769 #. type: Plain text
2770 #: build/C/man3/wmemcpy.3:22
2771 #, no-wrap
2772 msgid ""
2773 "B<wchar_t *wmemcpy(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
2774 ">I<n>B<);>\n"
2775 msgstr ""
2776
2777 #. type: Plain text
2778 #: build/C/man3/wmemcpy.3:31
2779 msgid ""
2780 "The B<wmemcpy>()  function is the wide-character equivalent of the "
2781 "B<memcpy>(3)  function.  It copies I<n> wide characters from the array "
2782 "starting at I<src> to the array starting at I<dest>."
2783 msgstr ""
2784
2785 #. type: Plain text
2786 #: build/C/man3/wmemcpy.3:36
2787 msgid ""
2788 "The arrays may not overlap; use B<wmemmove>(3)  to copy between overlapping "
2789 "arrays."
2790 msgstr ""
2791
2792 #. type: Plain text
2793 #: build/C/man3/wmemcpy.3:42
2794 msgid "B<wmemcpy>()  returns I<dest>."
2795 msgstr ""
2796
2797 #. type: Plain text
2798 #: build/C/man3/wmemcpy.3:48
2799 msgid "B<memcpy>(3), B<wcscpy>(3), B<wmemmove>(3), B<wmempcpy>(3)"
2800 msgstr ""
2801
2802 #. type: TH
2803 #: build/C/man3/wmemmove.3:14
2804 #, no-wrap
2805 msgid "WMEMMOVE"
2806 msgstr ""
2807
2808 #. type: Plain text
2809 #: build/C/man3/wmemmove.3:17
2810 msgid "wmemmove - copy an array of wide-characters"
2811 msgstr ""
2812
2813 #. type: Plain text
2814 #: build/C/man3/wmemmove.3:22
2815 #, no-wrap
2816 msgid ""
2817 "B<wchar_t *wmemmove(wchar_t *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
2818 ">I<n>B<);>\n"
2819 msgstr ""
2820
2821 #. type: Plain text
2822 #: build/C/man3/wmemmove.3:33
2823 msgid ""
2824 "The B<wmemmove>()  function is the wide-character equivalent of the "
2825 "B<memmove>(3)  function.  It copies I<n> wide characters from the array "
2826 "starting at I<src> to the array starting at I<dest>.  The arrays may "
2827 "overlap."
2828 msgstr ""
2829
2830 #. type: Plain text
2831 #: build/C/man3/wmemmove.3:39
2832 msgid "B<wmemmove>()  returns I<dest>."
2833 msgstr ""
2834
2835 #. type: Plain text
2836 #: build/C/man3/wmemmove.3:43
2837 msgid "B<memmove>(3), B<wmemcpy>(3)"
2838 msgstr ""
2839
2840 #. type: TH
2841 #: build/C/man3/wmemset.3:14
2842 #, no-wrap
2843 msgid "WMEMSET"
2844 msgstr ""
2845
2846 #. type: Plain text
2847 #: build/C/man3/wmemset.3:17
2848 msgid "wmemset - fill an array of wide-characters with a constant wide character"
2849 msgstr ""
2850
2851 #. type: Plain text
2852 #: build/C/man3/wmemset.3:22
2853 #, no-wrap
2854 msgid "B<wchar_t *wmemset(wchar_t *>I<wcs>B<, wchar_t >I<wc>B<, size_t >I<n>B<);>\n"
2855 msgstr ""
2856
2857 #. type: Plain text
2858 #: build/C/man3/wmemset.3:31
2859 msgid ""
2860 "The B<wmemset>()  function is the wide-character equivalent of the "
2861 "B<memset>(3)  function.  It fills the array of I<n> wide-characters starting "
2862 "at I<wcs> with I<n> copies of the wide character I<wc>."
2863 msgstr ""
2864
2865 #. type: Plain text
2866 #: build/C/man3/wmemset.3:34
2867 msgid "B<wmemset>()  returns I<wcs>."
2868 msgstr ""
2869
2870 #. type: Plain text
2871 #: build/C/man3/wmemset.3:37
2872 msgid "B<memset>(3)"
2873 msgstr ""