Categorias:

Funções de cadeia de caracteres e binários (Correspondência/Comparação)

LEFT

Retorna uma subcadeia de caracteres na extremidade esquerda de sua entrada. LEFT(STR,N) é equivalente a SUBSTR(STR,1,N).

Consulte também:

RIGHT , SUBSTR , SUBSTRING

Sintaxe

LEFT( <string_expr> , <length_expr> )
Copy

Argumentos

string_expr

Este deve ser um valor VARCHAR ou BINARY.

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

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 for BINARY.

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.

No entanto, o valor retornado mantém a especificação de agrupamento do primeiro argumento. Isso pode ser útil se o valor retornado for passado para outra função como parte de chamadas de funções aninhadas.

Exemplos

SELECT LEFT('ABCDEF', 3);

-------------------+
 LEFT('ABCDEF', 3) |
-------------------+
 ABC               |
-------------------+
Copy