structure std::hash< ara::core::String >

La spécialisation std::hash< ara::core::String > sert au calcul de valeurs de hachage entières pour des instances de ara::core::String dans le module core. Elle permet l’intégration transparente du type de chaîne Adaptive dans des conteneurs standard non ordonnés. En tant qu’objet fonction sans état, déclaré comme final, elle ne possède aucun cycle de vie complexe et ne nécessite qu’une chaîne de caractères valide pour une évaluation déterministe.

plus ›

Contexte

La structure std::hash< ara::core::String > constitue une spécialisation de template de la classe fonction C++ standardisée std::hash pour le type ara::core::String au sein du module core de l’Adaptive Platform. Conformément à l’architecture générale des bibliothèques standard C++, elle sert d’objet fonction de hachage qui associe des instances de chaînes de caractères à des valeurs de hachage entières. Les partenaires d’interaction typiques sont des conteneurs associatifs standard tels que des ensembles ou des maps non triés, qui ont recours à des interfaces de hachage standardisées pour l’indexation rapide et la distribution des éléments. La déclaration est spécifiée en tant que final, de sorte que toute dérivation ultérieure de cette spécialisation est exclue.

Interprétation : étant donné qu’aucune exigence explicite ni référence documentaire n’est consignée dans le présent extrait de spécification, le rôle de la spécialisation devrait s’insérer de façon transparente dans la sémantique conventionnelle de la bibliothèque standard de std::hash et servir principalement à l’interopérabilité entre ara::core::String et les structures de données basées sur le hachage. Question Q-6d2835413a6e35a5 (ouverte)

Cycle de vie

En tant qu’objet fonction sans état, std::hash< ara::core::String > n’est soumis à aucune phase complexe de cycle de vie ni à des transitions d’état dynamiques. Des exemplaires de la structure peuvent être instanciés au besoin ou créés sous forme d’objets fonctions temporaires et détruits immédiatement après le calcul. Il n’existe aucune relation de propriété persistante sur les chaînes de caractères transmises. La structure étant sans état, l’appel de l’opérateur fonctionnel pour des instances constantes de ara::core::String devrait être intrinsèquement sûr pour la concurrence et thread-safe, tant que la chaîne sous-jacente n’est pas modifiée de manière concurrente pendant le calcul de hachage. Question Q-bec5dd50aaf196d9 (ouverte)

Parcours d'utilisation

L’utilisation régulière de std::hash< ara::core::String > s’effectue soit implicitement par le biais de conteneurs associatifs, soit par instanciation explicite en vue de déterminer la valeur de hachage d’une chaîne de caractères :

• Création ou référencement d’une instance valide de ara::core::String.
• Instanciation de l’objet fonction std::hash< ara::core::String > ou utilisation implicite comme paramètre de hachage par défaut dans des conteneurs standard non ordonnés.
• Exécution de l’opérateur d’appel avec passage de la chaîne de caractères pour renvoyer la valeur de hachage calculée.

Interprétation : le déroulement suit ici probablement le modèle habituel des objets fonctions C++ sans étapes supplémentaires de configuration ou d’initialisation. Question (ouverte)

Scénarios d'erreur

Le calcul de la valeur de hachage présuppose que l’instance de chaîne de caractères ara::core::String transmise est valide. Les états d’erreur ou les codes d’erreur spécifiques au sens de ara::core::ErrorCode ne sont pas indiqués pour cette spécialisation dans la charge utile. En se basant sur les exigences standard des fonctions de hachage, il convient de supposer que le calcul s’effectue de manière déterministe et ne lève habituellement aucune exception, pour autant que l’accès à la zone mémoire de la chaîne soit garanti.