4D v16.3

METHOD GET CODE

Página Inicial

 
4D v16.3
METHOD GET CODE

METHOD GET CODE 


 

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

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.

Consulte o exemplo do comando METHOD SET CODE.

This example illustrates the effect of the option parameter.

You want to export the following "simple_init" method:

 Case of
    :(Form event=On Load)
       ALL RECORDS([Customer])
 End case

If you execute the following code:

 C_TEXT($code)
 C_TEXT($contents)
 $code:=METHOD Get path(Path project method;"simple_init")
 METHOD GET CODE($code;$contents;0) //no tokens
 TEXT TO DOCUMENT("simple_init.txt";$contents)

The resulting document will contain:

  //%attributes = {"lang":"en"} comment added and reserved by 4D
Case of
    : (Form event=On Load)
        ALL RECORDS([Customer])
End case

If you execute the following code:

 C_TEXT($code)
 C_TEXT($contents)
 $code:=METHOD Get path(Path project method;"simple_init")
 METHOD GET CODE($code;$contents;Code with tokens//use tokens
 TEXT TO DOCUMENT("simple_init.txt";$contents)

The resulting document will contain:

  //%attributes = {"lang":"en"} comment added and reserved by 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

 
PROPRIEDADES 

Produto: 4D
Tema: Accesso aos Objetos de Design
Número 1190

 
HISTÓRIA 

Criado por: 4D v13
Modificado: 4D v14
Modificado: 4D v15
Modificado: 4D v15 R4

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)