SUBSTR()

Propósito

Extrair parte de uma cadeia de caracteres.

Sintaxe

SUBSTR (<exp.C>, <exp.N1>, <exp.N2>)

Argumentos

<exp.C>

representa uma cadeia de caracteres da qual será extraída uma subcadeia.

<exp.N1>

representa a posição inicial em <exp.C> para extração. Se for um valor positivo, refere-se ao caractere mais a esquerda de <exp.C>. Se for um valor negativo refere-se ao caractere mais a direita de <exp.C>. Se for igual a 0 (zero), SUBSTR() retorna uma cadeia vazia ("").

<exp.N2>

representa a posição final em <exp.C> para extração. Se maior que a quantidade de caracteres existentes a partir de <exp.N1>, a extração será até o fim de <exp.C> a partir de <exp.N1>.

Utilização

Retorna uma cadeia de caracteres que corresponde a uma subcadeia de <exp.C>. Utilizada para o tratamento de cadeia de caracteres e está relacionada com as funções LEFT () e RIGHT (), que também extraem subcadeias de uma cadeia de caracteres.

Exemplos

O exemplo a seguir mostra-nos a utilização desta função.

var_nom = "João Carlos da Silva Mendes"

? SUBSTR(var_nom,1,5)             && Exibirá "João "

? SUBSTR(var_nom,-6,6)             && Exibirá "Mendes"

? SUBSTR(var_nom,RAT(" ",var_nom),50)     && Exibirá " Mendes"

? SUBSTR(var_nom,0,70)             && Exibirá ""

Consulte

AT(), LEN(), STR(), STRCOUNT(), STRTRAN() e STUFF().

<exp.C>	representa uma cadeia de caracteres da qual será extraída uma subcadeia.
<exp.N1>	representa a posição inicial em <exp.C> para extração. Se for um valor positivo, refere-se ao caractere mais a esquerda de <exp.C>. Se for um valor negativo refere-se ao caractere mais a direita de <exp.C>. Se for igual a 0 (zero), SUBSTR() retorna uma cadeia vazia ("").
<exp.N2>	representa a posição final em <exp.C> para extração. Se maior que a quantidade de caracteres existentes a partir de <exp.N1>, a extração será até o fim de <exp.C> a partir de <exp.N1>.