Decodificador de máscara de bits

Informe o valor armazenado e uma lista que associe cada nome a um bit com valor de potência de dois. O resultado preserva a ordem declarada, retorna todos os nomes ativos e informa qualquer parcela restante de bits não definidos. 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. Cada linha contém um nome e um bit. O bit precisa ser uma potência de dois positiva: 1, 2, 4, 8, 16 e assim por diante. Esses valores representam posições binárias independentes, portanto podem ser combinados com segurança por soma ou OR bit a bit. Os nomes têm os espaços externos removidos e devem ser únicos; os valores dos bits também precisam ser exclusivos, pois dois rótulos na mesma posição tornariam a resposta ambígua. 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. São aceitos inteiros não negativos exatos do JavaScript até 9,007,199,254,740,991 e bits individuais até 4,503,599,627,370,496. Registros inválidos geram falhas claras, sem coerção silenciosa para uma lista de permissões aparentemente plausível, porém errada.

Entenda flags ativas e bits desconhecidos

Para cada definição, o decodificador verifica se aquela posição binária está presente em value. 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. 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. 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. O valor original volta sem alterações para manter a procedência exata em logs e verificações posteriores.

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. 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. 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. O navegador e a API usam a mesma biblioteca. A consulta interativa é gratuita, e tarefas automatizadas concluídas custam US$ 0,002.