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. |
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:")
Guia de scripting do ACL 14.1