Imprimir      Abrir versão PDF da ajuda online


Tópico anterior

Tópico seguinte

Funções de cadeia

As funções de cadeia efectuam várias manipulações de caracteres e funcionam em cadeias de caracteres.

ASCII

Converte uma única cadeia de caracteres no respectivo código ASCII correspondente, entre 0 e 255.

Sintaxe:

ASCII (expressão_caracteres)

onde:

expressão_caracteres

Qualquer expressão que devolve um carácter ASCII.

Se a expressão de caracteres devolver mais do que um carácter, será devolvido o código ASCII que corresponde ao primeiro carácter da expressão.

BIT_LENGTH

Devolve o comprimento, em bits, de uma cadeia especificada. Cada carácter Unicode tem 2 bytes de comprimento, o qual é igual a 16 bits.

Sintaxe:

BIT_LENGTH (expressão_caracteres)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.

CHAR

Converte um valor numérico entre 0 e 255 no valor do carácter que corresponde ao código ASCII.

Sintaxe:

CHAR (expressão_n)

onde:

expressão_n

Qualquer expressão que devolve um valor numérico entre 0 e 255.

CHAR_LENGTH

Devolve o comprimento, em número de caracteres, de uma cadeia especificada. Os espaços em branco à esquerda e à direita não são calculados no comprimento da cadeia.

Sintaxe:

CHAR_LENGTH (expressão_caracteres)

onde:

expressão_caracteres

Qualquer expressão que devolve um valor numérico entre 0 e 255.

CONCAT

Existem dois formatos desta função. O primeiro formato efectua a concatenação de duas cadeias de caracteres. O segundo formato utiliza o carácter de concatenação da cadeia de caracteres para concatenar mais do que duas cadeias de caracteres.

Sintaxe do formato 1:

CONCAT (expressão_caracteres1, expressão_caracteres2)

onde:

expressão_caracteres

Expressões que devolvem cadeias de caracteres.

Sintaxe do formato 2:

expressão_cadeia1 || expressão_cadeia2 || ... expressão_cadeiaxx

onde:

expressão_cadeia

Expressões que devolvem cadeias de caracteres, separadas pelo operador de concatenação da cadeia de caracteres || (barras verticais duplas). A primeira cadeia é concatenada com a segunda cadeia para produzir uma cadeia intermediária, a qual é, em seguida, concatenada com a cadeia seguinte e assim sucessivamente.

Exemplo:

Conta."Nome da conta" ||'-'|| Conta."Localização da conta"

Os resultados têm a seguinte apresentação:

Action Rentals - Sede

INSERT

Insere uma cadeia de caracteres especificada numa localização especificada noutra cadeia de caracteres, substituindo um número especificado de caracteres na cadeia alvo.

Sintaxe:

INSERT(expressão_caracteres1, n, m, expressão_caracteres2)

onde:

expressão_caracteres1

Qualquer expressão que devolve uma cadeia de caracteres. Esta é a cadeia que recebe a inserção.

expressão_caracteres2

Qualquer expressão que devolve uma cadeia de caracteres. Esta é a cadeia a inserir.

n

Qualquer número inteiro positivo que representa o número de caracteres desde o início da primeira cadeia onde é inserida uma parte da segunda cadeia.

m

Qualquer número inteiro positivo que representa o número de caracteres na primeira cadeia que serão substituídos pela segunda cadeia na sua totalidade.

LEFT

Devolve um número especificado de caracteres a partir do lado esquerdo da cadeia.

Sintaxe:

LEFT(expressão_caracteres, n)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.

n

Qualquer número inteiro positivo que representa o número de caracteres desde o lado esquerdo da cadeia que são devolvidos.

LENGTH

Devolve o comprimento, em número de caracteres, de uma cadeia especificada. O comprimento é devolvido excluindo qualquer espaço em branco à direita.

Sintaxe:

LENGTH(expressão_caracteres)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.

LOCATE

Devolve a posição numérica de uma cadeia noutra cadeia. Se a cadeia não for localizada, a função LOCATE devolve o valor 0. Se pretende especificar uma posição inicial para começar a procura, utilize a função LOCATEN.

Sintaxe:

LOCATE(expressão_caracteres1, expressão_caracteres2)

onde:

expressão_caracteres1

Qualquer expressão que devolve uma cadeia de caracteres. Esta é a expressão a procurar na expressão de caracteres.

expressão_caracteres2

Qualquer expressão que devolve uma cadeia de caracteres. Esta é a expressão a procurar.

