wcsnrtombs

Autres langues

Langue: ja

Autres versions - même langue

Version: July 25, 1999 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

Sommaire

̾Á°

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

½ñ¼°


#include <wchar.h>



size_t wcsnrtombs(char *dest, const wchar_t **src, size_t nwc,

                  size_t len, mbstate_t *ps);

ÀâÌÀ

wcsnrtombs() ´Ø¿ô¤Ï¡¢ wcsrtombs() ´Ø¿ô¤Ë»÷¤Æ¤¤¤ë¡£¤¿¤À¤·¡¢ ÊÑ´¹¤µ¤ì¤ë¥ï¥¤¥Éʸ»ú¤Î¿ô¤¬(*src ¤«¤é¿ô¤¨¤Æ) nwc ʸ»ú¤ËÀ©¸Â ¤µ¤ì¤Æ¤¤¤ëÅÀ¤¬°Û¤Ê¤ë¡£

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

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

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

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

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

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

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

ÊÖ¤êÃÍ

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

½àµò

¤³¤Î´Ø¿ô¤Ï GNU ³ÈÄ¥¤Ç¤¢¤ë¡£

Ãí°Õ

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

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

´ØÏ¢¹àÌÜ

iconv(3), wcsrtombs(3)