Linux Certif

Toute la documentation sur la certification Linux LPI

wcsrtombs

̾Á°

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

½ñ¼°

#include <wchar.h>



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

                 size_t len, mbstate_t *ps);

ÀâÌÀ

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

(¸½ºß¤Î¥í¥±¡¼¥ë¤Ë´ð¤Å¤¤¤Æ)¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤Çɽ¸½¤Ç¤­¤Ê¤¤¥ï¥¤¥Éʸ»ú¤Ë ½Ð²ñ¤Ã¤¿¾ì¹ç¡£¤³¤Î¾ì¹ç¤Ï¡¢*src ¤ÏÉÔÀµ¤Ê¥ï¥¤¥Éʸ»ú¤ò»Ø¤·¤¿¾õÂÖ¤Ë ¤Ê¤ê¡¢(size_t)(-1) ¤¬ÊÖ¤µ¤ì¡¢ errno ¤Ë EILSEQ ¤¬ÀßÄꤵ¤ì¤ë¡£

2. Ťµ¤ÎÀ©¸Â¤Ë¤è¤êÊÑ´¹¤¬»ß¤á¤é¤ì¤¿¾ì¹ç¡£¤³¤Î¾ì¹ç¤Ë¤Ï¡¢*src ¤Ï¼¡¤Ë ÊÑ´¹¤µ¤ì¤ë¤Ù¤­¥ï¥¤¥Éʸ»úÎó¤ò»Ø¤·¤¿¾õÂ֤ˤʤꡢdest ¤Ë½ñ¤­¹þ¤Þ¤ì ¤¿¥Ð¥¤¥È¿ô¤¬ÊÖ¤µ¤ì¤ë¡£

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

dest ¤¬ NULL ¤Ê¤é¤Ð len ¤Ï̵»ë¤µ¤ì¤ÆÁ°½Ò¤Î¤è¤¦¤ËÊÑ´¹¤¬¹Ô¤ï ¤ì¤ë¤¬¡¢ÊÑ´¹¤µ¤ì¤¿¥Ð¥¤¥È¥Ç¡¼¥¿¤Ï¥á¥â¥ê¤Ë½ñ¤­½Ð¤µ¤ì¤Ê¤¤ÅÀ¤È¡¢½ÐÎÏÀè¤ÎĹ ¤µ¤ÎÀ©¸Â¤¬¤Ê¤¤ÅÀ¤¬°Û¤Ê¤ë¡£

¾åµ­¤Î¤¤¤º¤ì¤Î¾ì¹ç¤â¡¢ps ¤¬ NULL ¥Ý¥¤¥ó¥¿¤Ê¤é¤Ð¡¢wcsnrtombs ´Ø¿ô ¤À¤±¤¬ÃΤäƤ¤¤ëÀÅŪ¤Êƿ̾¤Î¾õÂÖ¤¬¥·¥Õ¥È¾õÂÖ¤ÎÂå¤ï¤ê¤ËÍѤ¤¤é¤ì¤ë¡£

¥×¥í¥°¥é¥Þ¤Ï¾¯¤Ê¤¯¤È¤â len ¥Ð¥¤¥È¤ÎÎΰè¤ò dest ¤Ë³ÎÊݤ·¤Ê ¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£

ÊÖ¤êÃÍ

wcsrtombs() ¤Ï¡¢ÊÑ´¹¤·¤ÆÆÀ¤é¤ì¤¿¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤Î¥Ð¥¤¥È¿ô¤òÊÖ¤¹¡£ ¤³¤ì¤Ë¤Ï½ªÃ¼¤Î null ¥Ð¥¤¥È¤Ï´Þ¤Þ¤ì¤Ê¤¤¡£ ÊÑ´¹¤Ç¤­¤Ê¤¤¥ï¥¤¥Éʸ»ú¤Ë½Ð²ñ¤Ã¤¿¾ì¹ç¤Ë¤Ï (size_t)(-1) ¤¬ÊÖ¤µ¤ì¡¢ errno ¤Ë EILSEQ ¤¬ÀßÄꤵ¤ì¤ë¡£

½àµò

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

ps ¤Ë NULL ¤òÅϤ·¤¿ºÝ¤ÎÆ°ºî¤Ï¥Þ¥ë¥Á¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤Ç¤Ê¤¤¡£

´ØÏ¢¹àÌÜ

iconv(3), wcsnrtombs(3), wcstombs(3)