Guia de Referência do Net.Data

Funções de Cadeia

Segue abaixo o conjunto de funções padrões de cadeia aceitas pelo Net.Data:

• DTW_ASSIGN

• DTW_CONCAT

• DTW_DELSTR

• DTW_INSERT

• DTW_LASTPOS

• DTW_LENGTH

• DTW_LOWERCASE

• DTW_POS

• DTW_REVERSE

• DTW_STRIP

• DTW_SUBSTR

• DTW_TRANSLATE

• DTW_UPPERCASE

Attention: O Net.Data não suporta a manipulação de cadeias de caracteres de múltiplos bytes em nenhuma plataforma exceto OS/400.

DTW_ASSIGN

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Atribui o valor de uma variável de entrada a uma variável de saída. Como $(Vn), onde n é um número, não é reconhecido fora do bloco REPORT, você pode utilizar esta função para atribuir o valor a uma variável diferente, caso deseje referenciar o valor fora do bloco ROW.

Esta função também pode ser utilizada para alterar uma variável em uma macro. Por exemplo, você pode alterar DATABASE para um bloco HTML. (Veja o exemplo na seção DATABASE.)

Sintaxe

• @DTW_ASSIGN(saídaCadeia, entradaCadeia)

Parâmetros

Tabela 20. Parâmetros DTW_ASSIGN

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	saídaCadeia	OUT	Variável que contém a cadeia literal idêntica à entradaCadeia.
cadeia	entradaCadeia	IN	Variável ou cadeia literal.

Exemplos

Exemplo 1:

@DTW_ASSIGN(RC, "0")

• Define RC como "0".

Exemplo 2:

@DTW_ASSIGN(cadeia1, cadeia2)

• Define cadeia1 com o valor da cadeia2.

DTW_CONCAT

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Concateneia duas cadeias.

Sintaxe

• @DTW_CONCAT(entradaCadeia1, entradaCadeia2, saídaCadeia)
• @DTW_rCONCAT(entradaCadeia1, entradaCadeia2)

Parâmetros

Tabela 21. Parâmetros DTW_CONCAT

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia1	IN	Variável ou cadeia literal.
cadeia	entradaCadeia2	IN	Variável ou cadeia literal.
cadeia	saídaCadeia	OUT	Variável que contém uma cadeia de 'entradaCadeia1 + entradaCadeia2'.

Exemplos

Exemplo 1:

@DTW_CONCAT("Este", " é um teste.", resultado)

• Retorna: resultado = "Este é um teste."

Exemplo 2:

@DTW_CONCAT(cadeia1, "José!", resultado)

• Entrada: cadeia1 = "Sem saída "
• Retorna: resultado = "Sem saída José! "

Exemplo 3:

@DTW_rCONCAT("Isto", " é um teste.")

• Retorna: "Isto é um teste."

DTW_DELSTR

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Elimina uma subcadeia da cadeia especificada a partir do enésimo caractere para caracteres de comprimento.

Sintaxe

• @DTW_DELSTR(entradaCadeia, n, comprimento, saídaCadeia)
• @DTW_DELSTR(entradaCadeia, n, saídaCadeia)
• @DTW_rDELSTR(entradaCadeia, n, comprimento)
• @DTW_rDELSTR(entradaCadeia, n)

Parâmetros

Tabela 22. Parâmetros DTW_DELSTR

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
inteiro	n	IN	A posição do caractere onde a subcadeia a ser eliminada começa. Se n for maior que o comprimento da entradaCadeia, então saídaCadeia será definido com o valor de entradaCadeia.
inteiro	comprimento	OUT	O comprimento da subcadeia a ser eliminada. O padrão é eliminar todos os caracteres até o final da entradaCadeia.
cadeia	saídaCadeia	OUT	Variável que contém o formato modificado de entradaCadeia.

Exemplos

Exemplo 1:

@DTW_DELSTR("abcde", "3",
"2", resultado)

• Retorna: resultado = "abe"

Exemplo 2:

