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

Статья
10/16/2024

Применимо к: Приложениям Canvas Потокам рабочего стола Приложениям на основе моделей Power Pages Power Platform CLI

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

Description

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

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

Синтаксис

логический( String )
логический( СтрокаОдинСтолбецТаблица )

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

логический( Число )
логический( ЧислоОдноСтолбцовТаблица )

Номер - Обязательно. Числа для преобразования. 0 преобразуется в ложь , а все остальные числа преобразуются в истину. пустые значения принимаются и преобразуются в пустые.

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

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

Примеры

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

Формула	Описание:	Result
логический( "истина" )	Преобразует значение текстовой строки `"true"` в логическое значение.	истинный
логический( "ложь" )	Преобразует значение текстовой строки `"false"` в логическое значение.	ЛОЖЬ
логический( "ИСТИНА" )	Преобразует значение текстовой строки `"TRUE"` в логическое значение.	истинный
логический( "Истинно" )	Преобразует значение текстовой строки `"TrUe"` в логическое значение.	истинный
логический( "Правдивый" )	Попытки преобразовать текстовую строку `"Truthful"` в логическое значение, но так как это не нечувствительный к регистру вариант значений `true` и `false`, то возвращается ошибка.	ошибка (неверный аргумент)
логический( Пусто() )	Преобразование пустого значения в логическое значение.	пустой
логический( 0 )	Преобразует число `0` в логическое значение.	ЛОЖЬ
логический( 1 )	Преобразует число `1` в логическое значение.	истинный
логический(-1234)	Преобразует число `-1234` в логическое значение.	истинный

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

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

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

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

Поделиться через