ExtractText() — MyAthus AthusScript

Extrai um trecho de texto usando expressão de seleção por linha, comando e ocorrência. Utilize a janela de configuração no DevStudio para ver todas as opções de extração.
Retorno: String

Sintaxe

ExtractText(texto [, linha [, comando [, ocorrencia]]])

Parâmetros

Parâmetro	Obrigatório	Descrição
`texto`	Sim	Texto de entrada.
`linha`	Não	Seletor de linha.
`comando`	Não	Comando de extração.
`ocorrencia`	Não	Índice da ocorrência desejada.

Exemplos

AthusScript

string $texto = 'Nota Fiscal Exemplo\r\n'
$texto = $texto + 'Número: 156.700 Série: 200\r\n'
$texto = $texto + 'Emitente:\r\n'
$texto = $texto + 'Empresa Emissora Ltda\r\n'
$texto = $texto + 'Emissão: 02/01/2025\r\n'
$texto = $texto + 'Vencimento: 10/01/2025\r\n'

// Extrair o número da nota:
string $numero = ExtractText($texto, 'StartsWith("Número:")', 'Substring(FIND(":")+1, FIND("Série")-1)')
// Linha que inicia com "Número:", extrair da posição do ":"+1 até "Série"-1

// Extrair a série:
string $serie = ExtractText($texto, 'StartsWith("Número:")', 'Substring(FIND("Série:")+6, END)')
// Linha que inicia com "Número:", extrair da posição do "Série:"+6 até fim da linha

// Extrair o emitente:
string $emitente = ExtractText($texto, 'StartsWith("Emitente:")+1')
// Selecionar uma linha após "Emitente:"

// Extrair a data da linha de emissão com RegEx:
string $emissao = ExtractText($texto, 'Contains("Emissão")', 'RegEx(\\d{2}/\\d{2}/\\d{4})')

Observações

A função ExtractText simplifica a extração de informações utilizando a lógica de Seleção de linha + Comando de Extração + Ocorrência, com expressões legíveis para buscar os dados através da posição relativa no texto. Também é possível extrair textos diretamente com a função RegEx().