Swift 5.10 組み込み関数一覧

**Swift Standard Libraryに含まれるグローバル関数**を全て調べてみました。
Pythonの公式ドキュメント「[組み込み関数](https://docs.python.org/ja/3/library/functions.html)」のような、importなしで使える関数の一覧を見てみたかったのが動機です。

# 調査方法

Xcode 15.4 で `command+shift+0` を押して開発者ドキュメントを開き、左下にある Filter でフレームワークSwiftの「func」で検索し、グローバルな関数だけを目grepして集めました。
Swiftでは演算子も `(+)(2, 3) == 5` のように関数の一種として捉えることができますが、今回は除外しています。Deprecated(非推奨)な関数も除外しています。

# 調査結果

**全46個**のグローバル関数が見つかりました。
学習における各関数の重要度を、ChatGPT先生に3つの段階で分類してもらいました。

- **重要度：必須 (8個)**
Swiftの基本的なプログラミングにおいて頻繁に使われる重要な関数です。これらはSwift学習者が早い段階で学習すべきであり、日常的に使うことが多いです。

- **重要度：実用的 (24個)**
使う場面が限定的ながら、ある特定のコンテキストで有効な関数が含まれています。

- **重要度：特殊 (14個)**
ほとんどの開発者が日常的に使わない、特殊な状況でのみ使用される関数です。

重要度ごとに関数を紹介していきます。

<details><summary>全46個をまとめて見たい方はこちら (クリックして展開)</summary>
<table>
<tr><th>関数名</th><th>カテゴリ</th><th>iOS</th><th>重要度</th></tr>
<tr><td>abs</td><td>Global Numeric Functions</td><td>8.0+</td><td>必須</td></tr>
<tr><td>all</td><td>SIMD Vector Types</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>any</td><td>SIMD Vector Types</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>assert</td><td>Debugging and Reflection</td><td>8.0+</td><td>必須</td></tr>
<tr><td>assertionFailure</td><td>Debugging and Reflection</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>debugPrint</td><td>Debugging and Reflection</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>dump</td><td>Debugging and Reflection</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>fatalError</td><td>Debugging and Reflection</td><td>8.0+</td><td>必須</td></tr>
<tr><td>getVaList</td><td>C Interoperability</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>isKnownUniquelyReferenced</td><td>Managed Buffers</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>max</td><td>Global Numeric Functions</td><td>8.0+</td><td>必須</td></tr>
<tr><td>min</td><td>Global Numeric Functions</td><td>8.0+</td><td>必須</td></tr>
<tr><td>numericCast</td><td>Special-Use Numeric Types</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>pointwiseMax</td><td>SIMD Vector Types</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>pointwiseMin</td><td>SIMD Vector Types</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>precondition</td><td>Debugging and Reflection</td><td>8.0+</td><td>必須</td></tr>
<tr><td>preconditionFailure</td><td>Debugging and Reflection</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>print</td><td>Debugging and Reflection</td><td>8.0+</td><td>必須</td></tr>
<tr><td>readLine</td><td>Input and Output</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>repeatElement</td><td>Collections</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>sequence</td><td>Collections</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>stride</td><td>Collections</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>swap</td><td>Manual Memory Management</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>transcode</td><td>Unicode</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>type</td><td>Debugging and Reflection</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>unsafeBitCast</td><td>Type Casting and Existential Types</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>unsafeDowncast</td><td>Type Casting and Existential Types</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>withCheckedContinuation</td><td>Concurrency</td><td>13.0+</td><td>実用的</td></tr>
<tr><td>withCheckedThrowingContinuation</td><td>Concurrency</td><td>13.0+</td><td>実用的</td></tr>
<tr><td>withDiscardingTaskGroup</td><td>Concurrency</td><td>17.0+</td><td>特殊</td></tr>
<tr><td>withExtendedLifetime</td><td>Manual Memory Management</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>withoutActuallyEscaping</td><td>Type Casting and Existential Types</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>withTaskCancellationHandler</td><td>Concurrency</td><td>13.0+</td><td>実用的</td></tr>
<tr><td>withTaskGroup</td><td>Concurrency</td><td>13.0+</td><td>実用的</td></tr>
<tr><td>withThrowingDiscardingTaskGroup</td><td>Concurrency</td><td>17.0+</td><td>特殊</td></tr>
<tr><td>withThrowingTaskGroup</td><td>Concurrency</td><td>13.0+</td><td>実用的</td></tr>
<tr><td>withUnsafeBytes</td><td>Manual Memory Management</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>withUnsafeContinuation</td><td>Concurrency</td><td>13.0+</td><td>実用的</td></tr>
<tr><td>withUnsafeCurrentTask</td><td>Concurrency</td><td>13.0+</td><td>特殊</td></tr>
<tr><td>withUnsafeMutableBytes</td><td>C Interoperability</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>withUnsafeMutablePointer</td><td>C Interoperability</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>withUnsafePointer</td><td>Manual Memory Management</td><td>8.0+</td><td>実用的</td></tr>
<tr><td>withUnsafeTemporaryAllocation</td><td>Manual Memory Management</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>withUnsafeThrowingContinuation</td><td>Concurrency</td><td>13.0+</td><td>実用的</td></tr>
<tr><td>withVaList</td><td>C Interoperability</td><td>8.0+</td><td>特殊</td></tr>
<tr><td>zip</td><td>Collections</td><td>8.0+</td><td>必須</td></tr>
</table>
</details>

## 重要度：必須

<table>
<tr><th>関数名</th><th>カテゴリ</th><th>iOS</th></tr>
<tr><td>abs</td><td>Global Numeric Functions</td><td>8.0+</td></tr>
<tr><td>assert</td><td>Debugging and Reflection</td><td>8.0+</td></tr><tr>
<td>fatalError</td><td>Debugging and Reflection</td><td>8.0+</td></tr><tr>
<td>max</td><td>Global Numeric Functions</td><td>8.0+</td></tr><tr>
<td>min</td><td>Global Numeric Functions</td><td>8.0+</td></tr><tr>
<td>precondition</td><td>Debugging and Reflection</td><td>8.0+</td></tr><tr>
<td>print</td><td>Debugging and Reflection</td><td>8.0+</td></tr><tr>
<td>zip</td><td>Collections</td><td>8.0+</td></tr>
</table>

- [`abs(_:)`](https://developer.apple.com/documentation/swift/abs(_:))
符号付き数値の絶対値を求めます。`abs(-12) == 12`

- [`assert(_:_:file:line:)`](https://developer.apple.com/documentation/swift/assert(_:_:file:line:))
デバッグ時に、条件が偽の場合に実行時エラーを出します。

- [`fatalError(_:file:line:)`](https://developer.apple.com/documentation/swift/fatalerror(_:file:line:))
エラーを出してプログラムを強制終了します。

- [`max(_:_:)`](https://developer.apple.com/documentation/swift/max(_:_:)), [`max(_:_:_:_:)`](https://developer.apple.com/documentation/swift/max(_:_:_:_:))
2個以上の比較可能な値を受け取って最大値を返します。

- [`min(_:_:)`](https://developer.apple.com/documentation/swift/min(_:_:)), [`min(_:_:_:_:)`](https://developer.apple.com/documentation/swift/min(_:_:_:_:))
2個以上の比較可能な値を受け取って最小値を返します。

- [`precondition(_:_:file:line:)`](https://developer.apple.com/documentation/swift/precondition(_:_:file:line:))
事前条件を確認し、偽の場合に実行時エラーを出します。

- [`print(_:separator:terminator:)`](https://developer.apple.com/documentation/swift/print(_:separator:terminator:))
標準出力を行う関数です。

- [`zip(_:_:)`](https://developer.apple.com/documentation/swift/zip(_:_:))
2つのシーケンスをペアにして新しいシーケンスを作成します。

アサーション系の関数(assert, fatalError, precondition)の使い分けが曖昧な方はチェックしておきましょう。
print関数のオプションや、zip関数に長さの異なるシーケンスを渡した時の挙動、max関数やmin関数に文字列を渡した時の挙動など、Pythonと共通する部分が多いことに気付いて個人的にテンションが上がっています。

## 重要度：実用的 (1/2)

<table>
<tr><th>関数名</th><th>カテゴリ</th><th>iOS</th></tr>
<tr><td>assertionFailure</td><td>Debugging and Reflection</td><td>8.0+</td></tr>
<tr><td>debugPrint</td><td>Debugging and Reflection</td><td>8.0+</td></tr>
<tr><td>dump</td><td>Debugging and Reflection</td><td>8.0+</td></tr>
<tr><td>isKnownUniquelyReferenced</td><td>Managed Buffers</td><td>8.0+</td></tr>
<tr><td>numericCast</td><td>Special-Use Numeric Types</td><td>8.0+</td></tr>
<tr><td>preconditionFailure</td><td>Debugging and Reflection</td><td>8.0+</td></tr>
<tr><td>readLine</td><td>Input and Output</td><td>8.0+</td></tr>
<tr><td>repeatElement</td><td>Collections</td><td>8.0+</td></tr>
<tr><td>sequence</td><td>Collections</td><td>8.0+</td></tr>
<tr><td>stride</td><td>Collections</td><td>8.0+</td></tr>
<tr><td>swap</td><td>Manual Memory Management</td><td>8.0+</td></tr>
</table>

- [`assertionFailure(_:file:line:)`](https://developer.apple.com/documentation/swift/assertionfailure(_:file:line:))
デバッグ時に実行時エラーを出します。assert関数の条件にfalseを渡すのと同じです。

- [`debugPrint(_:separator:terminator:)`](https://developer.apple.com/documentation/swift/debugprint(_:separator:terminator:))
printと変わらないことが多いですが、オブジェクトをデバッグに適したテキスト表現で標準出力します。

- [`dump(_:name:indent:maxDepth:maxItems:)`](https://developer.apple.com/documentation/swift/dump(_:name:indent:maxdepth:maxitems:))
オブジェクトの内容をprintやdebugPrintよりも詳細に出力します。プロパティの値や階層構造を見やすく表示してくれるので、デバッグにとても有用です。

- [`isKnownUniquelyReferenced(_:)`](https://developer.apple.com/documentation/swift/isknownuniquelyreferenced(_:)-98zpp)
AnyObjectに適合するクラスオブジェクトが、他に強参照されていないか確認します。[Copy-on-Write(CoW)](https://notion.yumemi.co.jp/copy-on-write)という仕組みの実装に役立ちます。

- [`numericCast(_:)`](https://developer.apple.com/documentation/swift/numericcast(_:))
`Int`や`UInt`、`Int8`、`Int32`などの整数型から整数型への変換を行う関数です。
`let a: Int8 = numericCast(UInt8(200))`のように変換後の型で表現できない数値が渡された場合は、実行時エラーになります。

- [`preconditionFailure(_:file:line:)`](https://developer.apple.com/documentation/swift/preconditionfailure(_:file:line:))
実行時エラーを出します。precondition関数の条件にfalseを渡すのと同じです。

- [`readLine(strippingNewline:)`](https://developer.apple.com/documentation/swift/readline(strippingnewline:))
標準入力から1行読み取ります。EOFで`nil`が返ります。競プロでお馴染み。

- [`repeatElement(_:count:)`](https://developer.apple.com/documentation/swift/repeatelement(_:count:))
指定した要素を指定回数繰り返すシーケンスを返します。[`Array.init(repeating:count:)`](https://developer.apple.com/documentation/swift/array/init(repeating:count:)-5zvh4)もそうですが、第 1 引数は`@autoclosure`ではないので全ての要素は単一の実体を参照していることに注意が必要です。

```swift
for str in repeatElement("Hello", count: 3) {
    print(str) // Hello Hello Hello
}
for user in repeatElement(User(), count: 3) {
    print(ObjectIdentifier(user)) // 3つとも同一のインスタンス
}
```

- [`sequence(first:next:)`](https://developer.apple.com/documentation/swift/sequence(first:next:)), [`sequence(state:next:)`](https://developer.apple.com/documentation/swift/sequence(state:next:))
クロージャを使って次の値を生成するシーケンスを生成します。

```swift
for i in sequence(first: 1, next: { $0 == 128 ? nil : $0 * 2 }) {
    print(i) // 1 2 4 8 16 32 64 128
}
for i in sequence(state: (0, 1), next: { state in
    (state.0, state.1) = (state.1, state.0 + state.1)
    return state.0
}).prefix(8) {
    print(i) // 1 1 2 3 5 8 13 21
}
```

- [`stride(from:to:by:)`](https://developer.apple.com/documentation/swift/stride(from:to:by:)), [`stride(from:through:by:)`](https://developer.apple.com/documentation/swift/stride(from:through:by:))
指定された範囲内の一定間隔の値のシーケンスを生成します。
```swift
for i in stride(from: 10, to: 20, by: 2) {
    print(i) // 10 12 14 16 18
}
for i in stride(from: 10, through: 20, by: 2) {
    print(i) // 10 12 14 16 18 20
}
```

- [`swap(_:_:)`](https://developer.apple.com/documentation/swift/swap(_:_:))
`swap(&a, &b)`のように変数の値を交換する時に使います。`(a, b) = (b, a)`と書くよりも簡潔で、パフォーマンスやメモリ使用量の面でも優れています。


## 重要度：実用的 (2/2)

<table>
<tr><th>関数名</th><th>カテゴリ</th><th>iOS</th></tr>
<tr><td>withCheckedContinuation</td><td>Concurrency</td><td>13.0+</td></tr>
<tr><td>withCheckedThrowingContinuation</td><td>Concurrency</td><td>13.0+</td></tr>
<tr><td>withExtendedLifetime</td><td>Manual Memory Management</td><td>8.0+</td></tr>
<tr><td>withoutActuallyEscaping</td><td>Type Casting and Existential Types</td><td>8.0+</td></tr>
<tr><td>withTaskCancellationHandler</td><td>Concurrency</td><td>13.0+</td></tr>
<tr><td>withTaskGroup</td><td>Concurrency</td><td>13.0+</td></tr>
<tr><td>withThrowingTaskGroup</td><td>Concurrency</td><td>13.0+</td></tr>
<tr><td>withUnsafeBytes</td><td>Manual Memory Management</td><td>8.0+</td></tr>
<tr><td>withUnsafeContinuation</td><td>Concurrency</td><td>13.0+</td></tr>
<tr><td>withUnsafeMutableBytes</td><td>C Interoperability</td><td>8.0+</td></tr>
<tr><td>withUnsafeMutablePointer</td><td>C Interoperability</td><td>8.0+</td></tr>
<tr><td>withUnsafePointer</td><td>Manual Memory Management</td><td>8.0+</td></tr>
<tr><td>withUnsafeThrowingContinuation</td><td>Concurrency</td><td>13.0+</td></tr>
</table>

- [`withCheckedContinuation(isolation:function:_:)`](https://developer.apple.com/documentation/swift/withcheckedcontinuation(isolation:function:_:))
従来のcompletionHandlerによる非同期関数を、新方式のConcurrencyに適応させるための関数です。`withUnsafeContinuation`と違って断続の呼び出しに関するミス(複数回呼び出してしまうなど)をチェックする機能がついているため、安全性が高いです。

- [`withCheckedThrowingContinuation(isolation:function:_:)`](https://developer.apple.com/documentation/swift/withcheckedthrowingcontinuation(isolation:function:_:)/)
`withCheckedContinuation`のthrows版。失敗の可能性がある非同期処理で使用します。

- [`withExtendedLifetime(_:_:)`](https://developer.apple.com/documentation/swift/withextendedlifetime(_:_:)-4kl68), [`withExtendedLifetime(_:_:)`](https://developer.apple.com/documentation/swift/withextendedlifetime(_:_:)-6mq1)
クロージャや非同期処理の途中で予期せずオブジェクトが解放されてしまうのを防ぐために、オブジェクトのライフタイムを明示的に延長したい時に使います。

```swift
let user = User()
DispatchQueue.global().async {
    withExtendedLifetime(user) {
        // このクロージャの実行が終わるまではuserは解放されない
        user.doSomething()
    }
}
```

- [`withoutActuallyEscaping(_:do:)`](https://developer.apple.com/documentation/swift/withoutactuallyescaping(_:do:))
nonescapingとして受け取ったクロージャを、一時的にescapingなクロージャとして扱うことができます。
第 1 引数で渡したnonescapingなクロージャを`do`クロージャ内ではエスケープすることができますが、実際にそのクロージャを保存して`do`終了後に利用することは未定義の操作となります。

- [`withTaskCancellationHandler(operation:onCancel:isolation:)`](https://developer.apple.com/documentation/swift/withtaskcancellationhandler(operation:oncancel:isolation:))
Concurrencyでタスクがキャンセルされた時の処理を書くことができます。

- [`withTaskGroup(of:returning:isolation:body:)`](https://developer.apple.com/documentation/swift/withtaskgroup(of:returning:isolation:body:))
Concurrencyで複数の非同期タスクを並列に実行します。

- [`withThrowingTaskGroup(of:returning:isolation:body:)`](https://developer.apple.com/documentation/swift/withthrowingtaskgroup(of:returning:isolation:body:))
`withTaskGroup`のthrows版。失敗の可能性がある非同期処理で使用します。

- [`withUnsafeBytes(of:_:)`](https://developer.apple.com/documentation/swift/withunsafebytes(of:_:)-5zxtl), [`withUnsafeBytes(of:_:)`](https://developer.apple.com/documentation/swift/withunsafebytes(of:_:)-5gesg)
指定した値の生のバイトデータに対して安全にアクセスできる関数です。低レベルなメモリ操作やバイナリデータの処理が必要な場面などで使用されます。クロージャに渡される`buffer`は読み取り専用です。
```swift
var number: Int = 12 * 256 + 34
withUnsafeBytes(of: &number) { buffer in
    for byte in buffer {
        print(byte) // 34 12 0 0 0 0 0 0
    }
}
```

- [`withUnsafeContinuation(isolation:_:)`](https://developer.apple.com/documentation/swift/withunsafecontinuation(isolation:_:))
従来のcompletionHandlerによる非同期関数を、新方式のConcurrencyに適応させるための関数です。`withCheckedContinuation`と違って断続の呼び出しに関するミス(複数回呼び出してしまうなど)をチェックする機能がついていません。

- [`withUnsafeMutableBytes(of:_:)`](https://developer.apple.com/documentation/swift/withunsafemutablebytes(of:_:))
指定した値の生のバイトデータに対して安全にアクセスできる関数です。`withUnsafeBytes`と違って`buffer`への書き込みができます。

- [`withUnsafeMutablePointer(to:_:)`](https://developer.apple.com/documentation/swift/withunsafemutablepointer(to:_:))
指定した値に対するポインタを使った処理を行うことができる関数です。`withUnsafePointer`と違ってポインタへの書き込みができます。

- [`withUnsafePointer(to:_:)`](https://developer.apple.com/documentation/swift/withunsafepointer(to:_:)-9fjn6), [`withUnsafePointer(to:_:)`](https://developer.apple.com/documentation/swift/withunsafepointer(to:_:)-35wrn)
指定した値に対するポインタを使った処理を行うことができる関数です。CやObjective-Cとの相互運用や、低レベルなシステムプログラミングで使用されます。クロージャに渡されるポインタは読み取り専用です。

- [`withUnsafeThrowingContinuation(isolation:_:)`](https://developer.apple.com/documentation/swift/withunsafethrowingcontinuation(isolation:_:))
`withUnsafeContinuation`のthrows版。失敗の可能性がある非同期処理で使用します。

## 重要度：特殊

<table>
<tr><th>関数名</th><th>カテゴリ</th><th>iOS</th></tr>
<tr><td>all</td><td>SIMD Vector Types</td><td>8.0+</td></tr>
<tr><td>any</td><td>SIMD Vector Types</td><td>8.0+</td></tr>
<tr><td>getVaList</td><td>C Interoperability</td><td>8.0+</td></tr>
<tr><td>pointwiseMax</td><td>SIMD Vector Types</td><td>8.0+</td></tr>
<tr><td>pointwiseMin</td><td>SIMD Vector Types</td><td>8.0+</td></tr>
<tr><td>transcode</td><td>Unicode</td><td>8.0+</td></tr>
<tr><td>type</td><td>Debugging and Reflection</td><td>8.0+</td></tr>
<tr><td>unsafeBitCast</td><td>Type Casting and Existential Types</td><td>8.0+</td></tr>
<tr><td>unsafeDowncast</td><td>Type Casting and Existential Types</td><td>8.0+</td></tr>
<tr><td>withDiscardingTaskGroup</td><td>Concurrency</td><td>17.0+</td></tr>
<tr><td>withThrowingDiscardingTaskGroup</td><td>Concurrency</td><td>17.0+</td></tr>
<tr><td>withUnsafeCurrentTask</td><td>Concurrency</td><td>13.0+</td></tr>
<tr><td>withUnsafeTemporaryAllocation</td><td>Manual Memory Management</td><td>8.0+</td></tr>
<tr><td>withVaList</td><td>C Interoperability</td><td>8.0+</td></tr>
</table>

- [`all(_:)`](https://developer.apple.com/documentation/swift/all(_:))
- [`any(_:)`](https://developer.apple.com/documentation/swift/any(_:))
`SIMDMask`の`Bool`を使い状態を判別する関数です。`any`はレーンのいずれかが`true`であれば`true`、`all`はレーンの全てが`true`であれば`true`を返します。([出典](https://appleengine.hatenablog.com/entry/2019/12/21/013152))
```swift
let s8 = SIMD8<Float>(1,2,3,4,5,6,7,8)
any(s8 .< 3) // true
all(s8 .< 7) // false
all(s8 .< 9) // true
```

- [`getVaList(_:)`](https://developer.apple.com/documentation/swift/getvalist(_:))
CやObjective-Cの可変引数関数をSwiftで呼び出すために使用される関数です。`withVaList`と違ってポインタを直接返すため、ポインタの管理は呼び出し側に委ねられます。特別な理由がなければ`withVaList`を使用すべきです。

- [`pointwiseMin(_:_:)`](https://developer.apple.com/documentation/swift/pointwisemin(_:_:)-39txi), [`pointwiseMin(_:_:)`](https://developer.apple.com/documentation/swift/pointwisemin(_:_:)-8v95p)
- [`pointwiseMax(_:_:)`](https://developer.apple.com/documentation/swift/pointwisemax(_:_:)-29hn2), [`pointwiseMax(_:_:)`](https://developer.apple.com/documentation/swift/pointwisemax(_:_:)-2k6er)
2つのレーンを調べその中の最大値や最小値を設定したレーンを返します。([出典](https://appleengine.hatenablog.com/entry/2019/12/21/013152))
```swift
let s1 = SIMD3(0,1,2)
let s2 = SIMD3(2,1,0)
pointwiseMin(s1, s2) // SIMD3<Int>(0, 1, 0)
pointwiseMax(s1, s2) // SIMD3<Int>(2, 1, 2)
```

- [`transcode(_:from:to:stoppingOnError:into:)`](https://developer.apple.com/documentation/swift/transcode(_:from:to:stoppingonerror:into:))
異なるUnicodeエンコーディング間の変換に使用する関数です。低レベルなUnicode操作が必要な場面で役立ちます。

- [`type(of:)`](https://developer.apple.com/documentation/swift/type(of:))
渡された値の動的な型（ランタイムでの実際の型）を取得するための関数です。プロトコルで抽象化された値やジェネリックパラメータなどの型を調べる際に便利です。

- [`unsafeBitCast(_:to:)`](https://developer.apple.com/documentation/swift/unsafebitcast(_:to:))
メモリ上のビット列そのままを、指定した型に解釈し直すための関数です。使用する際は、元の型と変換後の型が同じメモリサイズとレイアウトを持っていることを確認する必要があります。**Swiftの型システムを無視した非常に危険な関数**です。パフォーマンスが重要な場面で使用します。

- [`unsafeDowncast(_:to:)`](https://developer.apple.com/documentation/swift/unsafedowncast(_:to:))
渡されたインスタンスを特定のクラス型にダウンキャストする関数です。そのインスタンスが常に指定した型であると完全に保証されている場合に使用します。**Swiftの型安全性を破る関数**であり、通常は型チェックの行われる`as!`や`as?`を使用すべきです。パフォーマンスが重要な場面で使用します。

- [`withDiscardingTaskGroup(returning:isolation:body:)`](https://developer.apple.com/documentation/swift/withdiscardingtaskgroup(returning:isolation:body:))
Concurrencyで複数の非同期タスクを並列に実行します。`withTaskGroup`と違って子タスクの完了時にその結果を保持せず、すぐに破棄します。タスクの結果ではなく、タスクが引き起こす副作用（ネットワークリクエストなど）にだけ興味がある場合に使用します。

- [`withThrowingDiscardingTaskGroup(returning:isolation:body:)`](https://developer.apple.com/documentation/swift/withthrowingdiscardingtaskgroup(returning:isolation:body:))
`withDiscardingTaskGroup`のthrows版。タスクがエラーをスローすると、その時点でタスクグループが自動的にキャンセルされ、最初にスローされたエラーを保持します。全タスクの終了を待ってから関数が終了し、保持されたエラーが再スローされます。

- [`withUnsafeCurrentTask(body:)`](https://developer.apple.com/documentation/swift/withunsafecurrenttask(body:)-6gvhl)
現在のタスク（実行中の非同期処理）への一時的な参照を取得し、そのタスクの状態やプロパティにアクセスするための関数です。非同期関数の中では常に現在のタスクが返されますが、同期関数内ではタスクが存在しない場合があり、`nil`が渡されることがあります。主に非同期処理のデバッグやタスクのモニタリング、最適化の目的で使用されます。以下は現在のタスクの優先度を取得する例です。
```swift
Task {
    withUnsafeCurrentTask { task in
        if let task = task {
            print("Current task priority: \(task.priority)")
        } else {
            print("No task context available.")
        }
    }
}
```

- [`withUnsafeTemporaryAllocation(of:capacity:_:)`](https://developer.apple.com/documentation/swift/withunsafetemporaryallocation(of:capacity:_:)),
[`withUnsafeTemporaryAllocation(byteCount:alignment:_:)`](https://developer.apple.com/documentation/swift/withunsafetemporaryallocation(bytecount:alignment:_:))
一時的にメモリを確保して、操作を行うための関数です。確保されたメモリはクロージャ内でのみ有効で、クロージャが終了した時点で自動的に解放されます。

- [`withVaList(_:_:)`](https://developer.apple.com/documentation/swift/withvalist(_:_:))
CやObjective-Cの可変引数関数をSwiftで呼び出すために使用される関数です。`getVaList`と違ってクロージャ内でポインタを扱います。ポインタはクロージャのスコープ内でのみ有効であるため、メモリ安全性が高いです。

# まとめ

全46個、思ったより少なかったこともあり全ての関数の詳細を調べることができて勉強になりました(特にConcurrency関連)。SIMDや低レベルのメモリ管理、C互換性に関係する関数は低い重要度に分類されている傾向があるようですね。
リストアップした時に、`with`から始まる関数が18個、全体の4割近くを占めていたことには驚きました。