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 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 vazia, 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( Author.Text ) Mede o tamanho da cadeia de caracteres no controle Author. 14
Compr( "" ) 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:

Fórmula Descrição Resultado
Len( ShowColumns( People, "Address" ) ) Na coluna Address 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.
Len( [ "Hello", "to the", "World", "" ] ) 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.