Partager via


CSimpleStringT::SetString

Définit la chaîne d'un objet d' CSimpleStringT .

void SetString( 
   PCXSTR pszSrc, 
   int nLength 
); 
void SetString( 
   PCXSTR pszSrc 
);

Paramètres

  • pszSrc
    Un pointeur vers une chaîne terminée par le caractère NULL.

  • nLength
    Le nombre de caractères dans pszSrc.

Notes

Copiez une chaîne dans l'objet de CSimpleStringT . SetString remplace les données de chaîne plus anciennes dans la mémoire tampon.

Les deux versions d' SetString vérifier si pszSrc est un pointeur null, et si c'est le cas, levez une erreur d' E_INVALIDARG .

La version d'un- paramètre d' SetString attend pszSrc indique une chaîne terminée par le caractère NULL.

La version à deux paramètres d' SetString attend également pszSrc est une chaîne terminée par le caractère NULL. Elle utilise nLength comme longueur de chaîne à moins qu'il rencontre un terminateur null en premier.

La version à deux paramètres d' SetString contrôle également si les points d' pszSrc à un emplacement dans la mémoire tampon actuel dans CSimpleStringT. Dans ce cas particulier, SetString utilise une fonction de copie de mémoire qui ne remplace pas les données de chaîne telle qu'elle copie des données de chaîne vers sa mémoire tampon.

Exemple

L'exemple suivant illustre l'utilisation du mot clé CSimpleStringT::SetString :

CSimpleString s(_T("abcdef"), pMgr);
ASSERT(_tcscmp(s, _T("abcdef")) == 0);

s.SetString(_T("Soccer"), 6);
ASSERT(_tcscmp(s, _T("Soccer")) == 0);   

Configuration requise

en-tête : atlsimpstr.h

Voir aussi

Référence

CSimpleStringT, classe