Управление памятью приложений на нижнем уровне реализуется через иерархическую систему управляющих структур. Структуры нижнего уровня включают в себя головную структуру, структуры групп, блоков, банков и пулов сегментов памяти. Управление памятью на логическом уровне осуществляется через систему классов хэндлов. Структуры нижнего уровня и соответствующие им функции реализуют базовый набор средств работы с памятью. CTC_AllGroup - головная структура управления памятью на нижнем уровне. Структура содержит динамический массив пулов групп памяти mgAllLoc. Каждый пул, в свою очередь, представляет собой массив одинакового числа (mgKolGroupInPul) структур групп памяти CTC_AllLoc.

struct CTC_AllGroup* GetAllGroup(void); Проверяет наличие головной управляющей структуры CTC_AllGroup. При ее отсутствии заказывает память под нее и производит инициализацию. Указатель на структуру CTC_AllGroup. Функция устанавливает число групп в пуле mgKolGroupInPul равным 100. int FreeGroupLoc(struct CTC_AllGroup* AllGroup); Освобождает память, заказанную во всех имеющихся в головной структуре AllGroup группах памяти, память из-под самих структур групп памяти и память из-под массива пулов групп. 0 нет. GetAll1Group FreeAllLoc Группа памяти представлена структурой CTC_AllLoc. Группа включает в себя пулы блоков памяти и массив банков пулов сегментов памяти. Каждый элемент этого массива используется для выделения сегментов памяти ограниченной фиксированной длины из своих пулов. На физическом уровне доступ к группе памяти осуществляется по ее абсолютному (физическому) номеру в разделенном на пулы массиве групп. Нумерация групп начинается с единицы. Логический доступ к группе поддерживается с помощью структуры логического номера группы, состоящей из внутреннего номера и физического (абсолютного) номера. Внутренний номер группы - to be continued.

struct CTC_AllLoc* GetAllLoc(CTC_AllGroup *AllGroup,struct TCtcMemGroup Group,int AddGroup=0); Поставляет указатель на структуру группы памяти CTC_AllLoc по логическому номеру группы Group. Использует физический номер группы в случае неактуальности внутреннего номера. В противном случае использует внутренний номер для выработки физического номера. При отсутствии группы с данным физическим номером в случае ненулевого значения AddGroup создает ее. Указатель на структуру CTC_AllLoc или NULL. Физический номер группы должен находиться в пределах выделенного пространства номеров групп [1...mgKolDopGroup]. GetAll1Group GetIstNomGrup int FreeAllLoc(struct CTC_AllLoc* AllLoc); Освобождает всю память, заказанную в группе AllLoc, и обнуляет структуру группы. 0 При значении счетчика открытий блока больше 1 выдается сообщение ОСВОБОЖДЕНИЕ НЕЗАКРЫТОГО БЛОКА. GetBlokLoc FreeDataBlok GetLocMem FreeLocMem int FreeGroup( int Group ); Освобождает всю память, заказанную в группе с физическим номером Group. 0 Ограничений на значение Group нет. GetAllGroup GetAll1Group FreeAllLoc int FreeGroupL( struct TCtcMemGroup Group ); Освобождает всю память, заказанную в группе с логическим номером Group. 0 нет. GetAllGroup GetAllLoc FreeAllLoc int NewGroupLoc(struct CTC_AllGroup* AllGroup, int KolBlokInPul=1024, int MaxDlinInLocMem=1024); Поставляет абсолютный номер свободной или новой (в отсутствие свободных) группы в массиве групп, устанавливая число блоков в пуле KolBlokInPul и максимальную длину сегмента памяти MaxDlinInLocMem. Абсолютный номер группы в массиве групп. При невозможности выделения номера группы выдает сообщение ОШИБКА RGROUP. GetAllGroup GetAll1Group FreeAllLoc int registerGroup( void ); Поставляет абсолютный номер свободной или новой (в отсутствие свободных) группы в массиве групп. Абсолютный номер группы в массиве групп. То же, что и NewGroupLoc. GetAllGroup NewGroupLoc int GetIstNomGRP(struct TCtcMemGroup Group); Поставляет физический номер группы по ее логическому номеру Group. Физический номер группы. нет. GetAllGroup GetIstNomGrup Блок памяти – структура, посредством которой реализуется управление единым куском оперативной памяти заданной длины. На физическом уровне доступ к блоку осуществляется через его порядковый (физический) номер внутри заданной группы. Нумерация блоков начинается с единицы. Тип блока определяется источником заказа памяти для него.

Тип 0 реализуется при длине заказываемого куска, не меньшей maMaxDlinInLocMem. В этом случае память заказывается из общего системного пула оперативной памяти.

В противном случае реализуется тип 1. Здесь память берется из определенного банка пулов сегментов памяти, соответствующего заданной длине.

Тип 2 означает использование блоком дисковой памяти.

Тип 3 означает, что блоку присвоена память, уже предварительно заказанная до получения номера блока (т.н. "чужая" память).

int NewBlokLoc(struct CTC_AllLoc* AllLoc); Поставляет физический номер свободного блока памяти из группы AllLoc. Устанавливает номер следующего свободного блока группы. Наращивает счетчик занятых блоков группы. Корректирует, при необходимости, максимальный номер занятого блока. Устанавливает счетчик открытий блока равным 1. Физический номер блока.

При ненулевом значении счетчика открытий свободного блока выдает сообщение ПЕРВЫЙ СВОБОДНЫЙ БЛОК НЕ СВОБОДЕН

При нулевом значении ссылки у найденного свободного блока на следующий свободный блок (это означает, что все блоки после найденного также свободны)и значении maMaxUsedBlok (максимальный номер занятого блока), большем найденного номера блока, выдает сообщение Свободный блок без ссылки <= maMaxUsedBlok

При значении ссылки на следующий свободный блок, превышающем maMaxUsedBlok+1, выдает сообщение Cсылкa слишком далеко

При ненулевом значении счетчика открытий следующего свободного блока выдает сообщение Cсылкa на занятый блок

GetBlokLoc struct CTC_BlokLoc* GetBlokLoc(struct CTC_AllLoc* AllLoc, int NomBlok, int AddBlok=0); При взведенном флаге 0x40000000 номера NomBlok определяет физический (порядковый) номер блока в группе AllLoc. В противном случае порядковым номером является NomBlok. Поставляет указатель структуры блока памяти c данным номером из группы AllLoc. При отсутствии блока с таким номером и ненулевом значении AddBlok добавляет блок в группу. Указатель структуры блока памяти или NULL.

Два старших бита номера NomBlok - служебные.

Нулевое значение указателя AllLoc недопустимо.

Порядковый номер блока должен находиться в пределах выделенного пространства номеров [1...mgKolDopGroup].

IstNomBlok AddPulBlok unsigned int SetLocElm(int Dlina,struct TCtcMemGroup Group,void *Adr=NULL); Заказывает кусок памяти длиной Dlina для блока памяти, принадлежащем группе с логическим номером Group, и, в случае ненулевого указателя Adr, заполняет заказанный кусок содержимым памяти по указателю Adr. Источник памяти определяется исходя из значения Dlina (см. выше). Физический номер используемого блока памяти или 0 в случае неудачи.

При невозможности получения структуры группы, соответствующей логическому номеру Group (например, нулевом физическом номере группы), выдает сообщение Незарегистрированная группа.

GetAllGroup GetAllLoc NewBlokLoc GetBlokLoc SetElmFromBlok void *GetLocAdrFromBlok(struct CTC_AllLoc* AllLoc,int NomBlok, struct CTC_BlokLoc* Blok, int Offs=0,int Fix=0); Поставляет указатель на участок куска памяти блока Blok с физическим номером NomBlok в группе AllLoc, смещенный относительно начала куска на Offs байт. При ненулевом младшем бите Fix наращивает счетчик открытий блока. Указатель участка памяти или NULL.

