Compartilhar via


Função Len

Aplica-se a: Aplicativos Canvas Dataverse Colunas de fórmula Fluxos de desktop Aplicativos baseados em modelo Power Pages Power Platform CLI

Retorna o tamanho de uma cadeia de caracteres de texto.

Descrição

Se você especificar uma única cadeia de caracteres como o argumento, o valor de retorno será o tamanho como um número. Se você especificar uma tabela de coluna única que contenha cadeias de caracteres, o valor de retorno será uma tabela de coluna única com uma coluna Valor que contém o tamanho de cada cadeia de caracteres. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, como descrito em Trabalhando com tabelas.

Se você especificar uma cadeia de caracteres blank, Len retornará 0.

Sintaxe

Len( String )

  • String - Obrigatório. A cadeia de caracteres a ser medida.

Len( SingleColumnTable )

  • SingleColumnTable - Obrigatório. Uma tabela de coluna única de cadeias de caracteres a serem medidas.

Exemplos

Cadeia de caracteres única

Para os exemplos desta seção, a fonte de dados é um controle de entrada de texto chamado Author e que contém a cadeia de caracteres "E. E. Cummings".

Fórmula Descrição Resultado
Len(Autor.Texto) Mede o tamanho da cadeia de caracteres no controle Author. 14
Len( "" ) Mede o tamanho de uma cadeia de caracteres vazia. 0

Tabela de coluna única

Para o primeiro exemplo nesta seção, a fonte de dados é denominada People e contém estes dados:

Name Address
"Jean" "123 Main St NE"
"Fred" "789 SW 39th #3B"
Fórmula Description Result
Len( ShowColumns( Pessoas, "Endereço")) Na colunaAddress da tabela People:
  • Mede o tamanho de cada cadeia de caracteres.
  • Retorna uma tabela de coluna única que contém o tamanho de cada cadeia de caracteres.
Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 14, 15
Len( [ "Olá", "para o", "Mundo", "" ] ) Na coluna Value da tabela embutida:
  • Mede o tamanho de cada cadeia de caracteres.
  • Retorna uma tabela de coluna única que contém o tamanho de cada cadeia de caracteres.
Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: 5, 6, 5, 0