FUNçãOEm revisão

Upper

Upper( <cString> )

Converte uma string para letras maiúsculas.

StringsNormalizaçãoTexto

01 · VISÃO GERAL

Visão geral

Upper() devolve uma string com os caracteres convertidos para maiúsculas. É útil para padronizar chaves textuais, comparações e filtros digitados por usuários.

02 · SINTAXE

Sintaxe

Upper( <cString> )

Parâmetros

cString

CaractereObrigatório

Texto que será convertido para maiúsculas.

03 · EXEMPLO PRÁTICO

Busca sem diferenciar caixa

User Function ExUpper()
    Local cFiltro := Upper("cliente")

    If Upper("Cliente Ativo") $ cFiltro
        MsgInfo("Encontrado")
    EndIf
Return

Resultado esperado

Upper() ajuda a padronizar textos antes de comparar.

BOAS PRÁTICAS

Use com Lower() para padronização textual.
Em comparações, aplique o mesmo critério nos dois lados.

ARMADILHAS COMUNS

Caracteres acentuados podem variar conforme configuração; valide no ambiente real.
Não confunda padronização de caixa com remoção de acentos ou tratamento fonético.

Conteúdos relacionados

REFERÊNCIAS

Programação em ADVPL Completo. Documentação oficial histórica de treinamento, seção 4.5.4, p. 45-50. Conteúdo resumido, revisado e exemplos adaptados.

Situação: Em revisão
Página criada em: 24/08/2026 às 23:20
Última revisão em: 24/08/2026 às 23:20
Idioma original: Português
Revisão: Usina.BR