文書   >   Swift   >   Swift 標準ライブラリ   >   Debugging and Reflection (デバッグと反映)   >   preconditionFailure(_:file:line:)
関数
preconditionFailure(_:file:line:)
前進するために必要な条件をチェックします。
宣言
パラメータ
message | プレイグラウンドまたは -Onone ビルドで印刷すべき文字列。デフォルトは空の文字列です。 |
file | message とともに印刷すべきファイル名。デフォルトは、 preconditionFailure(_:file:line:) が呼び出されたファイルです。 |
line | message とともに印刷すべき行番号。デフォルトは、preconditionFailure(_:file:line:) が呼び出された行番号です。 |
議論
あなたの API が不適切に使用された場合にのみ制御フローがそれぞれの呼び出しに到達できる場合、この関数を使用してプログラムを停止します。この関数の効果は、使用されるビルドフラグによって異なります。
- プレイグラウンドおよび -Onone ビルド (Xcode のデバッグ構成のデフォルト) では、message を出力した後、デバッグ可能な状態でプログラムの実行を停止します。
- -O ビルド (Xcode のリリース構成のデフォルト)では、プログラムの実行を停止します。
- -Ounchecked ビルドでは、最適化はこの関数が決して呼ばれないと想定する場合があります。この想定を満たさないことは、重大なプログラミングエラーです。
以下も見よ
テストする
func assert(() -> Bool, () -> String, file: StaticString, line: UInt)
optional のメッセージを使用して、従来の C スタイルのアサートを実行します。
func assertionFailure(() -> String, file: StaticString, line: UInt)
内部健全性チェック (sanity check) が失敗したことを示します。
func precondition(() -> Bool, () -> String, file: StaticString, line: UInt)
前進するために必要な条件をチェックします。
トップへ
トップへ
トップへ
トップへ
トップへ