【Swift】プロジェクト内のファイル読み込み

プロジェクトに含まれているリソースファイルにアクセスする方法を解説します。

アプリ内のファイルシステムへアクセスする方法を知りたい方は、【Swift】アプリ内のファイル読み書きを御覧ください。

環境
テキストファイルの準備
サンプルソースと解説

環境

この記事の情報は次のバージョンで動作確認しています。

【Xcode】11.4.1
【Swift】5.2
【iOS】13.4.1
【macOS】Catalina バージョン 10.15.4

テキストファイルの準備

次のような国名と首都名をカンマ区切りで格納した"captal.txt"を準備します。

日本,東京

アメリカ合衆国,ワシントンD.C

中華人民共和国,北京

インド,ニューデリー

インドネシア,ジャカルタ

パキスタン,イスラマバード

ブラジル,ブラジリア

ナイジェリア,アブジャ

バングラディシュ,ダッカ

ロシア,モスクワ

下図のようにファイルをドラッグしてProject Navigatorに追加します。

サンプルソースと解説

プロジェクトに追加したcapital.txtファイルを読み込む部分のコードがこちらです。

/// ①プロジェクト内にある"capital.txt"のパス取得

guard let fileURL = Bundle.main.url(forResource: "capital", withExtension: "txt") else {

fatalError("ファイルが見つからない")

}

/// ②capital.txtファイルの内容をfileContents:Stringに読み込み

guard let fileContents = try? String(contentsOf: fileURL) else {

fatalError("ファイル読み込みエラー")

}

/// ③ファイルの内容を"\n"で分割。

let countries = fileContents.components(separatedBy: "\n")

/// ④１行づつ出力

for capital in countries {

let values = capital.components(separatedBy: ",")

print("\(values[0])の首都は、\(values[1])です。")

}

①ファイルのパスを取得

/// ①プロジェクト内にある"capital.txt"のパス取得

guard let fileURL = Bundle.main.url(forResource: "capital", withExtension: "txt") else {

fatalError("ファイルが見つからない")

}

Xcodeでビルドされたアプリでは「バンドル（Bundle）」と呼ばれるものが作成され、プロジェクトに追加したファイルはこのBundle内に配置されます。
Bundle.main.url()を使って、このBundle内に格納された対象ファイルのパスを取得します。
引数（forResouece）にはファイル名、引数（withExtension）に拡張子を指定します。

対象ファイルが存在しない場合はnilが戻りますので、サンプルではfatalError()で強制的にアプリをクラッシュさせています。