Acesse o novo Manual 2.7 new.jpg
 

Descritores

Todo o processo de geração de código está baseado na construção dos Descritores. É importante conhecer o comportamento de cada um deles dentro do processamento do gerador.

Nos itens abaixo descrevemos o funcionamento de cada Descritor:

Representa a estrutura de um procedimento que não retorna valor. Nele existem quatro parâmetros, descritos abaixo:

%1 - Nome do procedimento;

%2 - Lista de parâmetros;

%3 - Bloco de declaração de variáveis;

%4 - Bloco de execução de comandos.

O primeiro parâmetro é obtido pelo próprio gerador, pelo arquivo XML. O segundo parâmetro é obtido pelo resultado conjunto dos descritores DeclareParamIn, ParamSeparator e DeclareParamOut. O terceiro parâmetro é obtido pelo retorno do descritor DeclareVar. O quarto parâmetro é obtido pelo resultado conjunto de todos os outros descritores.

Representa a estrutura de uma função que retorna um valor de um determinado tipo. Nele existem cinco parâmetros, descritos abaixo:

%1 - Nome do procedimento;

%2 - Lista de parâmetros;

%3 - Bloco de declaração de variáveis;

%4 - Bloco de execução de comandos;

%5 - Tipo de retorno da função.

Os quatro primeiros parâmetros são equivalentes aos do descritor acima. O quinto parâmetro é obtido pelo retorno do descritor do tipo encontrado no arquivo XML. Os descritores que fazem referência aos tipos têm o mesmo nome encontrado no XML:

Representa o formato de declaração de parâmetros de entrada de procedimentos e funções. Nele existem 2 parâmetros, descritos abaixo:

%1 - Tipo do parâmetro;

%2 - Identificador do parâmetro.

O primeiro parâmetro é obtido pelo arquivo XML e convertido pelo descritor do tipo correspondente. O segundo parâmetro é obtido pelo resultado conjunto entre o descritor PrefixVar e o nome do parâmetro no arquivo XML. O resultado completo é obtido em conjunto com o descritor ParamSeparator.

Representa o formato de declaração de parâmetros de saída de procedimentos que retornam um valor. Nele existem dois parâmetros, descritos abaixo:

%1 - Tipo do parâmetro;

%2 - Identificador do parâmetro.

O primeiro parâmetro é obtido pelo arquivo XML e convertido pelo descritor do tipo correspondente. O segundo parâmetro é obtido pelo resultado conjunto dos descritores PrefixVar e ReturnName.

Representa o conjunto de caracteres utilizados como separadores dos parâmetros de entrada. Este descritor não possui parâmetros.

Representa o conjunto de caracteres utilizados como prefixos para nomes de variáveis. Este descritor não possui parâmetros.

Representa o formato de declaração de variáveis. Nele existem dois parâmetros, descritos abaixo:

%1 - Tipo da variável;

%2 - Identificador da variável.

O primeiro parâmetro é obtido pelo arquivo XML e convertido pelo descritor do tipo correspondente. O segundo parâmetro é obtido pelo resultado conjunto entre o descritor PrefixVar e o nome da variável no arquivo XML.

Representa o nome da variável de saída utilizada em procedimentos que retornam valores. Este descritor é utilizado para linguagens que não implementam função e necessitam retornar um valor por meio de procedimentos. Este descritor não possui parâmetros.

Representa a sintaxe do comando de encerramento de um procedimento. Não é utilizado em funções. Este descritor não possui parâmetros.

Representa a sintaxe do comando de encerramento de uma função ou procedimento que retorna um valor. Nele existem dois parâmetros descritos abaixo:

%1 - Nome da variável de retorno;

%2 - Valor a ser retornado.

O primeiro parâmetro é obtido pelo conteúdo do descritor ReturnName. O segundo parâmetro é obtido pelo arquivo XML. Quando utilizado em uma função, normalmente só o segundo parâmetro é necessário.

Representa a sintaxe do comando de encerramento de uma função ou procedimento que retorna um valor de tipo lógico. Nele existem dois parâmetros, descritos abaixo:

%1 - Nome da variável de retorno;

%2 - Valor de tipo lógico a ser retornado.

O primeiro parâmetro é obtido pelo conteúdo do descritor ReturnName. O segundo parâmetro é obtido pelo arquivo XML. Quando utilizado em uma função, normalmente só o segundo parâmetro é necessário.

