Bitmask-Flags dekodieren

Geben Sie den gespeicherten Wert sowie eine Liste an, die jeden Namen einem Bit mit einer Zweierpotenz zuordnet. Das Ergebnis behält Ihre vorgegebene Reihenfolge bei, liefert alle aktiven Namen und weist den Restwert nicht definierter Bits aus. Damit lesen Sie Datenbankfelder, API-Nutzdaten, Protokollwerte, Zugriffseinstellungen und ältere Konfigurationen, ohne Zahlen manuell in Binärdarstellung umzuwandeln oder vom speziellen Operatorverhalten einer Programmiersprache abhängig zu sein.

Beschreiben Sie die Maske mit eindeutig benannten Bits

Beginnen Sie mit der nicht negativen Ganzzahl im Feld value und fügen Sie für jede in Ihrem System festgelegte Bedeutung eine Zeile zu flags hinzu. Jede Zeile enthält einen Namen und ein Bit. Das Bit muss eine positive Zweierpotenz sein: 1, 2, 4, 8, 16 und so weiter. Diese Werte stehen für unabhängige Binärpositionen und lassen sich daher sicher durch Addition oder bitweises OR kombinieren. Äußere Leerzeichen in Namen werden entfernt; jeder Name muss eindeutig sein. Auch Bitwerte dürfen nicht doppelt vorkommen, da zwei Bezeichnungen für dieselbe Position das Ergebnis mehrdeutig machen würden. Sie können die Definitionen beliebig anordnen: active_flags übernimmt Ihre Reihenfolge, sodass eine Anwendung ihre bevorzugte Darstellung beibehält. Null ist eine gültige Maske und ergibt ein leeres active_flags-Array. Exakte, nicht negative JavaScript-Ganzzahlen bis 9,007,199,254,740,991 und einzelne Bits bis 4,503,599,627,370,496 sind zulässig. Ungültige Datensätze führen zu einer klaren Fehlermeldung, statt unbemerkt in eine scheinbar plausible, aber falsche Berechtigungsliste umgewandelt zu werden.

Verstehen Sie aktive Flags und unbekannte Bits

Für jede Definition prüft der Dekodierer, ob die zugehörige Binärposition in value gesetzt ist. Ist sie vorhanden, wird der entsprechende Name an active_flags angehängt und der Bitwert zur erklärten aktiven Summe addiert. Die Antwort enthält außerdem unknown_bits. Dieser Wert entsteht, indem alle deklarierten aktiven Bits vom ursprünglichen Wert abgezogen werden. Ist unknown_bits gleich null, erklären Ihre Definitionen die Maske vollständig. Ein anderer Wert ist nicht zwangsläufig ein Fehler: Er kann auf ein neues serverseitiges Flag, eine bewusst ausgelassene interne Option oder unterschiedliche Schemaversionen hinweisen. Den Rest sichtbar zu lassen ist sicherer, als Informationen zu verwerfen. Bei value 13 und den Bits read=1, write=2, execute=4 sowie admin=8 lauten die aktiven Namen beispielsweise read, execute und admin; unknown_bits ist null. Fehlt Bit 8 in den Definitionen, liefert dieselbe Eingabe read und execute sowie unknown_bits mit dem Wert 8. Der ursprüngliche Wert bleibt in der Antwort unverändert, damit Protokolle und spätere Prüfungen die genaue Herkunft bewahren.

Nutzen Sie deterministische Dekodierung für Rechte und Optionen

Bitmasken kommen häufig in Datenbankspalten, Betriebssystemmodi, Funktionsschaltern, Geräteregistern, Spielzuständen und Antworten externer APIs vor, weil viele Wahrheitswerte in eine Ganzzahl passen. Diese Funktion macht solche Felder an einer Integrationsgrenze verständlich. Speichern Sie die Flag-Definitionen zusammen mit der Schemaversion, rufen Sie den Dekodierer beim Eingang eines Datensatzes auf und verwenden Sie active_flags für Anzeige, Filterung oder Richtlinienprüfungen. Beobachten Sie unknown_bits als Kompatibilitätssignal: Ein Rest ungleich null kann den Datensatz zur Prüfung weiterleiten, bevor Software eine neue Berechtigung als gewöhnlichen alten Wert behandelt. Der Algorithmus führt begrenzte Berechnungen über höchstens 256 Definitionen aus und verwendet weder Netzwerk, Uhr, Gebietsschema, Zufall noch veränderlichen Zustand; identisches JSON erzeugt stets identisches JSON. Zudem vermeidet er die vorzeichenbehafteten 32-Bit-Operatoren von JavaScript und verarbeitet daher exakte Masken weit oberhalb von 32 Bit. Browser und API verwenden dieselbe Bibliothek. Die interaktive Nutzung ist kostenlos; erfolgreiche automatisierte API-Aufträge kosten $0.002.