Partilhar via


Tohex()

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Converte a entrada em uma cadeia de caracteres hexadecimal.

Sintaxe

tohex( valor, [,minLength ])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Designação Tipo Necessário Descrição
valor int ou longo ✔️ O valor que é convertido em uma cadeia de caracteres hexadecimal.
minComprimento int O valor que representa o número de caracteres à esquerda a serem incluídos na saída. Valores entre 1 e 16 são suportados. Valores superiores a 16 são truncados para 16. Se a cadeia de caracteres for maior que minLength sem caracteres principais, minLength será efetivamente ignorada. Os números negativos são representados apenas no mínimo pelo tamanho dos dados subjacentes, portanto, para um inteiro (32 bits) o minLength é no mínimo 8, para um longo (64 bits) é no mínimo 16.

Devoluções

Se a conversão for bem-sucedida, o resultado será um valor de cadeia de caracteres. Se a conversão não for bem-sucedida, o resultado será null.

Exemplo

O exemplo a seguir verifica se a conversão de inteiros tohex() resulta no valor hexadecimal esperado.

print
    tohex(256) == '100',
    tohex(-256) == 'ffffffffffffff00', // 64-bit 2's complement of -256
    tohex(toint(-256), 8) == 'ffffff00', // 32-bit 2's complement of -256
    tohex(256, 8) == '00000100',
    tohex(256, 2) == '100' // Exceeds min length of 2, so min length is ignored.

Output

print_0 print_1 print_2 print_3 print_04
verdadeiro verdadeiro verdadeiro verdadeiro verdadeiro