Representa a sintaxe do comando de atribuição de um valor a uma variável. Nele existem dois parâmetros, descritos abaixo:

%1 - Nome da variável;

%2 - Valor a ser atribuído.

O primeiro parâmetro é obtido pelo resultado conjunto entre o descritor PrefixVar e o arquivo XML. O segundo parâmetro é obtido pelo arquivo XML. Quando a expressão não atribui valores a uma variável, SetVar não é utilizado.

Representa a sintaxe do comando de atribuição de um valor do tipo lógico a uma variável do tipo lógico. Nele existem dois parâmetros, descritos abaixo:

%1 - Nome da variável do tipo lógico;

%2 - Valor do tipo lógico a ser atribuído.

O primeiro parâmetro é obtido pelo resultado conjunto entre o descritor PrefixVar e o arquivo XML. O segundo parâmetro é obtido pelo arquivo XML. Quando a expressão não atribui valores a uma variável, SetBoolean não é utilizado.

Representa a sintaxe da chamada de uma função ou procedimento. Nele existem dois parâmetros, descritos abaixo:

%1 - Nome da função ou procedimento;

%2 - Lista de parâmetros.

Todos os parâmetros são obtidos pelo arquivo XML. Quando um procedimento retorna um valor, é adicionado ao segundo parâmetro o resultado do descritor CallRuleReturn.

Representa a sintaxe do parâmetro de retorno da chamada de um procedimento. Nele existe um parâmetro, descrito abaixo:

%1 - Nome da variável receptora do valor de retorno do procedimento.

O parâmetro é obtido pelo arquivo XML.

Representa o conjunto de caracteres utilizados como separadores dos parâmetros de entrada na chamada de uma função ou procedimento. Este descritor não possui parâmetros.

Representa o valor 0 ou 1; onde 0 indica que, dentro de uma expressão, não será permitida a chamada de uma função, utilizando-se o seu valor de retorno; e 1 permite o uso de funções dentro de uma expressão. Este descritor não possui parâmetros.

Representa a sintaxe do início de um laço condicional. Nele existe um parâmetro, descrito abaixo:

%1 - Condição lógica.

O parâmetro é obtido pelo arquivo XML.

Representa a sintaxe de fim de um laço condicional. Este descritor não possui parâmetros.

Representa a sintaxe do início de uma estrutura condicional. Nele existe um parâmetro, descrito abaixo:

%1 - Condição lógica.

O parâmetro é obtido pelo arquivo XML.

Representa a sintaxe do separador entre o bloco de execução para condição verdadeira e o bloco de execução para condição falsa da estrutura condicional. Este descritor não possui parâmetros.

Representa a sintaxe de fim de uma estrutura condicional. Este descritor não possui parâmetros.

Representa um conjunto de caracteres utilizado como marcador para início de bloco de comentário. Este descritor não possui parâmetros.

Representa um conjunto de caracteres utilizado como marcador para fim de bloco de comentário. Este descritor não possui parâmetros.

Representa um conjunto de caracteres utilizado como marcador para linha de comentário. Este descritor não possui parâmetros.

Representa um conjunto de caracteres utilizado como delimitador para início de constantes letras. Este descritor não possui parâmetros.

Representa um conjunto de caracteres utilizado como delimitador para fim de constantes letras. Este descritor não possui parâmetros.

Representa o formato de apresentação de expressões lógicas. Nele existe um parâmetro, descrito abaixo:

%1 - Constante lógica.

O parâmetro é obtido pelo descritor lógico, que retorna à constante lógica, definida para a linguagem.

Representa a sintaxe do comando para emissão de uma mensagem de alerta. Nele existe um parâmetro, descrito abaixo:

%1 - Mensagem a ser exibida.

O parâmetro é obtido pelo arquivo XML.

Representa a sintaxe do comando para emissão de uma mensagem de erro. Nele existe um parâmetro, descrito abaixo:

%1 - Mensagem a ser exibida.

O parâmetro é obtido pelo arquivo XML.

Representa o símbolo de separação de decimais para números fracionados. Este descritor não possui parâmetros.

Representa o formato de apresentação da constante do tipo data. Nele existem sete parâmetros, descritos abaixo:

%D - Dia;

%M - Mês;

%Y - Ano;

%H - Hora;

%N - Minuto;

%S - Segundo;

%1 - Valor data sem formatação.

