Decodificador de máscara de bits

Isso ajuda você a ler campos de banco de dados, payloads de API, valores de protocolos, configurações de acesso e sistemas legados sem converter números manualmente para binário nem depender do comportamento específico de operadores de uma linguagem.

Descreva a máscara com bits nomeados explicitamente

Comece com o inteiro não negativo no campo value e adicione uma linha em flags para cada significado definido pelo seu sistema. As definições podem aparecer em qualquer ordem; active_flags respeita a sequência fornecida, permitindo que a aplicação mantenha a apresentação desejada. Zero é uma máscara válida e retorna um array active_flags vazio.

Entenda flags ativas e bits desconhecidos

Para cada definição, o decodificador verifica se aquela posição binária está presente em value. Um valor diferente de zero não representa necessariamente um erro: ele pode indicar uma flag recém-adicionada pelo servidor, uma opção interna omitida de propósito ou uma incompatibilidade de versão do esquema. Exibir esse restante é mais seguro que descartar informação. O valor original volta sem alterações para manter a procedência exata em logs e verificações posteriores. Quando está, o nome correspondente é incluído em active_flags e o valor do bit entra no total ativo declarado. A resposta também contém unknown_bits, calculado pela subtração de todos os bits ativos declarados do valor original. Quando unknown_bits é zero, as definições fornecidas explicam toda a máscara. Por exemplo, se value for 13 e os bits declarados forem read=1, write=2, execute=4 e admin=8, os nomes ativos serão read, execute e admin, e unknown_bits será zero. Se o bit 8 não fosse declarado, a mesma entrada retornaria read e execute, com unknown_bits igual a 8.

Use decodificação determinística em permissões e opções

Máscaras de bits aparecem em colunas de bancos de dados, modos de sistemas operacionais, controles de funcionalidades, registradores de dispositivos, estados de jogos e respostas de APIs externas porque reúnem muitos booleanos em um inteiro. Esta capacidade torna esses campos legíveis no limite de uma integração. Ele também evita os operadores bit a bit assinados de 32 bits do JavaScript e processa máscaras exatas muito acima de 32 bits. Armazene as definições junto da versão do esquema, execute o decodificador quando o registro entrar no fluxo e use active_flags para exibição, filtros ou verificações de política. Monitore unknown_bits como sinal de compatibilidade: um restante diferente de zero pode encaminhar o registro para análise antes que o software interprete uma permissão nova como um valor antigo comum. O algoritmo realiza operações limitadas sobre no máximo 256 definições e não usa rede, relógio, localidade, aleatoriedade nem estado mutável; o mesmo JSON sempre gera o mesmo JSON. O navegador e a API usam a mesma biblioteca. A consulta interativa é gratuita, e tarefas automatizadas concluídas custam US$ 0,002.