Linux Certif

Toute la documentation sur la certification Linux LPI

mbsrtowcs

̾Á°

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

½ñ¼°

#include <wchar.h>



size_t mbsrtowcs(wchar_t *dest, const char **src,

                  size_t len, mbstate_t *ps);

ÀâÌÀ

dest ¤¬ NULL ¥Ý¥¤¥ó¥¿¡¼¤Ç¤Ê¤±¤ì¤Ð¡¢ mbsrtowcs() ´Ø¿ô¤Ï ¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó *src ¤ò dest ¤«¤é»Ï¤Þ¤ë¥ï¥¤¥Éʸ»úÎó¤Ë ÊÑ´¹¤¹¤ë¡£dest ¤Ë¤ÏºÇÂç¤Ç len ʸ»ú¤Î¥ï¥¤¥Éʸ»ú¤¬ ½ñ¤­¹þ¤Þ¤ì¤ë¡£Æ±»þ¤Ë¥·¥Õ¥È¾õÂÖ *ps ¤ò¹¹¿·¤¹¤ë¡£ ÊÑ´¹¤Ï mbrtowc(dest,*src,n,ps) ¤ò¡¢ ¤³¤Î¸Æ¤Ó½Ð¤·¤¬À®¸ù¤¹¤ë¸Â¤ê·«¤êÊÖ¤·¼Â¹Ô¤·¤¿¤Î¤È¼Â¼ÁŪ¤ËƱÍͤǤ¢¤ë¡£ ¤³¤³¤Ç n ¤ÏÀµ¤Î¿ô¤Ç¤¢¤ê¡¢·«¤êÊÖ¤·¤´¤È¤Ë dest ¤¬ 1 Áý²Ã¤µ¤»¤é¤ì¡¢ *src ¤¬¾ÃÈñ¤·¤¿¥Ð¥¤¥È¿ô¤À¤±Áý²Ã¤µ¤»¤é¤ì¤ë¡£ÊÑ´¹¤Ï°Ê²¼¤Î»°¤Ä¤Î ¤¤¤º¤ì¤«¤Î¾ò·ï¤ÇÄä»ß¤¹¤ë:

1. ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¡£¤³¤Î¾ì¹ç¤Ë¤Ï *src ¤ÏÉÔÀµ¤Ê ¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ò»Ø¤¹¤è¤¦¤Ë¤·¤Æ¡¢(size_t)(-1) ¤òÊÖ¤·¡¢errno ¤Ë EILSEQ ¤òÀßÄꤹ¤ë¡£

2. len ʸ»ú¤Î L'\0' °Ê³°¤Î¥ï¥¤¥Éʸ»ú¤ò dest ¤Ë³ÊǼ¤·¤¿¾ì¹ç¡£ ¤³¤Î¾ì¹ç¤Ï *src ¤Ï¼¡¤ËÊÑ´¹¤µ¤ì¤ë¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ò»Ø¤¹¤è¤¦¤Ë¤·¤Æ¡¢ dest ¤Ë½ñ¤­¹þ¤Þ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Î¿ô¤òÊÖ¤¹¡£

3. ¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬽ªÃ¼¤Î '\0' ¤Þ¤Ç´Þ¤á¤Æ´°Á´¤ËÊÑ´¹¤µ¤ì¤¿¾ì¹ç¡£ (¤³¤Î»þ¡¢ÉûºîÍѤȤ·¤Æ *ps ¤¬½é´ü¾õÂÖ¤ËÌᤵ¤ì¤ë¡£) ¤³¤Î¾ì¹ç¤Ï *src ¤Ë¤Ï NULL ¤¬ÀßÄꤵ¤ì¡¢½ªÃ¼¤Î L'\0' ʸ»ú¤ò½ü¤¤¤Æ dest ¤Ë½ñ¤­¹þ¤Þ¤ì¤¿Ê¸»ú¿ô¤òÊÖ¤¹¡£

dest ¤¬ NULL ¤Î¾ì¹ç¡¢len ¤Ï̵»ë¤µ¤ì¡¢¾åµ­¤ÈƱÍͤÎÊÑ´¹¤¬ ¹Ô¤ï¤ì¤ë¤¬¡¢ÊÑ´¹¤µ¤ì¤¿¥ï¥¤¥Éʸ»ú¤Ï¥á¥â¥ê¤Ë½ñ¤­¹þ¤Þ¤ì¤º¡¢ÊÑ´¹Àè¤Î¾å¸Â ¤¬Â¸ºß¤·¤Ê¤¤¡£

¾åµ­¤Î¤É¤Á¤é¤Î¾ì¹ç¤Ç¤â¡¢ps ¤¬ NULL ¥Ý¥¤¥ó¥¿¡¼¤Ê¤é¤Ð¡¢ Âå¤ê¤Ë mbsrtowcs ´Ø¿ô¤Î¤ß¤¬»ÈÍѤ¹¤ëÀÅŪ¤Ç̾Á°¤Î¤Ê¤¤¾õÂÖ¤¬»ÈÍѤµ¤ì¤ë¡£

¥×¥í¥°¥é¥Þ¡¼¤Ï dest ¤ËºÇÄã¤Ç¤â len ¥ï¥¤¥Éʸ»ú¤ò½ñ¤­¹þ¤à¤³ ¤È¤¬¤Ç¤­¤ë¶õ´Ö¤¬¤¢¤ë¤³¤È¤òÊݾڤ·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£

ÊÖ¤êÃÍ

mbsrtowcs() ´Ø¿ô¤Ï¥ï¥¤¥Éʸ»úÎó¤ËÊÑ´¹´°Î»¤·¤¿¥ï¥¤¥Éʸ»ú¤Î¿ô¤òÊÖ¤¹¡£ ½ªÃ¼¤Î¥Ê¥ë¥ï¥¤¥Éʸ»ú¤Ï´Þ¤Þ¤Ê¤¤¡£ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¾ì¹ç¤Ë¤Ï (size_t)(-1) ¤òÊÖ¤·¡¢errno ¤Ë EILSEQ ¤òÀßÄꤹ¤ë¡£

½àµò

C99

Ãí°Õ

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

ps ¤È¤·¤Æ NULL ¤òÅϤ¹¤³¤È¤Ï¥Þ¥ë¥Á¥¹¥ì¥Ã¥É¤Ç¤Ï°ÂÁ´¤Ç¤Ê¤¤¡£

´ØÏ¢¹àÌÜ

iconv(3), mbsnrtowcs(3), mbstowcs(3)