Os seis primeiros parâmetros indicam as partes que compõem a data/hora. Poderão ser posicionados na ordem que for desejada para apresentação da constante data. O segundo parâmetro é o valor da data, obtido pelo arquivo XML.

Representa o formato de apresentação da constante do tipo hora. Nele existem quatro parâmetros, descritos abaixo:

%H - Hora;

%N - Minuto;

%S - Segundo;

%1 - Valor data sem formatação.

Os três primeiros parâmetros indicam as partes que compõem a hora. Poderão ser posicionados na ordem que for desejada para apresentação da constante hora. O segundo parâmetro é o valor da hora, obtido pelo arquivo XML.

Representa o formato de apresentação da constante FALSO do tipo lógico. Este descritor não possui parâmetros.

Representa o formato de apresentação da constante VERDADEIRO do tipo lógico. Este descritor não possui parâmetros.

Representa o formato de apresentação da constante NULO. Normalmente os padrões reservam a palavra NULL para informar que o valor será NULO, portanto, se o formato desejado for NULL, este deve ser precedido de % (símbolo percentual) resultando ”%NULL”. Este descritor não possui parâmetros.

Representa a sintaxe de declaração do tipo letras. Nele existe um parâmetro, descrito abaixo:

%1 - Tamanho do texto

Este descritor é utilizado para a declaração de variáveis do tipo letras. O parâmetro representa a quantidade máxima de caracteres permitida.

Representa a sintaxe de declaração do tipo numérico inteiro. Este descritor não possui parâmetros.

Representa a sintaxe de declaração do tipo numérico fracionado. Este descritor não possui parâmetros.

Representa a sintaxe de declaração do tipo data. Este descritor não possui parâmetros.

Representa a sintaxe de declaração do tipo hora. Este descritor não possui parâmetros.

Representa a sintaxe de declaração do tipo lógico. Este descritor não possui parâmetros.

Representa a sintaxe de declaração do tipo tabela. Este tipo representa um conjunto de registros recuperados de uma tabela contida em um banco de dados. Normalmente está relacionado diretamente com o tipo CURSOR do banco de dados. Este descritor não possui parâmetros.

Representa a sintaxe de declaração do tipo variante, que representa um tipo indeterminado, podendo ser utilizado para diversos fins. Normalmente está relacionado diretamente com tipos de classes de objetos ou ponteiros para outros tipos. Este descritor não possui parâmetros.

Representa a sintaxe do operador ”E”, que retorna um valor lógico por meio de uma função lógica conjuntiva. Normalmente é utilizado para avaliar expressões lógicas de 'n' elementos que se apresentam aqui como parâmetros. Os parâmetros estão representados com o símbolo ”%*”, que significa uma lista de parâmetros de quantidade variável. O mínimo, neste caso, são dois parâmetros, para que seja possível a operação ”E” lógica. O conteúdo que está entre os símbolos ”[]” representa o conjunto de caracteres que será inserido como operador entre os parâmetros. A regra para utilização desses símbolos é: %* seguido de separador.

Exemplos:

Representa a sintaxe do operador ”OU”, que retorna um valor lógico por meio de uma função lógica disjuntiva. Normalmente é utilizado para avaliar expressões lógicas de 'n' elementos que se apresentam aqui como parâmetros. Os parâmetros estão representados com o símbolo ”%*”, que significa uma lista de parâmetros de quantidade variável. O mínimo, neste caso, são dois parâmetros, para que seja possível a operação ”OU” lógica. O conteúdo que está entre os símbolos ”[]” representa o conjunto de caracteres que será inserido como operador entre os parâmetros. A regra para utilização desses símbolos é: %* seguido de separador.

Exemplos:

Representa a sintaxe do operador ”NÃO”, que retorna um valor lógico por meio de uma função lógica de negação. Normalmente é utilizado para negar expressões lógicas. Nele existe um parâmetro.

%1 - Expressão lógica a ser negada

O parâmetro indicado por %1 representa a expressão lógica a ser negada, que pode ser uma constante ou uma função lógica.

Exemplos:

Representa a sintaxe do operador ”IGUAL”, que retorna um valor lógico por meio de uma função de igualdade lógica. Nele existem dois parâmetros, descritos abaixo:

%1 - Primeira expressão a ser comparada

%2 - Segunda expressão a ser comparada

