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

Position

Retorna a posição inicial da ocorrência especificada da cadeiaDePesquisa no texto.

Formato 

Position(texto ; cadeiaDePesquisa ; inicial ; ocorrência)

Parâmetros 

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

cadeiaDePesquisa - qualquer expressão de texto ou campo de texto que representa o conjunto de caracteres que deseja localizar.

inicial - qualquer campo ou expressão numérica que contém um número que representa o número de caracteres do início da cadeia de texto em que a pesquisa deve ser iniciada. Um valor inicial de 1 ou menos inicia a pesquisa a partir do primeiro caracteres da cadeia de texto.

ocorrência - qualquer expressão numérica ou campo que contém um número, que representa qual instância da cadeia de texto deseja localizar. A varredura começa no valor inicial e, se a ocorrência for positiva, continua na direção do fim da cadeia de texto; se a ocorrência for negativa, a varredura continua na direção do começo da cadeia de texto. Um valor de zero para ocorrência é inválido e retorna um resultado de zero.

Tipo de dados retornado 

número

Originado em 

FileMaker Pro 6.0 ou anterior

Descrição 

Essa função não possui diferenciação entre maiúsculas e minúsculas. Se cadeiaDePesquisa não estiver contido em texto ou se não tiver nenhuma ocorrência especificada, zero será retornado.

Exemplo 1 

Position("Mississippi";"iss";1;1) retorna 2.

Position("Mississippi";"iss";1;2) retorna 5.

Position("Mississippi";"iss";3;1) retorna 5.

Exemplo 2 

Left(Nome;Position(Nome;" ";1;1)-1) retorna William, quando Nome é um campo de texto que contém William Smith.

Exemplo 3 

Right(Nome;Length(Nome) - Position(Nome;" ";Length(Nome);1)) retorna Smith.

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