Sumário

Search

  1. Prefácio
  2. A Linguagem de Transformação
  3. Constantes
  4. Operadores
  5. Variáveis
  6. Datas
  7. Funções
  8. Criação de funções personalizadas
  9. Referência de API da Função Personalizada

Referência de Linguagem de Transformação

Referência de Linguagem de Transformação

REPLACESTR

REPLACESTR

Substitui caracteres em uma string por um único caractere, vários caracteres ou nenhum caractere. REPLACESTR pesquisa a string de entrada para todas as strings que você especifica e as substitui pela nova string especificada.

Sintaxe

REPLACESTR (
CaseFlag
,
InputString
,
OldString
1, [OldString2, ... OldStringN,]
NewString
)
A tabela a seguir descreve os argumentos para este comando:
Argumento
Requerido/
Opcional
Descrição
CaseFlag
Requerido
Deve ser um inteiro. Determina se os argumentos nessa função fazem distinção entre maiúsculas e minúsculas. Você pode inserir qualquer expressão de transformação válida.
Quando
CaseFlag
é um número diferente de 0, a função faz distinção entre maiúsculas e minúsculas.
Quando
CaseFlag
é um valor nulo, a função não faz distinção entre maiúsculas e minúsculas.
InputString
Requerido
Deve ser uma string de caractere. Passa os valores que você deseja pesquisar. Você pode inserir qualquer expressão de transformação válida. Se você passar um valor numérico, a função o converterá em uma string de caractere.
Se
InputString
estiver como NULL, REPLACESTR retornará o valor NULL.
OldString
Requerido
Deve ser uma string de caractere. A string que você deseja substituir. Você deve inserir pelo menos um argumento
OldString
. Você pode inserir um ou mais caracteres por argumento
OldString
. Você pode inserir qualquer expressão de transformação válida. Você também pode inserir um literal de texto anexado entre aspas simples, por exemplo, 'abc'.
Se você passar um valor numérico, a função o converterá em uma string de caractere.
Quando REPLACESTR contém vários argumentos
OldString
e um ou mais argumentos
OldString
é NULL ou vazio, REPLACESTR ignora o argumento
OldString
. Quando todos os argumentos
OldString
são NULL ou vazio, REPLACESTR retorna
InputString
.
A função substitui os caracteres nos argumentos
OldString
na ordem que eles aparecem na função. Por exemplo, se você inserir vários argumentos
OldString
, o primeiro argumento
OldString
terá precedência sobre o segundo argumento
OldString
e o segundo argumento
OldString
terá precedência sobre o terceiro argumento
OldString
. Quando REPLACESTR substituir uma string, ele coloca o cursor depois dos caracteres substituídos em
InputString
antes de pesquisar a próxima correspondência.
NewString
Requerido
Deve ser uma string de caractere. Você pode inserir um caractere, vários caracteres, uma string vazia ou NULL. Você pode inserir qualquer expressão de transformação válida.
Se
NewString
for NULL ou vazio, REPLACESTR removerá todas as ocorrências de
OldString
em
InputString
.

Valor de Retorno

String.
String vazia se REPLACESTR remover todos os caracteres em
InputString
.
NULL se
InputString
for NULL.
InputString
se todos os argumentos
OldString
forem NULL ou vazios.

Exemplos

A seguinte expressão remove as aspas duplas e as duas strings de texto diferentes dos dados de log da Web de cada linha na porta WEBLOG:
REPLACESTR( 1, WEBLOG, '"', 'GET ', ' HTTP/1.1', NULL )
WEBLOG
RETURN VALUE
"GET /news/index.html HTTP/1.1"
/news/index.html
"GET /companyinfo/index.html HTTP/1.1"
/companyinfo/index.html
GET /companyinfo/index.html
/companyinfo/index.html
GET
[empty string]
NULL
NULL
A seguinte expressão altera o título de determinados valores de cada linha na porta TITLE:
REPLACESTR ( 1, TITLE, 'rs.', 'iss', 's.' )
TITLE
RETURN VALUE
Mrs.
Ms.
Miss
Ms.
Mr.
Mr.
MRS.
MRS.
A seguinte expressão altera o título de determinados valores de cada linha na porta TITLE:
REPLACESTR ( 0, TITLE, 'rs.', 'iss', 's.' )
TITLE
RETURN VALUE
Mrs.
Ms.
MRS.
Ms.
A seguinte expressão mostra como a função REPLACESTR substitui vários argumentos
OldString
de cada linha na porta INPUT:
REPLACESTR ( 1, INPUT, 'ab', 'bc', '*' )
INPUT
RETURN VALUE
abc
*c
abbc
**
abbbbc
*bb*
bc
*
A seguinte expressão mostra como a função REPLACESTR substitui vários argumentos
OldString
de cada linha na porta INPUT:
REPLACESTR ( 1, INPUT, 'ab', 'bc', 'b' )
INPUT
RETURN VALUE
ab
b
bc
b
abc
bc
abbc
bb
abbcc
bbc
Quando quiser usar uma aspa simples (') em
OldString
ou
NewString
, você deve usar a função CHR. Use as funções CHR e CONCAT para concatenar uma aspa simples em uma string. A aspa simples é o único caractere que não pode ser usado dentro de um literal de string. Considere o seguinte exemplo:
CONCAT( 'Joan', CONCAT( CHR(39), 's car' ))
O valor retornado é:
Joan's car
A seguinte expressão altera uma string que inclui a aspa simples, de cada linha na porta INPUT:
REPLACESTR ( 1, INPUT, CONCAT('it', CONCAT(CHR(39), 's' )), 'its' )
INPUT
RETURN VALUE
it's
its
mit's
mits
mits
mits
mits'
mits'