Os dois parâmetros serão obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe do operador ”DIFERENTE” que retorna um valor lógico por meio de uma função de diferença lógica. Nele existem dois parâmetros descritos abaixo:

%1 - Primeira expressão a ser comparada

%2 - Segunda expressão a ser comparada

Os dois parâmetros serão obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe do operador ”MAIOR QUE”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o primeiro parâmetro for MAIOR QUE o segundo parâmetro; caso contrário é FALSO. Nele existem dois parâmetros, descritos abaixo:

%1 - Primeira expressão a ser comparada

%2 - Segunda expressão a ser comparada

Os dois parâmetros serão obtidos por outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe do operador ”MENOR QUE”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o primeiro parâmetro for MENOR QUE o segundo parâmetro; caso contrário é FALSO. Nele existem dois parâmetros, descritos abaixo:

%1 - Primeira expressão a ser comparada

%2 - Segunda expressão a ser comparada

Os dois parâmetros serão obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe do operador ”MAIOR OU IGUAL”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o primeiro parâmetro for MAIOR OU IGUAL ao segundo parâmetro; caso contrário é FALSO. Nele existem dois parâmetros, descritos abaixo:

%1 - Primeira expressão a ser comparada

%2 - Segunda expressão a ser comparada

Os dois parâmetros serão obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe do operador ”MENOR OU IGUAL”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o primeiro parâmetro for MENOR OU IGUAL ao segundo parâmetro; caso contrário, é FALSO. Nele existem dois parâmetros, descritos abaixo:

%1 - Primeira expressão a ser comparada

%2 - Segunda expressão a ser comparada

Os dois parâmetros serão obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe do operador ”É NULO”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o parâmetro for NULO; caso contrário, é FALSO. Nele existe um parâmetro, descrito abaixo:

%1 - Expressão a ser testada

O parâmetro é obtido por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe do operador ”IGUAL”, que retorna um valor lógico por meio de uma função de igualdade lógica. Este descritor é equivalente ao isEqual, no entanto sua sintaxe será utilizada em cláusulas WHERE do SQL.

Representa a sintaxe do operador ”DIFERENTE”, que retorna um valor lógico por meio de uma função de diferença lógica. Este descritor é equivalente ao isDiferent, no entanto sua sintaxe será utilizada em cláusulas WHERE do SQL.

Representa a sintaxe do operador ”MAIOR QUE”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o primeiro parâmetro for MAIOR QUE o segundo parâmetro; caso contrário, é FALSO. Este descritor é equivalente ao isGreater, no entanto sua sintaxe será utilizada em cláusulas WHERE do SQL.

Representa a sintaxe do operador ”MENOR QUE”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o primeiro parâmetro for MENOR QUE o segundo parâmetro; caso contrário, é FALSO. Este descritor é equivalente ao isMinor, no entanto sua sintaxe será utilizada em cláusulas WHERE do SQL.

Representa a sintaxe do operador ”MAIOR OU IGUAL”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o primeiro parâmetro for MAIOR OU IGUAL ao segundo parâmetro; caso contrário, é FALSO. Este descritor é equivalente ao isGreaterOrEqual, no entanto sua sintaxe será utilizada em cláusulas WHERE do SQL.

Representa a sintaxe do operador ”MENOR OU IGUAL”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o primeiro parâmetro for MENOR OU IGUAL ao segundo parâmetro; caso contrário, é FALSO. Este descritor é equivalente ao isMinorOrEqual, no entanto sua sintaxe será utilizada em cláusulas WHERE do SQL.

Representa a sintaxe do operador ”É NULO”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o parâmetro for NULO; caso contrário, é FALSO. Este descritor é equivalente ao isNull, no entanto sua sintaxe será utilizada em cláusulas WHERE do SQL.

Representa a sintaxe do operador ”CONTENDO”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o segundo parâmetro estiver contido no primeiro; caso contrário, é FALSO. Este descritor é utilizado em cláusulas WHERE do SQL. Nele existem dois parâmetros, descritos abaixo:

%1 - Expressão em que será pesquisada

%2 - Expressão a ser localizada

Os dois parâmetros serão obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções. Deve-se obedecer à ordem dos parâmetros, sabendo-se que o segundo parâmetro é o que deverá estar contido no primeiro.

Exemplo:

Representa a sintaxe do operador ”INICIANDO COM”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o segundo parâmetro estiver contido no início do primeiro; caso contrário, é FALSO. Este descritor é utilizado em cláusulas WHERE do SQL. Nele existem dois parâmetros, descritos abaixo:

