rtsIDr (1158390), страница 22
Текст из файла (страница 22)
Записываемый подмассив является блоком (разреженным, если хотя бы один 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.
Объектом может быть:
-
распределённый массив (тогда ссылка это первое слово его заголовка);
-
представление абстрактной машины;
-
многопроцессорная система;
-
параллельный цикл.
Размер измерения параллельного цикла равен
ceil((LastIndex - InitIndex + 1) / Step) ,
где:
| InitIndex | | начальное значение индексной переменной параллельного цикла для измерения *AxisPtr; |
| LastIndex | | конечное значение индексной переменной параллельного цикла для измерения *AxisPtr; |
| Step | | шаг изменения индексной переменной параллельного цикла для измерения *AxisPtr; |
| сeil | | функция нахождения наименьшего целого, не меньшего значения своего аргумента. |
При нулевом значении *AxisPtr возвращается размер всего объекта (произведение размеров всех измерений).
Если *ObjectRefPtr не является ссылкой ни на один из вышеперечисленных объектов, то функция возвращает нулевое значение.
| long locsiz_ ( | ObjectRef | *ObjectRefPtr, |
Функция locsiz_ аналогична рассмотренной выше функции getsiz_, но возвращает локальный размер измерения *AxisPtr (или локальный размер всего объекта), т.е. размер части объекта, отображённой на текущий процессор. Если объектом является многопроцессорная система, то значения, возвращаемые функциями getsiz_ и locsiz_, совпадают.
Отметим, что локальный размер всего объекта, не имеющего локальной части на текущем процессоре, равен нулю.
17.3Опрос признака распределенного массива
long tstda_ (ObjectRef *ObjectRefPtr);
Функция tstda_ позволяет установить, является ли объект, заданный ссылкой *ObjectRefPtr, распределённым массивом.
Возвращается значение:
0 объект не является распределённым массивом;
1 объект является распределённым массивом;
2 объект является полностью размноженным распределённым массивом.
17.4Опрос длины элемента распределенного массива
long getlen_ (long ArrayHeader[]);
ArrayHeader заголовок распределённого массива.
Функция getlen_ возвращает длину элемента заданного распределённого массива в байтах.
17.5Уничтожение заданного объекта
long delobj_ (ObjectRef *ObjectRefPtr);
*ObjectRefPtr ссылка на уничтожаемый объект.
Уничтожаемым объектом может быть:
-
распределённый массив (ссылка на него первое слово его заголовка);
-
представление абстрактной машины;
-
многопроцессорная система;
-
карта отображения представления абстрактной машины;
-
карта отображения распределённого массива;
-
редукционная переменная;
-
редукционная группа;
-
группа границ распределённых массивов;
-
буфер удалённых элементов регулярного доступа;
-
группа буферов удалённых элементов регулярного доступа;
-
буфер удалённых элементов нерегулярного доступа;
-
группа буферов удалённых элементов нерегулярного доступа.
Объект быть уничтожена функцией delobj_ только в том случае, если он был создан в текущей подзадаче и в текущем программном блоке (или его подблоке) (см. п. 8 и п. 10).
Возвращается нулевое значение.
17.6Опрос признака процессора ввода/вывода
long tstio_ (void);
Функция возвращает единицу, если текущий процессор является процессором ввода/вывода, и нуль в противном случае.
17.7Рассылка областей памяти процессора ввода/вывода
| long srmem_ ( | long | *MemoryCountPtr, |
| *MemoryCountPtr | | число областей рассылаемой памяти. |
| StartAddrArray | | массив, i-й элемент которого содержит начальный адрес (i+1)-й области, приведенный к типу AddrType. |
| LengthArray | | массив, i-й элемент которого содержит длину в байтах (i+1)-й области. |
Функция srmem_ передает заданные области памяти процессора ввода/вывода всем остальным процессорам решающего поля. При выполнении функции процессором ввода/вывода осуществляется передача, любым другим процессором приём. Число параметров, задаваемых в массивах LengthArray и StartAddrArray, должно быть равно *MemoryCountPtr. Длина каждой рассылаемой области не должна превосходить максимального положительного целого числа (LengthArray[i] ≤ (unsigned int)-1 >> 1).
Возвращается нулевое значение.
Для преобразования адреса переменной к виду, пригодному для использования в функции srmem_ , в системе поддержки предусмотрена функция















