Boolean 関数
適用対象:
キャンバス アプリ デスクトップ フロー モデル駆動型アプリ Power Pages Power Platform CLI
ブール値 – テキスト文字列、数値、または型指定されていない値をブール値に変換します。
説明設定
ブール値 関数を使用して、その他の型をブール値に変換します。 ブール値は、true、false、または 空白 です。
ほとんどの場合、型強制は自動的に行われ、ブール値 関数を明示的に使用する必要はありません。 例えば、If( "true", 1, 0 ) は、テキスト文字列として 1 を返し、"true" はブール値に自動的に変換されます。 ブール値 関数は、明示的な変換が必要な場合、または型指定されていない値を使用する場合に役立ちます。
構文
ブール値( 文字列 )
ブール値( 文字列シングル列テーブル )
- 文字列 - 必須。 変換する文字列。
"true"または"false"の大文字と小文字を区別しないバージョンである必要があります。 これらの文字列はローカライズされていません。 空白 および空の文字列も受け入れられ、 空白に変換されます。 他のすべてのテキスト文字列はエラーを返します。
ブール値( 番号 )
ブール値( 数値単一列テーブル )
- 番号 - 必須。 変換する数字。
0は false に変換され、他のすべての数値は trueに変換されます。 空白 値は受け入れられ、 空白に変換されます。
ブール値( 型なし )
- 型なし - 必須。 変換する型指定されていない値。 許容値は、型指定されていないプロバイダーによって異なります。 JSON の場合、JSON ブール値は
true、false、nullが受け入れられ、Power Fx での true、false、と 空欄 の値が対応します。 文字列または数値は、先程説明した 文字列 および 数字 のオーバーロードの概説として承認されています。
使用例
基本的な使用
| 式 | Description | Result |
|---|---|---|
| ブール値( "true" ) | テキスト文字列 "true" をブール値に変換します。 |
真実 |
| ブール値( "偽" ) | テキスト文字列 "false" をブール値に変換します。 |
間違い |
| ブール値( "TRUE" ) | テキスト文字列 "TRUE" をブール値に変換します。 |
真実 |
| ブール値( "本当" ) | テキスト文字列 "TrUe" をブール値に変換します。 |
真実 |
| ブール値( "真実" ) | テキスト文字列 "Truthful" のブール値への変換を試みますが、true と false の大文字と小文字を区別しないバリエーションではないため、エラーが返されます。 |
エラー (無効な引数) |
| ブール値( 空白() ) | 空欄 値をブール値に変換します。 | 空白 |
| ブール値( 0 ) | 数字 0 をブール値に変換します。 |
間違い |
| ブール値( 1 ) | 数字 1 をブール値に変換します。 |
真実 |
| ブール値( -1234 ) | 数字 -1234 をブール値に変換します。 |
真実 |
型指定されていない使用
| 式 | 説明設定 | Result |
|---|---|---|
| ブール値( パースJSON( "{ ""bool"": true }" ).bool ) | 型指定されていない値 true (JSONブール値) をブール値に変換します。 |
真実 |
| ブール値( パースJSON( "{ ""bool"": null }" ).bool ) | 型指定されていない値 null (JSON null) をブール値に変換します。 |
空白 |
| ブール値( パースJSON( "{ ""bool"": "true" }" ).bool ) | 型指定されていない値の変換を試みます"true"(JSON文字列) をブール値に変換しますが、JSONでは有効なブール値ではないため、エラーが返されます。 |
エラー (無効な引数) |
| ブール値(JSONを解析します ("[ true, false, null ]" ).bool ) | ブール値の配列を単一列テーブルに変換しようとします。 単一列のテーブルは、型指定されていない値ではサポートされていません。代わりに、式 ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) または ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) を使用すべきです。 |
エラー (無効な引数) |
単一列テーブル
| 式 | 説明設定 | Result |
|---|---|---|
| ブール値( [ "true", "false", 空白() ] ) | テキスト文字列の単一列テーブルをブール値の単一列テーブルに変換します。 | [ true, false, blank ] |
| ブール値( [ "真", "偽" ] ) | テキスト文字列の単一列テーブルをブール値の単一列テーブルに変換します。 このテーブルの 2 番目のレコードは、true と false の大文字と小文字を区別しないバリエーションではないため、このレコードに対してエラーが返されます。 |
[ true, error (無効な引数) ] |
| ブール値( [ 1, 2, 0 ] ) | 数字の単一列テーブルをブール値の単一列テーブルに変換します。 | [ true, true, false ] |