Todos os produtos
Search
Central de documentação

MaxCompute:LENGTHB

Última atualização: Aug 20, 2026

Retorna o comprimento, em bytes, da string especificada por str.

Sintaxe

bigint lengthb(string <str>)

Parâmetros

str: obrigatório. Valor do tipo STRING. Se o valor de entrada for dos tipos BIGINT, DOUBLE, DECIMAL ou DATETIME, a conversão implícita para STRING ocorre antes do cálculo.

Valor de retorno

Retorna um valor do tipo BIGINT. O resultado segue as regras abaixo:

  • Se o valor de str não for dos tipos STRING, BIGINT, DOUBLE, DECIMAL ou DATETIME, a função retornará um erro.

  • Se o valor de str for null, o retorno será null.

Exemplos

  • Exemplo 1: Obtenha o comprimento da string Tech on the net em bytes. Comando de exemplo:

    -- The return value is 15. 
    select lengthb('Tech on the net');
  • Exemplo 2: Defina o parâmetro de entrada como null. Comando de exemplo:

    -- The return value is null. 
    select lengthb(null);

Funções relacionadas

LENGTHB é uma função de string. Para mais informações sobre funções de busca e conversão de strings, consulte String functions.