string(3C)

文字列 s2 を文字列 s1 の末尾に連結します。 strncat() は、文字列 s2 を文字列 s1 の末尾に最大 n 文字連結します。 s2 が n 文字より短い場合、そのまま連結します。 どちらの関数も null で終了する連結後の結果 s1 の値) を指すポインターを返します。

文字列の引き数を比較して、文字コードの大小関係を比較しながら s1 が s2 より小さいか、等しいか、大きいかによって、負の整数、0、正の整数を返します。 対応する文字の比較は、文字の型があたかも unsigned char であるかのように行われます。 s1 と s2 に対する null ポインターは、空の文字列へのポインターと同じに扱われます。 strncmp() は、同様の比較を行いますが、最大 n 文字 (０ 以下の n では等しい動作は行わない) の比較を行います。 strcasecmp() は strcmp() と、 strncasecmp() は strncmp() と機能についてそれぞれ同様ですが、文字は、比較に先立って _tolower() conv(3C) を参照) によって変換されます。 返される大小関係には、小文字への変換が反映されます。

文字列 s2 を文字列 s1 に null までコピーします。 strncpy() は、ちょうど n 文字をコピーし、必要なら n 文字全部が書かれるまで、 s2 を切り詰めたり、 s1 に null を加えます。 s2 が、 n 以上の場合、 s1 は、null で終了しません。 どちらの関数も s1 を返します。 strncpy() を任意の構造体の n バイトのコピーに使わないよう注意してください。 その構造体の中に null があると、 strncpy() は、ソースから宛先へ、 n バイト未満をコピーし、残りを null で満たします。 memcpy() 関数 memory(3C) を参照) を使って任意のバイナリデータをコピーしてください。

s1 が指す文字列のコピーである新しい文字列を指すポインターを返します。 新しい文字列の領域は、 malloc() 関数 malloc(3C) を参照) を使って確保します。

末尾の null を除いた s の文字数を返します。

(strrchr()) 文字列 s 中の最初 (最後) に文字 c が現れる位置へのポインターを返します。 また、 c が文字列中にないときは、null ポインターを返します。 文字列の末尾にある null は、文字列の一部として扱われます。 index() (rindex()) は strchr() (strrchr()) と同じもので、BSD 系のアプリケーションへの移植性のみ備わっています。

文字列 s1 内に文字列 s2 内の任意の文字が現れる最初の位置へのポインターを返します。 また、 s2 内の文字が s1 内にないときは、null ポインターを返します。

(strcspn()) 文字列 s1 内で、文字列 s2 内の文字 (文字列 s2 にない文字) だけからなる最大の先頭セグメントの長さを返します。

(strrstr()) 文字列 s1 内に文字列 s2 が最初 (最後) に現れる位置へのポインターを返します。 また、文字列中に s2 がなければ、NULL ポインターを返します。 s2 が大きさ ０ の文字列を指すとき、 strstr() (strrstr()) は s1 を返します。

文字列 s1 を、分離された文字列 s2 内の １ つ以上の文字で区切られた ０ 以上のテキストトークンの連なりからなるものとみなします。 最初の (null でないポインター s1 を指定しての) 呼び出しで、最初のトークンの先頭の文字を指すポインターを返し、そのトークンに続いて s1 に null を書き込みます。 個々の呼び出しで、文字列 s1 でのテキストトークンの位置を見失わないので、以降の、最初の引き数を null ポインターにする呼び出しが、続く文字列に行われます。 このようにして、トークンが １ つもなくなるまで、個々の呼び出しが文字列 s1 に行われます。分離された文字列 s2 は、呼び出しが違っていても構いません。 s1 にトークンが １ つもなくなると、null ポインターが返されます。

strtok() と同じですが、３ 番目の引き数として文字列ポインターのアドレスが渡される点が異なります。 この引き数を使って、検索対象の文字列内の現在の位置を追跡します。 ポインターを文字列内の現在のトークンに返すか、トークンが存在しない場合はヌル値を返します。

s1 が指す文字列が、 s2 が指す文字列に対して大きいか、等しいか、小さいかによって、正の整数、0、負の整数を返します。 比較は、プログラムの locale (以下の「ロケール」を参照) に適するように解釈された文字列に基づいています。 ``C'' の locale では、 strcoll() は、 strcmp() と同様に働きます。

s2 が指す文字列を変換し、その結果の文字列を s1 が指す配列に格納します。 この変換は、 strcmp() 関数を変換された ２ つの文字列に用いる場合、変換前の ２ つの文字列に strcoll() 関数を適用し、その結果に応じて正、0、負の値を返すようになっています。 終端にある null 文字を含んで、 n バイトしか出力文字列には格納されません。 変換後の文字列が n バイト以下しかない場合、出力文字列の長さが返されます (終端にある null 文字は含まれていません)。 n バイト以上のとき、返す値は文字列 s1 が占めている (終端にある null 文字は含まれない) バイト数になり、配列の内容は、確定しません。