「C言語/標準ライブラリ/string.h」の版間の差分

 

文字列操作の関数を使用するためには、

 

== コピー関数 ==

=== memcpy関数 ===

*形式

void *memcpy(void * restrict s1, const void * restrict s2, size_t n);

</pre>

*機能

:s2が指すオブジェクトから、s1が指すオブジェクトに、n文字コピーする。<br>s1とs2が重なっている場合、その動作は未定義である。<br>返却値はs1の値を返す。

void *memmove(void *s1, const void *s2, size_t n);

</pre>

*機能

:s2が指すオブジェクトから、s1が指すオブジェクトに、n文字コピーする。<br>s1とs2が重なっていてもよい。<br>返却値はs1の値を返す。

char *strcpy(char * restrict s1, const char * restrict s2);

</pre>

*機能

:s2が指す文字列（終端ナル文字を含む）をs1が指す配列にコピーする。<br>s1とs2が重なっている場合、その動作は未定義である。<br>返却値はs1の値を返す。

char *strncpy(char * restrict s1, const char * restrict s2, size_t n);

</pre>

*機能

:s2が指す配列から、s1が指す配列に、n個以下の文字（ナル文字に続く文字はコピーしない。）をコピーする。<br>s1とs2が重なっている場合、その動作は未定義である。<br>s2が指す配列がn文字より短い配列である場合、s1が指す配列中のコピーの後ろに、全体でn文字書き込むまでナル文字を付加する。<br>返却値はs1の値を返す。

 

== 連結関数 ==

=== strcat関数 ===

*形式

char *strcat(char * restrict s1, const char * restrict s2);

</pre>

*機能

:s2が指す文字列（終端ナル文字を含む。）のコピーをs1が指す文字列の最後に付加する。<br>s2の先頭の文字が、s1が指す文字列の最後のナル文字を書き換える。<br>s1とs2が重なっている場合、その動作は未定義である。<br>返却値はs1の値を返す。

char *strncat(char * restrict s1, const char * restrict s2, size_t n);

</pre>

*機能

:s2が指す配列からn個以下の文字を、s1が指す文字列の最後に付加する。<br>（ナル文字及びナル文字に続く文字は付加しない。）<br>s2の先頭の文字が、s1が指す文字列の最後のナル文字を書き換える。<br>終端ナル文字を常に結果に付加する。<br>s1とs2が重なっている場合、その動作は未定義である。<br>返却値はs1の値を返す。

 

==== 比較関数 ====

比較関数memcmp, strcmp及びstrncmpが返す0以外の値の符号は、

比較対象のオブジェクトにおいて最初に異なる文字の対

int memcmp(const void *s1, const void *s2, size_t n);

</pre>

*機能

:s1が指すオブジェクトの始めのn文字と、s2が指すオブジェクトの始めのn文字を比較する。<br>返却値はs1がs2より大きいか、等しいか、又は小さいかによって、それぞれ、0より大きい、0に等しい、又は0より小さい整数を返す。

int strcmp(const char *s1, const char *s2);

</pre>

*機能

:s1が指す文字列とs2が指す文字列を比較する。<br>返却値はs1が指す文字列が、s2が指す文字列より大きいか、等しいか、又は小さいかによって、それぞれ、0より大きい、0に等しい、又は0より小さい整数を返す。

int strcoll(const char *s1, const char *s2);

</pre>

*機能

:s1が指す文字列とs2が指す文字列を比較する。<br>このとき、いずれの文字列も、その時点のロケールのLC_COLLATEカテゴリに従って解釈する。<br>返却値は、s1が指す文字列及びs2が指す文字列をその時点のロケールに従って解釈したとき、<br>s1が指す文字列が、s2が指す文字列より大きいか、等しいか、又は小さいかによって、それぞれ、0より大きい、0に等しい、又は0より小さい整数を返す。

int strncmp(const char *s1, const char *s2, size_t n);

</pre>

*機能

:s1が指す配列をs2が指す配列と比較する。<br>比較する文字はn文字以下とする。（ナル文字に続く文字は比較しない）<br>返却値は、s1が指す配列（ナル文字で終了しうる）が、s2が指す配列（ナル文字で終了しうる）より大きいか、等しいか、又は小さいかによって、それぞれ、0より大きい、0に等しい、又は0より小さい整数を返す。

size_t strxfrm(char * restrict s1, const char * restrict s2, size_t n);

</pre>

*機能

:s2が指す文字列を変換し、その結果の文字列をs1が指す配列に格納する。<br>その変換は次の通りとする。<br>すなわち、strcmp関数を変換結果の2つの文字列に適用した場合、strcmp関数が0より大きい値を返すか、0を返すか、又は0より小さい値を返すかは、2つの変換前の文字列をstrcoll関数に適用した結果と一致する。<br>終端ナル文字を含めて、n個を超える文字を、s1が指す結果の配列に格納することはない。<br>nが0である場合、s1は空ポインタであってもよい。<br>s1とs2が重なっている場合、その動作は未定義である。<br>返却値は、変換した結果の文字列（終端ナル文字は含まない）の長さを返す。<br>返却された値がn以上の場合、s1が指す配列の内容は不定とする。

 

