LPTSTR GetBufferSetLength ( int nNewLength );
jeter ( CMemoryException );
Valeur de retour
Un pointeur LPTSTR au tampon de l'objet personnage (par un NULL).
Paramètres
nNewLength
La taille exacte de la mémoire tampon de caractères CString en caractères.
Remarques
Retourne un pointeur vers la mémoire tampon de caractères interne de l'objet CString , tronquer ou de plus en plus de sa longueur si nécessaire pour correspondre exactement à la longueur spécifiée dans nNewLength. Le pointeur retourné de LPTSTR n'est pas const et permet ainsi une modification directe des matières CString.
Si vous utilisez le pointeur retourné par les fonctions membres GetBuffer pour modifier le contenu de la chaîne, vous devez appeler ReleaseBuffer avant d'utiliser les autres fonctions de membre de CString.
L'adresse retournée par GetBufferSetLength ne peut être valide après l'appel à ReleaseBuffer puisque des opérations supplémentaires de CString peuvent provoquer le tampon CString à être réaffecté. La mémoire tampon n'est pas redistribué si vous ne modifiez pas la longueur de CString.
La mémoire tampon est libérée automatiquement lorsque l'objet CString est détruit.
Notez que si vous garder une trace de la longueur de chaîne vous-même, vous ne devez pas ajouter le caractère null de fin. Vous devez, toutefois, spécifier la longueur de la chaîne finale lorsque vous libérer de la mémoire tampon avec ReleaseBuffer. Si vous ajoutez un caractère null de fin lorsque vous appelez ReleaseBuffer, vous devez passer – 1 (par défaut) pour la longueur. ReleaseBuffer se produira un strlen dans la mémoire tampon afin de déterminer sa longueur.
Pour plus d'informations sur le décompte de références, consultez les articles suivants:
Aperçu de CString |nbsp ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;CString::GetBuffer, CString::ReleaseBuffer