Propósito
Decompor uma cadeia de caracteres.
Sintaxe
WORD (<exp.C1>, <exp.C2>, <exp.N>)
Argumentos
<exp.C1> |
representa a cadeia de caracteres a ser decomposta. |
<exp.C2> |
representa o separador para decomposição. |
<exp.N> |
representa um FLAG para determinar a chamada da função. Pode ser 1 para primeira chamada e 0 para as chamadas posteriores. |
Utilização
Retorna as partes de uma cadeia de caracteres, procurando os separadores das partes. Pesquisa a cadeia de caracteres da esquerda para direita até encontrar um separador ou o fim da cadeia.
Útil para decompor nomes no uso do recurso de pesquisa fonética ou na passagem de parâmetros por meio de um único STRING.
Exemplos
O exemplo a seguir mostra-nos a decomposição de um nome.
var_nom = "João Carlos da Silva Mendes"
var_sep = " "
parte_nom = WORD (var_nom, var_sep, 1) && Primeira chamada
? parte_nom && Exibirá "João"
DO WHILE !EMPTY(parte_nom) && WORD retorna uma cadeia vazia ao final
parte_nom = WORD (var_nom, var_sep, 0) && Chamadas subsequentes
? parte_nom && Exibirá "Carlos", "da", "Silva", "Mendes" e ""
ENDDO
Consulte
AT(), PHONETC() e SUBSTR().