Guia de Referência do Net.Data

Funções de Palavras

Estas funções complementam as funções de cadeia e modificam palavras ou conjuntos de palavras. O Net.Data interpreta uma palavra como sendo uma cadeia com espaço delimitado ou uma cadeia com espaços em ambos os lados. A seguir são apresentados alguns exemplos:

Valor de cadeia	Número de palavras
um dois três	3
um, dois, três	5
Parte 2: Crescimento de Vendas da Internet	5

• DTW_DELWORD
• DTW_SUBWORD
• DTW_WORD
• DTW_WORDINDEX
• DTW_WORDLENGTH
• DTW_WORDPOS
• DTW_WORDS

DTW_DELWORD

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. Palavras são eliminadas da palavra n para o número de palavras especificado pelo comprimento.

Sintaxe

• @DTW_DELWORD(entradaCadeia, n, comprimento, saídaCadeia)
• @DTW_DELWORD(entradaCadeia, n, saídaCadeia)
• @DTW_rDELWORD(entradaCadeia, n, comprimento)
• @DTW_rDELWORD(entradaCadeia, n

Parâmetros

Tabela 33. Parâmetros DTW_DELWORD

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
inteiro	n	IN	A posição da primeira palavra a ser eliminada.
inteiro	comprimento	IN	O número de palavras a serem eliminadas. O padrão é eliminar todas as palavras de n até o final da entradaCadeia. Parâmetro opcional.
cadeia	saídaCadeia	OUT	Variável que contém o formato modificado de entradaCadeia.

Exemplos

Exemplo 1:

@DTW_DELWORD("Este é o momento", "5", result)

• Retorna: resultado = "Agora é o momento"

Exemplo 2:

@DTW_DELWORD("Agora é o momento", "2", result)

• Retorna: resultado = "Agora"

Exemplo 3:

@DTW_DELWORD("Agora é o
momento", "2", "2", resultado)

• Retorna: resultado = "Agora momento"

Exemplo 4:

@DTW_rDELWORD("Agora é o momento.", "3")

• Retorna: "Agora é"

DTW_SUBWORD

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. A subcadeia começa na palavra n e continua para o número de palavras especificado pelo comprimento.

Sintaxe

• @DTW_SUBWORD(entradaCadeia, n, comprimento, saídaCadeia)
• @DTW_SUBWORD(entradaCadeia, n, saídaCadeia)
• @DTW_rSUBWORD(entradaCadeia, n, comprimento)
• @DTW_rSUBWORD(entradaCadeia, n)

Parâmetros

Tabela 34. Parâmetros DTW_SUBWORD

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
inteiro	n	IN	A posição da primeira palavra da subcadeia. Nulo será retornado se este valor for maior que o número de palavras na entradaCadeia.
inteiro	comprimento	IN	O número de palavras na subcadeia. Caso este valor seja maior que o número de palavras de n até o final da entradaCadeia, todas as palavras até o final de entradaCadeia serão retornadas. O padrão é retornar todas as palavras de n até o final de entradaCadeia.
cadeia	saídaCadeia	OUT	Variável que contém uma subcadeia de entradaCadeia especificada por n e comprimento.

Exemplos

Exemplo 1:

@DTW_SUBWORD("Agora é o
momento", "5", resultado)

• Retorna: resultado = ""

Exemplo 2:

@DTW_SUBWORD("Agora é o
momento", "2", resultado)

• Retorna: resultado = "é o momento"

Exemplo 3:

@DTW_SUBWORD(Agora é o
momento", "2", "2", resultado)

• Retorna: resultado = "é o "

Exemplo 4:

@DTW_rSUBWORD("Agora é o momento", "3")

• Retorna: "o momento"

DTW_WORD

Objetivo

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

Retorna uma única palavra de uma posição especificada da cadeia de entrada.

Sintaxe

• @DTW_WORD(entradaCadeia, n, saídaCadeia)
• @DTW_rWORD(entradaCadeia, n)

Parâmetros

Tabela 35. Parâmetros DTW_WORD

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
inteiro	n	IN	A posição da palavra a ser retornada. Caso este valor seja maior que o número de palavras em entradaCadeia, nulo é retornado.
cadeia	saídaCadeia	OUT	Variável que contém a palavra na posição da palavra n.

Exemplos

Exemplo 1:

@DTW_WORD("Agora é o
momento", "3", resultado)

• Retorna: resultado = "o"

Exemplo 2:

@DTW_WORD("Agora é o momento",
"5", resultado)

• Retorna: resultado = ""

Exemplo 3:

@DTW_rWORD("Agora é o
momento", "4")

• Retorna: "momento"

DTW_WORDINDEX

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 de caractere do primeiro caractere na enésima palavra da cadeia de entrada.

Sintaxe

• @DTW_WORDINDEX(entradaCadeia, n, saídaCadeia)
• @DTW_rWORDINDEX(entradaCadeia, n)

Parâmetros

Tabela 36. Parâmetros DTW_WORDINDEX

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
inteiro	n	IN	A posição da palavra a ser indexada. Caso este valor seja maior que o número de palavras na cadeia de entrada, 0 é retornado.
cadeia	saídaCadeia	OUT	Variável que contém a posição de caractere da enésima palavra da entradaCadeia.

Exemplos

Exemplo 1:

@DTW_WORDINDEX("Agora é o momento", "3", resultado)

• Retorna: resultado = "8"

Exemplo 2:

@DTW_WORDINDEX("Agora é o momento", "6", resultado)

• Retorna: resultado = "0"

Exemplo 3:

@DTW_rWORDINDEX("Agora é o momento", "2")

• Retorna: "5"

DTW_WORDLENGTH

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 da enésima palavra da cadeia de entrada.

Sintaxe

• @DTW_WORDLENGTH(entradaCadeia, n, saídaCadeia)
• @DTW_rWORDLENGTH(entradaCadeia, n)

Parâmetros

Tabela 37. Parâmetros DTW_WORDLENGTH

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
inteiro	n	IN	A posição da palavra cujo comprimento você deseja saber. Caso este valor seja maior que o número de palavras na cadeia de entrda, 0 é retornado.
cadeia	saídaCadeia	OUT	Variável que contém o comprimento da enésima palavra na entradaCadeia.

Exemplos

Exemplo 1:

@DTW_WORDLENGTH("Agora é o momento", "1", resultado)

• Retorna: resultado = "3"

Exemplo 2:

@DTW_rWORDLENGTH("Agora é o momento", "6")

• Retorna: "0"

DTW_WORDPOS

Objetivo

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

Retorna o número da palavra da primeira ocorrência de uma cadeia em outra cadeia. Para comparações, espaços em branco múltiplos são tratados como um único espaço em branco. A comparação é sensível à maiúsculas/minúsculas.

Sintaxe

• @DTW_WORDPOS(entradaCadeia1, entradaCadeia2, n, saídaCadeia)
• @DTW_WORDPOS(entradaCadeia1, entradaCadeia2, saídaCadeia)
• @DTW_rWORDPOS(entradaCadeia1, entradaCadeia2, n)
• @DTW_rWORDPOS(entradaCadeia1, entradaCadeia2)

Parâmetros

Tabela 38. Parâmetros DTW_WORDPOS

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia1	IN	Variável ou cadeia literal.
cadeia	entradaCadeia2	IN	Variável ou cadeia literal a ser procurada.
inteiro	n	IN	A posição da palavra na entradaCadeia2 na qual se inicia a busca. Caso este valor seja maior que o número de palavras em entradaCadeia2, 0 é retornado. O padrão é procurar a partir do começo de entradaCadeia2.
cadeia	saídaCadeia	OUT	A posição de palavra da entradaCadeia1 na entradaCadeia2.

Exemplos

Exemplo 1:

@DTW_WORDPOS("the", "Agora é o momento", resultado)

• Retorna: resultado = "3"

Exemplo 2:

@DTW_WORDPOS("O", "Agora é o momento", resultado)

• Retorna: resultado = "0"

Exemplo 3:

@DTW_WORDPOS("O", "Agora é o momento", "5", resultado)

• Retorna: resultado = "0"

Exemplo 4:

@DTW_WORDPOS("é  o",
"Agora é     o momento", resultado)

• Retorna: resultado = " 2"

Exemplo 5:

@DTW_rWORDPOS("ser",
"Ser ou não ser", "3")

• Retorna: "6"

DTW_WORDS

Objetivo

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

Retorna o número de palavras em uma subcadeia.

Sintaxe

• @DTW_WORDS(entradaCadeia, saídaCadeia)
• @DTW_rWORDS(entradaCadeia)

Parâmetros

Tabela 39. Parâmetros DTW_WORDS

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	entradaCadeia	IN	Variável ou cadeia literal.
cadeia	saídaCadeia	OUT	Variável que contém o número de palavras em entradaCadeia.

Exemplos

Exemplo 1:

@DTW_WORDS("Agora é o momento", resultado)

• Retorna: resultado = "4"

Exemplo 2:

@DTW_rWORDS("
")

• Retorna: "0"