Validateur UUID

En cas de réussite, il renvoie la forme canonique normalisée en minuscules, la variante codée dans les bits de séquence d’horloge et la version inscrite dans l’UUID. Les lettres hexadécimales majuscules ou minuscules sont acceptées, sans pour autant tolérer silencieusement les accolades, les chaînes compactes, les séparateurs déplacés ou les caractères non hexadécimaux.

Ce que contrôle ce validateur d’UUID

Un UUID contient 128 bits, mais les personnes et les systèmes l’échangent généralement sous la forme de 36 caractères visibles répartis en cinq groupes : huit caractères hexadécimaux, puis quatre, quatre, quatre et douze, séparés par des traits d’union. Ce validateur contrôle précisément cette représentation. Il vérifie la longueur totale, confirme la position de chaque séparateur et rejette tout caractère autre qu’un chiffre hexadécimal ou un trait d’union. Les lettres hexadécimales peuvent être en majuscules ou en minuscules, car leur casse ne modifie pas les bits sous-jacents. Les espaces, accolades, préfixes URN, valeurs compactes de 32 caractères et signes de ponctuation finaux ne sont pas supprimés en silence. Cette frontière stricte est utile lorsque vous testez le contrat d’une API ou d’un champ de base de données : la saisie correspond à la forme UUID documentée ou reçoit une explication qui désigne le défaut structurel. Une réponse positive contient valid à vrai et fournit une valeur canonique en minuscules, adaptée aux comparaisons stables, clés de cache, jeux d’essai et journaux. La validation est déterministe : elle ne consulte aucun registre, ne génère aucun remplacement et ne prétend pas que l’UUID existe dans un système externe.

Comment la variante et la version sont décodées

Les métadonnées d’un UUID sont codées dans l’identifiant lui-même, sans recherche externe. La version correspond au chiffre hexadécimal placé au début du troisième groupe ; le validateur le convertit en un entier de 0 à 15 et le renvoie directement. Les versions couramment attribuées comprennent la version 1 fondée sur le temps, les versions 3 et 5 fondées sur un nom, la version 4 aléatoire, la version 6 à temps réordonné, la version 7 à temps Unix et la version 8 personnalisée. La variante provient des premiers bits du quatrième groupe. Un premier bit nul est indiqué par ncs ; le motif 10 par rfc_4122, famille employée par les formats UUID modernes ; 110 par microsoft ; et 111 par future. Décrire les bits ne revient pas à imposer un profil applicatif. Un UUID structurellement correct peut porter une version réservée ou une variante historique. L’outil décrit donc le codage observé au lieu de supposer que toute valeur bien formée doit être de version 4. Votre application peut ensuite appliquer sa propre politique aux champs renvoyés.

Canonicalisation, erreurs et usages pratiques

La canonicalisation ne modifie que la casse des lettres hexadécimales : les cinq groupes et tous les chiffres restent intacts, tandis que les lettres de A à F passent en minuscules. Deux écritures acceptées de la même valeur de 128 bits produisent ainsi exactement la même chaîne canonique. Le validateur ne supprime pas les espaces et ne répare pas une valeur presque correcte, car ce nettoyage automatique pourrait masquer une rupture de sérialisation. Une valeur vide, une valeur qui n’est pas une chaîne, un nombre de caractères erroné, des traits d’union déplacés ou des caractères interdits donnent au contraire des messages explicatifs distincts. Ce comportement convient aux contrôles d’importation, diagnostics de formulaires, jeux d’essai et outils d’assistance où la cause compte autant que la réponse positive ou négative. Envoyez un candidat dans le champ text ; les alias uuid et value sont aussi acceptés pour faciliter l’intégration. L’opération coûte $0.002 par élément via l’API et fonctionne sans réseau, hasard, horloge, modèle ni stockage persistant. Elle contrôle uniquement la syntaxe et les métadonnées intégrées, sans déterminer l’unicité, la propriété, la présence en base ou l’adéquation à un protocole particulier.