閉じる

C言語で配列を返す方法｜ポインタや構造体を使った実践的な実装パターン

広告

C言語を学習する過程で、多くの開発者が「関数から配列を戻り値として返したい」という課題に直面します。

C言語の言語仕様上、関数が配列そのものを直接戻り値として返すことは許可されていません。

しかし、ポインタや構造体、動的メモリ確保といった技術を組み合わせることで、実質的に配列のデータを関数間で受け渡すことが可能になります。

この記事では、実務でも多用される実践的な配列の返却手法を、具体的なコード例とともに詳しく解説します。

目次 [ close ]
  1. なぜC言語では配列を直接返せないのか
  2. 方法1：呼び出し元で用意した配列をポインタで受け取る
    1. 実装例：ポインタによる配列操作
  3. 方法2：静的変数（static）を利用して配列のポインタを返す
    1. 実装例：static配列の返却
  4. 方法3：動的メモリ確保（malloc）を利用する
    1. 実装例：mallocによる動的な配列生成
  5. 方法4：構造体の中に配列を含めて値を返す
    1. 実装例：構造体を利用した配列の返却
  6. 各手法の比較と使い分けのポイント
  7. 安全なプログラムを書くための注意点
  8. まとめ

なぜC言語では配列を直接返せないのか

C言語において、関数が戻り値として返せるのは、基本型や構造体、あるいはポインタに限られています。

配列名は式の中で評価されると、その配列の先頭要素を指すポインタに自動的に変換されるという性質を持っています。

関数内で定義されたローカルな配列をそのまま返そうとすると、関数の終了とともにその配列がメモリ上から消滅してしまいます。

消滅した領域を指すポインタを呼び出し元で参照することは、未定義の動作を引き起こし、深刻なバグの原因となります。

そのため、安全にデータをやり取りするためには、メモリの有効期限（スコープ）を正しく管理する手法を選択する必要があります。

方法1：呼び出し元で用意した配列をポインタで受け取る

最も安全で効率的な方法は、関数の呼び出し側で配列を準備し、そのポインタを引数として関数に渡す方法です。

この手法は「出力引数」と呼ばれ、C言語の標準ライブラリでも広く採用されている一般的な設計パターンです。

呼び出し元でメモリが確保されているため、関数内で新しくメモリを割り当てる必要がなく、メモリ管理が非常にシンプルになります。

実装例：ポインタによる配列操作

C言語
#include <stdio.h>

// 呼び出し元から渡された配列に値を代入する関数
void fillArray(int *arr, int size) {
    for (int i = 0; i < size; i++) {
        // インデックスごとに値を設定
        arr[i] = i * 10;
    }
}

int main() {
    int myArray[5];
    int n = 5;

    // 配列の先頭アドレスを渡す
    fillArray(myArray, n);

    for (int i = 0; i < n; i++) {
        printf("myArray[%d] = %d\n", i, myArray[i]);
    }

    return 0;
}
実行結果
myArray[0] = 0
myArray[1] = 10
myArray[2] = 20
myArray[3] = 30
myArray[4] = 40

この方法の利点は、メモリの確保と解放の責任が呼び出し側にあることが明確である点です。

関数の引数に配列のサイズを渡すことで、配列の範囲外へのアクセスを防ぐ安全性も確保しやすくなります。

方法2：静的変数（static）を利用して配列のポインタを返す

関数内で宣言する変数にstatic修飾子を付与すると、その変数の寿命はプログラムの実行終了まで持続するようになります。

これを利用することで、関数が終了した後もメモリ上に残る配列のポインタを呼び出し元に返すことが可能になります。

ただし、静的変数はプログラム全体で共有される単一の領域であるため、再入可能性（リエントラント）に欠けるという欠点があります。

実装例：static配列の返却

C言語
#include <stdio.h>

int* getStaticArray() {
    // staticキーワードにより、関数終了後も値が保持される
    static int data[3] = {100, 200, 300};
    return data;
}

int main() {
    int *res;

    res = getStaticArray();

    printf("Result: %d, %d, %d\n", res[0], res[1], res[2]);

    return 0;
}
実行結果
Result: 100, 200, 300

この手法は、マルチスレッド環境において複数のスレッドから同時に呼び出されるとデータが破壊されるリスクがあります。

また、同じ関数を二度呼び出すと、以前に取得したポインタが指す内容も上書きされてしまうため、注意が必要です。

方法3：動的メモリ確保（malloc）を利用する

実行時に必要なサイズが決まる場合や、永続的なデータとして扱いたい場合には、malloc関数を使用した動的メモリ確保が適しています。

