Imprimir      Abrir a versão em PDF da Ajuda on-line


Tópico anterior

Próximo tópico

Funções de string

As funções de string executam várias manipulações de caracteres e operam em strings de caracteres.

ASCII

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

Sintaxe:

ASCII (expressão_caracteres)

em que:

expressão_caracteres

Qualquer expressão avaliada como um caractere ASCII.

Se a expressão de caractere for avaliada como mais de um caractere, será retornado o código ASCII correspondente ao primeiro caractere da expressão.

BIT_LENGTH

Retorna o comprimento, em bits, de uma string especificada. Cada caractere Unicode tem 2 bytes de comprimento, que equivale a 16 bits.

Sintaxe:

BIT_LENGTH (expressão_caracteres)

em que:

expressão_caracteres

Qualquer expressão avaliada como string de caracteres.

CHAR

Converte um valor numérico entre 0 e 255 em valor de caractere correspondente ao código ASCII.

Sintaxe:

CHAR (expressão_n)

em que:

expressão_n

Qualquer expressão avaliada como um valor numérico entre 0 e 255.

CHAR_LENGTH

Retorna o comprimento, em número de caracteres, de uma string especificada. Os vazios iniciais e finais não são contatos no comprimento da string.

Sintaxe:

CHAR_LENGTH (expressão_caracteres)

em que:

expressão_caracteres

Qualquer expressão avaliada como um valor numérico entre 0 e 255.

CONCAT

Há duas formas desta função. A primeira forma concatena duas strings de caracteres. A segunda usa o caractere de concatenação de string para concatenar mais de duas strings de caracteres.

Sintaxe da forma 1:

CONCAT (expressão_caracteres1, expressão_caracteres2)

em que:

expressão_caracteres

Expressões avaliadas como strings de caracteres.

Sintaxe da forma 2:

string_expressão1 || string_expressão2 || ... string_expressãoxx

em que:

string_expressão

Expressões avaliadas como strings de caracteres, separadas pelo operador de concatenação de string de caracteres || (duas barras verticais). A primeira string é concatenada com a segunda para produzir uma string intermediária que, depois, é concatenada com a string seguinte e assim por diante.

Exemplo:

Account."Account Name" ||'-'|| Account."Account Location"

Os resultados poderiam ser:

Action Rentals - Headquarters

INSERT

Insere uma string de caracteres especificada em um local específico de outra string de caracteres, substituindo um número determinado de caracteres da string de destino.

Sintaxe:

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

em que:

expressão_caracteres1

Qualquer expressão avaliada como uma string de caractere. Essa é a string que recebe a inserção.

expressão_caracteres2

Qualquer expressão avaliada como uma string de caractere. Essa é a string para inserir.

n

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

m

Qualquer número inteiro positivo que representa o número de caracteres da primeira string a ser substituído pela totalidade da segunda string.

LEFT

Retorna um número especificado de caracteres do lado esquerdo da string.

Sintaxe:

LEFT (expressão_caracteres, n)

em que:

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres.

n

Qualquer número inteiro positivo que representa o número de caracteres da esquerda da string que são retornados.

LENGTH

Retorna o comprimento, em número de caracteres, de uma string especificada. O comprimento é retornado excluindo caracteres em branco iniciais.

Sintaxe:

LENGTH (expressão_caracteres)

em que:

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres.

LOCATE

Retorna a posição numérica de uma string com outra string. Se a string não for encontrada, a função LOCATE retornará o valor 0. Se você deseja especificar uma posição inicial para começar a pesquisa, use a função LOCATEN.

Sintaxe:

LOCATE (expressão_caracteres1, expressão_caracteres2)

em que:

expressão_caracteres1

Qualquer expressão avaliada como uma string de caracteres. Essa é a expressão para pesquisar a expressão de caracteres.

expressão_caracteres2

Qualquer expressão avaliada como uma string de caracteres. Essa é a expressão a ser pesquisada.

