Conversor decimal para ponto fixo

Firmware embarcado, núcleos DSP, datapaths FPGA e motores de jogo ainda guardam muitos sinais como inteiros de ponto fixo em formato Q, em vez de floats IEEE-754: um número escolhido de bits fica à direita de um ponto binário implícito, de modo que cada inteiro armazenado é múltiplo de uma resolução fixa.

O que o formato Q significa e como o inteiro armazenado é formado

Isso não é ponto flutuante IEEE-754: não há campo de expoente, nem um líder oculto, nem underflow gradual. Este endpoint implementa esse contrato e nada mais. Ele não emite macros C, não empacota uma palavra de máquina completa com uma largura de bits inteiros escolhida a menos que você interprete o inteiro armazenado, e não converte para padrões de bits IEEE-754. Essas são intenções de busca diferentes, atendidas por outras ferramentas.

Contrato de entrada, modos de arredondamento e campos da resposta

Campos ausentes, strings vazias, valores não finitos, um n não inteiro ou um n fora de zero a cinquenta e dois também falham, e essas falhas não são cobradas. Se o produto de value e dois elevado a n sair da faixa de inteiro seguro, a tarefa é rejeitada em vez de perder bits baixos em silêncio. Envie um corpo JSON com dois campos obrigatórios e um modo opcional. value é o decimal finito a codificar; pode chegar como número JSON ou como string numérica, e os aliases decimal e number são aceitos. fractional_bits é o inteiro n em Q.n, de zero a cinquenta e dois inclusive, para que dois elevado a n continue sendo um inteiro seguro exato de JavaScript; os aliases incluem frac_bits, n e q. rounding é opcional e o padrão é nearest, que significa metade afastando-se de zero — a convenção da maioria das notas de DSP, e não a mesma de JavaScript Math.round, que manda os empates rumo a mais infinito. Os outros modos documentados são toward_zero (truncar o produto escalado), floor (em direção a menos infinito) e ceil (em direção a mais infinito); qualquer outro token falha com invalid_input. Em caso de sucesso o corpo ecoa value e fractional_bits, nomeia o modo de arredondamento, informa q_format como Q.n e devolve scale (dois elevado a n), resolution (dois elevado a menos n), stored (o código inteiro), stored_hex (hex de magnitude com sinal), reconstructed (stored sobre scale), rounding_error (reconstructed menos o valor original), abs_error, um booleano exact quando o erro arredondado é zero, e uma string curta de fórmula. Combine a resposta com a sua própria verificação de largura de palavra se precisar saber se stored cabe em um registrador com sinal de dezesseis ou trinta e dois bits; este endpoint não assume uma largura total de bits, então a forma hex é magnitude com sinal, não complemento de dois de um recipiente oculto.

Onde um conversor de formato Q justifica o seu uso

Como a implementação é parse de nível A puro, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída; a validação falha não consome saldo. Quando a intenção de busca for o padrão hex IEEE-754 de um float, use uma ferramenta de padrão de bits em ponto flutuante; quando a intenção for um inteiro Q.n com o seu erro e a sua resolução, este é o contrato.