Classe CHString
[La classe CHString fait partie de l’infrastructure du fournisseur WMI, qui est maintenant considérée dans l’état final, et aucun développement, amélioration ou mise à jour supplémentaire ne sera disponible pour les problèmes non liés à la sécurité affectant ces bibliothèques. Les API MI doivent être utilisées pour tout nouveau développement.]
Le tableau suivant répertorie les méthodes CHString.
Membres
La classe CHString possède ces types de membres :
Constructeurs
La classe CHString a ces constructeurs.
| Constructeur | Description |
|---|---|
| CHString | Construit des chaînes CHString de différentes manières. |
Méthodes
La classe CHString présente ces méthodes.
| Méthode | Description |
|---|---|
| AllocSysString | Alloue un BSTR à partir des données CHString. |
| Collate | Compare deux chaînes (respecte la casse ; utilise des informations spécifiques aux paramètres régionaux). |
| Comparer | Compare deux chaînes (respecte la casse). |
| CompareNoCase | Compare deux chaînes (ne respecte pas la casse). |
| Empty | Force une chaîne à avoir une longueur de 0 (zéro). |
| Find | Surchargé. Recherche un caractère ou une sous-chaîne à l’intérieur d’une chaîne plus grande. |
| FindOneOf | Recherche le premier caractère correspondant à partir d’un ensemble. |
| Format | Surchargé. Formate la chaîne comme sprintf. |
| FormatMessageW | Surchargé. Formate une chaîne de message. |
| FormatV | Formate la chaîne comme vsprintf. |
| FreeExtra | Supprime toute surcharge de cette chaîne en libérant toute mémoire supplémentaire précédemment allouée à la chaîne. |
| GetAllocLength | Retourne la taille de la mémoire tampon de chaîne. |
| GetAt | Surchargé. Retourne le caractère figurant à une position donnée. |
| GetBuffer | Retourne un pointeur vers les caractères de la chaîne CHString. |
| GetBufferSetLength | Retourne un pointeur vers les caractères de la chaîne CHString, en tronquant à la longueur spécifiée. |
| GetData | Retourne un pointeur vers les données de la chaîne CHString. |
| GetLength | Retourne le nombre de caractères Unicode d’une chaîne CHString. |
| IsEmpty | Teste si une chaîne CHString ne contient aucun caractère. |
| Left | Extrait la partie gauche d’une chaîne (comme la fonction LEFT$ en Basic). |
| LoadStringW | Charge une chaîne CHString existante à partir d’un fichier de ressources. |
| LockBuffer | Désactive le comptage des références et protège la chaîne dans la mémoire tampon. |
| MakeLower | Convertit tous les caractères de cette chaîne en caractères minuscules. |
| MakeReverse | Inverse les caractères de cette chaîne. |
| MakeUpper | Convertit tous les caractères de cette chaîne en caractères majuscules. |
| Mid | Surchargé. Extrait la partie centrale d’une chaîne (comme la fonction MID$ en Basic). |
| ReleaseBuffer | Libère le contrôle de la mémoire tampon retourné par GetBuffer. |
| ReverseFind | Recherche un caractère à l’intérieur d’une chaîne plus grande ; commence à partir de la fin. |
| Right | Extrait la partie droite d’une chaîne (comme la fonction RIGHT$ en Basic). |
| SetAt | Définit un caractère à une position donnée. |
| SpanExcluding | Extrait une sous-chaîne contenant uniquement les caractères qui ne figurent pas dans l’ensemble. |
| SpanIncluding | Extrait une sous-chaîne contenant uniquement les caractères qui figurent dans un ensemble. |
| TrimLeft | Supprime les espaces blancs au début de la chaîne. |
| TrimRight | Supprime les espaces blancs à la fin de la chaîne. |
| UnlockBuffer | Active le comptage des références et libère la chaîne dans la mémoire tampon. |
Opérateurs
The **CHString** class has these operators.
| Opérateur | Description |
|---|---|
| operator != (CHString, CHString) | Compare deux éléments CHString pour déterminer s’ils sont différents. |
| operator != (CHString, LPCWSTR) | Compare un élément CHString à un élément LPCWSTR pour déterminer s’ils sont différents. |
| operator [] | Retourne le caractère figurant à une position donnée, substitution de l’opérateur GetAt. |
| opérateur + | Concatène deux chaînes et retourne une nouvelle chaîne. |
| operator += | Concatène une nouvelle chaîne à la fin d’une chaîne existante. |
| operator < (CHString, LPCWSTR) | Compare un élément CHString à un élément LPCWSTR. |
| operator < (CHString, CHString) | Compare deux éléments CHString. |
| operator <= (CHString, CHString) | Compare deux éléments CHString. |
| operator <= (CHString, LPCWSTR) | Compare un élément CHString à un élément LPCWSTR. |
| operator = | Affecte une nouvelle valeur à une chaîne CHString. |
| operator == (CHString, CHString) | Compare deux éléments CHString pour déterminer s’ils sont égaux. |
| operator == (CHString, LPCWSTR) | Compare un élément CHString à un élément LPCWSTR pour déterminer s’ils sont égaux. |
| operator > (CHString, CHString) | Compare deux éléments CHString. |
| operator > (CHString, LPCWSTR) | Compare un élément CHString à un élément LPCWSTR. |
| operator >= (CHString, CHString) | Compare deux éléments CHString. |
| operator >= (CHString, LPCWSTR) | Compare un élément CHString à un élément LPCWSTR. |
| operator LPCWSTR | Accède directement aux caractères stockés dans une chaîne CHString sous la forme d’une chaîne de style C. |
Notes
Le destructeur de la classe est CHString::~CHString.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|