LPTSTR GetBufferSetLength ( int nNewLength );
tirar ( CMemoryException );
Valor devuelto
Un puntero LPTSTR al búfer de caracteres (terminada en null) del objeto.
Parámetros
nNewLength
El tamaño exacto del búfer de caracteres CString en caracteres.
Observaciones
Devuelve un puntero al búfer de carácter interno para el objeto CString , truncando o aumentando su longitud si es necesario que coincidan exactamente con la longitud especificada en nNewLength. El puntero LPTSTR devuelto no es const y así permite la modificación directa de contenidos de CString.
Si utiliza el puntero devuelto por GetBuffer para cambiar el contenido de la cadena, debe llamar a ReleaseBuffer antes de utilizar otras funciones de miembro de CString.
La dirección devuelta por GetBufferSetLength puede no ser válida después de la llamada a ReleaseBuffer ya operaciones adicionales de CString pueden causar el búfer de CString se reasignen. El búfer no va ser reasignado si no cambia la longitud de la CString.
La memoria de búfer se liberarán automáticamente cuando se destruye el objeto CString.
Tenga en cuenta que, si realizar un seguimiento de la longitud de la cadena usted mismo, no debe anexar el carácter null de terminación. Sin embargo, debe especificar la longitud de la cadena final cuando suelte el búfer con ReleaseBuffer. Si al llamar a ReleaseBuffer, anexar un carácter nulo, debe pasar – 1 (predeterminado) para la longitud. ReleaseBuffer realizará un strlen en el búfer para determinar su longitud.
Para obtener más información acerca del recuento de referencia, consulte los siguientes artículos:
Visión General de CString |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambié&nnbsp;CString::GetBuffer, CString::ReleaseBuffer