%1 - Expressão na qual será pesquisada

%2 - Expressão a ser localizada

Os dois parâmetros serão obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções. Deve-se obedecer à ordem dos parâmetros, sabendo-se que o segundo parâmetro é o que deverá estar contido no início do primeiro.

Exemplo:

Representa a sintaxe do operador ”TERMINANDO COM”, que retorna um valor lógico por meio de uma função lógica em que o resultado é VERDADEIRO quando o segundo parâmetro estiver contido no final do primeiro; caso contrário, é FALSO. Este descritor é utilizado em cláusulas WHERE do SQL. Nele existem dois parâmetros, descritos abaixo:

%1 - Expressão na qual será pesquisada

%2 - Expressão a ser localizada

Os dois parâmetros serão obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções. Deve-se obedecer à ordem dos parâmetros, sabendo-se que o segundo parâmetro é o que deverá estar contido no final do primeiro.

Exemplo:

Representa a sintaxe do comando ”INSERT” do SQL, que insere registros em uma tabela do banco de dados. Nele existem três parâmetros, descritos abaixo:

%1 - Nome da tabela do banco de dados

%2 - Lista de campos

%3 - Lista de valores a serem inseridos

Os parâmetros são obtidos pelo arquivo XML.

Representa a sintaxe do comando ”UPDATE” do SQL, que altera registros em uma tabela do banco de dados. Nele existem dois parâmetros, descritos abaixo:

%1 - Nome da tabela do banco de dados

%2 - Lista de alterações (campo = valor)

Os parâmetros são obtidos pelo arquivo XML.

Representa a sintaxe do comando ”DELETE” do SQL, que apaga registros em uma tabela do banco de dados. Nele existe um parâmetro, descrito abaixo:

%1 - Nome da tabela do banco de dados

O parâmetro é obtido pelo arquivo XML.

Representa a sintaxe da cláusula de restrição ”WHERE” para comandos SQL, utilizada para SELECT, UPDATE e DELETE. Nele existe um parâmetro, descrito abaixo:

%1 - Expressão lógica restritiva

O parâmetro é obtido pelo arquivo XML e por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções. Este descritor é usado apenas pelos descritores SQLInsert, SQLUpdate e SQLDelete.

Representa o valor 0 ou 1; onde 0 indica que não será permitida uma consulta SQL dentro de uma expressão condicional; e 1 indica que será permitida. Este descritor não possui parâmetros.

Representa a sintaxe do comando de declaração e abertura de um ”CURSOR” no SQL, que permite gerenciar um conjunto de dados dinâmico, por meio de uma variável do tipo TABELA.

Nele existem três parâmetros, descritos abaixo:

%1 - Variável do tipo TABELA

%2 - Comando SELECT do SQL que retorna um conjunto de dados dinâmico

%3 - Lista de variáveis utilizadas pelo comando FETCH

O primeiro parâmetro é sempre o nome da variável de tipo TABELA. É obtido pelo arquivo XML. O segundo parâmetro é o comando SELECT, que retornará um conjunto de registros que será gerenciado pelo CURSOR, por meio da variável do tipo TABELA. O terceiro parâmetro é a lista de variáveis utilizadas pelo comando FETCH. Este comando faz avançar um registro no CURSOR, atribuindo os valores dos campos do SELECT para as variáveis que se encontram na lista.

Exemplo:

Conteúdo do descritor:

OPEN %1 FOR %2;

FETCH %1 INTO %3;

Resultado do gerador:

OPEN tb_produto FOR (select codproduto, decricao from produto);

FETCH tb_produto INTO tb_produto_codproduto, tb_produto_descricao;

Em alguns casos, podem ser utilizadas algumas técnicas para auxiliar a geração do código. No exemplo abaixo, utilizamos um recurso do gerador para suprir uma falta de recursos de um determinado banco de dados:

--@n<declaração da variável>

