Usina BRAdvPL Guide
Sign in
← All topics
FUNCTIONUnder review

X3Titulo

X3Titulo()

Reads field title in the current language.

X3TituloAdvPL
01 · OVERVIEW

Overview

The historical manual describes reading field title from the already positioned SX3 record in the current language. The title is a presentation label and may change by language without changing the technical name. The caller must confirm the key beforehand: an open alias and valid record do not prove intended identity. Community samples use fixed keys without checking DbSeek; this adaptation does not repeat that lookup. An aliased expression avoids changing the active area and does not modify the dictionary. (Sources: refs. 1–1.)

02 · SYNTAX

Syntax

X3Titulo()

Return value

Character per historical manual.

03 · PRACTICAL EXAMPLE

Commented example

#Include "Protheus.ch"

User Function Ed724()
    Local xResult := Nil
    // The caller already verified this record key; do not reposition here.
    If Select("SX3") > 0
        If !SX3->(Eof())
            xResult := SX3->(X3Titulo())
        EndIf
    EndIf
    // Display only the type, without exposing dictionary content.
    ConOut(ValType(xResult))
Return Nil
Expected result

Displays the result type; absent alias or EOF leaves Nil and displays U. Content/language are not fixed. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

BEST PRACTICES
  • Historical contract: verify availability/positioning on the target release. Do not open, close or edit SXs as a lookup side effect.
  • Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.

Related content

REFERENCES
  1. Waterloo Ferreira da Silva. AdvPL — O Manual, p. 386. Referência histórica. Accessed on 2026-10-28.
Status
Under review
Page created on
Last reviewed on
Original language
Portuguese
Reviewed by
Usina.BR
0 approved comment(s)

Comments

There are no approved comments yet.

Sign in with Google or Microsoft to comment.

Powered by Usina Docs · Alpha