@DTW_rDELSTR("abcde","6","1")

• Retorna: "abcde"

DTW_INSERT

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Insere uma cadeia em outra cadeia começando após o enésimo caractere.

Sintaxe

• @DTW_INSERT(entradaCadeia1, entradaCadeia2, n, comprimento, preenchimento, saídaCadeia)
• @DTW_INSERT(entradaCadeia1, entradaCadeia2, n, comprimento, saídaCadeia)
• @DTW_INSERT(entradaCadeia1, entradaCadeia2, n, saídaCadeia)
• @DTW_INSERT(entradaCadeia1, entradaCadeia2, saídaCadeia)
• @DTW_rINSERT(entradaCadeia1, entradaCadeia2, n, comprimento, preenchimento)
• @DTW_rINSERT(entradaCadeia1, entradaCadeia2, n, comprimento)
• @DTW_rINSERT(entradaCadeia1, entradaCadeia2, n)
• @DTW_rINSERT(entradaCadeia1, entradaCadeia2)

Parâmetros

Tabela 23. Parâmetros DTW_INSERT

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia1	IN	Variável ou cadeia literal a ser inserida na entradaCadeia2.
cadeia	entradaCadeia2	IN	Variável ou cadeia literal.
inteiro	n	IN	A posição do caractere na entradaCadeia2 após a qual entradaCadeia1 será inserido. Caso n seja maior que o comprimento de entradaCadeia2, este é preenchido com o caractere de preenchimento, até que possua caracteres suficientes. O padrão é inserir no começo de entradaCadeia2.
inteiro	comprimento	IN	O número de caracteres de entradaCadeia1 a ser inserido. A cadeia é preenchida com o caractere de preenchimento, caso este parâmetro seja maior que o comprimento de entradaCadeia1. O padrão é o comprimento de entradaCadeia1.
inteiro	preenchimento	IN	O caractere de preenchimento utilizado conforme descrito para n e comprimento. O caractere de preenchimento padrão é um espaço em branco.
cadeia	saídaCadeia	OUT	Variável que contém a entradaCadeia2 modificada através da inserção de parte ou toda a entradaCadeia1.

Exemplos

Exemplo 1:

@DTW_INSERT("123", "abc", resultado)

• Retorna: resultado = "123abc"

Exemplo 2:

@DTW_INSERT("123", "abc", "5", resultado)

• Retorna: resultado = "abc 123"

Exemplo 3:

@DTW_INSERT("123", "abc", "5", "6", resultado)

• Retorna: resultado = "abc 123"

Exemplo 4:

@DTW_INSERT("123", "abc", "5", "6", "_", resultado)

• Retorna: resultado = "abc__123___"

Exemplo 5:

@DTW_rINSERT("123","abc","5","6","+")

• Retorna: "abc++123+++"

DTW_LASTPOS

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Retorna a posição da última ocorrência de uma cadeia em outra cadeia, começando a partir do enésimo caractere de trás para frente.

Sintaxe

• @DTW_LASTPOS(entradaCadeia1, entradaCadeia2, n, posição)
• @DTW_LASTPOS(entradaCadeia1, entradaCadeia2, posição)
• @DTW_rLASTPOS(entradaCadeia1, entradaCadeia2, n)
• @DTW_rLASTPOS(entradaCadeia1, entradaCadeia2)

Parâmetros

Tabela 24. Parâmetros DTW_LASTPOS

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia1	IN	Variável ou cadeia literal procurada na entradaCadeia2.
cadeia	entradaCadeia2	IN	Variável ou cadeia literal.
inteiro	n	IN	A posição de caractere na entradaCadeia2 na qual se inicia a busca para entradaCadeia1. O padrão é iniciar a busca no primeiro caractere.
inteiro	posição	OUT	A posição da última ocorrência da entradaCadeia1 na entradaCadeia2. Caso nenhuma ocorrência seja encontrada, 0 é retornado.

Exemplos

Exemplo 1:

@DTW_LASTPOS(" ", "abc def ghi", resultado)

