Swiftの関数ベストプラクティスまとめ！初心者でも読みやすいコードを書く方法

Swift 関数のベストプラクティスまとめ

先生と生徒の会話形式で理解しよう

生徒

「Swiftで関数を作るとき、どうやったらキレイに書けますか？」

先生

「いい質問だね。関数にはいくつか守ると良いルールやコツがあるんだよ。それを知っていれば、コードが読みやすくなるし、バグも減らせるんだ。」

生徒

「具体的にはどんなことに気をつけたらいいんですか？」

先生

「じゃあ、Swiftの関数をきれいに書くためのベストプラクティスを一緒に学んでいこう！」

1. 関数はひとつの目的だけを持たせよう

関数は「ひとつの目的」に集中させるのがポイントです。たとえば、「データを取得して表示する」ではなく、「データを取得する関数」と「表示する関数」に分けた方が読みやすくなります。


func fetchUserData() {
    // ユーザーデータを取得
}

func displayUserData() {
    // ユーザーデータを画面に表示
}

このように、関数を役割ごとに分けることで、あとから見たときに理解しやすくなります。

2. 引数は必要最小限に

関数に渡す値（これを「引数」といいます）は、できるだけ少なくしましょう。引数が多すぎると使うのが大変になり、バグの原因にもなります。


func createUser(name: String, age: Int, email: String) {
    // ユーザーを作成
}

もしも引数が4つ以上になる場合は、構造体などでまとめるのが良いです。

3. 名前はわかりやすく自然な文章のように

関数名と引数名を組み合わせると、まるで文章のように読めるようにしましょう。これがSwiftの外部引数名の考え方です。


func sendMessage(to user: String, with text: String) {
    // メッセージ送信
}

このようにすると、関数の呼び出しが自然に読めます：


sendMessage(to: "Taro", with: "こんにちは！")

4. 処理が長くなったら内部で関数に分ける

関数の中が長くなると、どこで何をしているかがわかりにくくなります。そんなときは、処理をいくつかの関数に分けるとスッキリします。


func processOrder() {
    validateOrder()
    calculateTotal()
    sendConfirmation()
}

func validateOrder() { /* 注文の確認 */ }
func calculateTotal() { /* 合計金額を計算 */ }
func sendConfirmation() { /* 確認メールを送信 */ }

5. 戻り値で結果を返す習慣をつけよう

関数は処理が終わったあと、結果を戻す（戻り値）ことができます。特に値を使いまわすときに便利です。


func multiply(a: Int, b: Int) -> Int {
    return a * b
}

let result = multiply(a: 3, b: 4)
print(result)

戻り値があることで、関数の再利用性が高まります。

6. デフォルト引数を使って柔軟な関数にする

デフォルト引数とは、引数にあらかじめ値を設定しておくことです。これにより、必要に応じて引数を省略できます。


func greet(name: String = "ゲスト") {
    print("こんにちは、\(name)さん！")
}

greet()
greet(name: "花子")


こんにちは、ゲストさん！
こんにちは、花子さん！

7. 再利用できる関数は積極的に作る

同じような処理を何度も書いている場合は、関数として切り出して使い回すのがベストです。


func printDivider() {
    print("------------------")
}

print("処理開始")
printDivider()
print("処理終了")
printDivider()

Swiftを基礎から実践レベルまで学びたい人や、 iOSアプリ開発を本格的に始めたい人には、定番の入門＋実践書がこちらです。

Swift実践入門をAmazonで見る

※ Amazon広告リンク

8. コメントで補足をつけておく

関数が何をするのか、1行だけでも良いのでコメントをつけておくと、他の人（そして未来の自分）が見たときに理解しやすくなります。


// ユーザー情報をデータベースから取得する
func fetchUserFromDB() {
    // 取得処理
}

Windowsで始めるiPhoneアプリ開発入門｜Swiftの基本と仕組みを1時間で攻略

「iPhoneアプリを作りたいけれど、Macを持っていないから諦めている」そんな方のための画期的な入門講座です。実は、プログラミングの本質を学ぶのに高価な機材は必要ありません。本講座では、Windowsパソコンを使用し、クラウド環境を活用してAppleの最新言語Swift（スウィフト）の基礎を最短距離でマスターします。