Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.15. Работа с матрицами и массивами

А.5.15.10. rdsResizeVarArray – изменить размер матрицы/массива

Функция rdsResizeVarArray изменяет число строк и столбцов указанной матрицы или массива с возможностью сохранения старого содержимого.

  BOOL RDSCALL rdsResizeVarArray(
    LPVOID BaseAddr,                    // Базовый адрес переменной
    int Rows,                           // Новое число строк
    int Cols,                           // Новое число столбцов
    BOOL KeepData,                      // Сохранять содержимое
    RDS_PARRAYACCESSDATA pAccessData    // Заполняемое описание
  );

Тип указателя на эту функцию

RDS_BpVIIBAd

Параметры

BaseAddr (LPVOID): Указатель (может быть любого типа, в т.ч. и void*) на данные матрицы в дереве переменных блока, то есть указатель на область из восьми байтов, которые эта матрицы занимает в дереве переменных (см. §2.5.3 руководства программиста).
Rows, Cols (int): Новое число строк (Rows) и столбцов (Cols) в матрице. Для очистки матрицы можно передать ноль в обоих этих параметрах.
KeepData (BOOL): TRUE – сохранять старое содержимое матрицы (если ее размер уменьшается, она будет обрезана справа и снизу, если увеличивается – дополнена ячейками со значением элемента по умолчанию). FALSE – после изменения размера заполнить всю матрицу значением по умолчанию.
pAccessData (RDS_PARRAYACCESSDATA): Указатель на структуру описания матрицы RDS_ARRAYACCESSDATA которую функция должна заполнить после изменения размера. Если описание матрицы не нужно вызывающей программе, в этом параметре можно передать NULL.

Возвращаемое значение

TRUE – размер матрицы изменен, FALSE – произошла ошибка (указанная в параметре BaseAddr переменная – не матрица и не массив).

Примечания

Эта функция изменяет размер матрицы по указателю BaseAddr.

Пример

Пример использования функции rdsResizeVarArray приведен в §2.5.3 руководства программиста.

См. также

RDS_ARRAYACCESSDATA, rdsCopyVarArray.