Substr

Faz a extração de uma parte de uma determinada string.

Sintaxe

Substr(s1, n1, n2 )

Parâmetros

Parâmetro

Descrição

s1

A string de origem.

n1

A posição da string s1 para começar a extrair.

Sen1 for menor que um, a função assume a posição do primeiro caractere. Se n1 for superior ao comprimento de s1, a função assume a posição do último caractere.

n2

O número de caracteres a serem extraídos.

Se n2 for menor ou igual a 0, FormCalc retornará uma string vazia. Se n1 + n2 for maior do que o comprimento de s1, a função retorna uma substring que começa na posição n1 ao final de s1.

Exemplos

As expressões a seguir são exemplos de uso da função Substr:

Expressão

Retorna

Substr("ABCDEFG", 3, 4)

CDEF

Substr(3214, 2, 1)

2

Substr(Last_Name[0], 1, 3)

Retorna os três primeiros caracteres da primeira ocorrência de Last_Name.

Substr("ABCDEFG", 5, 0)

""

Substr("21 Waterloo St.", 4, 5)

Water