LOCATEN

Devolve a posição numérica de uma cadeia noutra cadeia. Isto é idêntico à função LOCATE, com a excepção de que a procura inicia na posição especificada por um argumento de número inteiro. Se a cadeia não for localizada, a função LOCATEN devolve o valor 0. A posição numérica a devolver é determinada pela contagem do primeiro carácter da cadeia que ocupa a posição 1, independentemente do valor do argumento de número inteiro.

Sintaxe:

LOCATEN (expressão_caracteres1, expressão_caracteres2, n)

onde:

expressão_caracteres1

Qualquer expressão que devolve uma cadeia de caracteres. Esta é a cadeia a procurar.

expressão_caracteres2

Qualquer expressão que devolve uma cadeia de caracteres. Esta é a cadeia a procurar.

n

Qualquer número positivo diferente de zero que representa a posição inicial para iniciar a procura da expressão locate.

LOWER

Converte uma cadeia de caracteres em minúsculas.

Sintaxe:

LOWER (expressão_caracteres)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.

OCTET_LENGTH

Devolve os bits, em 8 unidades base (número de bytes), de uma cadeia especificada.

Sintaxe:

OCTET_LENGTH (expressão_caracteres)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.

POSITION

Devolve a posição numérica de uma cadeia noutra cadeia. Se a cadeia não for localizada, a função devolve 0.

Sintaxe:

POSITION(expressão_caracteres1 IN expressão_caracteres2)

onde:

expressão_caracteres1

Qualquer expressão que devolve uma cadeia de caracteres. Esta é a cadeia a procurar.

expressão_caracteres2

Qualquer expressão que devolve uma cadeia de caracteres. Esta é a cadeia a procurar.

REPEAT

Repete uma expressão especificada n vezes, onde n é um número inteiro positivo.

Sintaxe:

REPEAT(expressão_caracteres, n)

REPLACE

Substitui os caracteres especificados de uma cadeia por outros caracteres especificados.

Sintaxe:

REPLACE(expressão_caracteres, expressão_alteração, expressão_substituição)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres. Esta cadeia terá os respectivos caracteres substituídos.

expressão_alteração

Qualquer expressão que devolve uma cadeia de caracteres. Especifica os caracteres da primeira cadeia que serão substituídos.

expressão_substituição

Qualquer expressão que devolve uma cadeia de caracteres. Especifica os caracteres de substituição a utilizar na substituição da primeira cadeia.

RIGHT

Devolve um número especificado de caracteres a partir do lado direito da cadeia.

Sintaxe:

RIGHT(expressão_caracteres, n)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.

n

Qualquer número inteiro positivo que representa o número de caracteres a partir do lado direito da primeira cadeia que são devolvidos.

SPACE

Insere espaços em branco.

Sintaxe:

SPACE (número inteiro)

onde:

número inteiro

Qualquer expressão que devolve uma cadeia de caracteres.

SUBSTRING

Cria uma nova cadeia a partir de um número fixo de caracteres para a cadeia original.

Sintaxe:

SUBSTRING (expressão_caracteres FROM posição_inicial)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.

posição_inicial

Um número inteiro positivo que indica a posição inicial na primeira cadeia de caracteres.

Exemplo:

SUBSTRING ('ABCDEF' FROM 3)

Resulta em:

CDEF

TRIM

Reparte espaços à esquerda e/ou à direita especificados a partir de uma cadeia de caracteres.

Sintaxe:

TRIM (tipo 'carácter' FROM expressão_caracteres)

onde:

tipo

LEADING

TRAILING

BOTH

Reparte espaços à esquerda especificados a partir de uma cadeia de caracteres.

Reparte espaços à direita especificados a partir de uma cadeia de caracteres.

Reparte caracteres especificados, espaços à esquerda e à direita, a partir de uma cadeia de caracteres.

carácter

Qualquer carácter único. Se a parte dos caracteres relativamente à especificação e às plicas for omitida, será utilizado um espaço como predefinição.

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.

NOTA: A sintaxe TRIM (expressão_caracteres) também é válida. Isto corta todos os espaços à esquerda e à direita.

UPPER

Converte uma cadeia de caracteres em maiúsculas.

Sintaxe:

UPPER (expressão_caracteres)

onde:

expressão_caracteres

Qualquer expressão que devolve uma cadeia de caracteres.


Publicado em Setembro 2017 Copyright © 2005, 2017, Oracle. Todos os direitos reservados. Legal Notices.