Décodeur de masque de bits

Indiquez la valeur enregistrée et une liste associant chaque nom à un bit dont la valeur est une puissance de deux. Le résultat conserve l’ordre de votre déclaration, renvoie tous les noms actifs et signale la partie correspondant à des bits non définis. Cet outil facilite la lecture des champs de base de données, charges utiles d’API, valeurs de protocole, réglages d’accès et configurations anciennes, sans conversion binaire manuelle ni dépendance aux particularités des opérateurs d’un langage.

Décrivez le masque avec des bits nommés explicitement

Commencez par l’entier positif ou nul du champ value, puis ajoutez une ligne dans flags pour chaque signification définie par votre système. Chaque ligne contient un nom et un bit. Le bit doit être une puissance de deux strictement positive : 1, 2, 4, 8, 16, etc. Ces valeurs représentent des positions binaires indépendantes et peuvent donc être combinées sans risque par addition ou avec l’opérateur OR bit à bit. Les espaces extérieurs des noms sont supprimés et chaque nom doit être unique. Les valeurs de bit doivent également être distinctes, car deux libellés pour une même position rendraient la réponse ambiguë. Vous pouvez classer les définitions comme vous le souhaitez : active_flags respecte cet ordre afin que votre application conserve sa présentation habituelle. Zéro constitue un masque valide et produit un tableau active_flags vide. Les entiers JavaScript exacts de 0 à 9,007,199,254,740,991 et les bits individuels jusqu’à 4,503,599,627,370,496 sont acceptés. Tout enregistrement non valide échoue explicitement au lieu d’être converti silencieusement en une liste plausible mais erronée.

Interprétez les drapeaux actifs et les bits inconnus

Pour chaque définition, le décodeur vérifie si la position binaire correspondante figure dans value. Si elle est présente, son nom est ajouté à active_flags et sa valeur alimente le total actif déclaré. La réponse comprend aussi unknown_bits, obtenu en retirant de la valeur initiale tous les bits actifs déclarés. Lorsque unknown_bits vaut zéro, vos définitions expliquent entièrement le masque. Une valeur non nulle n’est pas forcément une erreur : elle peut révéler un nouveau drapeau ajouté côté serveur, une option interne volontairement exclue ou un décalage entre versions de schéma. Afficher ce reliquat évite de perdre une information importante. Ainsi, avec value égal à 13 et les bits read=1, write=2, execute=4 et admin=8, les noms actifs sont read, execute et admin, tandis que unknown_bits vaut zéro. Si le bit 8 était absent des définitions, la même entrée renverrait read et execute avec unknown_bits égal à 8. La valeur d’origine est restituée telle quelle afin de préserver une provenance exacte dans les journaux et contrôles ultérieurs.

Intégrez un décodage déterministe aux permissions et options

Les masques de bits sont fréquents dans les colonnes de base de données, modes de système d’exploitation, interrupteurs de fonctionnalités, registres d’appareil, états de jeu et réponses d’API tierces, car ils regroupent de nombreux booléens dans un entier. Cette capacité rend ces champs compréhensibles à la frontière d’une intégration. Conservez les définitions avec la version du schéma, appelez le décodeur à l’arrivée de chaque enregistrement et exploitez active_flags pour l’affichage, le filtrage ou les contrôles de règles. Surveillez unknown_bits comme indicateur de compatibilité : un reliquat non nul peut déclencher une vérification avant qu’un logiciel ne traite une nouvelle permission comme une ancienne valeur ordinaire. L’algorithme effectue des calculs bornés sur 256 définitions au maximum et n’utilise ni réseau, ni horloge, ni paramètres régionaux, ni hasard, ni état mutable ; un JSON identique donne toujours le même JSON. Il évite aussi les opérateurs JavaScript signés sur 32 bits et traite donc exactement des masques bien plus grands. Le navigateur et l’API partagent la même bibliothèque. L’essai interactif est gratuit et chaque tâche automatisée réussie coûte $0.002.