Esta notação informa ao gerador que o texto encontrado após a sequência ”--@n” entrará na lista de declaração de variáveis, permitindo que seja declarada uma variável para uso interno do código e sem o conhecimento do criador do fluxo de origem. Nesse caso. o gerador não utilizará o descritor DeclareVar, sendo necessário informar a sintaxe da declaração completa na linguagem escrita. A letra ”n” indica um número que significa a ordem na qual a declaração entrará na lista. Caso seja necessário posicionar a declaração no topo da lista então ”n”, deve ser 1, e assim por diante. Caso o gerador encontre várias declarações com o mesmo número de ordem ”n”, elas serão colocadas na lista na ordem em que aparecem, permitindo organizar grupos de declarações na ordem desejada.

Exemplo:

Conteúdo do descritor:

SET %1 = CURSOR FOR %2

OPEN %1

FETCH NEXT FROM %1 INTO %3

SET @%1_FETCH_STATUS = @@FETCH_STATUS

--@1DECLARE @%1_FETCH_STATUS INT

Resultado do gerador:

SET tb_cargo = CURSOR FOR (select codcargo, descrição from cargo)

OPEN tb_cargo

FETCH NEXT FROM tb_cargo INTO tb_cargo_codcargo, tb_cargo_descricao

SET @tb_cargo_FETCH_STATUS = @@FETCH_STATUS

--@1DECLARE @tb_cargo_FETCH_STATUS INT

No exemplo acima, está definido um CURSOR com o nome ”tb_cargo”. A próxima instrução abre o CURSOR e, logo depois, é usado um FETCH que avança um registro no CURSOR. Em seguida, é atribuído o valor da variável global @@FETCH_STATUS para a variável @tb_cargo_FETCH_STATUS, que não existe no fluxo original, mas será declarada graças ao recurso do sinalizador --@1, que incluirá a declaração que se segue no bloco de declaração de variáveis, seguindo a ordem indicada pelo número após o @.

Esse é um exemplo de como é possível reunir várias instruções para atingir um único resultado para qual o descritor se propõe.

Representa a sintaxe da função de conversão de um tipo qualquer de dado para o tipo LETRAS. Nele existe um parâmetro, descrito abaixo:

%1 - Expressão a ser convertida

O parâmetro é obtido por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe da função de conversão de um tipo qualquer de dado para o tipo INTEIRO. Nele existe um parâmetro, descrito abaixo:

%1 - Expressão a ser convertida

O parâmetro é obtido por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe da função de conversão de um tipo qualquer de dado para o tipo FRACIONADO. Nele existe um parâmetro, descrito abaixo:

%1 - Expressão a ser convertida

O parâmetro é obtido por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções.

Representa a sintaxe da função de conversão de um dado do tipo LETRAS para o tipo DATA/HORA. Nele existem dois parâmetros, descritos abaixo:

%1 - Expressão do tipo LETRAS a ser convertida

%2 - Expressão do tipo LETRAS indicando o formato da expressão convertida (OPCIONAL)

Os dois parâmetros são obtidos por meio dos outros descritores que retornam várias formas de expressão, podendo ser constantes, variáveis ou funções. O segundo parâmetro é OPCIONAL.

Representa a sintaxe da função ”SOMA”, que retorna um somatório. Normalmente é utilizado para somar expressões numéricas de 'n' valores que se apresentam aqui como parâmetros. Os parâmetros estão representados com o símbolo ”%*”, que significa uma lista de parâmetros de quantidade variável. O mínimo, neste caso, são dois parâmetros, para que seja possível uma operação ”SOMA”. O conteúdo que está entre os símbolos ”[]” representa o conjunto de caracteres que será inserido como operador entre os parâmetros. A regra para a utilização desses símbolos é: %* seguido de separador.

Exemplos:

Representa a sintaxe da função ”SUBTRAÇÃO”, que retorna um somatório. Normalmente é utilizado para subtrair expressões numéricas de 'n' valores que se apresentam aqui como parâmetros. Os parâmetros estão representados com o símbolo ”%*”, que significa uma lista de parâmetros de quantidade variável. O mínimo, neste caso, são dois parâmetros, para que seja possível uma operação ”SUBTRAÇÃO”. O conteúdo que está entre os símbolos ”[]” representa o conjunto de caracteres que será inserido como operador entre os parâmetros. A regra para a utilização desses símbolos é: %* seguido de [ separador ].

Exemplos:

Representa a sintaxe do operador ”E”, que retorna um valor lógico por meio de uma função lógica conjuntiva. Este descritor é equivalente ao And, descrito anteriormente.

___________________________________________________________________________

image776.jpg

Caso este tópico não tenha comentário satisfatório, envie e-mail para documentacao@softwell.com.br