Função TEST( )

Retorna um valor lógico que indica se uma cadeia especificada ocorre em uma posição de byte específica no registro.

Sintaxe

TEST(posição_de_byte; cadeia)

Parâmetros

Nome	Tipo	Descrição
posição_de_byte	numérico	O número sequencial à esquerda no layout da tabela que identifica o local do primeiro caractere da cadeia. A função é avaliada como F se o início da cadeia não for identificado nessa posição, mesmo se a cadeia aparecer em outra posição no registro.
cadeia	caractere	A cadeia de caracteres que deve ser pesquisada. A pesquisa diferencia maiúsculas de minúsculas. Se houver a possibilidade de combinação de minúsculas e maiúsculas, utilize a função UPPER( ) para converter todos os caracteres em letras maiúsculas.

Nome

Tipo

Descrição

posição_de_byte

numérico

O número sequencial à esquerda no layout da tabela que identifica o local do primeiro caractere da cadeia.

A função é avaliada como F se o início da cadeia não for identificado nessa posição, mesmo se a cadeia aparecer em outra posição no registro.

cadeia

caractere

A cadeia de caracteres que deve ser pesquisada.

A pesquisa diferencia maiúsculas de minúsculas. Se houver a possibilidade de combinação de minúsculas e maiúsculas, utilize a função UPPER( ) para converter todos os caracteres em letras maiúsculas.

Saída

Lógico. Retorna T (verdadeiro) se a cadeia especificada começar no local do byte especificado dentro do registro, caso contrário, retorna F (falso).

Exemplos

Exemplos básicos

Suponha que um registro contenha:

Departamento: Marketing 
....|....|....|....|....|

Retorna T:

TEST(5; "Departamento")

Retorna F, pois a cadeia "Departamento" começa na quinta posição de byte e não na sexta:

TEST(6; "Departamento")

Retorna F, pois a função diferencia maiúsculas de minúsculas:

TEST(5; "DEPARTAMENTO")

Exemplos avançados

Isolamento de registros que são cabeçalhos de página

Use TEST( ) para criar um filtro que isola todos os registros que começam com "Página:":

SET FILTER TO TEST(1; "Página:")