wcsxfrm

ワイド文字列 (wide string) の変換※ を行います． 

#include <wchar.h>

size_t wcsxfrm (
    wchar_t * restrict s1,
    const wchar_t * restrict s2,
    size_t n
);

wcsxfrm 関数は s2 が指すワイド文字列を n 文字分変換※ して s1 が指す配列に格納します． ワイド文字列の変換はロケール情報の LC_COLLATE カテゴリに基づいて解釈されます．

n が 0 である場合，s1 は空ポインタ (NULL) であってもかまいません．
領域が重なり合うオブジェクト間でコピーが行われるときの動作は未定義です．
戻り値が n 以上の場合，s1 が指す配列の内容は不定になります．

※ 変換

wcsxfrm 関数で変換したワイド文字列を wcscmp 関数で比較したときに, 元のワイド文字列を wcscoll 関数で比較したのと同じ結果になるようにします．

戻り値