|
||||||||||||
|
|
MBRTOWCSection: Linux Programmer's Manual (3)Updated: July 25, 1999 Index Return to Main Contents ̾Á°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 ´Ø¿ô¤Ï ¾åµ¤ÈƱÍÍ¤ËÆ°ºî¤¹¤ë¤¬¡¢ÊÑ´¹¤·¤¿¥ï¥¤¥Éʸ»ú¤Ï¥á¥â¥ê¤Ë¤Ï½ñ¤¹þ¤Þ¤ì¤Ê¤¤¡£ »°ÈÖÌܤξì¹ç¤È¤·¤Æ s ¤¬ NULL ¤Î¾ì¹ç¤Ï pwc ¤È n ¤Ï ¤Ï̵»ë¤µ¤ì¤ë¡£mbrtowc ´Ø¿ô¤Ï *ps ¤ò½é´ü¾õÂ֤ˤ·¤Æ 0 ¤òÊÖ¤¹¡£ ¾åµ¤ÎÁ´¤Æ¤Î¾ì¹ç¤Ë¤ª¤¤¤Æ¡¢ps ¤¬ NULL ¥Ý¥¤¥ó¥¿¡¼¤Ê¤é¤ÐÂå¤ê¤Ë mbrtowc ´Ø¿ô¤Î¤ß¤¬»ÈÍѤ¹¤ëÀÅŪ¤Ç̾Á°¤Î¤Ê¤¤¾õÂÖ¤¬»ÈÍѤµ¤ì¤ë¡£ ÊÖ¤êÃÍL'\0' °Ê³°¤Î¥ï¥¤¥Éʸ»ú¤òǧ¼±¤·¤¿¾ì¹ç¤Ë¤Ï mbrtowc ´Ø¿ô¤Ï s ¤«¤é»Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥ÈÎ󤫤é²òÀϤ·¤¿¥Ð¥¤¥È¿ô¤òÊÖ¤¹¡£ L'\0' ¥ï¥¤¥Éʸ»ú¤òǧ¼±¤·¤¿¾ì¹ç¤Ë¤Ï 0 ¤òÊÖ¤¹¡£ ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¾ì¹ç¤Ë¤Ï (size_t)(-1) ¤òÊÖ¤·¡¢ errno ¤Ë EILSEQ ¤òÀßÄꤹ¤ë¡£´°Á´¤Ê¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»ú¤ò ²òÀϤǤ¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë¤Ï (size_t)(-2) ¤òÊÖ¤· n ¤òÁý²Ã¤µ¤»¤ë ɬÍפ¬¤¢¤ë¤³¤È¤ò¼¨¤¹¡£½àµòISO/ANSI C, UNIX98SEE ALSOmbsrtowcs(3)Ãí°Õmbrtowc ¤Îưºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î LC_CTYPE ¥«¥Æ¥´¥ê¤Ë°Í¸¤·¤Æ¤¤¤ë¡£
Index |
|||||||||||
|
||||||||||||