• Retorna: resultado = "8"

Exemplo 2:

@DTW_LASTPOS(" ", "abc def ghi", "10", resultado)

• Retorna: resultado = "8"

Exemplo 3:

@DTW_rLASTPOS(" ","abc def ghi","7")

• Retorna: "4"

DTW_LENGTH

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Retorna o comprimento de uma cadeia.

Sintaxe

• @DTW_LENGTH(entradaCadeia, comprimento)
• @DTW_rLENGTH(entradaCadeia)

Parâmetros

Tabela 25. Parâmetros DTW_LENGTH

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
inteiro	comprimento	OUT	Símbolo contendo o comprimento de entradaCadeia.

Exemplos

Exemplo 1:

@DTW_LENGTH("abcdefgh", resultado)

• Retorna: resultado = "8"

Exemplo 2:

@DTW_rLENGTH("")

• Retorna: "0"

DTW_LOWERCASE

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Retorna uma cadeia com todos os caracteres em minúsculas.

Sintaxe

• @DTW_LOWERCASE(entradaCadeia, saídaCadeia)
• @DTW_rLOWERCASE(entradaCadeia)
• @DTW_mLOWERCASE(multCadeia1, multCadeia2, ..., multCadeian)

Parâmetros

Tabela 26. Parâmetros DTW_LOWERCASE

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal com caracteres em minúsculas ou maiúsculas.
cadeia	saídaCadeia	OUT	Variável que contém a entradaCadeia com todos os caracteres em minúsculas.
cadeia	multCadeia	INOUT	Na entrada: Variável que contém uma cadeia. Na saída: Variável que contém a cadeia de entrada convertida para maiúsculas.

Exemplos

Exemplo 1:

@DTW_LOWERCASE("Isto", stringOut)

• Retorna: saídaCadeia = "isto"

Exemplo 2:

@DTW_rLOWERCASE(cadeia1)

• Entrada: cadeia1 = "Web Pages"
• Retorna: "web pages"

Exemplo 3:

@DTW_mLOWERCASE(cadeia1,
cadeia2, cadeia3)

• Entrada: cadeia1 = "THIS", cadeia2 = "IS", cadeia3 = "LOWERCASE"
• Retorna: cadeia1 = "this", cadeia2 = "is", cadeia3 = "lowercase"

DTW_POS

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Retorna a posição da primeira ocorrência de uma cadeia em outra cadeia.

Sintaxe

• @DTW_POS(entradaCadeia1, entradaCadeia2, n, nSaída)
• @DTW_POS(entradaCadeia1, entradaCadeia2, nSaída)
• @DTW_rPOS(entradaCadeia1, entradaCadeia2, n)
• @DTW_rPOS(entradaCadeia1, entradaCadeia2)

Parâmetros

Tabela 27. Parâmetros DTW_POS

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia1	IN	Variável ou cadeia literal a ser procurada.
cadeia	entradaCadeia2	IN	Variável ou cadeia literal a ser procurada
inteiro	n	IN	A posição de caractere na entradaCadeia2 na qual se inicia a busca. O valor padrão é iniciar a busca no primeiro caractere da entradaCadeia2.
inteiro	nSaída	OUT	Variável que contém a posição da primeira ocorrência de entradaCadeia1 na entradaCadeia2. Caso nenhuma ocorrência seja encontrada, 0 é retornado.

Exemplos

Exemplo 1:

@DTW_POS("dia", "Sábado", resultado)

• Retorna: resultado = "6"

Exemplo 2:

@DTW_POS("a", "Sábado", "3", resultado)

• Retorna: resultado = "7"

Exemplo 3:

@DTW_rPOS(" ","abc def ghi","5")

• Retorna: "8"

DTW_REVERSE

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Inverte a cadeia de entrada.

Sintaxe

• @DTW_REVERSE(entradaCadeia, saídaCadeia)
• @DTW_rREVERSE(entradaCadeia)

Parâmetros