При нулевом значении указателя Blok выдает сообщение Обращение к несуществующему блоку.

При нулевом значении счетчика открытий блока выдает сообщение Обращение к невыделенному блоку.

При отсутствии памяти у блока в зависимости от типа блока выдает следующие сообщения:

Пустые данные при Типе 0

Нет данных в блоке (при типе 1)

Нет места для чтения (при типе 2)

Пустые данные при Типе 3

Некорректный тип блока (при любом другом значении типа)

При типе 1 и сброшенном флаге занятости сегмента выдает сообщение Запрос свободного элемента в блоке

При значении Offs, превышающем длину куска памяти блока, выдает сообщение Обращение за пределы выделенного блока

GetInfoBlokFile SetElmFromBlok GetLocAdrFromBlok ReadDataBlokFile GetLocMem GetElmLoc unsigned int FreeBlokMem(int NomBlok,struct TCtcMemGroup Group); При ненулевом значении физического номера блока NomBlok ИЛИ физического номера группы освобождает всю память, заказанную в блоке c номером NomBlok в группе с логическим номером Group. Помечает блок как свободный, корректирует соответствующие ссылки и параметры (число занятых блоков, номер последнего занятого блока). Поданный номер блока NomBlok.

При отсутствии группы, соответствующей логическому номеру Group, (например, при нулевом действующем значении физического номера) выдает сообщение Незарегистрированная группа.

При ошибочном освобождении памяти блока выдает соответствующие сообщения (см. FreeElmFromBlok).

При возникновении ошибочных ситуаций с освобождением блока выдает следующие сообщения (функция FreeBlokLoc):

при нулевом физическом номере блока NomBlok - Освобождение нулевого блока 0;

при нулевом значении указателя на блок - Освобождение несуществущего блока;

при нулевом значении счетчика открытий блока - Освобождение свободного блока;

при значении счетчика открытий блока больше 1 - Освобождение открытого блока;

при значении NomBlok, превышающем максимальный номер занятого блока, - Освобождаемый Blok > MaxUsedBlok;

при недопустимом значении типа блока - Некорректный тип блока;

при наличии свободного блока с номером меньше NomMem и ненулевом значении счетчика открытий этого блока - Free.Ссылка на занятый элемент;

при нулевом значении ссылки у найденного предшествующего свободного блока на следующий свободный блок (это означает, что все блоки после найденного также свободны) и значении maMaxUsedBlok (максимальный номер занятого блока), не меньшем найденного номера блока, выдает сообщение Свободный элемент без ссылки < maMaxUsedBlok;

при корректировке максимального номера занятого блока, предшествующего освобождаемому, и нулевом указателе на этот предшествующий блок - Free.Почему-то Blok==NULL.

GetAllGroup GetAllLoc GetBlokLoc FreeElmFromBlok FreeBlokLoc unsigned int FreeElmFromBlok(struct CTC_AllLoc* AllLoc, struct CTC_BlokLoc *Blok); Освобождает всю память заказанную в блоке Blok группы AllLoc. 0

При возникновении ошибочных ситуаций с освобождением памяти блока выдает следующие сообщения:

при нулевом значении указателя Blok - Освобождение несуществущего блока;

при нулевом значении счетчика открытий блока - Освобождение невыделенного блока;

при значении счетчика открытий блока больше 1 - Освобождение незакрытого блока;

при недопустимом значении типа блока - Некорректный тип блока.

При возникновении ошибочных ситуаций с освобождением сегмента выдает следующие сообщения (функция FreeElmLoc):

при нулевом значении указателя на сегмент - Освобождение несуществущего элемента;

при сброшенном флаге занятости сегмента - Освобождение свободного элемента;

при значении номера сегмента, превышающем максимальный номер занятого сегмента, - Освобождаемый элемент > MaxUsedElm;

при наличии свободного сегмента с номером меньше номера освобождаемого сегмента и взведенном флаге занятости этого свободного сегмента - Free.Ссылка на занятый элемент;

при нулевом значении ссылки у найденного предшествующего свободного сегмента на следующий свободный сегмент (это означает, что все сегменты после найденного также свободны) и значении максимальногономер занятого сегмента, не меньшем найденного номера, выдает сообщение Свободный элемент без ссылки < maMaxUsedElm;

при корректировке максимального номера занятого сегмента, предшествующего освобождаемому, и нулевом указателе на этот предшествующий сегмент - Free.Почему-то Elm==NULL.

GetLocMem FreeElmLoc unsigned int LGetDlElm(struct TCtcMemGroup Group,unsigned Index); Поставляет длину куска памяти в блоке с физическим номером Index из группы с логическим номером Group. Длина куска памяти или 0 при нулевом значении Index.

При отсутствии группы, соответствующей логическому номеру Group, (например, при нулевом действующем значении физического номера) выдает сообщение GetDlElm.Незарегистрированная группа.

При недопустимом значении типа блока выдает сообщение Некорректный тип блока(функция GetDlElmFromBlok).

GetAllGroup GetAllLoc GetBlokLoc GetDlElmFromBlok unsigned int LAddLocElm(struct TCtcMemGroup &Group,unsigned &Index, int AddDlin,void *AdrAdd=NULL); Расширяет длину куска памяти в блоке с номером Index из группы с логическим номером Group на величину AddDlin и при ненулевом значении указателя AdrAdd заполняет добавленную память содержимым памяти по этому указателю. При отрицательном значении AddDlin добавленный участок пристыковывается к началу куска памяти, при положительном - к концу. При нулевом значении Index генерирует новый блок в заданной группе, заказывая для него кусок памяти длиной AddDlin. 0

Расширение куска памяти для блока, имеющего тип 3 ("чужая" память), ЗАПРЕЩЕНО. При попытке сделать это выдается сообщение Попытка расширить блок типа 3.

При недопустимом значении типа блока выдает сообщение Некорректный тип блока.

При нулевом значении Index функция генерирует новый блок и возвращает с параметром Index его физический номер. При этом функция может изменить значение логического номера группы Group, актуализируя в этом случае физический номер группы.

При нулевом значении физического номера группы, входящего в Group, выдает сообщение Нулевая группа\nФАТАЛЬНО.

При отсутствии группы, соответствующей поданному или сгенерированному логическому номеру, (например, при нулевом действующем значении физического номера) выдает сообщение AddLocElm.Незарегистрированная группа.

GetIstNomGRP SetLocElm GetAllGroup GetAllLoc GetBlokLoc GetDlElmFromBlok ReallocMem GetLocAdrFromBlok FreeBlokLoc Банк сегментов – структура, поддерживающая выделение куска памяти фиксированной для данного банка длины (сегмента) из предварительно заказанного массива памяти большего размера. Максимальная длина данных в сегменте ограничена значением maMaxDlinInLocMem, задаваемом функцией NewGroupLoc. Сегмент – элементарная структура нижнего уровня, состоящая из флага и следующего за ним куска памяти. Сегмент выделяется из предварительно заказанного массива памяти, содержащегося в банке сегментов. Минимальная длина сегмента - 5 байт. struct CTC_ElmLoc *GetElmLoc(struct CTC_AllLoc* AllLoc, struct CTC_LocMem *LocMem, int NomElm,int AddElm=0); Поставляет указатель структуры сегмента памяти c номером NomElm из банка сегментов LocMem группы AllLoc. При отсутствии сегмента с таким номером и ненулевом значении AddElm добавляет сегмент в банк. Указатель структуры сегмента памяти или NULL.

