mbstowcs

Autres langues

Langue: ja

Autres versions - même langue

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

Section: 3 (Bibliothèques de fonctions)

Sommaire

̾Á°

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

½ñ¼°


#include <stdlib.h>



size_t mbstowcs(wchar_t *dest, const char *src, size_t n);

ÀâÌÀ

dest ¤¬ NULL ¥Ý¥¤¥ó¥¿¡¼¤Ç¤Ê¤±¤ì¤Ð mbstowcs() ´Ø¿ô¤Ï ¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎó *src ¤ò dest ¤«¤é»Ï¤Þ¤ë¥ï¥¤¥Éʸ»úÎó¤Ë ÊÑ´¹¤¹¤ë¡£dest ¤Ë¤ÏºÇÂç¤Ç n ʸ»ú¤Î¥ï¥¤¥Éʸ»ú¤¬ ½ñ¤­¹þ¤Þ¤ì¤ë¡£ÊÑ´¹¤Ï½é´ü¾õÂ֤dz«»Ï¤µ¤ì¡¢ °Ê²¼¤Î»°¤Ä¤Î¤¤¤º¤ì¤«¤Î¾ò·ï¤ÇÄä»ß¤¹¤ë:

1. ÉÔÀµ¤Ê¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ËÁø¶ø¤·¤¿¡£¤³¤Î¾ì¹ç¤Ë¤Ï (size_t)(-1) ¤òÊÖ¤¹¡£

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

3. ¥Þ¥ë¥Á¥Ð¥¤¥Èʸ»úÎ󤬽ªÃ¼¤Î '\0' ¤Þ¤Ç´Þ¤á¤Æ´°Á´¤ËÊÑ´¹¤µ¤ì¤¿¾ì¹ç¡£ ¤³¤Î¾ì¹ç¤Ï½ªÃ¼¤Î L'\0' ʸ»ú¤ò½ü¤¤¤Ædest ¤Ë½ñ¤­¹þ¤Þ¤ì¤¿Ê¸»ú¿ô¤òÊÖ¤¹¡£

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

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

¾åµ­¤Î 2. ¤Î¾ì¹ç¤òÈò¤±¤ë¤¿¤á¤Ë¥×¥í¥°¥é¥Þ¡¼¤Ï n ¤¬ mbstowcs(NULL,src,0)+1 °Ê¾å¤Ç¤¢¤ë¤³¤È¤òÊݾڤ¹¤Ù¤­¤Ç¤¢¤ë¡£

ÊÖ¤êÃÍ

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

½àµò

C99

Ãí°Õ

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

mbsrtowcs(3) ´Ø¿ô¤ÏƱ¤¸µ¡Ç½¤Î¤è¤êÎɤ¤¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤òÄ󶡤¹¤ë¡£

´ØÏ¢¹àÌÜ

mbsrtowcs(3)