【C言語】関数の引数で文字列を受け取る方法を解説

2023-09-242024-07-22

C言語でプログラムを書くとき、文字列を関数に渡す方法を知っているととても便利です。

この記事では、文字列を関数の引数として渡す基本的な方法から、具体的な例までをわかりやすく解説します。

また、プログラムを書く上で注意すべきポイントやベストプラクティスについても紹介します。

初心者の方でも理解しやすいように、サンプルコードとその解説を交えながら進めていきますので、ぜひ参考にしてください。

目次から探す

関数の引数として文字列を受け取る方法

C言語では、関数の引数として文字列を受け取る方法はいくつかあります。

文字列は実際には文字の配列であり、配列やポインタを使って関数に渡すことができます。

ここでは、基本的な方法と具体的な例を紹介します。

文字列を引数として渡す基本

char配列を引数にする

文字列を関数に渡す最も基本的な方法は、char配列を引数として渡すことです。

以下に例を示します。

#include <stdio.h>
void printString(char str[]) {
    printf("文字列: %s\n", str);
}
int main() {
    char myString[] = "Hello, World!";
    printString(myString);
    return 0;
}

この例では、printString関数がchar配列を引数として受け取り、その内容を表示します。

ポインタを引数にする

もう一つの方法は、ポインタを使って文字列を渡すことです。

char配列の先頭アドレスをポインタとして渡すことで、同じように文字列を扱うことができます。

#include <stdio.h>
void printString(char *str) {
    printf("文字列: %s\n", str);
}
int main() {
    char myString[] = "Hello, World!";
    printString(myString);
    return 0;
}

この例では、printString関数がcharポインタを引数として受け取り、その内容を表示します。

char配列の先頭アドレスを渡すことで、ポインタを使って文字列を操作できます。

文字列を受け取る関数の例

文字列の長さを計算する関数

文字列の長さを計算する関数を作成することができます。

以下に例を示します。

#include <stdio.h>
int stringLength(char *str) {
    int length = 0;
    while (str[length] != '\0') {
        length++;
    }
    return length;
}
int main() {
    char myString[] = "Hello, World!";
    int length = stringLength(myString);
    printf("文字列の長さ: %d\n", length);
    return 0;
}

この例では、stringLength関数が文字列の長さを計算し、その結果を返します。

文字列をコピーする関数

文字列を別の配列にコピーする関数を作成することもできます。

以下に例を示します。

#include <stdio.h>
void stringCopy(char *destination, const char *source) {
    while (*source) {
        *destination = *source;
        destination++;
        source++;
    }
    *destination = '\0';
}
int main() {
    char source[] = "Hello, World!";
    char destination[50];
    stringCopy(destination, source);
    printf("コピーされた文字列: %s\n", destination);
    return 0;
}

この例では、stringCopy関数が文字列をコピーし、コピー先の配列に結果を格納します。

文字列を連結する関数

文字列を連結する関数も作成できます。

以下に例を示します。

#include <stdio.h>
void stringConcat(char *destination, const char *source) {
    while (*destination) {
        destination++;
    }
    while (*source) {
        *destination = *source;
        destination++;
        source++;
    }
    *destination = '\0';
}
int main() {
    char str1[50] = "Hello, ";
    char str2[] = "World!";
    stringConcat(str1, str2);
    printf("連結された文字列: %s\n", str1);
    return 0;
}

この例では、stringConcat関数が2つの文字列を連結し、結果を最初の文字列に格納します。

注意点とベストプラクティス

メモリ管理の重要性

C言語では、メモリ管理が非常に重要です。

特に文字列を扱う際には、メモリの確保と解放を適切に行わないと、メモリリークやクラッシュの原因となります。

以下に、文字列を動的に確保する例を示します。

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
void copyString(const char *source) {
    // 文字列の長さを取得し、メモリを確保
    char *destination = (char *)malloc(strlen(source) + 1);
    if (destination == NULL) {
        printf("メモリの確保に失敗しました。\n");
        return;
    }
    // 文字列をコピー
    strcpy(destination, source);
    printf("コピーされた文字列: %s\n", destination);
    // メモリを解放
    free(destination);
}
int main() {
    const char *original = "Hello, World!";
    copyString(original);
    return 0;
}

この例では、malloc関数を使って動的にメモリを確保し、strcpy関数で文字列をコピーしています。

最後に、free関数で確保したメモリを解放しています。

これにより、メモリリークを防ぐことができます。

NULLポインタの扱い

関数の引数として文字列を受け取る際には、NULLポインタが渡される可能性も考慮する必要があります。

NULLポインタを適切に扱わないと、プログラムがクラッシュする原因となります。

以下に、NULLポインタをチェックする例を示します。

#include <stdio.h>
#include <string.h>
void printString(const char *str) {
    if (str == NULL) {
        printf("NULLポインタが渡されました。\n");
        return;
    }
    printf("受け取った文字列: %s\n", str);
}
int main() {
    const char *validString = "Hello, World!";
    const char *nullString = NULL;
    printString(validString);
    printString(nullString);
    return 0;
}

この例では、関数printStringが引数として受け取った文字列がNULLかどうかをチェックしています。

NULLポインタが渡された場合には、適切なメッセージを表示して処理を終了します。

バッファオーバーフローの防止

バッファオーバーフローは、C言語プログラムにおいて非常に危険な問題です。

特に文字列操作を行う際には、バッファのサイズを超えないように注意する必要があります。

以下に、バッファオーバーフローを防ぐための例を示します。

#include <stdio.h>
#include <string.h>
void safeCopyString(char *destination, const char *source, size_t destSize) {
    if (strlen(source) >= destSize) {
        printf("バッファサイズを超えています。\n");
        return;
    }
    strcpy(destination, source);
    printf("安全にコピーされた文字列: %s\n", destination);
}
int main() {
    char buffer[10];
    const char *shortString = "Hello";
    const char *longString = "Hello, World!";
    safeCopyString(buffer, shortString, sizeof(buffer));
    safeCopyString(buffer, longString, sizeof(buffer));
    return 0;
}

この例では、safeCopyString関数がコピー先のバッファサイズをチェックし、バッファオーバーフローを防いでいます。

コピー元の文字列がバッファサイズを超える場合には、適切なメッセージを表示して処理を終了します。