Номер сегмента NomElm должен находиться в пределах выделенного пространства номеров [0...glKolDopElm].

Хэндл - структура, представляющая собой дескриптор блока памяти. Хэндл содержит логический номер группы и индекс – физический номер блока в группе. Хэндлы являются инструментом логического доступа к памяти из приложений. Программно хэндлы реализованы в виде иерархической системы классов с соответствующими функциями (методами) и операторами. Базовый хэндл является основой иерархической системы хэндлов. Через него осуществляются общие операции работы с памятью. Посредством базового хэндла память адресуется с точностью до байта. TCtcMemHandl SetLoc(int Dlina,struct TCtcMemGroup Group,void *Adr=NULL); Заказывает кусок памяти длиной Dlina в группе памяти с логическим номером Group и, в случае ненулевого указателя Adr, заполняет заказанный кусок содержимым памяти по указателю Adr. Хэндл блока памяти. нет. GetIstNomGRP SetLocElm TCtcMemHandl AssignLoc(void *adr,struct TCtcMemGroup Group,int Dlina=0); Выделяет номер блока в группе памяти с логическим номером Group и присваивает этому блоку кусок памяти по указателю adr длиной Dlina. Таким образом, полученный блок имеет тип 3 ("чужая" память). Хэндл блока памяти.

GetAllGroup GetAllLoc NewBlokLoc GetBlokLoc unsigned int FreeLoc(TCtcMemHandl &Handl); Проверяет старший бит индекса хэндла. При нулевом значении этого бита освобождает кусок памяти, представленный хэндлом Handl. 0-старший бит индекса хэндла равен нулю, память освобождена; 1-старший бит индекса хэндла равен единице. нет. FreeBlokMem void *GetLocAdr(TCtcMemHandl Handl,int Offs=0,int Fix=0); Поставляет указатель на участок куска памяти, представленный хэндлом Handl, со смещением Offs от начала куска. При взведенном младшем бите Fix наращивает счетчик открытий соответствующего блока. Указатель участка куска памяти хэндла или NULL (в этом случае выдается сообщение об обращении к несуществующему блоку памяти).

При отсутствии у хэндла Handl блока выдает сообщение Обращение к несуществующему блоку.

GetAllGroup GetAllLoc GetBlokLoc GetLocAdrFromBlok int PutLoc(TCtcMemHandl &Handl,int Offs,int Dl,char *Adr); При отсутствии у представленного хэндлом Handl блока участка памяти длиной Dl, смещенного от начала куска памяти на Offs байт, наращивает кусок до требуемой длины и копирует содержимое памяти по указателю Adr в заданный участок куска памяти. 0 При нулевом значении индекса хэндла Handl (отсутствии блока памяти) генерирует новый блок памяти длины Dl. В этом случае функция изменяет значение хэндла Handl, изменив в нем индекс хэндла и, возможно, логический номер группы посредством вызова функции LAddLocElm. ReallocLocElm GetLocAdr void *IniLocAdr(TCtcMemHandl Handl); Открывает хэндл, т.е. поставляет указатель куска памяти, представленный хэндлом Handl, и наращивает счетчик открытий соответствующего блока. Указатель куска памяти хэндла или NULL. нет. GetLocAdr int OutLocAdr(TCtcMemHandl Handl); Уменьшает на единицу счетчик открытий блока, соответствующего хэндлу Handl. Результирующее значение счетчика открытий.

Блок должен существовать физически, иначе выдается сообщение Закрытие несуществующего блока.

Блок должен быть связан с куском памяти, иначе выдается сообщение Закрытие блока без адреса.

Счетчик открытий блока должен превышать 1, иначе выдается сообщение Закрытие неоткрытого блока.