Tabela 28. Parâmetros DTW_REVERSE

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal a ser invertida.
cadeia	saídaCadeia	OUT	Variável que contém o formato invertido da entradaCadeia.

Exemplos

Exemplo 1:

@DTW_REVERSE("Isto é isto.", resultado)

• Retorna: resultado = ".ti si sihT"

Exemplo 2:

@DTW_rREVERSE(cadeia1)

• Entrada: cadeia1 = "reversed"
• Retorna: "desrever"

DTW_STRIP

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Remove espaços em branco à esquerda, à direita ou ambos da cadeia de entrada.

Sintaxe

• @DTW_STRIP(entradaCadeia, opção, saídaCadeia)
• @DTW_STRIP(entradaCadeia, saídaCadeia)
• @DTW_rSTRIP(entradaCadeia, opção)
• @DTW_rSTRIP(entradaCadeia)

Parâmetros

Tabela 29. Parâmetros DTW_STRIP

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
cadeia	opção	IN	Especifica quais espaços em branco devem ser removidas da entradaCadeia. O padrão é B. B ou b: remove espaços em branco à esquerda e à direita L ou l: remove somente espaços em branco à esquerda T ou t: remove somente espaços em branco à direita
cadeia	saídaCadeia	OUT	Variável que contém a entradaCadeia com os espaços em branco removidos conforme especificado pela opção.

Exemplos

Exemplo 1:

@DTW_STRIP("  dia ",
resultado)

• Retorna: resultado = "dia"

Exemplo 2:

@DTW_STRIP("  dia ", "T",
resultado)

• Retorna: resultado = "dia"

Exemplo 3:

@DTW_rSTRIP("  um dia  ","L")

• Retorna: "um dia "

DTW_SUBSTR

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Retorna uma subcadeia da cadeia de entrada, com caracteres opcionais de preenchimento.

Sintaxe

• @DTW_SUBSTR(entradaCadeia, n, comprimento, preenchimento, saídaCadeia)
• @DTW_SUBSTR(entradaCadeia, n, comprimento, saídaCadeia)
• @DTW_SUBSTR(entradaCadeia, n, saídaCadeia)
• @DTW_rSUBSTR(entradaCadeia, n, comprimento, preenchimento)
• @DTW_rSUBSTR(entradaCadeia, n, comprimento)
• @DTW_rSUBSTR(entradaCadeia, n)

Parâmetros

Tabela 30. Parâmetros DTW_SUBSTR

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal a ser procurada.
inteiro	n	IN	A posição de caractere na qual a subcadeia começa. O padrão é iniciar no começo da entradaCadeia.
inteiro	comprimento	IN	O número de caracteres da subcadeia. O padrão é o resto da cadeia.
cadeia	preenchimento	IN	O caractere de preenchimento utilizado caso n seja maior que o comprimento da entradaCadeia ou se o comprimento for além do final da entradaCadeia. O padrão é um espaço em branco.
cadeia	saídaCadeia	OUT	Variável que contém uma subcadeia de entradaCadeia.

Exemplos

Exemplo 1:

@DTW_SUBSTR("abc", "2", resultado)

• Retorna: resultado = "bc"

Exemplo 2:

@DTW_SUBSTR("abc", "2", "4", resultado)

• Retorna: resultado = "bc"

Exemplo 3:

@DTW_SUBSTR("abc", "2", "4", ".", resultado )

• Retorna: resultado = "bc.."

Exemplo 4:

@DTW_rSUBSTR("abc", "2", "6", ".")

• Retorna: "bc...."

DTW_TRANSLATE

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Converte caracteres na cadeia de entrada utilizando tabelas de conversão de saída e entrada, tabelaI e tabelaO. Caso não haja tabelaI, tabelaO e preenchimento na lista de parâmetros, a entradaCadeia é convertida para maiúsculas. Se a tabelaI a a tabelao estiverem na lista, mas não houver preenchimento, cada caractere na cadeia de entrada é pesquisado na tabelaI e convertido para o caractere correspondente na tabelaO. Se o preenchimento estiver na lista de parâmetros, o comprimento de entradaCadeia e de saídaCadeia será o mesmo. O caractere de preenchimento é utilizado se um caractere na cadeia de entrada não estiver na tabelaI. As tabelas de conversão podem ser de qualquer comprimento. Se nenhuma tabela de conversão for fornecida, a cadeia de entrada é convertida para maiúsculas.

