Funktion „Boolean“

  • Artikel

Gilt für: Canvas-Apps Desktop-Flows Modellgesteuerte Apps Power Platform CLI

Konvertiert eine Textzeichenfolge, eine Zahl oder einen nicht typisierten Wert in einen booleschen Wert.

Beschreibung des Dataflows

Verwenden Sie die Boolean-Funktion zum Konvertieren anderer Typen in einen booleschen Wert. Ein boolescher Wert ist true, false oder blank.

In den meisten Fällen erfolgt die Typzwangsänderung automatisch und die Boolean-Funktion muss nicht explizit verwendet werden. Zum Beispiel,If( "true", 1, 0 ) gibt 1 als Textzeichenfolge zurück, "true" wird automatisch in einen booleschen Wert umgewandelt. Die Funktion Boolean ist nützlich, wenn eine explizite Konvertierung gewünscht wird oder wenn ein nicht typisierter Wert verwendet wird.

Syntax

Boolean( Zeichenfolge )
Boolean( StringSingleColumnTable )

  • Zeichenfolge - Erforderlich. Die zu konvertierende(n) Zeichenfolge(n). Muss eine Version von "true" oder "false" sein, bei der die Groß-/Kleinschreibung nicht beachtet wird. Diese Zeichenfolgen sind nicht lokalisiert. leer und leere Zeichenfolge ist ebenfalls akzeptiert und wird in einen blank konvertiert. Alle anderen Textzeichenfolgen geben einen Fehler zurück.

Boolean( Zahl )
Boolean( NumberSingleColumnTable )

  • Number – Erforderlich. Die zu konvertierende(n) Zahl(en). 0 wird in false umgewandelt und alle anderen Zahlen werden in true umgewandelt. blank-Werte werden akzeptiert und in einen blank umgewandelt.

Boolean( Untypisiert )

  • Untypisiert – Erforderlich. Der nicht typisierte Wert, der konvertiert werden soll. Zulässige Werte hängen vom nicht typisierten Anbieter ab. Für JSON werden boolesche JSON-Werte true, false und null akzeptiert, entsprechend zu den Werten true, false und blank in Power Fx. Zeichenfolgen- oder Zahlenwerte werden wie beschrieben akzeptiert für die vorher beschriebenen Zeichenfolge- und Zahl-Überladungen.

Beispiele

Grundlegende Nutzung

Formel Beschreibung Result
Boolesch( „true“) Konvertiert den Textwert "true" in einen booleschen Wert. true
Boolesch( „false“) Konvertiert den Textwert "false" in einen booleschen Wert. False
Boolesch( „TRUE“) Konvertiert den Textwert "TRUE" in einen booleschen Wert. true
Boolesch( „TrUe“) Konvertiert den Textwert "TrUe" in einen booleschen Wert. true
Boolesch( „Truthful“) Versucht, die Textzeichenfolge "Truthful" in einen booleschen Wert zu konvertieren, da es sich aber nicht um eine Variation von true und false handelt, bei der die Groß-/Kleinschreibung nicht beachtet wird, wird ein Fehler zurückgegeben. Fehler (ungültiges Argument)
Boolesch( Blank() ) Konvertiert den Wert blank in einen booleschen Wert. leer
Boolesch( 0 ) Konvertiert die Zahl 0 in einen booleschen Wert. False
Boolesch( 1 ) Konvertiert die Zahl 1 in einen booleschen Wert. true
Boolesch( -1234 ) Konvertiert die Zahl -1234 in einen booleschen Wert. true

Nicht typisierte Verwendung

Formel Beschreibung des Dataflows Result
Boolesch( ParseJSON( „{ ""bool"": true }“).bool ) Konvertiert den nicht typisierten Wert true (ein boolescher JSON-Wert) in einen booleschen Wert. true
Boolesch( ParseJSON( „{ ""bool"": null }“).bool ) Konvertiert den nicht typisierten Wert null (ein JSON-Nullwert) in einen booleschen Wert. leer
Boolesch( ParseJSON( „{ ""bool"": „true“}“).bool ) Versucht, den nicht typisierten Wert "true" (eine JSON-Zeichenfolge) in einen booleschen Wert zu konvertieren, aber da es sich nicht um einen gültigen booleschen Wert in JSON handelt, wird ein Fehler zurückgegeben. Fehler (ungültiges Argument)
Boolesch( ParseJSON( „[ true, false, null ]“).bool ) Versucht, ein Array von booleschen Werten in eine Tabelle mit einer einzelnen Spalte zu konvertieren. Einspaltige Tabellen werden nicht mit nicht typisierten Werten unterstützt, und stattdessen sollte die Formel ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) oder ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) benutzt werden. Fehler (ungültiges Argument)

Einspaltige Tabellen

Formel Beschreibung des Dataflows Result
Boolesch( [ „true“, „false“, Blank() ] ) Konvertiert die einspaltige Tabelle mit Textzeichenfolgen in eine einspaltige Tabelle mit booleschen Werten. [ wahr, falsch, leer ]
Boolesch( [ „true“, „falsified“] ) Konvertiert die einspaltige Tabelle mit Textzeichenfolgen in eine einspaltige Tabelle mit booleschen Werten. Da der zweite Datensatz in dieser Tabelle keine Variante von true und false ist, bei der die Groß-/Kleinschreibung nicht berücksichtigt wird, wird für diesen Datensatz ein Fehler zurückgegeben. [ wahr, Fehler (ungültiges Argument) ]
Boolesch( [ 1, 2, 0 ] ) Konvertiert die einspaltige Tabelle mit Zahlen in eine einspaltige Tabelle mit booleschen Werten. [ wahr, wahr, falsch ]