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


Previous Topic

Next Topic

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_caractere)

em que:

expressão_caractere

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_caractere

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_caractere

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 Formulário 1:

CONCAT (expressão_caracteres1, expressão_caracteres2)

em que:

expressão_caractere

Expressões avaliadas como strings de caracteres.

Sintaxe Formulário 2:

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

em que:

expressão_string

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 se parecem com isto:

Action Rentals - Matrizes

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_caractere1

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

expressão_caractere2

Qualquer expressão avaliada como uma string de caracteres. 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_caractere

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_caractere)

em que:

expressão_caractere

Qualquer expressão avaliada como uma string de caracteres.

LOCATE

Retorna a posição numérica de uma string dentro de 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_caractere1

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

expressão_caractere2

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_caractere1

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

expressão_caractere2

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_caractere)

em que:

expressão_caractere

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_caractere

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_caractere1

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

expressão_caractere2

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_caractere

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

expressão_alteração

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

substituir_por_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_caractere

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 (inteiro)

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_caractere

Qualquer expressão avaliada como uma string de caracteres.

posição_inicial

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:

tipo

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.

caractere

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

expressão_caractere

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_caractere)

em que:

expressão_caractere

Qualquer expressão avaliada como uma string de caracteres.


Publicado em agosto de 2022 Copyright © 2005, 2022, Oracle e/ou suas empresas afiliadas. Legal Notices.