Текущий раздел:

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.