Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

X2Nome

X2Nome()

Lê descrição da tabela no idioma corrente.

X2NomeAdvPL
01 · VISÃO GERAL

Visão geral

O manual histórico descreve leitura de descrição da tabela conforme o registro já posicionado em SX2 e o idioma corrente. É descrição de apresentação; para nome físico SQL use uma API como RetSQLName no contexto correto. O chamador deve confirmar a chave antes deste fragmento: alias aberto e registro válido não comprovam que seja o registro desejado. Os exemplos comunitários fazem buscas com chaves fixas e sem conferir DbSeek; a adaptação não repete essa busca. A expressão aliasada evita trocar a área corrente e não modifica o dicionário. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

X2Nome()

Retorno

Caractere conforme manual histórico.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed720()
    Local xResultado := Nil
    // O chamador ja confirmou a chave deste registro; nao reposicionar aqui.
    If Select("SX2") > 0
        If !SX2->(Eof())
            xResultado := SX2->(X2Nome())
        EndIf
    EndIf
    // Exibir apenas o tipo, sem revelar conteudo do dicionario.
    ConOut(ValType(xResultado))
Return Nil
Resultado esperado

Exibe o tipo do resultado; sem alias aberto ou com EOF, mantém Nil e exibe U. Conteúdo e idioma não são fixados. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Contrato histórico: confirmar disponibilidade e posicionamento no release-alvo. Não abrir, fechar ou editar SXs como efeito colateral desta consulta.
  • 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, p. 384. Referência histórica. Consulta em 2026-10-28.
  2. Universo do Desenvolvedor. eurairapelli/universo_do_desenvolvedor_site. ADVPL/Funcoes/Arquivos SXs/X2Nome.PRW. Arquivo completo analisado; adaptação. Consulta em 2026-10-28.
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