ヒープ領域にメモリを確保するため、関数が終了してもそのデータは明示的に解放されるまで消滅しません。

戻り値としてポインタを返す際、最も自由度が高く実践的な手法と言えます。

実装例：mallocによる動的な配列生成

C言語
#include <stdio.h>
#include <stdlib.h>

int* createDynamicArray(int size) {
    // ヒープ領域からメモリを割り当て
    int *ptr = (int *)malloc(size * sizeof(int));

    // メモリ確保失敗時のエラー処理
    if (ptr == NULL) {
        return NULL;
    }

    for (int i = 0; i < size; i++) {
        ptr[i] = (i + 1) * 5;
    }

    return ptr;
}

int main() {
    int size = 4;
    int *arr = createDynamicArray(size);

    if (arr != NULL) {
        for (int i = 0; i < size; i++) {
            printf("arr[%d] = %d\n", i, arr[i]);
        }

        // 使用後は必ずfreeでメモリを解放する
        free(arr);
    }

    return 0;
}
実行結果
arr[0] = 5
arr[1] = 10
arr[2] = 15
arr[3] = 20

動的確保を用いる場合、使い終わったメモリを必ずfree関数で解放しなければならないという重要なルールがあります。

解放を忘れると「メモリリーク」が発生し、長時間稼働するプログラムのメモリを食い潰す原因となります。

方法4：構造体の中に配列を含めて値を返す

C言語では配列そのものを返すことはできませんが、構造体は「値」として関数から返すことが可能です。

配列を構造体のメンバとして定義することで、構造体のコピーを通じて配列のデータを一度に返却できます。

この方法はメモリの動的な管理を必要としないため、コードが簡潔になるメリットがあります。

実装例：構造体を利用した配列の返却

C言語
#include <stdio.h>

// 構造体に固定サイズの配列を定義
typedef struct {
    int values[3];
} ArrayWrapper;

ArrayWrapper getStructArray() {
    ArrayWrapper wrapper;
    wrapper.values[0] = 7;
    wrapper.values[1] = 14;
    wrapper.values[2] = 21;
    
    // 構造体ごと値として返す
    return wrapper;
}

int main() {
    ArrayWrapper result = getStructArray();

    printf("Values: %d, %d, %d\n", result.values[0], result.values[1], result.values[2]);

    return 0;
}
実行結果
Values: 7, 14, 21

構造体を利用する場合、配列のサイズがコンパイル時に固定されている必要があります。

大きな配列を構造体で返そうとすると、メモリのコピーコストが大きくなり、パフォーマンスに影響を与える可能性がある点に注意しましょう。

各手法の比較と使い分けのポイント

状況に応じて最適な手法を選択するために、それぞれの特徴を理解しておくことが重要です。

手法メリットデメリット
呼び出し元で確保最も安全、高速、メモリ管理が容易引数が多くなりがち
静的変数(static)手軽に実装可能スレッドセーフではない、上書きの危険
動的確保(malloc)サイズが可変、寿命を自在に制御free忘れによるリークのリスク
構造体による包摂値渡しで直感的な記述が可能サイズ固定、コピーのオーバーヘッド

基本的には、「呼び出し元で配列を確保し、ポインタを渡す」手法を第一選択とするのが定石です。

関数内でどうしても配列を生成し、その寿命を関数の外まで維持したい場合のみ、mallocの利用を検討しましょう。

安全なプログラムを書くための注意点

C言語におけるメモリ管理の誤りは、セグメンテーションフォールトなどの致命的なエラーを招きます。

特に初心者にとって最も危険なのは、ローカル配列のポインタを返してしまうミスです。

int* func() { int a[10]; return a; } のようなコードはコンパイラが警告を出してくれることが多いですが、決して無視してはいけません。

また、動的確保を行う際は、必ずNULLチェックを行い、メモリの割り当てが成功したかを確認する癖をつけてください。

大規模な開発では、誰がメモリを確保し、誰がメモリを解放するのかという「所有権」のルールをプロジェクト内で統一することが不可欠です。

まとめ

C言語で関数から配列を返すための方法は複数存在しますが、それぞれに明確な使いどころがあります。

配列の寿命とメモリの所在を常に意識することが、バグの少ない堅牢なコードを書くための近道です。

基本となる「引数での受け渡し」、柔軟な「動的確保」、簡潔な「構造体利用」の3パターンをマスターし、用途に合わせて使い分けられるようになりましょう。

この記事で紹介したテクニックを活用して、より高度なC言語プログラミングに挑戦してみてください。

URLをコピーしました！