Funkcja logiczna
Dotyczy:
Aplikacje kanwy Przepływy pulpitu Aplikacje oparte na modelu Interfejs Power Pages Power Platform wiersza polecenia aplikacji opartych na modelu
Konwertuje ciąg tekstowy, liczbę lub niewpisaną wartość na wartość logiczną.
opis
Użyj funkcji Boolean do przekonwertowania innych typów na wartość logiczną. Wartość logiczna to true, false lub blank.
W większości przypadków wpisanie tekstu coercion odbywa się automatycznie, a funkcja Boolean nie musi być używana jawnie. Na przykład If( "true", 1, 0 ) zwróci 1, ponieważ ciąg tekstowy "true" jest automatycznie konwertowany na wartość logiczną. Funkcja Boolean jest przydatna w przypadku wymaganej jawnej konwersji lub w przypadku niesymadowej wartości.
Składnia
Boolean( String )
Boolean( StringSingleColumnTable )
- Ciąg - Wymagane. Ciąg, który ma zostać przekonwertowany. Musi to być wersja bez rozróżniania wielkości liter
"true"lub"false". Te ciągi nie są zlokalizowane. Pusty i pusty ciąg jest również akceptowany i konwertowany na spację. Wszystkie inne ciągi tekstowe zawierają błąd.
Wartość logiczna( liczba )
Boolean( NumberSingleColumnTable )
- Liczba- Wymagane . Liczby do konwersji.
0jest konwertowany na wartość false , a wszystkie inne liczby są konwertowane na wartość true. Wartości puste są akceptowane i konwertowane na wartości puste.
Wartość logiczna ( bez typu )
- Niewpisane - Wymagane. Wartość, która nie jest konwertowana. Dopuszczalne wartości są zależne od niewpisanego dostawcy. Dla JSON wartości logiczne JSON
true,falseinullsą akceptowalne, co odpowiada wartościom true, false i blank w Power Fx. Wartości ciągów lub liczb są zaakceptowane jak wcześniej opisano w przeciążeniach Ciąg i Numer.
Przykłady
Podstawowy sposób użycia
| Formuła | opis | Result |
|---|---|---|
| Boolean( "prawda" ) | Konwertuje ciąg tekstowy "true" na wartość logiczną. |
prawdziwy |
| Boolean( "false" ) | Konwertuje ciąg tekstowy "false" na wartość logiczną. |
fałszywy |
| Boolean( "PRAWDA" ) | Konwertuje ciąg tekstowy "TRUE" na wartość logiczną. |
prawdziwy |
| Boolean( "TrUe" ) | Konwertuje ciąg tekstowy "TrUe" na wartość logiczną. |
prawdziwy |
| Boolean( "Prawdomówny" ) | Próbuje przekonwertować ciąg tekstowy "Truthful" na wartość logiczną, ale ponieważ nie jest to odmiana true i false, która nie uwzględnia wielkości liter, zwracany jest błąd. |
Błąd (nieprawidłowy argument) |
| Wartość logiczna( Puste() ) | Przekształć wartość puste na wartość logiczną. | pusty |
| Wartość logiczna( 0 ) | Konwertuj liczbę 0 na wartość logiczną. |
fałszywy |
| Wartość logiczna( 1 ) | Konwertuj liczbę 1 na wartość logiczną. |
prawdziwy |
| Wartość logiczna( -1234 ) | Konwertuj liczbę -1234 na wartość logiczną. |
prawdziwy |
Nieskonsekwowane użycie
| Formuła | opis | Result |
|---|---|---|
| Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) | Konwertuje wartość niezwiązoną true (wartość logiczną JSON) na wartość logiczną. |
prawdziwy |
| Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) | Konwertuje wartość niezwiązoną null (wartość logiczną null) na wartość logiczną. |
pusty |
| Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) | Próbuje przekonwertować niewpisaną wartość "true" (ciąg JSON) na wartość logiczną, ale ponieważ nie jest to prawidłowa wartość logiczna w JSON, zwracany jest błąd. |
Błąd (nieprawidłowy argument) |
| Boolean( ParseJSON( "[ prawda, fałsz, null ]" ).bool ) | Próbuje przekonwertować tablicę wartości logicznych na tabelę w jednej kolumnie. Tabele jednokolumnowe nie są obsługiwane z wartościami bez typu, a zamiast tego formuły ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) lub ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) powinny być używane. |
Błąd (nieprawidłowy argument) |
Tabele jednokolumnowe
| Formuła | opis | Result |
|---|---|---|
| Boolean( [ "prawda", "fałsz", puste () ] ) | Konwertowanie tabeli pojedynczej kolumny z ciągami tekstowymi na jedną kolumnę wartości logicznych. | [ true, false, blank ] |
| Boolean( [ "prawda", "sfalsyfikowany" ] ) | Konwertowanie tabeli pojedynczej kolumny z ciągami tekstowymi na jedną kolumnę wartości logicznych. Ponieważ drugi rekord w tej tabeli nie jest odmianą true i false bez rozróżniania wielkości liter, dla tego rekordu zwracany jest błąd. |
[ true, error (błędny argument) ] |
| Boolean( [ 1, 2, 0 ] ) | Konwertuje jednokolumnową tabelę liczb na jednokolumnową tabelę o wartości logicznej. | [ true, true, false ] |