Decodificador de máscaras de bits

Indique el valor almacenado y una lista que asocie cada nombre con un bit que sea potencia de dos. El resultado conserva el orden declarado, devuelve todos los nombres activos e informa de cualquier valor restante procedente de bits no definidos. Resulta útil para leer campos de bases de datos, cargas de API, valores de protocolos, controles de acceso y configuraciones heredadas sin convertir números a binario manualmente ni depender del comportamiento particular de un lenguaje.

Describa la máscara con bits nombrados explícitamente

Comience con el entero no negativo del campo value y añada una fila de flags por cada significado definido en su sistema. Cada fila contiene un nombre y un bit. El bit debe ser una potencia de dos positiva: 1, 2, 4, 8, 16 y así sucesivamente. Estos valores representan posiciones binarias independientes, por lo que pueden combinarse con seguridad mediante suma u OR bit a bit. Los nombres se recortan y deben ser únicos; los valores de bit también deben ser únicos, pues dos etiquetas para la misma posición harían ambigua la respuesta. Las definiciones pueden aparecer en cualquier orden; active_flags respeta el orden proporcionado para que una aplicación mantenga su presentación preferida. El cero es una máscara válida y genera un array active_flags vacío. Se admiten enteros no negativos exactos de JavaScript hasta 9,007,199,254,740,991 y bits individuales hasta 4,503,599,627,370,496. Los registros inválidos fallan claramente en lugar de transformarse silenciosamente en una lista de permisos plausible pero incorrecta.

Interprete las banderas activas y los bits desconocidos

Para cada definición, el decodificador comprueba si esa posición binaria está presente en value. Cuando lo está, añade el nombre correspondiente a active_flags y suma su valor al total activo declarado. La respuesta incluye además unknown_bits, calculado restando del valor original todos los bits activos que sí fueron declarados. Si unknown_bits vale cero, las definiciones suministradas explican completamente la máscara. Un valor distinto de cero no constituye necesariamente un error: puede indicar una bandera recién incorporada por el servidor, una opción interna omitida deliberadamente o una discrepancia de versión del esquema. Mostrar el resto es más seguro que descartar información. Por ejemplo, con value igual a 13 y los bits read=1, write=2, execute=4 y admin=8, los nombres activos son read, execute y admin, mientras unknown_bits vale cero. Si se omitiese el bit 8, el mismo valor devolvería read y execute, con unknown_bits igual a 8. El valor original permanece intacto para conservar una procedencia exacta en registros y comprobaciones posteriores.

Aplique una decodificación determinista a permisos y opciones

Las máscaras de bits son habituales en columnas de bases de datos, modos de sistemas operativos, controles de funciones, registros de dispositivos, estados de juegos y respuestas de API externas, porque agrupan muchos booleanos en un solo entero. Esta capacidad vuelve legibles esos campos en el límite de una integración. Guarde las definiciones junto con la versión del esquema, invoque el decodificador al recibir cada registro y utilice active_flags para mostrar, filtrar o comprobar políticas. Supervise unknown_bits como señal de compatibilidad: un resto distinto de cero puede enviar el registro a revisión antes de que el software confunda un permiso nuevo con un valor antiguo común. El algoritmo realiza operaciones acotadas sobre un máximo de 256 definiciones y no usa red, reloj, configuración regional, azar ni estado mutable; el mismo JSON siempre genera el mismo JSON. Además evita los operadores bit a bit de 32 bits con signo de JavaScript, por lo que procesa máscaras exactas muy superiores a 32 bits. El navegador y la API comparten la misma biblioteca. La consulta interactiva es gratuita y cada tarea automatizada correcta cuesta $0.002.