Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNDAMENTOEm revisão

Internacionalização de textos por includes

#Define → arquivo .ch → #Include → compilação

Separa mensagens do código por constantes de compilação.

Internacionalização de textos por includesAdvPL
01 · VISÃO GERAL

Visão geral

O manual histórico recomenda centralizar textos no include associado ao fonte. #Include insere conteúdo no pré-processamento; não é por si só tradução dinâmica conforme idioma do usuário. O exemplo reúne um cabeçalho fictício e um fonte, com ED_LANG_EN/ES como convenções próprias do exemplo, não símbolos oficiais. Compilar cada variante e verificar encoding e comprimento. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

#Define → arquivo .ch → #Include → compilação
03 · EXEMPLO PRÁTICO

Exemplo comentado

// EdMessages.ch: convencoes proprias do exemplo.
#IfDef ED_LANG_EN
    #Define ED_MSG "Ready"
#Else
    #IfDef ED_LANG_ES
        #Define ED_MSG "Listo"
    #Else
        #Define ED_MSG "Pronto"
    #EndIf
#EndIf

// EdExample.prw: salvar o cabecalho acima separadamente.
#Include "Protheus.ch"
#Include "EdMessages.ch"

User Function Ed493()
    ConOut(ED_MSG)
Return Nil
Resultado esperado

Exibe o texto selecionado na compilação, sem trocar idioma em tempo de execução. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Manter a mesma chave e os mesmos marcadores nas traduções. Não traduzir identificadores de API ou nomes de campo.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0; p. 77. Referência histórica. Consulta em 2026-10-27.
  2. Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0; p. 96. Referência histórica. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha