util_sha512h
Comportamento
Seção intitulada “Comportamento”- Calcula um hash
SHA512sobre os dados apontados porread_ptr - Escreve a primeira metade do hash em
write_ptr
- Calcula um hash
SHA512sobre os dados apontados pordata - Retorna a primeira metade do hash
Definição
Seção intitulada “Definição”int64_t util_sha512h ( uint32_t write_ptr, uint32_t write_len, uint32_t read_ptr, uint32_t read_len);function util_sha512h(data: ByteArray | HexString): ErrorCode | ByteArrayExemplo
Seção intitulada “Exemplo”C
uint8_t hash_out[32];if (util_sha512h(hash_out, 32, data_in_ptr, data_in_len) < 0) rollback("Could not generate Hash", 23, 1);if (util_sha512h(data) < 0) rollback("Could not generate Hash", 1)Parâmetros
Seção intitulada “Parâmetros”| Nome | Tipo | Descrição |
|---|---|---|
| write_ptr | uint32_t | Ponteiro para um buffer onde o hash será escrito |
| write_len | uint32_t | Tamanho do buffer de saída, deve ser pelo menos 32. |
| read_ptr | uint32_t | Ponteiro para o buffer de onde os dados serão lidos (para calcular o hash sobre eles) |
| read_len | uint32_t | Tamanho dos dados de entrada |
| Nome | Tipo | Descrição |
|---|---|---|
| data | ByteArray or HexString | Os dados sobre os quais calcular o hash, podem ser fornecidos como um array de números ou uma string. |
Código de Retorno
Seção intitulada “Código de Retorno”| Tipo | Descrição |
|---|---|
| int64_t | O número de bytes escritos, deve ser sempre 32. Se negativo, um erro: OUT_OF_BOUNDS- ponteiros/tamanhos especificados fora da memória do hook. TOO_SMALL- O buffer de saída não é grande o suficiente |
| Tipo | Descrição |
|---|---|
| ByteArray | ErrorCode se houver um erro ao calcular o hash, caso contrário retorna o hash SHA512-half como um array de números. |