LEN (expressão SSIS)
Retorna o número de caracteres em uma expressão de caractere. Se a cadeia de caracteres incluir espaços em branco à esquerda e à direita, a função os incluirá na contagem. LEN retorna valores idênticos para a mesma cadeia de caracteres de byte único e duplo.
Sintaxe
LEN(character_expression)
Argumentos
- character_expression
É a expressão a ser avaliada.
Tipos de resultado
DT_I4
Comentários
O argumento character_expression pode ser um tipo de dados DT_WSTR, DT_TEXT, DT_NTEXT ou DT_IMAGE. Para obter mais informações, consulte Tipos de dados do Integration Services.
Se character_expression for um literal de cadeia de caracteres ou uma coluna de dados com o tipo de dados DT_STR, ele será implicitamente convertido para o tipo de dados DT_WSTR antes de LEN executar sua operação. Outros tipos de dados devem ser explicitamente convertidos para o tipo de dados DT_WSTR. Para obter mais informações, consulte Cast (expressão SSIS): Converter tipos de dados SSIS.
Se o argumento transmitido para a função LEN tiver um tipo de dados BLOB (Binary Large Object Block), como DT_TEXT, DT_NTEXT ou DT_IMAGE, a função retornará uma contagem de bytes.
LEN retornará um resultado nulo se o argumento for nulo.
Exemplos
Este exemplo retorna o comprimento de uma literal de cadeia de caracteres. O resultado de retorno é 12.
LEN("Ball Bearing")
Este exemplo retorna a diferença entre o comprimento de valores nas colunas FirstName e LastName.
LEN(FirstName) - LEN(LastName)
Retorna o comprimento de um nome do computador que usa a variável de Sistema MachineName.
LEN(@MachineName)