Referência > Referência de funções > Funções de texto > FilterValues
 

FilterValues

Retorna um resultado de texto contendo somente os valores fornecidos em valoresDeFiltro, na ordem em que foram originalmente inseridos em textoParaFiltrar.

Formato 

FilterValues(textoParaFiltrar; valoresDeFiltro)

Parâmetros 

textoParaFiltrar - qualquer expressão de texto ou campo de texto.

valoresDeFiltro - valores que deseja preservar no texto especificado

Tipo de dados retornado 

texto

Originado em 

FileMaker Pro 7.0

Descrição 

Se o parâmetro filterValues não tiver valor algum, uma cadeia vazia será retornada.

Valores são itens de texto separados por retornos de carro. Um valor pode ser vazio, um único caractere, uma palavra, uma sentença ou um parágrafo. Quando pressiona Enter ou Return, você começa a criar um novo valor. O último valor será reconhecido com ou sem um retorno de carro.

Quando o parâmetro textoParaFiltrar ou valoresDeFiltro for uma cadeia literal, você deverá inserir um caractere de parágrafo (¶) entre cada item na cadeia. Para inserir um caractere de retorno de carro, clique no botão na caixa de diálogo Especificar cálculo.

A função FilterValues não possui diferenciação entre maiúsculas e minúsculas.

Cada valor retornado termina com um retorno de carro, permitindo que listas sejam concatenadas facilmente.

Exemplo 1 

FilterValues("Xadrez¶Calça¶Mala";"Xadrez¶Calça") retorna

Xadrez
Calça

Exemplo 2 

FilterValues(ValueListItems("Banco de dados";"Tamanhos");"Médio¶Pequeno") retorna

Pequeno
Médio

quando um arquivo de banco de dados com o nome Banco de dados tiver uma lista de valores Tamanhos que contém Pequeno¶Médio¶Grande.

Tópicos relacionados 

Referência de funções (lista de categorias)

Referência de funções (lista em ordem alfabética)

Sobre fórmulas

Sobre funções

Definição de campos de cálculo

Utilização de operadores em fórmulas