UUID-Format prüfen

Die UUID-Formatprüfung stellt fest, ob ein Wert der üblichen, mit Bindestrichen gegliederten UUID-Darstellung aus 36 Zeichen entspricht, und begründet die Ablehnung fehlerhafter Eingaben eindeutig. Bei Erfolg erhalten Sie die normalisierte kanonische Kleinschreibung, die in den Clock-Sequence-Bits codierte Variante und die in der UUID hinterlegte Version. Hexadezimale Buchstaben dürfen groß- oder kleingeschrieben sein; Klammern, kompakte Zeichenfolgen, falsch gesetzte Trenner und nicht hexadezimale Zeichen werden jedoch nicht stillschweigend akzeptiert.

Was diese UUID-Prüfung untersucht

Eine UUID umfasst 128 Bit, wird von Menschen und Systemen jedoch meist als 36 sichtbare Zeichen in fünf Gruppen übertragen: acht hexadezimale Zeichen, danach vier, vier, vier und zwölf, jeweils durch Bindestriche getrennt. Diese Prüfung untersucht genau diese Darstellung. Sie kontrolliert die Gesamtlänge, bestätigt jeden Trenner an seiner vorgeschriebenen Position und weist alle Zeichen zurück, die weder hexadezimale Ziffern noch Bindestriche sind.

Hexadezimale Buchstaben dürfen groß oder klein geschrieben werden, da die Schreibweise die zugrunde liegenden Bits nicht verändert. Leerzeichen, Klammern, ein URN-Präfix, kompakte Werte mit 32 Zeichen und nachgestellte Satzzeichen werden nicht unbemerkt entfernt. Eine erfolgreiche Antwort enthält valid mit dem Wahrheitswert wahr sowie einen kanonischen Wert in Kleinschreibung für stabile Vergleiche, Cache-Schlüssel, Testdaten und Protokolle.

Die Prüfung arbeitet deterministisch, fragt kein Register ab, erzeugt keinen Ersatz und behauptet nicht, dass die UUID in einem externen System existiert.

Wie Variante und Version decodiert werden

Die Metadaten einer UUID sind im Bezeichner selbst codiert und werden nicht nachgeschlagen. Die Version steht als hexadezimale Ziffer am Anfang der dritten Gruppe; die Prüfung wandelt sie in eine ganze Zahl von 0 bis 15 um und gibt sie direkt zurück. Zu den häufig verwendeten zugewiesenen Versionen zählen die zeitbasierte Version 1, die namensbasierten Versionen 3 und 5, die zufällige Version 4, die Version 6 mit neu geordneter Zeit, die Version 7 mit Unix-Zeit und die anwendungsspezifische Version 8.

Die Variante ergibt sich aus den führenden Bits der vierten Gruppe. Die Ausgabe dieser Bits ist keine Durchsetzung eines Anwendungsprofils. Eine strukturell korrekte UUID kann eine reservierte Version oder eine historische Variante enthalten.

Das Werkzeug beschreibt daher die Codierung, statt jede wohlgeformte UUID als Version 4 vorauszusetzen. Anschließend können Sie Ihre eigenen Richtlinien auf die zurückgegebenen Felder anwenden.

Kanonisierung, Fehler und praktische Nutzung

Die Kanonisierung ändert ausschließlich die Groß- und Kleinschreibung hexadezimaler Buchstaben: Alle fünf Gruppen und Ziffern bleiben unverändert, während A bis F kleingeschrieben werden. Zwei zulässige Schreibweisen desselben 128-Bit-Werts ergeben dadurch exakt dieselbe kanonische Zeichenfolge. Die Prüfung entfernt keine Leerzeichen und repariert keinen beinahe korrekten Wert, weil eine automatische Bereinigung einen fehlerhaften Übergang bei der Serialisierung verdecken könnte.

Stattdessen erzeugen ein leerer Wert, ein anderer Datentyp als eine Zeichenfolge, eine falsche Zeichenzahl, versetzte Bindestriche und unzulässige Zeichen jeweils eigene verständliche Meldungen. Er prüft nur Syntax und eingebettete Metadaten, nicht Eindeutigkeit, Eigentum, Datenbankvorkommen, Erzeugungsqualität oder Eignung für ein bestimmtes Protokoll.