Swift 標準ライブラリ > デバッグとリフレクション > assertionFailure(_:file:line:)
関数
assertionFailure(_:file:line:)
内部健全性チェックが失敗したことを示します。
宣言
パラメータ
| message | プレイグラウンドまたは -Onone ビルドで印刷される文字列。デフォルトは空文字列です。 |
| file | message とともに印刷されるファイル名。デフォルトは、assertionFailure(_:file:line:) が呼び出されたファイルです。 |
| line | message とともに印刷される行番号。デフォルトは、 assertionFailure(_:file:line:) が呼び出された行番号です。 |
議論
この関数を使用すると、出荷コードのパフォーマンスに影響を与えずに、制御フローが呼び出しに到達しないと予測された場合などの時、プログラムを停止できます。たとえば、他の case の1つが満たされなければならない知っている場合の switch の default case で。リリースのビルドでコードが不正な使用から保護されるようにするには、 preconditionFailure(_:file:line:) を参照してください。
- プレイグラウンドと -Onone ビルド (Xcode のデバッグ構成のデフォルト)で、メッセージの印刷後にデバッグ可能な状態でプログラムの実行を停止します。
- -O ビルドでは、影響はありません。
- -Ounchecked ビルドでは、最適化ツールは、この関数が決して呼び出されないと仮定するでしょう。その前提を満たさないことは、重大なプログラミングエラーになります。
以下も見よ
テスト
func assert(() -> Bool, () -> String, file: StaticString, line: UInt)
内部健全性チェックが失敗したことを示します。
func precondition(() -> Bool, () -> String, file: StaticString, line: UInt)
進行するために必要な条件をチェックします。
func preconditionFailure(() -> String, file: StaticString, line: UInt)
前提条件に違反したことを示します。