Partilhar via


LEFT (Expressão SSIS)

Retorna o número especificado de caracteres da parte mais à esquerda da expressão character especificada.

Sintaxe

  
LEFT(character_expression,number)  

Argumentos

character_expression
É uma expressão de caractere da qual extrair caracteres.

number
É uma expressão de inteiro que indica o número de caracteres retornados.

Tipos de resultado

DT_WSTR

Comentários

Se number for maior que o comprimento de character_expression, a função retornará character_expression.

Se number for zero, a função retornará uma cadeia de comprimento zero.

Se number for um número negativo, a função retornará um erro.

O argumento number pode obter variáveis e colunas.

LEFT só funciona com o tipo de dados DT_WSTR. Um argumento character_expression que é um literal de cadeia de caracteres ou uma coluna de dados com o tipo de dados DT_STR é implicitamente convertido para o tipo de dados DT_WSTR antes de LEFT executar sua operação. Outros tipos de dados devem ser explicitamente convertidos para o tipo de dados DT_WSTR. Para obter mais informações, confira Tipos de dados do Integration Services e Cast (Expressão SSIS).

LEFT retornará um resultado nulo se o argumento for nulo.

Exemplos de expressões

O exemplo a seguir usa um literal de cadeia de caracteres. O resultado de retorno é "Mountain".

LEFT("Mountain Bike", 8)  

Consulte Também

RIGHT (Expressão SSIS)
Funções (Expressão SSIS)