_ADVPL_LOG_decodeUTF8

Realizar a conversão do conteúdo de um texto do encode UTF-8 para um encode de destino definido, sendo que o padrão assumido, quando não for informado é CP1252.

Caso o conteúdo de origem informado não esteja no formato UTF-8, não será realizada a conversão, e o mesmo texto enviado será retornado sem qualquer alteração

Sintaxe

_ADVPL_LOG_decodeUTF8( < cText >, [ < cNewEncode > ] )

Parâmetros

Nome

Tipo

Obrigatório?

Descrição

cText

CHAR

Sim

Texto de origem que está com conteúdo formatado em encode UTF-8 para ter seu conteúdo convertido para um novo encode.

cNewEncode

CHAR

Não

Valor do encode de destino para converter o conteúdo de cText. Caso não seja informado, será assumido como padrão o encode CP1252.

Para mais informações dos valores de ENCODE aceitos aqui acesse a documentação da função DecodeUTF8.

Retorno

Tipo	Descrição
`CHAR`	Conteúdo do texto cText convertido para o novo encode informado. Se novo encode for omitido, a função assume como CP1252.

Exemplo

#---------------------------------------#
 FUNCTION LOG_decodeUTF8_test()
#---------------------------------------#
  DEFINE l_text    CHAR(100)

  LET l_text = "Texto com acentuação para teste de mudança de conteúdo de UTF-8 para novo conteúdo."

  LET l_text = _ADVPL_LOG_encodeUTF8(l_text)
  CALL conout("TEXTO em UTF-8: "||l_text CLIPPED)

  #Foi realizada conversão para UTF-8 anteriormente para comprovar que após o DECODE o valor original do texto é retornado.
  LET l_text = _ADVPL_LOG_decodeUTF8(l_text)
  CALL conout("TEXTO em novo ENCODE: "||l_text CLIPPED)
END FUNCTION

Informações

Fontes: funcoes_genericas.prw

Veja também

_ADVPL_LOG_encodeUTF8

Páginas filhas