wcstok

wcstok関数は、繰り返し呼び出すことにより、ワイド文字列s1を、ワイド文字列s2の中のいずれかのワイド文字で区切られる字句の列に分割する。ptrは、コール元が提供するwchar_t型ポインタを指し、wcstok関数が同じワイド文字列を走査し続けるために必要な情報を格納する。wcstok関数の最初の呼び出しではs1に空ポインタ以外を指定する。2回目以降の呼出しではs1にはNULLを指定する必要がある。また、ptrが指すオブジェクトは一連の呼出しの中の直前の呼出しで格納された値である必要がある。s2が指す区切りワイド文字列は、呼出しごとに異なっていてもよい。

wcstok関数は、まず、s2が指す区切りワイド文字列に含まれない最初のワイド文字がs1の中に存在するかを調べる。そのワイド文字が見つかった場合は、それを最初の字句の始まりとする。そのワイド文字が見つからなかった場合、wcstok関数は空ポインタを返却し、処理を終了する。

そして、見つかったワイド文字の位置から区切りワイド文字列に含まれている文字を探す。そのワイド文字が見つかった場合、そのワイド文字をナルワイド文字で書き換え、その字句を終結させる。そのワイド文字が見つからなかった場合、その字句をワイド文字列s1の最後までとみなし、次回以降の検索では空ポインタを返却する。

2回目以降の呼出しでは、保持したポインタが指すところから探索を開始する以外は上記と同じ動作である。