wcsrtombs

ワイド文字列 (wide string) を多バイト文字列 (multibyte string) に変換します． 

#include <wchar.h>

size_t wcsrtombs(
    char_t * restrict dst,
    const wchar_t ** restrict src,
    size_t len,
    mbstate_t * restrict ps
);

wcsrtombs 関数は src が (間接的に) 指すワイド文字列を変換状態 ps で始まる多バイト文字列に変換し，dst が指す配列に格納します※1．変換は終端ナルワイド文字 (null wide character) まで行われます．

変換は以下の場合、途中で終了します．

  • 正しい多バイト文字に対応しないワイド文字 (wide character) があった場合
  • dst が指す配列に len バイトを超える多バイト文字を格納した場合

変換が終端ナルワイド文字によって終了し，dst が空ポインタ (NULL) でない場合は変換状態 ps は初期変換状態になります．

引数

  • dst: 多バイト文字へのダブルポインタ (変換後の多バイト文字が格納されます)
  • src: 変換するワイド文字列
  • len: 変換するワイド文字の個数
  • ps: 変換状態

戻り値

  • 変換成功時: 変換に成功した多バイト文字のバイト数 (終端ナル文字は含みません)
  • 表現形式エラー時: (size_t)(-1) ※2

※1: dst が空ポインタでない場合のみです．

※2: errno に EILSEQマクロの値を格納します．また，変換状態 ps がどうなるかは未規定です．