CStringElementTraitsI, classe
Cette classe fournit des fonctions statiques liées aux chaînes stockées dans des objets de classe de collection. Elle est similaire à CStringElementTraits, mais effectue des comparaisons qui ne respectent pas la casse.
Syntaxe
template <typename T, class CharTraits = CDefaultCharTraits<T ::XCHAR>>
class CStringElementTraitsI : public CElementTraitsBase<T>
Paramètres
T
Type de données à stocker dans la collection.
Membres
Typedefs publics
| Nom | Description |
|---|---|
| CStringElementTraitsI ::INARGTYPE | Type de données à utiliser pour ajouter des éléments à l’objet de classe de collection. |
| CStringElementTraitsI ::OUTARGTYPE | Type de données à utiliser pour récupérer des éléments de l’objet de classe de collection. |
Méthodes publiques
| Nom | Description |
|---|---|
| CStringElementTraitsI ::CompareElements | Appelez cette fonction statique pour comparer deux éléments de chaîne pour l’égalité, en ignorant les différences dans le cas. |
| CStringElementTraitsI ::CompareElementsOrdered | Appelez cette fonction statique pour comparer deux éléments de chaîne, ignorant les différences dans le cas. |
| CStringElementTraitsI ::Hash | Appelez cette fonction statique pour calculer une valeur de hachage pour l’élément de chaîne donné. |
Notes
Cette classe fournit des fonctions statiques pour comparer des chaînes et pour créer une valeur de hachage. Ces fonctions sont utiles lors de l’utilisation d’une classe de collection pour stocker des données basées sur des chaînes. Utilisez CStringRefElementTraits lorsque les objets de chaîne doivent être traités comme références.
Pour plus d’informations, consultez les classes de collection ATL.
Hiérarchie d'héritage
CStringElementTraitsI
Spécifications
En-tête : atlcoll.h
CStringElementTraitsI ::CompareElements
Appelez cette fonction statique pour comparer deux éléments de chaîne pour l’égalité, en ignorant les différences dans le cas.
static bool CompareElements(INARGTYPE str1, INARGTYPE str2) throw();
Paramètres
str1
Premier élément de chaîne.
str2
Deuxième élément de chaîne.
Valeur de retour
Retourne true si les éléments sont égaux, false sinon.
Notes
Les comparaisons ne respectent pas la casse.
CStringElementTraitsI ::CompareElementsOrdered
Appelez cette fonction statique pour comparer deux éléments de chaîne, ignorant les différences dans le cas.
static int CompareElementsOrdered(INARGTYPE str1, INARGTYPE str2) throw();
Paramètres
str1
Premier élément de chaîne.
str2
Deuxième élément de chaîne.
Valeur de retour
Zéro si les chaînes sont identiques, < 0 si str1 est inférieur à str2 ou > 0 si str1 est supérieur à str2. La méthode CStringT ::Compare est utilisée pour effectuer les comparaisons.
Notes
Les comparaisons ne respectent pas la casse.
CStringElementTraitsI ::Hash
Appelez cette fonction statique pour calculer une valeur de hachage pour l’élément de chaîne donné.
static ULONG Hash(INARGTYPE str) throw();
Paramètres
str
Élément de chaîne.
Valeur de retour
Retourne une valeur de hachage calculée à l’aide du contenu de la chaîne.
CStringElementTraitsI ::INARGTYPE
Type de données à utiliser pour ajouter des éléments à l’objet de classe de collection.
typedef T::PCXSTR INARGTYPE;
CStringElementTraitsI ::OUTARGTYPE
Type de données à utiliser pour récupérer des éléments de l’objet de classe de collection.
typedef T& OUTARGTYPE;
Voir aussi
CElementTraitsBase, classe
Vue d’ensemble de la classe
CStringElementTraits, classe