rtsIDr (1158449), страница 22
Текст из файла (страница 22)
| *StreamPtr | | дескриптор файла ввода. |
| ArrayHeader | | заголовок распределённого массива. |
| InitIndexArray | | массив, в i-м элементе которого задается начальное значение индексной переменной (i+1)-го измерения распределённого массива. |
| LastIndexArray | | массив, в i-м элементе которого задается конечное значение индексной переменной (i+1)-го измерения распределённого массива. |
| StepArray | | массив, в i-м элементе которого задается значение шага для индексной переменной (i+1)-го измерения распределённого массива. |
Функция DisArrRead осуществляет чтение подмассива распределённого массива, определяемого множеством индексных кортежей вида
| { I1 M1: I1 = InitIndexArray[0] { Ik Mk: Ik = InitIndexArray[k-1] | + StepArray[0] *P1 } |
где:
| | | символ прямого произведения множеств; |
| n | | размерность распределённого массива; |
| Ik | | индексная переменная k-го измерения распределённого массива. |
0 ≤ Pk ≤ (LastIndexArray[k-1] InitIndexArray[k-1] 1) / StepArray[k-1].
Читаемый подмассив является блоком (разреженным, если хотя бы один StepArray[i] не равен единице).
Чтение происходит до исчерпания читаемых элементов по принятой в языке C дисциплине непрерывного размещения массивов в памяти: правый индекс меняется быстрее левого. Если начальное значение индекса для какого-либо измерения читаемого массива задано большим или равным его конечному значению, то индекс по этому измерению изменяться при копировании не будет. Отметим, что конечное значение индекса для любого измерения рассматривается системой поддержки как минимум между заданным в параметрах обращения к функции и размером массива по этому измерению минус 1.
Для полного охвата измерения читаемого массива без использования опроса размера объекта по заданному измерению (см.п.17.2) система поддержки предусматривает задание начального значения индекса равным -1. В этом случае начальное значение индекса будет считаться равным нулю, шаг единице, а конечное значение размеру массива по рассматриваемому измерению минус 1.
Функция возвращает число прочитанных элементов.
| long dvm_dfread ( | long | ArrayHeader[], |
| ArrayHeader | | заголовок распределённого массива. |
| Count | | число читаемых элементов. |
| *StreamPtr | | дескриптор файла ввода. |
Функция dvm_dfread осуществляет чтение первых по размещению в памяти Count элементов распределённого массива. При положительном Count число читаемых элементов полагается равным минимуму значения Count и числа элементов распределённого массива. При неположительном значении Count производится чтение всего распределённого массива.
Возвращается число прочитанных элементов.
16.3Запись подмассива распределенного массива в файл
| long DisArrWrite ( | DVMFILE | *StreamPtr, |
| *StreamPtr | | дескриптор файла вывода. |
| ArrayHeader | | заголовок распределённого массива. |
| InitIndexArray | | массив, в i-м элементе которого задается начальное значение индексной переменной (i+1)-го измерения распределённого массива. |
| LastIndexArray | | массив, в i-м элементе которого задается конечное значение индексной переменной (i+1)-го измерения распределённого массива. |
| StepArray | | массив, в i-м элементе которого задается значение шага для индексной переменной (i+1)-го измерения распределённого массива. |
Функция DisArrWrite осуществляет запись блока распределённого массива, определяемого множеством индексных кортежей вида
| { I1 M1: I1 = InitIndexArray[0] | + StepArray[0] *P1 } + StepArray[n-1]*Pn } , |
где:
| | | символ прямого произведения множеств; |
| n | | размерность распределённого массива; |
| Ik | | индексная переменная k-го измерения распределённого массива. |
0 ≤ Pk ≤ (LastIndexArray[k-1] InitIndexArray[k-1] 1) / StepArray[k-1].
Записываемый подмассив является блоком (разреженным, если хотя бы один StepArray[i] не равен единице).
Запись происходит до исчерпания записываемых элементов по принятой в языке C дисциплине непрерывного размещения массивов в памяти: правый индекс меняется быстрее левого. Если начальное значение индекса для какого-либо измерения записываемого массива задано большим или равным его конечному значению, то индекс по этому измерению изменяться при копировании не будет. Отметим, что конечное значение индекса для любого измерения рассматривается системой поддержки как минимум между заданным в параметрах обращения к функции и размером массива по этому измерению минус 1.
Для полного охвата измерения записываемого массива без использования опроса размера объекта по заданному измерению (см.п.17.2) система поддержки предусматривает задание начального значения индекса равным -1. В этом случае начальное значение индекса будет считаться равным нулю, шаг единице, а конечное значение размеру массива по рассматриваемому измерению минус 1.
Функция возвращает число записанных элементов.
| long dvm_dfwrite ( | long | ArrayHeader[], |
| ArrayHeader | | заголовок распределённого массива. |
| Count | | число записываемых элементов. |
| *StreamPtr | | дескриптор файла вывода. |
Функция dvm_dfwrite осуществляет запись первых по размещению в памяти Count элементов распределённого массива. При положительном Count число записываемых элементов полагается равным минимуму значения Count и числа элементов распределённого массива. При неположительном значении Count производится запись всего распределённого массива.
Возвращается число записанных элементов.
Замечание 1. Распределённый массив, задаваемый при обращении к функциям dvm_dfread, DisArrRead, dvm_dfwrite и DisArrWrite, должен быть отображён в процессорную систему, каждый элемент которой обязан принадлежать текущей процессорной системе.
Замечание 2. Первые по расположению в памяти Count элементов распределённого массива не являются, в общем случае, блоком и могут быть описаны следующим образом. Пусть разложение числа Count по весам измерений распределённого массива есть
| | n i=1 |
где:
| n | | размерность распределённого массива; |
| Ki | | коэффициент разложения для i-го измерения (0 ≤ Ki ≤ Sizei -1 , Sizei – размер i-го измерения); |
| Wi | | вес i-го измерения. |
|
| { | n 1 | для i = n . |
Тогда первые Count элементов могут быть представлены в виде следующего объединения блоков:
| n | n |
|
Поэтому чтение (запись) первых Count элементов распределённого массива с помощью функции dvm_dfread (dvm_dfwrite) эквивалентно последовательному чтению (записи) существующих блоков B1, ... , Bn с помощью функции DisArrRead (DisArrWrite) (блок Bm существует, если Km не равно нулю).
17Вспомогательные функции
17.1Опрос размерности заданного объекта
long getrnk_ (ObjectRef *ObjectRefPtr);
Функция getrnk_ возвращает размерность объекта, заданного ссылкой *ObjectRefPtr.
Объектом может быть:
-
распределённый массив ( тогда ссылка это первое слово его заголовка );
-
представление абстрактной машины;
-
многопроцессорная система;
-
карта отображения представления абстрактной машины;
-
карта отображения распределённого массива;
-
параллельный цикл.
Если *ObjectRefPtr не является ссылкой ни однин из вышеперечисленных объектов, то функция возвращает нулевое значение.
Для карты отображения (массива или представления абстрактной машины) возвращается размерность объекта, являющегося источником этой карты.
17.2Опрос размера заданного измерения заданного объекта
| long getsiz_ ( | ObjectRef | *ObjectRefPtr, |
Функция getsiz_ возвращает размер объекта, заданного ссылкой *ObjectRefPtr, по измерению *AxisPtr.
Объектом может быть:
-
распределённый массив (тогда ссылка это первое слово его заголовка);
-
представление абстрактной машины;
-
многопроцессорная система;
-
параллельный цикл.
Размер измерения параллельного цикла равен














