mbtowc(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

mbtowc(3c)

mbtowc(3C)               Standard C Library Functions               mbtowc(3C)

NAME
       mbtowc - convert a character to a wide-character code

SYNOPSIS
       #include <stdlib.h>

       int mbtowc(wchar_t *restrict pwc, const char *restrict s, size_t n);

DESCRIPTION
       If s is not a null pointer, mbtowc() determines the number of the bytes
       that  constitute  the character pointed to by s. It then determines the
       wide-character code for the value of type wchar_t that  corresponds  to
       that  character. (The value of the wide-character code corresponding to
       the null byte is 0.) If the character is valid and pwc is  not  a  null
       pointer,  mbtowc() stores the wide-character code in the object pointed
       to by pwc.


       A call with s as a null pointer causes this function to return  0.  The
       behavior  of  this function is affected by the LC_CTYPE category of the
       current locale. At most n bytes of the array pointed to by  s  will  be
       examined.

RETURN VALUES
       If s is a null pointer, mbtowc() returns 0. If s is not a null pointer,
       mbtowc()  returns 0 (if s points to the null byte), the number of bytes
       that constitute the converted character (if the next n or  fewer  bytes
       form  a valid character), or −1 and may set errno to indicate the error
       (if they do not form a valid character).


       In no case will the value returned be greater than n or  the  value  of
       the MB_CUR_MAX macro.

ERRORS
       The mbtowc() function may fail if:

       EILSEQ    Invalid character sequence is detected.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ CSIEnabled _ Interface StabilityCommitted _ MT-LevelMT-
       Safe _ StandardSee standards(7).


SEE ALSO
       wctomb(3C), mblen(3C), mbstowcs(3C), setlocale(3C),  wcstombs(3C),  at‐
       tributes(7), standards(7)


       Handling Characters and Character Strings in Internationalizing and Lo‐
       calizing Applications in Oracle Solaris

HISTORY
       The  mbtowc() function has been included in all Sun and Oracle releases
       of Solaris.

Oracle Solaris 11.4               25 Nov 2024                       mbtowc(3C)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3