Function 関数

assertionFailure(_:file:line:)

Indicates that an internal sanity check failed. これはある内部的な正常性確認が失敗したことを指し示します。

Declaration 宣言

func assertionFailure(_ message: @autoclosure () -> String = String(), file: StaticString = #file, line: UInt = #line)

Parameters パラメータ

message

A string to print in a playground or -Onone build. The default is an empty string. プレイグラウンドまたは-Ononeビルドにおいて出力される文字列。初期状態では空の文字列です。

file

The file name to print with message. The default is the file where assertionFailure(_:file:line:) is called. messageとともに出力するファイル名。初期状態では、assertionFailure(_:file:line:)が呼び出されたところのファイルです。

line

The line number to print along with message. The default is the line number where assertionFailure(_:file:line:) is called. messageに加えて出力される行番号。初期状態では、assertionFailure(_:file:line:)が呼び出されたところの行番号です。

Discussion 解説

Use this function to stop the program, without impacting the performance of shipping code, when control flow is not expected to reach the call—for example, in the default case of a switch where you have knowledge that one of the other cases must be satisfied. To protect code from invalid usage in Release builds, see preconditionFailure(_:file:line:). この関数を使って、制御の流れが呼び出しに届くと予想されない場合に、出荷コードの性能に影響を与えることなく、プログラムを停止してください—例えば、switchdefaultケース節において、そこにおいてあなたはそれ以前のケース節の1つが満たされなければならないことがわかっています。「リリース」ビルドにおける無効な使用法を調べるには、preconditionFailure(_:file:line:)を見てください。

  • In playgrounds and -Onone builds (the default for Xcode’s Debug configuration), stop program execution in a debuggable state after printing message. プレイグラウンドおよび-Ononeビルド(省略時のXcodeのDebug構成)では、messageを出力した後にデバッグ可能状態でプログラム実行を停止します。

  • In -O builds, has no effect. -Oビルドでは、影響はありません。

  • In -Ounchecked builds, the optimizer may assume that this function is never called. Failure to satisfy that assumption is a serious programming error. -Ouncheckedビルドでは、最適化はこの関数が決して呼ばれないと決めてかかります。了解事項を満たすことの失敗は、重大なプログラミングエラーです。

See Also 参照

Testing テスト