- Categorias:
Funções de cadeia de caracteres e binários (Correspondência/Comparação)
RIGHT¶
Retorna uma subcadeia de caracteres na extremidade direita de sua entrada.
RIGHT(STR,N)
é equivalente a SUBSTR(STR,LENGTH(STR)-N+1,N)
.
- Consulte também:
Sintaxe¶
RIGHT( <expr> , <length_expr> )
Argumentos¶
expr
A expressão para a qual você quer a subcadeia de caracteres mais à direita. A expressão deve ser avaliada como um valor
VARCHAR
ouBINARY
.length_expr
O comprimento deve ser uma expressão que avalia como um número inteiro. Deve especificar:
O número de caracteres UTF-8 a retornar se a entrada for
VARCHAR
.O número de bytes a retornar se a entrada for
BINARY
.
O comprimento deve ser maior ou igual a zero. Se o comprimento for um número negativo, a função retorna uma cadeia de caracteres vazia.
Retornos¶
O tipo de dados do valor retornado é o mesmo que o tipo de dados do valor de entrada (BINARY
ou VARCHAR
).
Notas de uso¶
Se
length_expr
for maior que o comprimento deexpr
, então a função retornaexpr
.
Detalhes do agrupamento¶
O agrupamento se aplica às entradas
VARCHAR
. O agrupamento não se aplica se o tipo de dados de entrada do primeiro parâmetro forBINARY
.No impact. Embora o agrupamento seja aceito sintaticamente, os agrupamentos não têm impacto no processamento. Por exemplo, idiomas com letras de dois e três caracteres (por exemplo, «dzs» em húngaro, «ch» em tcheco) ainda contam esses como dois ou três caracteres (não um caractere) para o argumento da extensão.
The collation of the result is the same as the collation of the input. Isso pode ser útil se o valor retornado for passado para outra função como parte de chamadas de funções aninhadas.
Exemplos¶
SELECT RIGHT('ABCDEFG', 3);
---------------------+
RIGHT('ABCDEFG', 3) |
---------------------+
EFG |
---------------------+