「C言語」タグアーカイブ

ctype.h にあるよく使う関数


ctype.h で定義されている、よく使うであろう関数をまとめてみました。

文字チェック

int isalnum(int character)

引数が文字 ('A' から 'Z', 'a' から 'z' または 0 から 9) なら 非ゼロ、そうでなければゼロを返す。

int isalpha(int character)

引数がアルファベットなら非ゼロ、そうでなければゼロを返す。

int isdigit(int character)

引数が数字 (0 から 9) なら非ゼロ、そうでなければゼロを返す。

int isxdigit(int character)

引数が16進数文字 (0 から 9'A' から 'F' または 'a' から 'f') なら非ゼロ、そうでなければゼロを返す。

int iscntrl(int character)

引数が制御文字 (0x00 から 0x1F または 0x7F) なら非ゼロ、そうでなければゼロを返す。

int isprint(int character)

引数が印字可能文字 (0x20 から 0x7E) なら非ゼロ、そうでなければゼロを返す。

int isgraph(int character)

引数がスペース以外の印字可能文字 (0x21 から 0x7E) なら非ゼロ、そうでなければゼロを返す。

int islower(int character)

引数が小文字なら非ゼロ、そうでなければゼロを返す。

int isupper(int character)

引数が大文字なら非ゼロ、そうでなければゼロを返す。

int isspace(int character)

引数が空白文字 (スペース、タブ文字、復帰文字、改行文字、垂直タブ文字、改ページ文字) なら非ゼロ、そうでなければゼロを返す。

int ispunct(int character)

引数が句読点文字 (空白文字とisalnumが非ゼロとなる文字を除くすべての文字) なら非ゼロ、そうでなければゼロを返す。

文字変換

int tolower(int character)

character が大文字なら、それを小文字にして返す。

int toupper(int character)

character が小文字なら、それを大文字にして返す。


string.h にある、よく使う関数


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文字で終わっている必要があります。 戻り値は、内部的に文字に変換された cstring の中で最初に現れる場所へのポインタです。 存在しなければ NULL が戻り値となります。

char *strstr(const char *string1, const char *string2)

string1 の中で string2 が最初に現れる場所を検出します。 戻り値は、 string1 の中で最初に現れた string2 の先頭へのポインタです。 string2string1 の中に存在しなかった場合、 戻り値は 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 が指し示す文字列の中に最初に現れる文字を探します。 戻り値は検出された文字へのポインタです。 string1string2 に共通の文字がなければ NULL を返します。

char *strtok(const char *string, const char *separator)

separatorstring のトークンの区切り文字として扱います。 戻り値は先頭にある区切り文字をスキップして、 string の中の最初のトークンを探し、そのトークンへのポインタを返します。 1度呼び出した後は、 stringNULL を指定して strtok を呼び出すことで、 最初に指定された string 内の次のトークンへのポインタを返します。 返されるトークンは、区切り文字が nul文字に置き換えられたものになります。 また、区切り文字 separator は呼び出しごとに変更できます。 トークンがなくなると、 NULL が返されます。

比較系

int memcmp(const void *buf1, const void *buf2, size_t count)

buf1buf2 の最初の count バイトを比較して、次の値を返します。

条件
buf1buf2 より小さい
0 buf1buf2 と等しい
buf1buf2 より大きい
int strncmp(const char *string1, const char *string2, size_t count)

string1string2 の最初の count 文字分を比較して、次の値を返します。

条件
substring1substring2 より小さい
0 substring1substring2 と等しい
substring1substring2 より大きい
int strcmp(const char *string1, const char *string2)

string1string2 を比較して、次の値を返します。

条件
string1string2 より小さい
0 string1string2 と等しい
string1string2 より大きい

コピー系

void *memcpy(void *dest, const void *src, size_t count)

srccount バイトを dest にコピーします。 アドレスが重複するオブジェクト間でのコピーが行われた場合の動作は不定です。 戻り値は dest へのポインタです。

char *strcpy(char *string1, const char *string2)

string2 を最後のnul文字も含めて、ポインタ string1 で指定される位置にコピーします。 string1 に文字列定数を指定することはできません。 戻り値は string1 へのポインタです。

char *strncpy(char *string1, const char *string2, size_t count)

string2count 文字分を string1 にコピーします。 countstring1 の長さより小さいか等しい場合、コピーされた文字列にnul文字は付加されません。 countstring2 の長さより大きい場合、結果の string1 には長さが count になるまで nul文字が埋め込まれます。 戻り値は string1 へのポインタです。

void *memmove(void *dest, const void *src, size_t count)

memcpy と同様に、 srccount バイトを 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)

string2string1 に連結し、結果の文字列の最後に '\0' を付けます。 string1 に文字列定数を指定することはできませんが、 string2 には文字列定数を指定することができます。 戻り値は string1 へのポインタです。

char *strncat(char *string1, const char string2, size_t count)

string2 の最初の count 文字を string1 に連結し、結果の文字列の最後に '\0' を付けます。 string2count 文字に満たない場合は string2 全体を string1 に連結します。 string1 に文字列定数を指定することはできませんが、 string2 には文字列定数を指定することができます。 戻り値は string1 へのポインタです。

その他

char *strerror(int errno)

errno にあるエラー番号をエラーメッセージ文字列にマップして、文字列へのポインタを返します。