Поделиться через


CStringData Class

Этот класс представляет данные строкового объекта.

struct CStringData

Члены

Методы

AddRef

Увеличивает число ссылок объекта данных string.

data

Возвращает символьные данные строкового объекта.

IsLocked

Определяет, если буфер связанного объекта строки блокирована.

IsShared

Определяет, если буфер связанного объекта строки в настоящее время использовать совместно.

Блокировка

Блокирует буфер связанного объекта строки.

Release

Освобождает строчный объект.

Unlock

Разблокирует буфер связанного объекта строки.

Элементы данных

nAllocLength

Длина выбранных данных в XCHAR s (не включая завершения null)

nDataLength

Длина в настоящий момент, используемых данных в XCHAR s (не включая завершения null)

nRefs

Текущий счетчик ссылок объекта.

pStringMgr

Указатель на него строки данного объекта строки.

Заметки

Этот класс должен использоваться только разработчиками, реализующий пользовательские диспетчеры строки. Дополнительные сведения о пользовательских диспетчерах строки см. в разделе управление памятью и CStringT

Этот класс инкапсулирует различные типы сведения и сведения, связанные с более высоким строковые объекты, например объекты CStringT, CSimpleStringT или CFixedStringT. Каждый более высокое строковый объект содержит указатель на объект, связанный CStringData несколько строковых объектов к точке на один и тот же объект данных string. Эта связь представляется значения счетчика ссылок (nRefs) объекта CStringData.

Примечание

В некоторых случаях строкового типа (например, CFixedString) не использует объект данных строки с более чем одним более высоким строковый объект.Дополнительные сведения см. в разделе управление памятью и CStringT.

Эти данные структурируются.

  • Диспетчер памяти (типа IAtlStringMgr) строк.

  • Текущая длина (nDataLength) строк.

  • Выбранная длина (nAllocLength) строк. Для повышения производительности это может отличаться от текущей длиной строки

  • Текущий счетчик ссылок (nRefs) объекта CStringData. Это значение используется для определения того, строковые объекты используют один и тот же объект CStringData.

  • Фактический буфер знаков (данные) строк.

    Примечание

    Фактический буфер символов строкового объекта выбрать диспетчером строки и добавить к объекту CStringData.

Требования

Header: atlsimpstr.h

См. также

Ссылки

Диаграмма иерархии

Другие ресурсы

ATL/MFC Shared Classes