_mbsnbset

string.h：インデックス への移動

ヘッダー ファイル

mbstring.h

カテゴリ

メモリおよび文字列操作ルーチン

プロトタイプ

unsigned char *_mbsnbset(unsigned char str, unsigned int ch, size_t maxlen);

説明

_mbsnbset は、文字列 str 内の最大 maxlen バイトを文字 ch に設定します。 引数 ch はシングルバイト文字でもマルチバイト文字でもかまいません。

maxlen バイトに達しないうちに終端の NULL 文字が見つかった場合、関数は終了します。 ch が str の末尾に収まらないマルチバイト文字の場合、str の最後の文字は空白文字に設定されます。

戻り値

_mbsnbset は、char へのポインタ（指定された文字で構成される新しい文字列）を返します。

例

 #include <mbstring.h>
 /* Creates a new string filled by the given character the
    given number of times.
 */
 char* fill_string(unsigned int ch, size_t chars)
 {
   /* Decide over the length of the string (for MBCS it's chars * 2 bytes) */
   int str_len = (ch <= 0xff) ? chars : chars * 2;
 
   /* Generate a new string made of the given character */
   return _mbsnbset((char*)malloc(str_len + 1), ch, str_len);
 }