LOCATEN

Retorna a posição numérica de uma string dentro de outra string. É idêntica à função LOCATE, exceto pelo fato de que a pesquisa começa na posição especificada por um argumento de número inteiro. Se a string não for localizada, a função LOCATEN retornará o valor 10. A posição numérica a retornar é determinada pela contagem do primeiro caractere da string que ocupa a posição 1, independentemente do valor do argumento de número inteiro.

Sintaxe:

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

em que:

expressão_caracteres1

Qualquer expressão avaliada como uma string de caracteres. Essa é a string a ser pesquisada.

expressão_caracteres2

Qualquer expressão avaliada como uma string de caracteres. Essa é a string a ser pesquisada.

n

Qualquer número inteiro positivo e não zero que representa a posição inicial para pesquisar a expressão locate.

LOWER

Converte uma string de caracteres em minúsculas.

Sintaxe:

LOWER (expressão_caracteres)

em que:

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres.

OCTET_LENGTH

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

Sintaxe:

OCTET_LENGTH (expressão_caracteres)

em que:

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres.

POSITION

Retorna a posição numérica de uma string dentro de outra string. Se a string não for localizada, a função retornará 0.

Sintaxe:

POSITION (expressão_caracteres1 IN expressão_caracteres2)

em que:

expressão_caracteres1

Qualquer expressão avaliada como uma string de caracteres. Essa é a string a ser pesquisada.

expressão_caracteres2

Qualquer expressão avaliada como uma string de caracteres. Essa é a string na qual será feita a pesquisa.

REPEAT

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

Sintaxe:

REPEAT (expressão_caracteres, n)

REPLACE

Substitui os caracteres especificados em uma string por outros caracteres indicados.

Sintaxe:

REPLACE (expressão_caracteres, change_expressão, replace_with_expressão)

em que:

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres. Os caracteres dessa string serão substituídos.

change_expressão

Qualquer expressão avaliada como uma string de caracteres. Especifica os caracteres da primeira string que serão substituídos.

replace_with_expressão

Qualquer expressão avaliada como uma string de caracteres. Especifica os caracteres que substituirão os da primeira string.

RIGHT

Retorna um número especificado de caracteres do lado direito da string.

Sintaxe:

RIGHT (expressão_caracteres, n)

em que:

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres.

n

Qualquer número inteiro positivo que representa o número de caracteres da direita da string que são retornados.

SPACE

Insere espaços em branco.

Sintaxe:

SPACE (integer)

em que:

integer

Qualquer expressão avaliada como uma string de caracteres.

SUBSTRING

Cria uma nova string a partir de um número fixo de caracteres na string original.

Sintaxe:

SUBSTRING (expressão_caracteres FROM starting_position)

em que:

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres.

starting_position

Um número inteiro positivo que indica a posição inicial dentro da primeira string de caracteres.

Exemplo:

SUBSTRING ('ABCDEF' FROM 3)

Resulta em:

CDEF

TRIM

Remove os caracteres iniciais e/ou finais especificados de uma string de caracteres.

Sintaxe:

TRIM (type 'character' FROM expressão_caracteres)

em que:

type

LEADING

TRAILING

BOTH

Remove os caracteres iniciais especificados de uma string de caracteres.

Remove os caracteres finais especificados de uma string de caracteres.

Remove os caracteres iniciais e finais especificados de uma string de caracteres.

character

Qualquer caractere único. Se a parte da especificação do caractere e as cotas únicas forem omitidas, um espaço será usado como padrão.

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres.

OBSERVAÇÃO: a sintaxe TRIM (expressão_caracteres) é válida também. Ela remove todos os espaços iniciais e finais.

UPPER

Converte uma string de caracteres em maiúsculas.

Sintaxe:

UPPER (expressão_caracteres)

em que:

expressão_caracteres

Qualquer expressão avaliada como uma string de caracteres.


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