CSimpleStringT::ReleaseBuffer
Contrôle de la distribution de la mémoire tampon allouée par GetBuffer.
void ReleaseBuffer(
int nNewLength = -1
);
Paramètres
- nNewLength
La nouvelle longueur de la chaîne de caractères, ne comptant pas une marque de fin null. Si la chaîne est null terminé, la valeur par défaut -1 définit la taille d' CSimpleStringT à la longueur actuelle de la chaîne.
Notes
Appelez cette méthode pour réaffecter ou libérer la mémoire tampon de l'objet String. Si vous savez que la chaîne dans la mémoire tampon est null terminé, vous pouvez omettre l'argument d' nNewLength . Si votre chaîne n'est pas interrompu null, utilisez nNewLength pour spécifier sa longueur. L'adresse retournée par GetBuffer n'est pas valide après l'appel à ReleaseBuffer ou à une autre opération d' CSimpleStringT .
Exemple
L'exemple suivant illustre l'utilisation du mot clé CSimpleStringT::ReleaseBuffer :
const int bufferSize = 1024;
CSimpleString s(_T("abc"), pMgr);
LPTSTR p = s.GetBuffer(bufferSize);
_tcscpy_s(p, bufferSize , _T("abc")); // use the buffer directly
ASSERT(s.GetLength() == 3); // String length = 3
s.ReleaseBuffer(); // Surplus memory released, p is now invalid.
ASSERT(s.GetLength() == 3); // Length still 3
Configuration requise
Header: atlsimpstr.h