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

Left

Left(cText,nCount) -> cPrefix

Extrai um prefixo de uma string.

LeftAdvPL
01 · VISÃO GERAL

Visão geral

nCount define quantas posições copiar à esquerda. Se exceder o tamanho, retorna a string inteira; se for zero ou negativo, retorna vazio. O exemplo usa ASCII para evitar presumir contagem de caracteres Unicode no encoding do ambiente. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

Left(cText,nCount) -> cPrefix

Parâmetros

cText
CaractereObrigatório

Texto de entrada.

nCount
NuméricoObrigatório

Quantidade de posições.

Retorno

String com o prefixo ou vazia.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed505()
    // Limites de extracao explicitos.
    ConOut(Left("ED0102",4))
    ConOut("["+Left("ED01",0)+"]")
Return Nil
Resultado esperado

Exibe ED01 e []. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Validar tipo e tamanho antes de usar o prefixo como chave.
  • 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. Left. TDN. 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