Guia de Referência do Net.Data

Instrução LIST

Objetivo

Você pode utilizar variáveis LIST para gerar uma lista definida de valores. A utilização de variáveis LIST pode ser útil na construção de consultas SQL com diversos itens como aqueles encontrados em algumas condições WHERE ou HAVING.

Sintaxe

             +---------------------------+
             V                           |
>>-%list--"----+------------------------++--"---nome da variável-->
               +-cadeia-----------------+
               +-variável de referência-+
               +-chamada de função------+

>--------------------------------------------------------------><

Contexto

Pode ser encontrado nestes contextos:

• instrução DEFINE

Parâmetros

%list

Palavra-chave que especifica que variáveis devem ser utilizadas para gerar uma lista definida de valores.

cadeia

Qualquer seqüência de caracteres alfabéticos e numéricos e pontuação exceto um tabulador, caractere de linha nova ou um espaço.

referência de variável

Retorna o valor de uma variável anteriormente definida e é especificada com $ e (). Por exemplo: se VAR = 'abc', então $(VAR) retorna o valor 'abc'. Consulte a seção Referência de Variável para obter informações sobre sintaxe.

chamada de função

Invoca um ou mais blocos FUNCTION previamente definidos com argumentos especificados. Consulte Chamada de função (@) para obter a sintaxe e exemplos.

nome da variável

O nome de uma variável. Uma cadeia alfabética ou numérica começando com um caractere alfabético ou sublinhado e contendo qualquer combinação de caracteres alfabéticos, numéricos ou sublinhado. Consulte a seção Nome da Variável para obter informações sobre sintaxe.

Restrições

Pode conter estes elementos:

• Referências de variável
• Chamadas de função
• Cadeias

Exemplos

Exemplo 1:

 %DEFINE{
DATABASE="custcity"
%LIST " OR " conditions
cond1="São Paulo"
cond2="Seattle"
cond3="Shangai"
whereClause=Conditions ? "WHERE $(conditions)" : ""
%}