==== 探索関数 ====

=== memchr関数 ===

*形式

void *memchr(const void *s, int c, size_t n);

</pre>

*機能

:sが指すオブジェクトの先頭のn文字（各々unsigned char型として解釈する。）の中でc（unsigned char型に型変換する。）が最初に現れる位置を捜す。<br>返却値は、捜し出した文字へのポインタを返す。<br>オブジェクトの中にその文字が現れない場合、空ポインタを返す。

char *strchr(const char *s, int c);

</pre>

*機能

:sが指す文字列の中で、c（char型に型変換する。）が最初に現れる位置を捜す。<br>終端ナル文字は文字列の一部とみなす。<br>返却値は、捜し出した文字へのポインタを返す。<br>文字列の中にその文字が現れない場合、空ポインタを返す。

size_t strcspn(const char *s1, const char *s2);

</pre>

*機能

:s1が指す文字列の中で、s2が指す文字列中の文字を含まない先頭部分の最大の長さを計算する。<br>返却値は、その先頭部分の長さを返す。

char *strpbrk(const char *s1, const char *s2);

</pre>

*機能

:s1が指す文字列の中で、s2が指す文字列の中のいずれかの文字が最初に現れる位置を捜す。<br>返却値は、その文字へのポインタを返す。<br>s1が指す文字列の中に、s2が指す文字列の中のいずれの文字も現れない場合、空ポインタを返す。

char *strrchr(const char *s, int c);

</pre>

*機能

:sが指す文字列の中で、c（char型に型変換する。）が最後に現れる位置を捜す。<br>終端ナル文字は文字列の一部とみなす。<br>返却値はその文字へのポインタを返す。<br>文字列の中にcが現れない場合、空ポインタを返す。

size_t strspn(const char *s1, const char *s2);

</pre>

*機能

:s1が指す文字列の中で、s2が指す文字列中の文字だけを含む先頭部分の最大の長さを計算する。<br>返却値は、その先頭部分の長さを返す。

char *strstr(const char *s1, const char *s2);

</pre>

*機能

:s1が指す文字列の中で、s2が指す文字列の中の文字の並び（終端ナル文字を除く。）が最初に現れる位置を捜す。<br>返却値は、探し出した文字列へのポインタを返す。<br>その文字列が見つからなかった場合、空ポインタを返す。<br>s2が長さ0の文字列を指す場合、s1を返す。

char *strtok(char * restrict s1, char * restrict s2);

</pre>

*機能

:strtok関数の一連の呼び出しは、s1が指す文字列を、s2が指す文字列の中のいずれかの文字で区切られる字句の列に分割する。<br>一連の呼び出しの最初の呼び出しでは、第1実引数として空ポインタ以外を指定する。<br>それ以降の呼び出しでは、第1実引数として空ポインタを指定する。<br>s2が指す区切り文字は、呼出しごとに異なっていてもよい。<br><br>一連の呼び出しの中の最初の呼び出しでは、s2が指すその時点での区切り文字列に含まれない最初の文字を、s1が指す文字列中で捜す。<br>その文字が見つからない場合、s1が指す文字列には字句が存在せず、strtok関数は空ポインタを返す。<br>その文字が見つかった場合、それを最初に字句の始まりとする。<br><br>次に、strtok関数は、見つかった文字の位置からその時点での区切り文字列に含まれている文字を捜す。その文字が見つからない場合、その時点の字句をs1が指す文字列の最後までとみなし、次回以降の探索では空ポインタを返す。<br>その文字が見つかった場合、その文字をナル文字で書き換え、その時点の字句を終了させる。<br>strtok関数はその次の文字へのポインタを保持しておき、字句の次の探索はそこから開始する。<br><br>第1実引数の値が空ポインタを持つ2回目以降の各呼び出しでは、保持したポインタが指すところから探索を開始する以外は、これと同じ動作をする。<br><br>処理系は、いかなるライブラリ関数もstrtok関数を呼び出さない場合の動作と同じ動作をしなければならない。<br><br>返却値は、字句の最初の文字へのポインタを返す。<br>字句が存在しない場合、空ポインタを返す。

 

==== その他の関数 ====

=== memset関数 ===

*形式

void *memset(void *s, int c, size_t n);

</pre>

*機能

:c(unsigned char型に型変換する。)の値を、sが指すオブジェクトの最初のn文字のそれぞれにコピーする。<br>返却値は、sの値を返す。

char *strerror(int errnum);

</pre>

*機能

:errnumに入っている番号をメッセージ文字列に対応付ける。<br>典型的にはerrnumの値は、errnoが使われるが、strerror関数はint型の全ての値に対してメッセージを割り当てなければならない。<br><br>処理系は、いかなるライブラリ関数もstrerror関数を呼び出さない場合の動作と同じ動作をしなければならない。<br><br>返却値は、文字列へのポインタを返す。<br>その内容は、文化圏固有とする。<br>このポインタが指す配列をプログラムで変更してはならないが、strerror関数のそれ以降の呼び出しで書き変わることがある。

size_t strlen(const char *s);

</pre>

*機能

:sが指す文字列の長さを計算する。<br>返却値は、終端ナル文字に先行する文字の個数を返す。