UUID-Format prüfen

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. Diese strenge Grenze hilft Ihnen beim Testen des Vertrags einer API oder eines Datenbankfelds: Eine Eingabe entspricht entweder der dokumentierten UUID-Textform oder Sie erhalten eine Begründung, die den strukturellen Fehler benennt. 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. Ein führendes Nullbit wird als ncs ausgegeben; das Bitmuster 10 als rfc_4122, die Familie moderner UUID-Formate; 110 als microsoft; und 111 als future. 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. Dadurch eignet sich die Funktion für Importsperren, Formulardiagnosen, Test-Fixtures und Supportwerkzeuge, bei denen die Ursache ebenso wichtig ist wie Ja oder Nein. Senden Sie einen Kandidaten im Feld text; für eine einfachere Integration werden auch die Aliasse uuid und value angenommen. Der Vorgang kostet über die API $0.002 je Element und benötigt weder Netzwerk noch Zufall, Uhrzeit, Modell oder dauerhaften Speicher. Er prüft nur Syntax und eingebettete Metadaten, nicht Eindeutigkeit, Eigentum, Datenbankvorkommen, Erzeugungsqualität oder Eignung für ein bestimmtes Protokoll.