GetAllGroup GetAllLoc GetBlokLoc unsigned int ReallocLocElm(TCtcMemHandl &Handl,int DlNew, void *AdrAdd=NULL); При значении DlNew, превышающей текущую длину куска памяти хэндла Handl, наращивает текущую длину куска до требуемой величины. При ненулевом значении AdrAdd копирует содержимое памяти по AdrAdd длиной DlNew в кусок памяти хэндла. 0 При нулевом значении индекса хэндла Handl (т.е. отсутствии блока памяти) генерирует новый блок памяти длины DlNew. В этом случае функция изменяет значение хэндла Handl, изменив в нем индекс хэндла и, возможно, логический номер группы посредством вызова функции LAddLocElm. GetDlElm GetAllGroup GetAllLoc GetBlokLoc AddLocElm PutLoc unsigned int ReplaceLocElm(TCtcMemHandl Handl,int DlNew,void *AdrAdd); Выполняет те же действия, что и функция ReallocLocElm. 0 То же, что и для функции ReallocLocElm. unsigned int AddLocElm(TCtcMemHandl &Handl,int AddDlin,void *AdrAdd=NULL); Расширяет длину куска памяти хэндла Handl на величину AddDlin c конца куска при положительном значении AddDlin или на величину -AddDlin с начала куска при отрицательном значении AddDlin. При ненулевом значении указателя AdrAdd заполняет добавленную память содержимым памяти по этому указателю. При отсутствии блока памяти у поданного хэндла генерирует новый блок. 0 Функция изменяет значение хэндла Handl при генерации нового блока памяти. LAddLocElm unsigned int GetDlElm(TCtcMemHandl Handl); Поставляет длину куска памяти хэндла Handl. Длина куска памяти хэндла Handl или 0 при нулевых значениях физического номера группы и индекса хэндла. нет. TCtcMemHandl::TCtcMemHandl(void); Конструктор по умолчанию. Создает хэндл и инициализирует все его поля нулями. нет. char* TCtcMemHandl::Ini(); Открывает хэндл, поставляя указатель на кусок его памяти и наращивая счетчик открытий. нет. IniLocAdr char* TCtcMemHandl::Adr(int Beg=0); Поставляет указатель на участок куска памяти хэндла со смещением Beg. При отсутствии блока памяти хэндла выдает сообщение об обращении к несуществующему блоку памяти и возвращает NULL. GetLocAdr void TCtcMemHandl::Clear(void); Обнуляет все поля хэндла. нет. void TCtcMemHandl::Set(int Dl,int NGroup,void *Adr=NULL); Генерирует для хэндла блок памяти в группе с физическим номером NGroup, заказывает для этого блока кусок памяти длиной Dl и копирует в него содержимое памяти по Adr в случае его ненулевого значения. нет. SetLoc void TCtcMemHandl::Set(int Dl,struct TCtcMemGroup Group,void *Adr=NULL); Генерирует для хэндла блок памяти в группе с логическим номером Group, заказывает для этого блока кусок памяти длиной Dl и копирует в него содержимое памяти по Adr в случае его ненулевого значения. нет. SetLoc void TCtcMemHandl::NEW(int NGroup,int Dl,void *Adr=NULL); То же, что и TCtcMemHandl::Set(int,int,void*). нет. TCtcMemHandl::Set(int,int,void*) void TCtcMemHandl::NEW(struct TCtcMemGroup Group,int Dl,void *Adr=NULL); То же,что и TCtcMemHandl::Set(int,TCtcMemGroup,void*). нет. TCtcMemHandl::Set(int,TCtcMemGroup,void*) void TCtcMemHandl::Free(void); Освобождает кусок памяти хэндла и обнуляет его поля. нет. FreeLoc int TCtcMemHandl::KolElm(void); Поставляет длину куска памяти хэндла. нет. GetDlElm void TCtcMemHandl::Realloc(int KolElm,void *Adr); Увеличивает текущую длину куска памяти хэндла до значения KolElm и копирует в него содержимое памяти по указателю Adr. При нулевом значении индекса хэндла (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти длины KolElm. ReallocLocElm void TCtcMemHandl::Replace(int KolElm,void *Adr); То же, что и TCtcMemHandl::Realloc(int,void*). То же, что и TCtcMemHandl::Realloc(int,void*). ReallocLocElm void TCtcMemHandl::Put(int BegElm,int KolElm,void *Adr); При превышении суммой BegElm+KolElm текущей длины куска памяти хэндла наращивает ее до значения BegElm+KolElm байт и при ненулевом значении Adr копирует в смещенный на BegElm байт участок содержимое памяти по Adr длиной KolElm байт. В противном случае обнуляет данный участок. При нулевом значении индекса хэндла (т.е. отсутствии связанного с хэндлом блока памяти) генерирует новый блок памяти длины BegElm+KolElm байт. TCtcMemHandl::Replace(int,void*) void TCtcMemHandl::Add(int KolElm,void *Adr); Расширяет текущую длину куска памяти хэндла на величину KolElm с конца куска при положительном значении KolElm или на величину -KolElm с начала куска при отрицательном значении KolElm. При ненулевом значении указателя Adr заполняет добавленную память содержимым памяти по этому указателю. При отсутствии блока памяти у поданного хэндла генерирует новый блок. При нулевом значении индекса хэндла (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти длины KolElm. AddLocElm void TCtcMemHandl::Insert(int BegElm,int KolElm,void *Adr); При значении BegElm меньше текущей длины куска памяти хэндла расширяет текущую длину куска памяти хэндла на KolElm байт, перенося содержимое куска со смещения BegElm на KolElm байт. В противном случае наращивает текущую длину куска памяти хэндла до значения BegElm+KolElm байт. При ненулевом значении Adr вставляет в кусок памяти, начиная со смещения BegElm байт, содержимое памяти по Adr длиной KolElm байт. В противном случае обнуляет вставленный участок. При нулевом значении индекса хэндла (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти длины BegElm+KolElm. TCtcMemHandl::Add(int,void*) TCtcMemHandl::Adr(int) TCtcMemHandl::Put(int,int,void*) int TCtcMemHandl::SetReference(TCtcMemHandl HAdd, int NomRef); To be done To be done GetAllGroup GetAllLoc GetBlokLoc int TCtcMemHandl::IsMult(TCtcMemHandl HAdd); Устанавливает признак мультихэндла в блоке памяти хэндла HAdd. GetAllGroup GetAllLoc GetBlokLoc void TCtcMemHandl::operator=(int h); Обнуляет индекс хэндла. нет. TCtcMemHandl& TCtcMemHandl::operator=(const TCtcMemHandl &h); При действительном физическом номере группы хэндла копирует поля хэндла h в соответствующие поля хэндла. нет. GetIstNomGRP SetInternalGroup GetBlokLoc bool TCtcMemHandl::operator >(const unsigned int &h ); При ненулевом физическом номере группы хэндла и значении индекса хэндла (при сброшенном старшем бите) больше h возвращает значение ИСТИНА, в противном случае - ЛОЖЬ. нет. bool TCtcMemHandl::operator == (const unsigned int &h) При равенстве значении индекса (при сброшенном старшем бите) хэндла значению h возвращает значение ИСТИНА, в противном случае - ЛОЖЬ; нет. TCtcMemHandl& TCtcMemHandl::operator<<=(TCtcMemHandl &h); Возвращает ссылку на хэндл, взводя старший бит индекса хэндла h. нет. TCtcMemHandl& TCtcMemHandl::operator|=(const TCtcMemHandl &h); Возвращает ссылку на хэндл, копируя в него поля хэндла h и в случае, если операнды не являются одним и тем же хэндлом, взводит старший бит первого операнда (т.е. стоящего в левой части). нет. char* TCtcMemHandl::operator ()(const int Index); Поставляет указатель на кусок памяти хэндла со смещением Index байт от начала куска без наращивания счетчика открытий хэндла. При отсутствии блока памяти хэндла выдает сообщение (обращение к несуществующему блоку) и возвращает NULL. GetLocAdr Типизированные хэндлы наследуют все методы и операторы базового хэндла. Элементом памяти, адресуемым с помощью типизированного хэндла, является объект определенного типа. Существуют следующие классы типизированных хэндлов: Класс (условный класс NAME_LOCCL) Тип элемента (условный тип TIP_LOC) TMemCharchar TMemShortshort TMemIntint TMemFloatfloat TMemDoubledouble TMultMemHandlTCtcMemHandl

Класс TMultMemHandl или мультихэндл заслуживает особого упоминания, так как в этом случае элементом памяти хэндла является не объект простого стандартного типа, а базовый хэндл. Это обстоятельство обусловливает некоторую специфику в методах работы с мультихэндлом.

int NAME_LOCCL::KolElm(void); Поставляет количество элементов соответствующего типа в хэндле. нет. TCtcMemHandl::KolElm(void) void NAME_LOCCL::Set(int KolElm,int NGroup,TIP_LOC *Adr); Генерирует для типизированного хэндла блок памяти в группе с физическим номером NGroup, заказывает для этого блока кусок памяти длиной KolElm элементов типа TIP_LOC и копирует в него содержимое памяти по Adr в случае его ненулевого значения. В случае мультихэндла устанавливает в структуре блока памяти хэндла соответствующий признак с помощью функции TCtcMemHandl::IsMult(TCtcMemHandl). TCtcMemHandl::Set(int,int,void*) void NAME_LOCCL::NEW(int NGroup,int KolElm,TIP_LOC *Adr); To же, что и NAME_LOCCL::Set(int,int,TIP_LOC*) To же, что и NAME_LOCCL::Set(int,int,TIP_LOC*) NAME_LOCCL::Set(int,int,TIP_LOC*) void NAME_LOCCL::Set(int KolElm,struct TCtcMemGroup Group,TIP_LOC *Adr); Генерирует для типизированного хэндла блок памяти в группе с логическим номером Group, заказывает для этого блока кусок памяти длиной KolElm элементов типа TIP_LOC и копирует в него содержимое памяти по Adr в случае его ненулевого значения. To же, что и NAME_LOCCL::Set(int,int,TIP_LOC*) TCtcMemHandl::Set(int,TCtcMemGroup,void*) void NAME_LOCCL::NEW(struct TCtcMemGroup Group,int KolElm,TIP_LOC *Adr); То же, что и NAME_LOCCL::Set(int,TCtcMemGroup,TIP_LOC*). To же, что и NAME_LOCCL::Set(int,int,TIP_LOC*) NAME_LOCCL::Set(int,TCtcMemGroup,TIP_LOC*) void NAME_LOCCL::Set(int KolElm,int NGroup); Генерирует для типизированного хэндла блок памяти в группе с физическим номером NGroup и заказывает для этого блока кусок памяти длиной KolElm элементов соответствующего типа. To же, что и NAME_LOCCL::Set(int,int,TIP_LOC*) TCtcMemHandl::Set(int,int,void*) void NAME_LOCCL::NEW(int NGroup,int KolElm=5); То же, что и NAME_LOCCL::Set(int,int). To же, что и NAME_LOCCL::Set(int,int,TIP_LOC*) Если не задано KolElm, оно принимается равным 5. NAME_LOCCL::Set(int,int,TIP_LOC*) void NAME_LOCCL::Set(int KolElm,struct TCtcMemGroup Group); Генерирует для типизированного хэндла блок памяти в группе с логическим номером Group и заказывает для этого блока кусок памяти длиной KolElm элементов соответствующего типа. To же, что и NAME_LOCCL::Set(int,int,TIP_LOC*) NAME_LOCCL::Set(int,TCtcMemGroup,TIP_LOC*) void NAME_LOCCL::NEW(struct TCtcMemGroup Group,int KolElm=5); То же, что и NAME_LOCCL::Set(int,TCtcMemGroup). То же, что и NAME_LOCCL::NEW(int,int). NAME_LOCCL::Set(int,TCtcMemGroup) TIP_LOC* NAME_LOCCL::Ini(); Открывает типизированный хэндл, поставляя указатель на начальный (нулевой) элемент типа TIP_LOC и наращивая счетчик открытий. нет. TCtcMemHandl::Ini() TIP_LOC* NAME_LOCCL::Adr(int Beg); При значении Beg, не превышающем общее число элементов типа TIP_LOC в типизированном хэндле, поставляет указатель на элемент с номером Beg. В противном случае возвращает NULL. Нет. TCtcMemHandl::Adr(int) TIP_LOC* NAME_LOCCL::Adr(void); Поставляет указатель на нулевой элемент типизированного хэндла. Нет. NAME_LOCCL::Adr(int) void NAME_LOCCL::Put(int BegElm,int KolElm,TIP_LOC *Adr); При необходимости наращивает текущую длину куска памяти типизированного хэндла до значения BegElm+KolElm элементов памяти типа TIP_LOC и при ненулевом значении Adr копирует в смещенный на BegElm элементов памяти участок содержимое памяти по Adr длиной KolElm элементов. В противном случае обнуляет данный участок. Нет. TCtcMemHandl::Put(int,int,void*) void NAME_LOCCL::Insert(int BegElm,int KolElm,TIP_LOC *Adr); При значении BegElm меньше текущего числа элементов памяти типизированного хэндла расширяет текущую длину куска памяти хэндла на значение KolElm элементов памяти, перенося содержимое куска со смещения BegElm на KolElm элементов памяти. В противном случае наращивает текущую длину куска памяти хэндла до значения BegElm+KolElm элементов памяти. При ненулевом значении Adr вставляет в кусок памяти, начиная со смещения BegElm элементов памяти, содержимое памяти по Adr длиной KolElm элементов. В противном случае обнуляет вставленный участок. При нулевом значении индекса хэндла (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти длины BegElm+KolElm элементов памяти. TCtcMemHandl::Insert(int,int,void*) void NAME_LOCCL::Add(int KolElm,TIP_LOC *Adr); Расширяет длину куска памяти типизированного хэндла на величину KolElm элементов памяти c конца куска при положительном значении KolElm или на величину -KolElm с начала куска при отрицательном значении KolElm. При ненулевом значении указателя Adr заполняет добавленную память содержимым памяти по этому указателю. При нулевом значении индекса хэндла (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти и выделяет для него кусок памяти длины KolElm элементов памяти. AddLocElm void NAME_LOCCL::Add(int KolElm); Расширяет длину куска памяти типизированного хэндла на величину KolElm элементов памяти c конца куска при положительном значении KolElm или на величину -KolElm с начала куска при отрицательном значении KolElm. При отсутствии блока памяти у поданного хэндла генерирует новый блок. При нулевом значении индекса хэндла (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти длины KolElm элементов памяти. NAME_LOCCL::Add(int,TIP_LOC*) void NAME_LOCCL::Realloc(int KolElm,TIP_LOC *Adr); При значении KolElm, превышающей текущее число элементов памяти типизированного хэндла, наращивает текущее число элементов до требуемой величины. При ненулевом значении Adr копирует KolElm элементов памяти по Adr в кусок памяти хэндла. При нулевом значении индекса хэндла (т.е. отсутствии блока памяти) генерирует новый блок с куском памяти длины KolElm элементов. В этом случае функция изменяет значение хэндла, назначив в нем индекс хэндла и, возможно, логический номер группы. ReallocLocElm void NAME_LOCCL::Realloc(int KolElm); При значении KolElm, превышающей текущее число элементов памяти типизированного хэндла, наращивает текущее число элементов до требуемой величины. При нулевом значении индекса хэндла (т.е. отсутствии блока памяти) генерирует новый блок памяти длины KolElm элементов. В этом случае функция изменяет значение хэндла, назначив в нем индекс хэндла и, возможно, логический номер группы. NAME_LOCCL::Realloc(int,TIP_LOC*) void NAME_LOCCL::Replace(int KolElm,TIP_LOC *Adr); Выполняет те же действия, что и NAME_LOCCL::Realloc(int,TIP_LOC*). То же, что и NAME_LOCCL::Realloc(int,TIP_LOC*). ReplaceLocElm void NAME_LOCCL::Replace(int KolElm); Выполняет те же действия, что и NAME_LOCCL::Realloc(int). То же, что и NAME_LOCCL::Realloc(int). NAME_LOCCL::Replace(int,TIP_LOC*) void NAME_LOCCL::Free(void); Освобождает кусок памяти типизированного хэндла и обнуляет его поля. В случае мультихэндла предварительно освобождает куски памяти хэндлов-элементов. TCtcMemHandl::Free() NAME_LOCCL& NAME_LOCCL::operator=(const TCtcMemHandl &h); При действительном физическом номере группы типизированного хэндла, копирует поля хэндла h в соответствующие поля типизированного хэндла. нет. TCtcMemHandl::operator=(const TCtcMemHandl&) TIP_LOC* NAME_LOCCL::operator ()(const int Index); Поставляет указатель на Index-ный элемент памяти типизированного хэндла без наращивания счетчика открытий хэндла. При отсутствии блока памяти хэндла выдает сообщение (обращение к несуществующему блоку) и возвращает NULL. GetLocAdr TIP_LOC& NAME_LOCCL::operator [](const int Index); Поставляет ссылку на Index-ный элемент памяти типизированного хэндла без наращивания счетчика открытий хэндла. При отсутствии блока памяти хэндла выдает сообщение (обращение к несуществующему блоку). GetLocAdr TIP_LOC* NAME_LOCCL::operator ->(void); Поставляет указатель на нулевой элемент памяти типизированного хэндла без наращивания счетчика открытий хэндла. При отсутствии блока памяти типизированного хэндла выдает сообщение (обращение к несуществующему блоку) и возвращает NULL. GetLocAdr Пулы непосредственно наследуют все методы и операторы мультихэндла и фактически являются типизированными мультихэндлами (хэндлами-пулами), так как здесь все хэндлы-элементы памяти типизированного хэндла TMultMemHandl, сами, в свою очередь, является типизированными хэндлами одного определенного класса. Есть следующие классы пулов: Класс хэндла-пула (условный класс NAME_PULCL) Класс хэндла-элемента (условный тип NAME_LOCCL) TPulCharTMemChar TPulStrTMemChar TPulShortTMemShort TPulIntTMemInt TPulFloatTMemFloat TPulDoubleTMemDouble TPulMemHandlTMultMemHandl

Хотя класс TPulStr и является непосредственным наследником класса TPulChar, он все же может быть отнесен к пулам, так как реализует вариант TPulChar c поддержкой средств работы с нуль-терминированными строками. Это нашло свое отражение в специфике его методов и операторов.

void NAME_PULCL::Set(int KolElm,int Group,NAME_LOCCL *Adr); Вызывает NAME_LOCCL::Set(int,int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. Устанавливает в структуре блока памяти хэндла соответствующий признак с помощью функции TCtcMemHandl::IsMult(TCtcMemHandl). NAME_LOCCL::Set(int,int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::NEW(int Group,int KolElm,NAME_LOCCL *Adr); То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). NAME_LOCCL::Set(int,int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Set(int KolElm,struct TCtcMemGroup Group,NAME_LOCCL *Adr); Вызывает NAME_LOCCL::Set(int,TCtcMemGroup,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). NAME_LOCCL::Set(int,TCtcMemGroup,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::NEW(struct TCtcMemGroup Group,int KolElm,NAME_LOCCL *Adr); То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). NAME_LOCCL::Set(int,TCtcMemGroup,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Set(int KolElm,int Group); Генерирует для хэндла-пула блок памяти в группе с физическим номером Group. То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). NAME_LOCCL::Set(int,int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::NEW(int Group,int KolElm=5); То же, что и NAME_PULCL::Set(int,int). То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). Если параметр KolElm не задан, он принимается равным 5. NAME_LOCCL::Set(int,int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Set(int KolElm,struct TCtcMemGroup Group); Генерирует для хэндла-пула блок памяти в группе с логическим номером Group. То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). NAME_LOCCL::Set(int,TCtcMemGroup,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::NEW(struct TCtcMemGroup Group, int KolElm=5); То же, что и NAME_PULCL::Set(int,TCtcMemGroup). То же, что и NAME_PULCL::Set(int,int,NAME_LOCCL*). Если параметр KolElm не задан, он принимается равным 5. NAME_LOCCL::Set(int,TCtcMemGroup,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. NAME_LOCCL* NAME_PULCL::Ini(); Открывает хэндл-пул, поставляя указатель на начальный (нулевой) элемент типа NAME_LOCCL и наращивая счетчик открытий. нет. NAME_LOCCL::Ini(), где NAME_LOCCL=TMultMemHandl. NAME_LOCCL* NAME_PULCL::Adr(int Beg); При значении Beg, не превышающем общее число элементов типа NAME_LOCCL в хэндле-пуле, поставляет указатель на элемент с номером Beg. В противном случае возвращает NULL. нет. NAME_LOCCL::Adr(int), где NAME_LOCCL=TMultMemHandl. NAME_LOCCL* NAME_PULCL::Adr(void); Поставляет указатель на нулевой элемент хэндла-пула. нет. NAME_LOCCL::Adr(void), где NAME_LOCCL=TMultMemHandl. void NAME_PULCL::Put(int BegElm,int KolElm,NAME_LOCCL *Adr); Пре необходимости наращивает текущую длину куска памяти хэндла-пула до значения BegElm+KolElm элементов памяти типа NAME_LOCCL и при ненулевом значении Adr копирует в смещенный на BegElm элементов участок содержимое памяти по Adr длиной KolElm элементов. В противном случае обнуляет данный участок. нет. NAME_LOCCL::Put(int,int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Insert(int BegElm,int KolElm,NAME_LOCCL *Adr); При значении BegElm меньше текущего значения числа элементов хэндла-пула расширяет текущую длину куска памяти хэндла-пула на значение KolElm элементов памяти, перенося содержимое куска со смещения BegElm на KolElm элементов памяти. В противном случае наращивает текущую длину куска памяти хэндла-пула до значения BegElm+KolElm элементов памяти. При ненулевом значении Adr вставляет в кусок памяти, начиная со смещения BegElm элементов памяти, содержимое памяти по Adr длиной KolElm элементов. В противном случае обнуляет вставленный участок. При нулевом значении индекса хэндла-пула (т.е. отсутствии блока памяти у хэндла-пула) генерирует новый блок памяти длины BegElm+KolElm элементов памяти типа NAME_LOCCL. NAME_LOCCL::Insert(int,int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Add(int KolElm,NAME_LOCCL *Adr); Расширяет длину куска памяти хэндла-пула на величину KolElm элементов памяти c конца куска при положительном значении KolElm или на величину -KolElm с начала куска при отрицательном значении KolElm. При ненулевом значении указателя Adr заполняет добавленную память содержимым памяти по этому указателю. При нулевом значении индекса хэндла-пула (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти и выделяет для него кусок памяти длины KolElm элементов памяти. NAME_LOCCL::Add(int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Add(int KolElm); Расширяет длину куска памяти хэндла-пула на величину KolElm элементов памяти c конца куска при положительном значении KolElm или на величину -KolElm с начала куска при отрицательном значении KolElm. То же, что и NAME_PULCL::Add(int,NAME_LOCCL*). NAME_LOCCL::Add(int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Realloc(int KolElm,NAME_LOCCL *Adr); При значении KolElm, превышающем текущее число элементов памяти хэндла-пула, наращивает текущее число элементов до требуемой величины. При ненулевом значении Adr копирует KolElm элементов памяти по Adr в кусок памяти хэндла-пула. При нулевом значении индекса хэндла-пула (т.е. отсутствии блока памяти) генерирует новый блок с куском памяти длины KolElm элементов. В этом случае функция изменяет значение хэндла-пула, назначив в нем индекс хэндла и, возможно, логический номер группы. NAME_LOCCL::Realloc(int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Realloc(int KolElm); При значении KolElm, превышающем текущее число элементов памяти хэндла-пула, наращивает текущее число элементов до требуемой величины. То же, что и NAME_PULCL::Realloc(int,NAME_LOCCL*). NAME_LOCCL::Realloc(int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Replace(int KolElm,NAME_LOCCL *Adr); Выполняет те же действия, что и NAME_PULCL::Realloc(int,NAME_LOCCL*). То же, что и NAME_PULCL::Realloc(int,NAME_LOCCL*). NAME_LOCCL::Replace(int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. void NAME_PULCL::Replace(int KolElm); Выполняет те же действия, что и NAME_PULCL::Realloc(int). То же, что и NAME_PULCL::Realloc(int). NAME_LOCCL::Replace(int,TIP_LOC*), где NAME_LOCCL=TMultMemHandl, TIP_LOC=TCtcMemHandl. int NAME_PULCL::KolInElm(int NomPul); Возвращает число элементов соответствующего типа в типизированном хэндле, являющимся NomPul-ным элементом хэндла-пула. Если указатель NomPul-ного элемента хэндла-пула - NULL, например, в случае, когда NomPul не меньше общего числа элементов хэндла-пула, функция возвращает 0. NAME_PULCL::Adr(int) NAME_LOCCL::KolElm(void) void NAME_PULCL::FreeElm(int NomPul); Освобождает кусок памяти и обнуляет поля типизированного хэндла, являющимся NomPul-ным элементом хэндла-пула. Осуществляет проверку на непревышение NomPul общего числа элементов хэндла-пула и действительность указателя на NomPul-ный элемент хэндла-пула. NAME_LOCCL::KolElm(void) NAME_PULCL::Adr(int) NAME_LOCCL::Free(void) void NAME_PULCL::SetElm(int NomPul,int KolElm,TIP_LOC *Adr=NULL); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). Освобождает существующий типизированный хэндл, находящийся в позиции NomPul хэндла-пула. Генерирует для типизированного хэндла в этой позиции блок памяти в группе хэндла-пула, заказывает для этого блока кусок памяти длиной KolElm элементов типа TIP_LOC и копирует в него содержимое памяти по Adr в случае его ненулевого значения. В случае, если типизированный хэндл является мультихэндлом, устанавливает в структуре блока памяти типизированного хэндла соответствующий признак с помощью функции TCtcMemHandl::IsMult(TCtcMemHandl). NAME_PULCL::Replace(int) NAME_PULCL::Adr(int) NAME_PULCL::FreeElm(int) NAME_LOCCL::NEW(TCtcMemGroup,int,TIP_LOC*) void NAME_PULCL::AddElm(int KolElm,TIP_LOC *Adr=NULL); Пристыковывает к концу хэндла-пула один элемент - типизированный хэндл, генерирует для него блок памяти в группе хэндла-пула, заказывает для этого блока кусок памяти длиной KolElm элементов типа TIP_LOC и копирует в него содержимое памяти по Adr в случае его ненулевого значения. То же, что и для NAME_PULCL::SetElm(int,int,TIP_LOC*). NAME_LOCCL::KolElm(void) NAME_PULCL::SetElm(int,int,TIP_LOC*) void NAME_PULCL::InsertElm(int NomPul,int KolElm,TIP_LOC *Adr=NULL); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). В противном случае наращивает число элементов памяти хэндла-пула на единицу и переносит значения элементов на одну позицию вперед, начиная с позиции NomPul. Генерирует для типизированного хэндла в этой позиции блок памяти в группе хэндла-пула, заказывает для этого блока кусок памяти длиной KolElm элементов типа TIP_LOC и копирует в него содержимое памяти по Adr в случае его ненулевого значения. То же, что и для NAME_PULCL::SetElm(int,int,TIP_LOC*). NAME_LOCCL::KolElm(void) NAME_PULCL::Add(int) NAME_PULCL::Adr(void) TCtcMemHandl::Clear(void) NAME_PULCL::SetElm(int,int,TIP_LOC*) TIP_LOC* NAME_PULCL::AdrElm(int NomPul,int NomElm=0); При ненулевом значении указателя на типизированный хэндл, находящийся в позиции NomPul хэндла-пула, поставляет указатель на NomElm-ный элемент этого типизированного хэндла. В противном случае возвращает NULL. нет. NAME_PULCL::Adr(int) NAME_LOCCL::Adr(int) void NAME_PULCL::PutElm(int NomPul,int BegElm,int KolElm,TIP_LOC *Adr=NULL); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). При нулевом физическом номере группы NomPul-ного типизированного хэндла назаначает ему логический номер группы хэндла-пула. При необходимости наращивает текущую длину куска памяти NomPul-ного типизированного хэндла до значения BegElm+KolElm элементов памяти типа TIP_LOC и при ненулевом значении Adr копирует в смещенный на BegElm элементов участок содержимое памяти по Adr длиной KolElm элементов. В противном случае обнуляет данный участок. При нулевом значении индекса NomPul-ного типизированного хэндла (т.е. отсутствии блока памяти) генерирует новый блок с куском памяти длины (BegElm+KolElm) элементов. В этом случае функция изменяет значение NomPul-ного типизированного хэндла, назначив в нем индекс хэндла и, возможно, логический номер группы. NAME_PULCL::Replace(int) NAME_PULCL::Adr(int) NAME_LOCCL::Put(int,int,TIP_LOC*) void NAME_PULCL::InsertInElm(int NomPul,int BegElm,int KolElm,TIP_LOC *Adr=NULL); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). При нулевом физическом номере группы NomPul-ного типизированного хэндла назаначает ему логический номер группы хэндла-пула. При значении BegElm меньше текущего числа элементов памяти NomPul-ного типизированного хэндла расширяет текущую длину куска памяти этого хэндла на значение KolElm элементов памяти типа TIP_LOC, перенося содержимое куска со смещения BegElm на KolElm элементов памяти. В противном случае наращивает текущую длину куска памяти типизированного хэндла до значения BegElm+KolElm элементов памяти типа TIP_LOC. При ненулевом значении Adr вставляет в кусок памяти, начиная со смещения BegElm элементов памяти, содержимое памяти по Adr длиной KolElm элементов. В противном случае обнуляет вставленный участок. При нулевом значении индекса NomPul-ного типизированного хэндла (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти длины BegElm+KolElm элементов памяти типа TIP_LOC. NAME_PULCL::Replace(int) NAME_PULCL::Adr(int) NAME_LOCCL::Insert(int,int,TIP_LOC*) void NAME_PULCL::AddInElm(int NomPul,int KolElm,TIP_LOC *Adr=NULL); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). При нулевом физическом номере группы NomPul-ного типизированного хэндла назаначает ему логический номер группы хэндла-пула. Наращивает текущую длину куска памяти NomPul-ного типизированного хэндла с конца на KolElm элементов памяти типа TIP_LOC и при ненулевом значении Adr копирует в добавленный участок содержимое памяти по Adr. В противном случае обнуляет добавленный участок. При нулевом значении индекса NomPul-ного типизированного хэндла (т.е. отсутствии блока памяти) генерирует новый блок с куском памяти длины KolElm элементов. В этом случае функция изменяет значение NomPul-ного типизированного хэндла, назначив в нем индекс хэндла и, возможно, логический номер группы. NAME_PULCL::KolInElm(int) NAME_PULCL::PutElm(int,int,int,TIP_LOC*) void NAME_PULCL::ReallocElm(int NomPul,int KolElm,TIP_LOC *Adr=NULL); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). При нулевом физическом номере группы NomPul-ного типизированного хэндла назаначает ему логический номер группы хэндла-пула. При значении KolElm, превышающей текущее число элементов памяти NomPul-ного типизированного хэндла, наращивает текущее число элементов до требуемой величины. При ненулевом значении Adr копирует KolElm элементов памяти по Adr в кусок памяти типизированного хэндла. При нулевом значении индекса NomPul-ного типизированного хэндла (т.е. отсутствии блока памяти) генерирует новый блок с куском памяти длины KolElm элементов. В этом случае функция изменяет значение NomPul-ного типизированного хэндла, назначив в нем индекс хэндла и, возможно, логический номер группы. NAME_PULCL::Replace(int) NAME_PULCL::Adr(int) NAME_LOCCL::Realloc(int,TIP_LOC*) void NAME_PULCL::ReplaceElm(int NomPul,int KolElm,TIP_LOC *Adr=NULL); То же, что и NAME_PULCL::ReallocElm(int,int,TIP_LOC*). То же, что и NAME_PULCL::ReallocElm(int,int,TIP_LOC*). NAME_PULCL::Replace(int) NAME_PULCL::Adr(int) NAME_LOCCL::Replace(int,TIP_LOC*) char* TPulStr::AdrStr(int NomPul); При ненулевом значении указателя на типизированный хэндл TMemChar, находящийся в позиции NomPul хэндла-пула, поставляет указатель на строку, содержащуюся в этом типизированном хэндле. В противном случае возвращает NULL. нет. NAME_PULCL::Adr(int), где NAME_PULCL=TPulChar NAME_LOCCL::Adr(void), где NAME_LOCCL=TMemChar int TPulStr::StrLen(int NomPul); При ненулевом значении указателя на типизированный хэндл TMemChar, находящийся в позиции NomPul текущего хэндла-пула, и ненулевом значении указателя на содержимое этого типизированного хэндла поставляет длину строки, содержащуюся в этом типизированном хэндле. В противном случае возвращает 0. нет. TPulStr::AdrStr(int) char* TPulStr::GetStr(int NomPul); При ненулевом значении указателя на типизированный хэндл TMemChar, находящийся в позиции NomPul текущего хэндла-пула, заказывает память под содержащуюся в типизированном хэндле строку, копирует ее в заказанную память и возвращает указатель на эту память. В противном случае возвращает NULL. Память по поставляемому функцией указателю подлежит возврату по ее использовании. NAME_PULCL::Adr(int), где NAME_PULCL=TPulChar NAME_LOCCL::Adr(void), где NAME_LOCCL=TMemChar void TPulStr::AddStr(char *Adr); Пристыковывает к концу хэндла-пула типизированный хэндл TMemChar, генерирует для него блок памяти в группе хэндла-пула, заказывает для этого блока кусок памяти, достаточный для размещения в нем строки Adr в случае ненулевого значения указателя Adr или длиной 1 байт в противном случае. Копирует строку Adr (если Adr - не NULL) в пристыкованный типизированный хэндл TMemChar. При нулевом значении Adr заносит в пристыкованный хэндл нуль-терминатор. NAME_PULCL::AddElm(int,TIP_LOC*), где NAME_PULCL=TPulChar, TIP_LOC=char void TPulStr::SetStr(int NomPul,char *Adr); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). Освобождает существующий NomPul-ный типизированный хэндл TMemChar. Генерирует для типизированного хэндла TMemChar в позиции NomPul блок памяти в группе текущего хэндла-пула, достаточный для размещения в нем строки Adr в случае ненулевого значения указателя Adr или длиной 1 байт в противном случае. Копирует строку Adr (если Adr - не NULL) в созданный типизированный хэндл TMemChar. При нулевом значении Adr заносит в NomPul-ный хэндл нуль-терминатор. NAME_PULCL::SetElm(int,int,TIP_LOC*), где NAME_PULCL=TPulChar, TIP_LOC=char void TPulStr::InsertStr(int NomPul,char *Adr); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). В противном случае наращивает число элементов памяти хэндла-пула на единицу и переносит значения элементов на одну позицию вперед, начиная с позиции NomPul. Генерирует для типизированного хэндла TMemChar этой позиции блок памяти в группе хэндла-пула, заказывает для этого блока кусок памяти, достаточный для размещения в нем строки Adr в случае ненулевого значения указателя Adr или длиной 1 байт в противном случае. Копирует строку Adr (если Adr - не NULL) в NomPul-ный типизированный хэндл TMemChar. При нулевом значении Adr заносит в NomPul-ный хэндл нуль-терминатор. NAME_PULCL::InsertElm(int,int,TIP_LOC*), где NAME_PULCL=TPulChar, TIP_LOC=char void TPulStr::DelStr(int NomPul); При значении NomPul, меньшем общего числа элементов памяти хэндла-пула, и при положительных физическом номере группы и значении индекса (при сброшенном старшем бите) NomPul-ного типизированного хэндла TMemChar заносит в этот хэндл специальную сигнатуру, состоящую из четырех байт: {0 1 255 0}. нет. NAME_LOCCL::KolElm(void), где NAME_LOCCL=TMultMemHandl TCtcMemHandl::operator>(const unsigned int&) NAME_PULCL::operator[](const int), где NAME_PULCL=TPulChar NAME_LOCCL::Replace(int,TIP_LOC*), где NAME_LOCCL=TMemChar, TIP_LOC=char void TPulStr::PutStr(int NomPul,char *Adr=NULL); При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). При нулевом физическом номере группы NomPul-ного типизированного хэндла TMemChar назаначает ему логический номер группы хэндла-пула. В качестве требуемой длины NomPul-ного типизированного хэндла TMemChar принимается длина строки Adr c учетом нуль-терминатора при ненулевом значении Adr или 1 байт в противном случае. Если эта длина превышает длину уже содержащейся в NomPul-ном типизированном хэндле TMemChar строки (с учетом нуль-терминатора), наращивает число его элементов до требуемой величины и при ненулевом значении Adr копирует в него строку по Adr. При нулевом значении Adr и отсутствии строки в NomPul-ном типизированном хэндле заносит в него нуль-терминатор. То же, что и NAME_PULCL::ReallocElm(int,int,TIP_LOC*). NAME_PULCL::ReplaceElm(int,int,TIP_LOC*), где NAME_PULCL=TPulChar, TIP_LOC=char void TPulStr::StrCat(int NomPul,char *Adr=NULL); При ненулевом значении указателя строки Adr и ненулевой длине этой строки производит следующие действия. При значении NomPul, не меньшем общего числа элементов памяти хэндла-пула, наращивает число элементов до требуемой величины (NomPul+1). При нулевом физическом номере группы NomPul-ного типизированного хэндла TMemChar назаначает ему логический номер группы хэндла-пула. Наращивает текущую длину куска памяти этого хэндла на длину строки Adr и пристыковывает эту строку к имеющейся там строке, перенося нуль-терминатор в конец объединенной строки. При нулевом значении индекса NomPul-ного типизированного хэндла (т.е. отсутствии блока памяти у хэндла) генерирует новый блок памяти размером с длину строки Adr (а надо на единицу больше ???!!!). TPulStr::StrLen(int) NAME_PULCL::InsertInElm(int,int,int,TIP_LOC*), где NAME_PULCL=TPulChar, TIP_LOC=char void TPulStr::FreeStr(int NomPul); Освобождает кусок памяти и обнуляет поля типизированного хэндла TMemChar, являющимся NomPul-ным элементом хэндла-пула. Осуществляет проверку на непревышение NomPul общего числа элементов хэндла-пула и действительность указателя на NomPul-ный элемент хэндла-пула. NAME_PULCL::FreeElm(int) int TPulStr::AddContext(char *Adr,int Regim=0);

При ненулевом значении указателя строки Adr и ненулевой длине этой строки в зависимости от значения параметра Regim производит следующие действия.

Если Regim равен 0, и строка Adr отсутствует в пуле, заносит строку Adr в первую свободную позицию пула (с пустым хэндлом TMemChar или содержащим сигнатуру удаленной строки). В отсутствие свободных позиций наращивает число элементов пула на единицу и заносит строку Adr в добавленную позицию.

При значении Regim, равном 1, заносит строку Adr в первую свободную позицию пула или добавленную позицию независимо от наличия строки Adr в пуле.

В обоих случаях возвращает номер позиции пула с внесенной строкой.

Если Regim равен 2, просто сканирует пул в поисках строки Adr и возвращает номер позиции со строкой, если она найдена, или -1 в противном случае.

При нулевом значении указателя строки Adr и нулевой длине этой строки выдает сообщение ПУСТАЯ СТРОКА. NAME_LOCCL::KolElm(void), где NAME_LOCCL=TMultMemHandl и NAME_LOCCL=TMemChar TCtcMemHandl::operator>(const unsigned int&) NAME_PULCL::operator[](const int), где NAME_PULCL=TPulChar NAME_LOCCL::Adr(void), где NAME_LOCCL=TMemChar TPulStr::PutStr(int,char*) NAME_PULCL& NAME_PULCL::operator =(const TCtcMemHandl &h); То же, что и NAME_LOCCL::operator=(const TCtcMemHandl &) нет. TCtcMemHandl::operator=(const TCtcMemHandl&) NAME_LOCCL& NAME_PULCL::operator [](const int Index); Поставляет ссылку на Index-ный типизированный хэндл хэндла-пула без наращивания счетчика открытий типизированного хэндла. При отсутствии блока памяти типизированного хэндла выдает сообщение (обращение к несуществующему блоку). NAME_LOCCL::operator[](const int), где NAME_LOCCL=TMultMemHandl. NAME_LOCCL* NAME_PULCL::operator ()(const int Index); Поставляет указатель на Index-ный типизированный хэндл хэндла-пула без наращивания счетчика открытий типизированного хэндла. При отсутствии блока памяти типизированного хэндла выдает сообщение (обращение к несуществующему блоку) и возвращает NULL. NAME_LOCCL::operator()(const int), где NAME_LOCCL=TMultMemHandl. TPulStr& TPulStr::operator =(const TCtcMemHandl &h); То же, что и NAME_LOCCL::operator=(const TCtcMemHandl &) нет. TCtcMemHandl::operator=(const TCtcMemHandl&)

Матричный пул - это пул с внутренним механизмом доступа к элементам составляющих его типизированных хэндлов как к элементам линейной матрицы. Внешний логический доступ к элементам матричного пула осуществляется по номеру элемента в матричном пуле. В отличие от пула, где все элементы хэндла-пула однородны, т.е. являются типизированными хэндлами одного определенного типа, в матричном пуле нулевой элемент является базовым хэндлом, содержащим специальную структуру со служебной информацией, в частности,