Tempo de leitura: 1 minuto
A função SubStr retorna parte do conteúdo de uma string especificada, de acordo com a posição inicial deste conteúdo na string e a quantidade de caracteres que deverá ser retornada a partir daquele ponto(inclusive). Ela é também uma das funções de manipulação de string em ADVPL.
Sintaxe:
SubStr(cTexto,nPos,nQtd)
Parâmetro(s):
Retorno:
Observações:
- nPos inicia em 1;
- Se nPos for menor que 0(zero) ou maior do que o tamanho de cTexto, a função retornará uma string vazia;
- Se nQtd for menor ou igual a 0(zero), a função retornará uma string vazia;
- Se nQtd for passado vazia, será apresentado erro de sintaxe na compilação;
- Se nQtd for informado e for nula(Nil), dará erro de execução, com a mensagem: “argument #2 error, expected N->U”.
Exemplo de SubStr em ADVPL:
#include 'protheus.ch'
/*{Protheus.doc} User Function PSubStr
(Essa função tem por finalidade mostrar a função de Manipulação de String SubStr em ADVPL)
@type Function
@author Adilio Costa
@since 24/11/2023
@version Protheus 12.1.2210
@site https://www.protheusadvpl.com.br
@canal https://www.youtube.com/protheusadvpl
@instagram https://www.instagram.com/protheusadvpl
@Portal ProtheusAdvpl:https://hotmart.com/pt-br/marketplace/produtos/portal-protheusadvpl/O10336806O
@Post:SubStr
*/
User Function PSubStr()
Local cTexto := "Blog ProtheusAdvpl"
Local nPos := 6
Local nQtd := 8
Local cParteStr := ""
cParteStr := SubStr(cTexto,nPos,nQtd)
MsgInfo("Parte do Texto '"+cTexto+"':"+cParteStr,"Função SubStr")
Return
No exemplo acima nós utilizamos a função SubStr para obter parte do texto “Blog ProtheusAdvpl”, onde passamos para à função que retorne a partir da posição 6(nPos=6) 8 caracteres(nQtd=8), então a posição 6 é a letra “P” e retornando 8 caracteres temos a palavra “Protheus”.
É isso aí, finalizamos mais um post aqui no 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.
Link(s) de referência(s):
Link permanente
I used to be recommended this web site by my cousin. I’m no longer certain whether or not this submit is written by way of him as no one else recognise such specified about my trouble. You’re incredible! Thank you!