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 texto que você 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

Originada na versão

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.