METHOD GET CODE

4D v19.8

METHOD GET CODE


METHOD GET CODE ( rota ; codigo {; option} {; *} )

Parâmetro	Tipo	Descrição
rota	Texto, Array texto	Texto ou array de texto que contém uma ou vários caminhos de acesso
codigo	Texto, Array texto	Código dos métodos designados
option	Inteiro longo	0 ou omis = exportar simples (sem token), 1 = exportar com tokens
*	Operador	Se passado = o comando é aplicado à base de dados de host quando se executa desde um componente (parâmetro ignorado fora deste contexto)

Descrição

O comando METHOD GET CODE devolve no parâmetro codigo, o conteúdo dos métodos designados pelo parâmetro rota. Este comando pode devolver o código de todos os tipos de métodos: métodos base, triggers, métodos projeto, métodos formulário e métodos objeto.

Pode utilizar dois tipos de sintaxes, baseadas em arrays texto ou variáveis texto:

 C_TEXT(tVpath) // variáveis texto

 C_TEXT(tVcode)

 METHOD GET CODE(tVpath;tVcode) // código de somente um método

 ARRAY TEXT(arrPaths;0) // arrays texto

 ARRAY TEXT(arrCodes;0)

 METHOD GET CODE(arrPaths;arrCodes) // códigos de vários métodos

Não podem ser combinados as duas sintaxes.

Se passado um caminho de acesso não válida, o parâmetro codigo é deixado vazio e é gerado um erro.

No texto do codigo gerado por este comando:

os nomes dos comandos são escritos em inglês, a não ser que se use uma versão francesa de 4D e tenha sido selecionada a preferência "Usar a linguagem francesa e parâmetros regionais de sistema" (ver Página Métodos). Quando utilizar o parâmetro opção, o código pode conter tokens da linguagem com o objetivo de que seja independente da linguagem de programação 4D e da versão (ver mais adiante).
Para aumentar a legibilidade do código, o texto é indentado com os caracteres de tabulação em função das estruturas de programação, da mesma forma que no editor de métodos.
Uma linha é adicionada no cabeçalho do código gerado que contém os metadatos utilizados para a importação do código, por exemplo:
// %attributes = {"lang":"fr","invisible":true,"folder":"Web3"}

Durante uma importação, esta linha não se importa, se utiliza para definir os atributos a aplicar (os atributos não especificados se reinicializam a seu valor como padrão). O atributo "lang" define a linguagem de exportação e impede uma importação em uma aplicação na linguagem diferente (neste caso, se gera um erro). O atributo "folder" contém o nome da pasta pai do método; não é mostrada quando o método não tem uma pasta pai.
Podem ser definidos atributos adicionais. Para saber mais, consulte o comando METHOD SET ATTRIBUTES.

O parâmetro opção lhe permite seleccionar o modo de exportação do código com respeito aos elementos da linguagem tokenizados dos métodos:

Se passar 0 ou omitir o parâmetro opção, o código do método se exporta sem tokens, ou seja, da mesma forma que se mostra no editor de métodos.
Se passar 1 ou a constante Code with tokens, o código do método se exporta com tokens, ou seja, os elementos tokenizados são seguidos por sua referência interna no conteúdo do código exportado. Por exemplo, a expressão"String(a)" se exporta "String:C10(a)", donde "C10" é a referência interna do comando String.

Os elementos tokenizados da linguagem incluem:

os comandos e constantes 4D,
os nomes de tabelas e campos,
os comandos de plug-ins 4D.

O código exportado com seus tokens faz com que seja independente da linguagem de programação 4D, e também de qualquer mudança de nome poesterior dos elmentos da linguagem. Graças aos tokens, o código proporcionado em forma de texto sempre será interpretado corretamente por 4D, por exemplo usando o comando METHOD SET CODE ou por copiar/colar. Para saber mais sobre a sintaxe tokens tokens 4D, consulte Usar tokens em fórmulas.

Se o comando for executado desde um componente, se aplica como padrão para os métodos do componente. Se passar o parâmetro *, acessa aos métodos do banco de dados local.

Exemplo 1

Consulte o exemplo do comando METHOD SET CODE.

Exemplo 2

Este exemplo ilustra o efeito de parâmetro opção.

Se quiser exportar o método abaixo "simple_init" :

 Case of</p><p>:(FORM Event=On Load)

       ALL RECORDS([Customer])

 End case

Se executar o código abaixo:

 C_TEXT($path)

 C_TEXT($contents)

 $code:=METHOD Get path(Path project method;"simple_init")

 METHOD GET CODE($path;$contents;0) //sem tokens

 TEXT TO DOCUMENT("simple_init.txt";$contents)

O documento resultante conterá:

  //%attributes = {"lang":"en"} comentario adicionado e reservado por 4D
Case of
    : (Form event=On Load)
        ALL RECORDS([Customer])
End case

Se executar o código abaixo:

 C_TEXT($path)

 C_TEXT($contents)

 $code:=METHOD Get path(Path project method;"simple_init")

 METHOD GET CODE($path;$contents;Code with tokens) //sem tokens

 TEXT TO DOCUMENT("simple_init.txt";$contents)

O documento resultante conterá:

  //%attributes = {"lang":"en"} comentario adicionado e reservado por 4D
Case of
    : (Form event:C388=On Load:K2:1)
        ALL RECORDS:C47([Customer:1])
End case

Ver também

METHOD SET CODE
Usar tokens em fórmulas