Linux Certif

Toute la documentation sur la certification Linux LPI

mbtowc

̾Á°

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

½ñ¼°

#include <stdlib.h>



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

ÀâÌÀ

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

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

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

»°ÈÖÌܤξì¹ç¤È¤·¤Æ s ¤¬ NULL ¤Î¾ì¹ç¤Ï pwc ¤È n ¤Ï ̵»ë¤µ¤ì¤ë¡£ mbtowc() ´Ø¿ô¤Î¤ß¤¬»ÈÍѤ¹¤ë¥·¥Õ¥È¾õÂ֤Ͻé´ü¾õÂÖ¤Ë Ìᤵ¤ì¤ë¡£¤½¤·¤Æʸ»úÉä¹æ¤¬¥·¥Õ¥È¾õÂ֤˰͸¤¹¤ë¤Ê¤é¤Ð¥¼¥í°Ê³°¤ò¡¢Ê¸»úÉä¹æ¤¬ ¾õÂ֤ˤè¤é¤Ê¤¤¤Ê¤é¤Ð¥¼¥í¤òÊÖ¤¹¡£

ÊÖ¤êÃÍ

s ¤¬ NULL ¤Ç¤Ê¤±¤ì¤Ð mbtowc() ´Ø¿ô¤Ï s ¤«¤é¾ÃÈñ¤·¤¿ ¥Ð¥¤¥È¿ô¤ò¡¢s ¤¬¥Ê¥ëʸ»ú¤ò»Ø¤·¤Æ¤¤¤ë¾ì¹ç¤Ï¥¼¥í¤ò¡¢ ÊÑ´¹¤Ë¼ºÇÔ¤·¤¿¾ì¹ç¤Ï -1 ¤òÊÖ¤¹¡£

s ¤¬ NULL ¤Ê¤é¤Ð mbtowc() ´Ø¿ô¤Ïʸ»úÉä¹æ¤¬¥·¥Õ¥È¾õÂ֤˰͸ ¤·¤Æ¤¤¤ì¤Ð¥¼¥í°Ê³°¤ò¡¢¾õÂ֤ˤè¤é¤Ê¤±¤ì¤Ð¥¼¥í¤òÊÖ¤¹¡£

½àµò

C99

Ãí°Õ

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

¤³¤Î´Ø¿ô¤Ï¥Þ¥ë¥Á¥¹¥ì¥Ã¥É¤Ç¤Ï°ÂÁ´¤Ç¤Ï¤Ê¤¤¡£ mbrtowc(3) ´Ø¿ô¤Ï Ʊ¤¸µ¡Ç½¤Î¤è¤êÎɤ¤¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤òÄ󶡤¹¤ë¡£

´ØÏ¢¹àÌÜ

MB_CUR_MAX(3), mbrtowc(3), mbstowcs(3)