Table of Contents
C言語でよく使うであろうヘッダファイル string.h で定義されている関数をまとめてみました。
検出系
- void *memchr(const void *buf, int c, size_t count)
bufの最初のcountバイトを検索して、unsigned charに変換されたcが最初に現れる場所を探します。buf内のcの場所へのポインタを返します。bufの最初のcountバイトの中にcが存在しない場合はNULLが返されます。- char *strchr(const char *string, int c)
文字列
stringの最初の文字cを検出します。stringはnul文字で終わっている必要があります。 戻り値は、内部的に文字に変換されたcがstringの中で最初に現れる場所へのポインタです。 存在しなければNULLが戻り値となります。- char *strstr(const char *string1, const char *string2)
string1の中でstring2が最初に現れる場所を検出します。 戻り値は、string1の中で最初に現れたstring2の先頭へのポインタです。string2がstring1の中に存在しなかった場合、 戻り値はNULLとなります。string2が指す文字列の長さが 0 の場合はstring1へのポインタが戻り値になります。- size_t strspn(const char *string1, const char *string2)
文字列
string1の先頭から始まる部分文字列で、string2に含まれる文字からなるものの最大の長さを返します。 別の言い方をすれば、 文字列string2に含まれない文字がstring1の中で最初に現れる場所のインデックスを返します。string1のすべての文字がstring2に含まれる場合にはstring1の長さが返されます。- size_t strcspn(const char *string1, const char *string2)
文字列
string1の先頭から始まる文字列で、string2に含まれない文字からなるものの最大の長さを返します。 別の言い方をすれば、文字列string2に含まれる文字がstring1にの中で最初に現れる場所のインデックスを返します。string1のすべての文字がstring2に含まれない場合にはstring1の長さが返されます。- char *strpbrk(const char *string1, const char *string2)
string2が指し示す文字列に含まれる文字のうちで、string1が指し示す文字列の中に最初に現れる文字を探します。 戻り値は検出された文字へのポインタです。string1とstring2に共通の文字がなければNULLを返します。- char *strtok(const char *string, const char *separator)
separatorをstringのトークンの区切り文字として扱います。 戻り値は先頭にある区切り文字をスキップして、stringの中の最初のトークンを探し、そのトークンへのポインタを返します。 1度呼び出した後は、stringにNULLを指定してstrtokを呼び出すことで、 最初に指定されたstring内の次のトークンへのポインタを返します。 返されるトークンは、区切り文字が nul文字に置き換えられたものになります。 また、区切り文字separatorは呼び出しごとに変更できます。 トークンがなくなると、NULLが返されます。
比較系
- int memcmp(const void *buf1, const void *buf2, size_t count)
buf1とbuf2の最初のcountバイトを比較して、次の値を返します。値 条件 正 buf1はbuf2より小さい0 buf1はbuf2と等しい負 buf1はbuf2より大きい- int strncmp(const char *string1, const char *string2, size_t count)
string1とstring2の最初のcount文字分を比較して、次の値を返します。値 条件 正 substring1はsubstring2より小さい0 substring1はsubstring2と等しい負 substring1はsubstring2より大きい- int strcmp(const char *string1, const char *string2)
string1とstring2を比較して、次の値を返します。値 条件 正 string1はstring2より小さい0 string1はstring2と等しい負 string1はstring2より大きい
コピー系
- void *memcpy(void *dest, const void *src, size_t count)
srcのcountバイトをdest にコピーします。 アドレスが重複するオブジェクト間でのコピーが行われた場合の動作は不定です。 戻り値はdestへのポインタです。- char *strcpy(char *string1, const char *string2)
string2を最後のnul文字も含めて、ポインタstring1で指定される位置にコピーします。string1に文字列定数を指定することはできません。 戻り値はstring1へのポインタです。- char *strncpy(char *string1, const char *string2, size_t count)
string2のcount文字分をstring1にコピーします。countがstring1の長さより小さいか等しい場合、コピーされた文字列にnul文字は付加されません。countがstring2の長さより大きい場合、結果のstring1には長さがcountになるまで nul文字が埋め込まれます。 戻り値はstring1へのポインタです。- void *memmove(void *dest, const void *src, size_t count)
memcpyと同様に、srcのcountバイトをdest にコピーしますが、memcpyとは違ってアドレスが重複するオブジェクト間でのコピーを安全に行うことができます。 これはsrcを内部の1次配列にコピーしたうえでバイトを行うからです。 戻り値はdestへのポインタです。
- void *memset(void *dest, int c, size_t count)
destの最初のcountバイトを値cに変換します。 戻り値はdestへのポインタです。
文字列結合
- char *strcat(char *string1, const char string2)
string2をstring1に連結し、結果の文字列の最後に'\0'を付けます。string1に文字列定数を指定することはできませんが、string2には文字列定数を指定することができます。 戻り値はstring1へのポインタです。- char *strncat(char *string1, const char string2, size_t count)
string2の最初のcount文字をstring1に連結し、結果の文字列の最後に'\0'を付けます。string2がcount文字に満たない場合はstring2全体をstring1に連結します。string1に文字列定数を指定することはできませんが、string2には文字列定数を指定することができます。 戻り値はstring1へのポインタです。
その他
- char *strerror(int errno)
errnoにあるエラー番号をエラーメッセージ文字列にマップして、文字列へのポインタを返します。

