# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2024-06-01 06:02+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "mbstowcs" msgstr "" #. type: TH #: archlinux debian-unstable opensuse-tumbleweed #, no-wrap msgid "2024-05-02" msgstr "" #. type: TH #: archlinux debian-unstable #, no-wrap msgid "Linux man-pages 6.8" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "mbstowcs - convert a multibyte string to a wide-character string" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "LIBRARY" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Standard C library (I, I<-lc>)" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<#include Estdlib.hE>\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "BIB<[restrict .>IB<], const char *restrict >IB<,>\n" "B< size_t >IB<);>\n" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "If I is not NULL, convert the multibyte string I to a wide-" "character string starting at I. At most I wide characters are " "written to I. The sequence of characters in the string I shall " "begin in the initial shift state. The conversion can stop for three reasons:" msgstr "" #. type: IP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "\\[bu]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "An invalid multibyte sequence has been encountered. In this case, " "I<(size_t)\\ -1> is returned." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "I non-L\\[aq]\\e0\\[aq] wide characters have been stored at I. " "In this case, the number of wide characters written to I is returned, " "but the shift state at this point is lost." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The multibyte string has been completely converted, including the " "terminating null character (\\[aq]\\e0\\[aq]). In this case, the number of " "wide characters written to I, excluding the terminating null wide " "character, is returned." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "If I is NULL, I is ignored, and the conversion proceeds as " "above, except that the converted wide characters are not written out to " "memory, and that no length limit exists." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "In order to avoid the case 2 above, the programmer should make sure I " "is greater than or equal to I." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "The programmer must ensure that there is room for at least I wide " "characters at I." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "The number of wide characters that make up the converted part of the wide-" "character string, not including the terminating null wide character. If an " "invalid multibyte sequence was encountered, I<(size_t)\\ -1> is returned." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "ATTRIBUTES" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "For an explanation of the terms used in this section, see B(7)." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Interface" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Attribute" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Value" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid ".na\n" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid ".nh\n" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B()" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Thread safety" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Safe" msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "VERSIONS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The function B(3) provides a better interface to the same " "functionality." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "STANDARDS" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "C11, POSIX.1-2008." msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "HISTORY" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "POSIX.1-2001, C99." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The behavior of B() depends on the B category of the " "current locale." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The program below illustrates the use of B(), as well as some of " "the wide character classification functions. An example run is the " "following:" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "$ ./t_mbstowcs de_DE.UTF-8 Grüße!\n" "Length of source string (excluding terminator):\n" " 8 bytes\n" " 6 multibyte characters\n" "\\&\n" "Wide character string is: Grüße! (6 characters)\n" " G alpha upper\n" " r alpha lower\n" " ü alpha lower\n" " ß alpha lower\n" " e alpha lower\n" " ! !alpha\n" msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Program source" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "#include Elocale.hE\n" "#include Estdio.hE\n" "#include Estdlib.hE\n" "#include Estring.hE\n" "#include Ewchar.hE\n" "#include Ewctype.hE\n" "\\&\n" "int\n" "main(int argc, char *argv[])\n" "{\n" " size_t mbslen; /* Number of multibyte characters in source */\n" " wchar_t *wcs; /* Pointer to converted wide character string */\n" "\\&\n" " if (argc E 3) {\n" " fprintf(stderr, \"Usage: %s ElocaleE EstringE\\en\", argv[0]);\n" " exit(EXIT_FAILURE);\n" " }\n" "\\&\n" " /* Apply the specified locale. */\n" "\\&\n" " if (setlocale(LC_ALL, argv[1]) == NULL) {\n" " perror(\"setlocale\");\n" " exit(EXIT_FAILURE);\n" " }\n" "\\&\n" " /* Calculate the length required to hold argv[2] converted to\n" " a wide character string. */\n" "\\&\n" " mbslen = mbstowcs(NULL, argv[2], 0);\n" " if (mbslen == (size_t) -1) {\n" " perror(\"mbstowcs\");\n" " exit(EXIT_FAILURE);\n" " }\n" "\\&\n" " /* Describe the source string to the user. */\n" "\\&\n" " printf(\"Length of source string (excluding terminator):\\en\");\n" " printf(\" %zu bytes\\en\", strlen(argv[2]));\n" " printf(\" %zu multibyte characters\\en\\en\", mbslen);\n" "\\&\n" " /* Allocate wide character string of the desired size. Add 1\n" " to allow for terminating null wide character (L\\[aq]\\e0\\[aq]). */\n" "\\&\n" " wcs = calloc(mbslen + 1, sizeof(*wcs));\n" " if (wcs == NULL) {\n" " perror(\"calloc\");\n" " exit(EXIT_FAILURE);\n" " }\n" "\\&\n" " /* Convert the multibyte character string in argv[2] to a\n" " wide character string. */\n" "\\&\n" " if (mbstowcs(wcs, argv[2], mbslen + 1) == (size_t) -1) {\n" " perror(\"mbstowcs\");\n" " exit(EXIT_FAILURE);\n" " }\n" "\\&\n" " printf(\"Wide character string is: %ls (%zu characters)\\en\",\n" " wcs, mbslen);\n" "\\&\n" " /* Now do some inspection of the classes of the characters in\n" " the wide character string. */\n" "\\&\n" " for (wchar_t *wp = wcs; *wp != 0; wp++) {\n" " printf(\" %lc \", (wint_t) *wp);\n" "\\&\n" " if (!iswalpha(*wp))\n" " printf(\"!\");\n" " printf(\"alpha \");\n" "\\&\n" " if (iswalpha(*wp)) {\n" " if (iswupper(*wp))\n" " printf(\"upper \");\n" "\\&\n" " if (iswlower(*wp))\n" " printf(\"lower \");\n" " }\n" "\\&\n" " putchar(\\[aq]\\en\\[aq]);\n" " }\n" "\\&\n" " exit(EXIT_SUCCESS);\n" "}\n" msgstr "" #. SRC END #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B(3), B(3), B(3), B(3), B(3)" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "2023-02-05" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "Linux man-pages 6.03" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "BIB<[restrict .>IB<], const char *restrict >IB<,>\n" "B< size_t >IB<);>\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "If I is not NULL, the B() function converts the multibyte " "string I to a wide-character string starting at I. At most I " "wide characters are written to I. The sequence of characters in the " "string I shall begin in the initial shift state. The conversion can " "stop for three reasons:" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "I non-L\\[aq]\\e0\\[aq] wide characters have been stored at I. In " "this case, the number of wide characters written to I is returned, but " "the shift state at this point is lost." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "The programmer must ensure that there is room for at least I wide " "characters at I." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "If I is NULL, I is ignored, and the conversion proceeds as above, " "except that the converted wide characters are not written out to memory, and " "that no length limit exists." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "In order to avoid the case 2 above, the programmer should make sure I is " "greater than or equal to I." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "The B() function returns the number of wide characters that make " "up the converted part of the wide-character string, not including the " "terminating null wide character. If an invalid multibyte sequence was " "encountered, I<(size_t)\\ -1> is returned." msgstr "" #. type: Plain text #: debian-bookworm msgid "POSIX.1-2001, POSIX.1-2008, C99." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "$ ./t_mbstowcs de_DE.UTF-8 Grüße!\n" "Length of source string (excluding terminator):\n" " 8 bytes\n" " 6 multibyte characters\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "Wide character string is: Grüße! (6 characters)\n" " G alpha upper\n" " r alpha lower\n" " ü alpha lower\n" " ß alpha lower\n" " e alpha lower\n" " ! !alpha\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "#include Elocale.hE\n" "#include Estdio.hE\n" "#include Estdlib.hE\n" "#include Estring.hE\n" "#include Ewchar.hE\n" "#include Ewctype.hE\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "int\n" "main(int argc, char *argv[])\n" "{\n" " size_t mbslen; /* Number of multibyte characters in source */\n" " wchar_t *wcs; /* Pointer to converted wide character string */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (argc E 3) {\n" " fprintf(stderr, \"Usage: %s ElocaleE EstringE\\en\", argv[0]);\n" " exit(EXIT_FAILURE);\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " /* Apply the specified locale. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (setlocale(LC_ALL, argv[1]) == NULL) {\n" " perror(\"setlocale\");\n" " exit(EXIT_FAILURE);\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* Calculate the length required to hold argv[2] converted to\n" " a wide character string. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " mbslen = mbstowcs(NULL, argv[2], 0);\n" " if (mbslen == (size_t) -1) {\n" " perror(\"mbstowcs\");\n" " exit(EXIT_FAILURE);\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid " /* Describe the source string to the user. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " printf(\"Length of source string (excluding terminator):\\en\");\n" " printf(\" %zu bytes\\en\", strlen(argv[2]));\n" " printf(\" %zu multibyte characters\\en\\en\", mbslen);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* Allocate wide character string of the desired size. Add 1\n" " to allow for terminating null wide character (L\\[aq]\\e0\\[aq]). */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " wcs = calloc(mbslen + 1, sizeof(*wcs));\n" " if (wcs == NULL) {\n" " perror(\"calloc\");\n" " exit(EXIT_FAILURE);\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* Convert the multibyte character string in argv[2] to a\n" " wide character string. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (mbstowcs(wcs, argv[2], mbslen + 1) == (size_t) -1) {\n" " perror(\"mbstowcs\");\n" " exit(EXIT_FAILURE);\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " printf(\"Wide character string is: %ls (%zu characters)\\en\",\n" " wcs, mbslen);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " /* Now do some inspection of the classes of the characters in\n" " the wide character string. */\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " for (wchar_t *wp = wcs; *wp != 0; wp++) {\n" " printf(\" %lc \", (wint_t) *wp);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (!iswalpha(*wp))\n" " printf(\"!\");\n" " printf(\"alpha \");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (iswalpha(*wp)) {\n" " if (iswupper(*wp))\n" " printf(\"upper \");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (iswlower(*wp))\n" " printf(\"lower \");\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " putchar(\\[aq]\\en\\[aq]);\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " exit(EXIT_SUCCESS);\n" "}\n" msgstr "" #. type: TH #: fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "2023-11-14" msgstr "" #. type: TH #: fedora-40 mageia-cauldron #, no-wrap msgid "Linux man-pages 6.06" msgstr "" #. type: TH #: fedora-rawhide #, no-wrap msgid "Linux man-pages 6.7" msgstr "" #. type: TH #: opensuse-leap-15-6 #, no-wrap msgid "2023-03-30" msgstr "" #. type: TH #: opensuse-leap-15-6 #, no-wrap msgid "Linux man-pages 6.04" msgstr "" #. type: TH #: opensuse-tumbleweed #, no-wrap msgid "Linux man-pages (unreleased)" msgstr ""