【Swift入門】@escapingとは？使い方を初心者向けに徹底解説

// 通常のクロージャ（@escapingなし）
func simpleFunction(action: () -> Void) {
    print("処理開始")
    action()  // ここですぐに実行
    print("処理終了")
}

simpleFunction {
    print("クロージャ実行")
}

// 出力:
// 処理開始
// クロージャ実行
// 処理終了

// @escapingを使ったクロージャ
func delayedFunction(completion: @escaping () -> Void) {
    print("処理開始")
    DispatchQueue.main.asyncAfter(deadline: .now() + 2) {
        completion()  // 2秒後に実行（関数はすでに終了している）
    }
    print("処理終了")
}

delayedFunction {
    print("クロージャ実行")
}

// 出力:
// 処理開始
// 処理終了
// （2秒後）
// クロージャ実行

class APIClient {
    func fetchUserData(completion: @escaping (User?, Error?) -> Void) {
        URLSession.shared.dataTask(with: url) { data, response, error in
            // ネットワーク処理完了後にクロージャを実行
            if let error = error {
                completion(nil, error)
                return
            }
            
            // データをパース
            let user = parseUser(from: data)
            completion(user, nil)
        }.resume()
    }
}

// 使用例
let client = APIClient()
client.fetchUserData { user, error in
    if let user = user {
        print("ユーザー名: \(user.name)")
    }
}

class Button {
    var actionHandler: (() -> Void)?
    
    func setAction(_ handler: @escaping () -> Void) {
        self.actionHandler = handler  // プロパティに保存
    }
    
    func tap() {
        actionHandler?()  // 後で実行される
    }
}

// 使用例
let button = Button()
button.setAction {
    print("ボタンがタップされました")
}

button.tap()  // ボタンがタップされました

class TaskManager {
    func performTask(
        preparation: @escaping () -> Void,
        execution: @escaping () -> Void
    ) {
        DispatchQueue.global().async {
            preparation()  // preparationもescapingクロージャ内で使用
            
            DispatchQueue.main.async {
                execution()
            }
        }
    }
}

func processData(action: () -> Void) {
    action()
}  // actionはここで自動的に解放される

class ViewController {
    var name = "ホーム画面"
    
    func loadData() {
        APIClient().fetchData { data in
            // selfを強参照してしまう
            print("\(self.name)のデータを読み込みました")
        }
    }
}

class ViewController {
    var name = "ホーム画面"
    
    func loadData() {
        APIClient().fetchData { [weak self] data in
            guard let self = self else { return }
            print("\(self.name)のデータを読み込みました")
        }
    }
}

class DownloadManager {
    private var progressHandlers: [String: (Double) -> Void] = [:]
    private var completionHandlers: [String: (URL?, Error?) -> Void] = [:]
    
    func download(
        url: URL,
        progress: @escaping (Double) -> Void,
        completion: @escaping (URL?, Error?) -> Void
    ) {
        let taskID = UUID().uuidString
        
        // クロージャを保存
        progressHandlers[taskID] = progress
        completionHandlers[taskID] = completion
        
        // ダウンロード処理を開始
        let task = URLSession.shared.downloadTask(with: url) { [weak self] location, response, error in
            // 進捗を通知
            progress(1.0)
            
            // 完了を通知
            completion(location, error)
            
            // クリーンアップ
            self?.progressHandlers.removeValue(forKey: taskID)
            self?.completionHandlers.removeValue(forKey: taskID)
        }
        task.resume()
    }
}

// 使用例
let manager = DownloadManager()
manager.download(
    url: imageURL,
    progress: { progress in
        print("進捗: \(Int(progress * 100))%")
    },
    completion: { url, error in
        if let url = url {
            print("ダウンロード完了: \(url)")
        }
    }
)