Функция "Логическое значение"

  • Статья

Применимо к: приложениям на основе холста классическим потокам приложениям на основе модели интерфейсу командной строки Power Platform

Преобразует текстовую строку, число или нетипизированное значение в логическое значение.

Description

Использовать функцию Логическое значение для преобразования других типов в логическое значение. Логическое значение: true, false, или пусто.

В большинстве случаев приведение типа происходит автоматически, и функцию Логическое значение не нужно использовать явно. Например,If( "true", 1, 0 ) вернет 1 в качестве текстовой строки "true", значение автоматически преобразуется в логическое значение. Функция Логическое значение полезна, когда требуется явное преобразование или при использовании нетипизированного значения.

Синтаксис

Логическое значение( Строка )
Логическое значение( StringSingleColumnTable )

  • String — обязательный аргумент. Строки для преобразования. Должна быть версия без учета регистра "true" или "false". Эти строки не локализованы. пусто и пустая строка также принимается и преобразуется в пусто. Все остальные текстовые строки возвращают ошибку.

Логическое значение( Число )
Логическое значение( NumberSingleColumnTable )

  • Number — обязательный аргумент. Числа для преобразования. 0 преобразуется в false, а все остальные числа преобразуются в true. пусто значения принимаются и преобразуются в пусто.

Логическое значение( Нетипизированный )

  • Нетипизированный — обязательный аргумент. Нетипизированное значение для преобразования. Допустимые значения зависят от нетипизированного поставщика. Для JSON логические значения JSON true, false и null принимаются и соответствуют значениям true, false и пусто в Power Fx. Строковые или числовые значения принимаются, как описано для перегрузок Строка и Число, описанных ранее.

Примеры

Базовое использование

Формула Описание: Result
Boolean( "true" ) Преобразует значение текстовой строки "true" в логическое значение. true
Boolean( "false" ) Преобразует значение текстовой строки "false" в логическое значение. false
Boolean( "TRUE" ) Преобразует значение текстовой строки "TRUE" в логическое значение. true
Boolean( "TrUe" ) Преобразует значение текстовой строки "TrUe" в логическое значение. true
Boolean( "Truthful" ) Попытки преобразовать текстовую строку "Truthful" в логическое значение, но так как это не нечувствительный к регистру вариант значений true и false, то возвращается ошибка. ошибка (недопустимый аргумент)
Boolean( Blank() ) Преобразование пустого значения в логическое значение. пусто
Boolean( 0 ) Преобразует число 0 в логическое значение. false
Boolean( 1 ) Преобразует число 1 в логическое значение. true
Boolean( -1234 ) Преобразует число -1234 в логическое значение. true

Нетипизированное использование

Формула Description Result
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Преобразует нетипизированное значение true (логическое значение JSON) в логическое значение. true
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Преобразует нетипизированное значение null (значение "NULL" JSON) в логическое значение. пусто
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Попытки преобразовать нетипизированное значение "true" (строка JSON) в логическое значение, но поскольку оно не является допустимым логическим значением в JSON, возвращается ошибка. ошибка (недопустимый аргумент)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Пытается преобразовать массив логических значений в таблицу с одним столбцом. Таблицы с одним столбцом не поддерживаются с нетипизированными значениями, вместо этого формула ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) или ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) должны быть использованы. ошибка (недопустимый аргумент)

Таблицы с одним столбцом

Формула Description Result
Boolean( [ "true", "false", Blank() ] ) Преобразует таблицу текстовых строк с одним столбцом в таблицу логических значений с одним столбцом. [ true, false, пусто ]
Boolean( [ "true", "falsified" ] ) Преобразует таблицу текстовых строк с одним столбцом в таблицу логических значений с одним столбцом. Поскольку вторая запись в этой таблице не является нечувствительной к регистру вариацией значения true и false, то для этой записи возвращается ошибка. [ true, ошибка (недопустимый аргумент) ]
Boolean( [ 1, 2, 0 ] ) Преобразует таблицу чисел с одним столбцом в таблицу логических значений с одним столбцом. [ true, true, false ]