Formatando uma String Usando Especificador de Formatos com FormatStr em ADVPL

Adilio Costa 27 de setembro de 2025 Manipulação de String

Tempo de leitura: 1 minuto

A função FormatStr em ADVPL formata uma string passada como parâmetro usando especificadores de formatos(%c, %n,%d…) para serem substituídos por respectivos tipos de dados. Ela é uma das funções de manipulação de string em ADVPL.

FormatStr utilizar espeficicadores de formatos iguais ao da linguagem C.

Essa função é muito útil em situações onde queremos formatar string com vários tipos de dados sem precisar usar funções de conversões de tipos de dados.

Sintaxe:

FormatStr(cStr,aInfo)

Parâmetro(s):

Retorno:

Exemplo da função FormatStr em ADVPL:

#include 'protheus.ch'
/*{Protheus.doc} User Function fFormStr
    (Essa função tem por finalidade mostrar a função de Manipulação de String FormatStr em ADVPL)
    @type  Function
    @author Adilio Costa
    @since 26/09/2025
    @version 1.0
@?Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@?Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@?Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@?Conheça os Cursos e Formações do ProtheusAdvpl:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/

@Participe de nossas comunidades no WhatsApp:
-Comunidade Protheus Backoffice:https://chat.whatsapp.com/KMUIAjwZ6EZ6eAHsLkPTyb
-Comunidade Protheus-RH:https://chat.whatsapp.com/L5dUyAna6xU4ylG5DUgfOW
-Comunidade Protheus-Programação:https://chat.whatsapp.com/LsD6z0apdqKHlOz67bcaEn
-Comunidade Protheus-Framework:https://chat.whatsapp.com/BzUFpjaSnTC3vtsfa77jmG

|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|

*/
User Function fFormStr()

	Local dDataHoje   := Date()
    Local aInfo := {dDataHoje,2017}
	Local cStr := "A data de hoje é %d. O ProtheusAdvpl surgiu em %n."
	Local cStrForm  := FormatStr(cStr, aInfo)

	FWAlertInfo("A string '"+cStr+"' foi formatada para "+cStrForm,"Função FormatStr")




Return

É isso aí, finalizamos aqui o post aqui do Blog ProtheusAdvpl. Caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um e-mail para adiliocosta@protheusadvpl.com.br, até um próximo post, grande abraço e fica com Deus.