Sintaxe

• @DTW_TRANSLATE(entradaCadeia, tabelaO, tabelaI, preenchimento, saídaCadeia)
• @DTW_TRANSLATE(entradaCadeia, tabelaO, tabelaI, saídaCadeia)
• @DTW_TRANSLATE(entradaCadeia, tabelaO, saídaCadeia)
• @DTW_TRANSLATE(entradaCadeia, saídaCadeia)
• @DTW_rTRANSLATE(entradaCadeia, tabelaO, tabelaI, preenchimento)
• @DTW_rTRANSLATE(entradaCadeia, tabelaO, tabelaI)
• @DTW_rTRANSLATE(entradaCadeia, tabelaO)
• @DTW_rTRANSLATE(entradaCadeia)

Parâmetros

Tabela 31. Parâmetros DTW_TRANSLATE

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
cadeia	tabelaO	IN	Variável ou cadeia literal utilizada como tabela de conversão. Utilize nulo ("") para especificar a tabelaI ou preenchimento; caso contrário, este parâmetro é opcional.
cadeia	tabelaI	IN	Variável ou cadeia literal procurada na entradaCadeia. Utilize nulo ("") para especificar o preenchimento; caso contrário, este parâmetro é opcional.
cadeia	preenchimento	IN	O caractere de preenchimento a ser utilizado. O padrão é um espaço em branco.
cadeia	saídaCadeia	OUT	Variável que contém uma subcadeia de entradaCadeia.

Exemplos

Exemplo 1:

@DTW_TRANSLATE("abbc", resultado)

• Retorna: resultado = "ABBC"

Exemplo 2:

@DTW_TRANSLATE("abbc", "R", "bc", resultado)

• Retorna: resultado = "aRR "

Exemplo 3:

@DTW_rTRANSLATE("abcdef", "12", "abcd", ".")

• Retorna: "12..ef"

Exemplo 4:

@DTW_rTRANSLATE("abbc", "", "", "")

• Retorna: "abbc"

DTW_UPPERCASE

Objetivo

AIX	HP-UX	OS/2	OS/390	OS/400	SCO	SUN	Win NT
X	X	X	X	X	X	X	X

Retorna uma cadeia com caracteres em minúsculas.

Sintaxe

• @DTW_UPPERCASE(entradaCadeia, saídaCadeia)
• @DTW_rUPPERCASE(entradaCadeia)
• @DTW_mUPPERCASE(multCadeia1, multCadeia2, ..., multCadeian)

Parâmetros

Tabela 32. Parâmetros DTW_UPPERCASE

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal com caracteres em minúsculas ou maiúsculas.
cadeia	saídaCadeia	OUT	Variável que contém a entradaCadeia com todos os caracteres em maiúsculas.
cadeia	multCadeia	INOUT	Na entrada: Variável que contém uma cadeia. Na saída: Variável contendo a cadeia de entrada com cada caractere de aspa simples (') substituído por dois caracteres de aspa simples.

Exemplos

Exemplo 1:

@DTW_UPPERCASE("Test", resultado)

• Retorna: resultado = "TEST"

Exemplo 2:

@DTW_rUPPERCASE(cadeia1)

• Entrada: cadeia1 = "Web pages"
• Retorna: "WEB PAGES"

Exemplo 3:

@DTW_mUPPERCASE(cadeia1,
cadeia2, cadeia3)

• Entrada: cadeia1 = "This", cadeia2 = "is", cadeia3 = "upper case"
• Retorna: cadeia1 = "THIS", cadeia2 = "IS", cadeia3 = "UPPER CASE"