Linux Certif

Toute la documentation sur la certification Linux LPI

mbrtowc

̾Á°

mbrtowc - ¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ò¥ï¥¤¥Éʸ»ú¤ËÊÑ´¹¤¹¤ë

½ñ¼°

#include <wchar.h>



size_t mbrtowc(wchar_t *pwc, const char *s, size_t n, mbstate_t *ps);

ÀâÌÀ

¤³¤Î´Ø¿ô¤¬ÍѤ¤¤é¤ì¤ë¾ì¹ç¡¢Ä̾ï s ¤¬ NULL ¤Ç¤Ê¤¯ pwc ¤â NULL ¤Ç ¤Ê¤¤¡£¤³¤Î¾ì¹ç¤Ï¡¢ mbrtowc() ´Ø¿ô¤Ï s ¤«¤é»Ï¤Þ¤ëºÇÂç n ¥Ð¥¤¥È¤Î ¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»ú¤ò¸¡ºº¤·¤Æ¡¢¼¡¤Î´°Á´¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤ò¼è¤ê½Ð¤·¡¢ ¤½¤ì¤ò¥ï¥¤¥Éʸ»ú¤ËÊÑ´¹¤·¤Æ *pwc ¤Ë³ÊǼ¤¹¤ë¡£ Ʊ»þ¤Ë¥·¥Õ¥È¾õÂÖ *ps ¤ò¹¹¿·¤¹¤ë¡£ÊÑ´¹¤·¤¿¥ï¥¤¥Éʸ»ú¤¬ L'\0' ¤Ç ¤Ê¤±¤ì¤Ð¡¢s ¤«¤é¾ÃÈñ¤¹¤ë¥Ð¥¤¥È¿ô¤òÊÖ¤¹¡£ ÊÑ´¹¤·¤¿¥ï¥¤¥Éʸ»ú¤¬ L'\0' ¤Î¾ì¹ç¤Ë¤Ï¥·¥Õ¥È¾õÂÖ *ps ¤ò ½é´ü¾õÂÖ¤ËÌᤷ¤Æ 0 ¤òÊÖ¤¹¡£

s ¤«¤é»Ï¤Þ¤ë n ¥Ð¥¤¥È¤¬´°Á´¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»ú¤ò´Þ¤ó¤Ç¤¤¤Ê¤¤ ¾ì¹ç¤Ë¤Ï¡¢ mbrtowc() ¤Ï (size_t)(-2) ¤òÊÖ¤¹¡£ ¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó¤Ë¾éĹ¤Ê¥·¥Õ¥È¥·¡¼¥±¥ó¥¹¤¬´Þ¤Þ¤ì¤Æ¤¤¤ë¤È¡¢ n >= MB_CUR_MAX ¤Î»þ¤Ë¤â¤³¤Î¤è¤¦¤Ê¤³¤È¤¬µ¯¤³¤ê¤¨¤ë¡£

s ¤«¤é»Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬡¢¼¡¤Î´°Á´¤Êʸ»ú¤ÎÁ°¤Ë ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ò´Þ¤ó¤Ç¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢ mbrtowc() ¤Ï (size_t)(-1) ¤òÊÖ¤·¡¢errno ¤Ë EILSEQ ¤òÀßÄꤹ¤ë¡£ ¤³¤Î¾ì¹ç¤Ï *ps ¤Ø¤Î±Æ¶Á¤Ï̤ÄêµÁ¤Ç¤¢¤ë¡£

s ¤¬ NULL ¤Ç¤Ê¤¯ pwc ¤¬ NULL ¤Î¾ì¹ç¤Ï mbrtowc() ´Ø¿ô¤Ï ¾åµ­¤ÈƱÍͤËÆ°ºî¤¹¤ë¤¬¡¢ÊÑ´¹¤·¤¿¥ï¥¤¥Éʸ»ú¤Ï¥á¥â¥ê¤Ë¤Ï½ñ¤­¹þ¤Þ¤ì¤Ê¤¤¡£

puts *ps in the initial state and returns 0. »°ÈÖÌܤξì¹ç¤È¤·¤Æ s ¤¬ NULL ¤Î¾ì¹ç¡¢ pwc ¤È n ¤Ï ̵»ë¤µ¤ì¤ë¡£ *ps ¤¬É½¸½¤¹¤ëÊÑ´¹¾õÂÖ¤¬ÉÔ´°Á´¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÊÑ´¹¤ò¼¨¤·¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢ mbrtowc() ´Ø¿ô¤Ï (size_t)(-1) ¤òÊÖ¤·¡¢ errno ¤Ë EILSEQ ¤ò¥»¥Ã¥È¤·¡¢ *ps ¤Ï̤ÄêµÁ¾õÂ֤Τޤޤˤ¹¤ë¡£ ¤µ¤â¤Ê¤±¤ì¤Ð¡¢ mbrtowc() ´Ø¿ô¤Ï *ps ¤ò½é´ü¾õÂ֤ˤ·¤Æ 0 ¤òÊÖ¤¹¡£

¾åµ­¤ÎÁ´¤Æ¤Î¾ì¹ç¤Ë¤ª¤¤¤Æ¡¢ps ¤¬ NULL ¥Ý¥¤¥ó¥¿¡¼¤Ê¤é¤ÐÂå¤ï¤ê¤Ë mbrtowc ´Ø¿ô¤Î¤ß¤¬»ÈÍѤ¹¤ëÀÅŪ¤Ç̾Á°¤Î¤Ê¤¤¾õÂÖ¤¬»ÈÍѤµ¤ì¤ë¡£ ¤µ¤â¤Ê¤±¤ì¤Ð¡¢*ps ¤ÏÍ­¸ú¤Ê mbstate_t ¥ª¥Ö¥¸¥§¥¯¥È¤Ç ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£ mbstate_t ¥ª¥Ö¥¸¥§¥¯¥È¤Ç¤¢¤ë a ¤Ï¥¼¥í¤ÇËä¤á¤ë¤³¤È¤Ë¤è¤Ã¤Æ ½é´ü¾õÂ֤˽é´ü²½¤Ç¤­¤ë¡£°Ê²¼¤ËÎã¤ò¼¨¤¹¡£

memset(&a, 0, sizeof(a));

ÊÖ¤êÃÍ

L'\0' °Ê³°¤Î¥ï¥¤¥Éʸ»ú¤òǧ¼±¤·¤¿¾ì¹ç¤Ë¤Ï mbrtowc() ´Ø¿ô¤Ï s ¤«¤é»Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥ÈÎ󤫤é²òÀϤ·¤¿¥Ð¥¤¥È¿ô¤òÊÖ¤¹¡£ L'\0' ¥ï¥¤¥Éʸ»ú¤òǧ¼±¤·¤¿¾ì¹ç¤Ë¤Ï 0 ¤òÊÖ¤¹¡£ ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¾ì¹ç¤Ë¤Ï (size_t)(-1) ¤òÊÖ¤·¡¢ errno ¤Ë EILSEQ ¤òÀßÄꤹ¤ë¡£´°Á´¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»ú¤ò ²òÀϤǤ­¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë¤Ï (size_t)(-2) ¤òÊÖ¤· n ¤òÁý²Ã¤µ¤»¤ë ɬÍפ¬¤¢¤ë¤³¤È¤ò¼¨¤¹¡£

½àµò

C99

Ãí°Õ

mbrtowc() ¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î LC_CTYPE ¥«¥Æ¥´¥ê¤Ë°Í¸¤·¤Æ¤¤¤ë¡£

´ØÏ¢¹àÌÜ

mbsrtowcs(3)