wcsxfrm

＜wcsxfrm＞
概要	ワイド文字列を変換する。
ヘッダ	`#include <wchar.h>`
I/F	`size_t wcsxfrm(wchar_t * restrict s1, const wchar_t * restrict s2, size_t n);`
戻り値	変換した結果のワイド文字列(終端ナルワイド文字は含めない)の長さ。
詳細	wcsxfrm関数は、ワイド文字列s2をnワイド文字分変換し、配列s1に格納する。ワイド文字列の変換はロケール情報のLC_COLLATEカテゴリに基づいて行われる。wcsxfrm関数での変換は、変換後のワイド文字列のwcscmp関数での比較結果と、変換前のワイド文字列のwcscoll関数での比較結果が同じとなるように行われる。終端ナルワイド文字を含めて、nを超えるワイド文字数を、配列s1に格納することはない。nが0である場合はs1は空ポインタでもよい。戻り値がn以上の場合、配列s1の内容は不定である。領域が重なり合うオブジェクト間でコピーが行われるときの動作は未定義である。