Swift 標準ライブラリ > デバッグとリフレクション > 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)
オプションのメッセージで伝統的な C スタイルのアサートを実行します。
func assertionFailure(() -> String, file: StaticString, line: UInt)
内部健全性チェックが失敗したことを示します。
func precondition(() -> Bool, () -> String, file: StaticString, line: UInt)
進行するために必要な条件をチェックします。