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

PadR

PadR(xExp,nLen,[cFill]) -> cRet

Preenche uma string à direita.

PadRAdvPL
01 · VISÃO GERAL

Visão geral

O tamanho final é nLen. A função converte xExp para string; cFill omitido usa espaço e, quando informado, só seu primeiro caractere é usado. Se a entrada exceder nLen, há truncamento; nLen menor ou igual a zero produz string vazia. O exemplo comunitário compara C/L/R; a adaptação usa preenchimento visível para evitar ambiguidade de espaços. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

PadR(xExp,nLen,[cFill]) -> cRet

Parâmetros

xExp
QualquerObrigatório

Valor convertido para texto.

nLen
NuméricoObrigatório

Comprimento final.

cFill
CaractereOpcional

Caractere de preenchimento; padrão espaço.

Retorno

String com o comprimento definido, ou vazia para nLen não positivo.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed567()
    // Preenchimento visivel, sem alterar dados.
    ConOut(PadR("AB",6,"-"))
    ConOut(cValToChar(Len(PadR("AB",6,"-"))))
Return Nil
Resultado esperado

Resultado: AB----; tamanho 6. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir comprimento antes de preencher identificadores: truncamento pode perder informação. Definir política de encoding; formatação não valida chave ou campo de negócio.
  • 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. TOTVS. PadR. TDN. Consulta em 2026-10-27.
  2. Atilio. Exemplo 379; commit 7d275a7. 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