ValueCount
Retorna uma contagem do número total de valores no texto especificado.
Formato
ValueCount ( texto )
Parâmetros
texto
- qualquer expressão de texto ou campo de texto
Tipo de dados retornado
número
Originada na versão
7.0
Descrição
Valores são itens de texto que terminam com um retorno de carro. Você pode colocar vários valores juntos para criar uma lista de valores delimitada por retorno de carro. Um valor pode ser vazio, um único caractere, uma palavra, uma sentença ou um parágrafo. Quando você pressiona Enter ou Return, você começa a criar um novo valor. Se o último valor não estiver vazio, ele será reconhecido com ou sem um retorno de carro final.
Quando a lista de valores for uma cadeia literal como no exemplo abaixo, você deverá inserir um caractere de retorno de carro literal (¶) entre cada item na lista. Para inserir um caractere de retorno de carro literal, clique no botão ¶ na caixa de diálogo Especificar cálculo.
Notas
- ValueCount e outras funções que trabalham com listas de valores reconhecem todos os caracteres a seguir como separadores entre valores:
Nome do caractere |
Ponto de código Unicode |
Avanço de linha |
10 |
Retorno de carro |
13 |
Separador de linha |
8232 |
Separador de parágrafo |
8233 |
No que se refere a listas de valores, "retorno de carro" é usado para se referir a qualquer um dos seguintes caracteres separadores.
Exemplo 1
ValueCount ( "Item 1¶Item 2¶Item 3¶" )
retorna 3.
ValueCount ( "Item 1¶Item 2¶Item 3¶¶" )
retorna 4 (o último valor está vazio).
Exemplo 2
ValueCount(ValueListItems("Funcionários";"Nomes dos funcionários"))
retorna o número total de valores na lista de valores Nomes dos funcionários no arquivo de banco de dados de Funcionários.