rtsIDr (1158449), страница 16
Текст из файла (страница 16)
Возвращается число скопированных байтов.
13.2Копирование распределенных массивов
| long arrcpy_ ( | long | FromArrayHeader[], |
| FromArrayHeader | | заголовок читаемого распределённого массива. |
| FromInitIndexArray | | массив, i-й элемент которого содержит начальное значение индекса для (i+1)-го измерения читаемого массива. |
| FromLastIndexArray | | массив, i-й элемент которого содержит конечное значение индекса для (i+1)-го измерения читаемого массива. |
| FromStepArray | | массив, i-й элемент которого содержит шаг изменения индекса для (i+1)-го измерения читаемого массива. |
| ToArrayHeader | | заголовок записываемого распределённого массива. |
| ToInitIndexArray | | массив, j-й элемент которого содержит начальное значение индекса для (j+1)-го измерения записываемого массива. |
| ToLastIndexArray | | массив, j-й элемент которого содержит конечное значение индекса для (j+1)-го измерения записываемого массива. |
| ToStepArray | | массив, j-й элемент которого содержит шаг изменения индекса для (j+1)-го измерения записываемого массива. |
| *CopyRegimPtr | | режим копирования. |
Копирование происходит до исчерпания читаемых или записываемых элементов по принятой в языке C дисциплине непрерывного размещения массивов в памяти: правый индекс меняется быстрее левого. Если начальное значение индекса для какого-либо измерения читаемого или записываемого массива задано большим или равным его конечному значению, то индекс по этому измерению изменяться при копировании не будет. Отметим, что конечное значение индекса для любого измерения рассматривается системой поддержки как минимум между заданным в параметрах обращения к функции и размером массива по этому измерению минус 1.
Для полного охвата измерения читаемого или записываемого массива без использования опроса размера объекта по заданному измерению (см.п.17.2) система поддержки предусматривает задание начального значения индекса равным -1. В этом случае начальное значение индекса будет считаться равным нулю, шаг единице, а конечное значение размеру массива по рассматриваемому измерению минус 1.
Один из массивов (но не оба) может быть не распределённым, а обычным, размноженным по всем процессорам, массивом с типом элементов, совпадающим с типом элементов распределённого массива (если определяющий его указатель не является указателем на заголовок распределённого массива). "Обычный" массив считается одномерным, элементы его полагаются расположенными в памяти непрерывно, а параметры, задающие его индексы для копирования, игнорируются.
Если один из массивов не является распределённым, то способ копирования определяется значением *CopyRegimPtr:
-
при нулевом значении *CopyRegimPtr "обычный" массив считается размещённым на всех процессорах текущей процессорной системы;
-
положительное значение *CopyRegimPtr означает, что "обычный" массив предполагается размещённым только на процессоре ввода/вывода;
-
отрицательное значение *CopyRegimPtr (допустимо только для читаемого "обычного" массива) устанавливает режим росписи распределённого массива, определённого параметром ToArrayHeader, элементом, адрес которого задан параметром FromArrayHeader.
Если оба массива не являются распределёнными, то копирование не производится.
Если оба массива являются распределёнными, то они могут иметь различные размерности, размеры по каждому измерению, могут быть по-разному распределены, но должны иметь совпадающий тип элементов.
Как читаемый распределённый массив, так и записываемый должны быть отображены в процессорные системы, каждый элемент которых обязан принадлежать текущей процессорной системе.
Функция возвращает число скопированных элементов.
13.3Асинхронное копирование распределенных массивов
| long arwelm_( | long | FromArrayHeader[], |
| long arwelf_( | long | FromArrayHeader[], |
| long acopel_( | long | FromArrayHeader[], |
| long aelmcp_( | long | FromArrayHeader[], |
| long aarrcp_( | long | FromArrayHeader[], |
Описанные выше функции arwelm_ , arwelf_ , acopel_ , aelmcp_ и aarrcp_ осуществляют запуск операций копирования, выполняемых функциями rwelm_, rwelmf_, copelm_, elmcpy_, и arrcpy_ . Все параметры рассматриваемых функций, кроме последнего, аналогичны одноименным параметрам их синхронных аналогов. Последний параметр, CopyFlagPtr, является указателем на флаг завершения запущенной операции копирования.
Ожидание завершения копирования осуществляется с помощью функции
long waitcp_ (AddrType *CopyFlagPtr);
*CopyFlagPtr флаг завершения операции копирования, заданный при её запуске.
Возвращается нулевое значение.
13.4Доступ к элементам локальной части распределенного массива
Пусть n размерность распределённого массива. Тогда его заголовок, задаваемый при обращении к функции crtda_ c нулевым значением параметра *ExtHdrSignPtr, может быть объявлен, например, как
long ArrayHeader[n+1]; /* стандартный заголовок */
Пусть также базовый указатель, соответствующий типу элементов распределённого массива, есть BasePtr. Тогда обращение к элементу локальной части распределённого массива, определённому индексным вектором (I1,...,In), осуществляется по линейному индексу следующим образом:
| | n-1 |
Для языка C п ри обращении к функции crtda_ значение базового указателя можно задавать равным NULL. Тогда доступ к элементу локальной части распределённого массива можно произвести разименованно:
| | n-1 |
где Type тип элементов распределённого массива.
Коэффициенты ArrayHeader[1], ... ,ArrayHeader[n-1] и адресная константа ArrayHeader[n] вычисляются системой поддержки при выполнении функций выравнивания массива align_ и realn_ следующим образом.
Пусть:
| Ii,нач | | начальное значение индекса локальной части распределённого массива по измерению i; |
| Ii,кон | | конечное значение индекса локальной части распределённого массива по измерению i; |
| LWi | | ширина нижней границы распределённого массива для измерения i; |
| HWi | | ширина верхней границы распределённого массива для измерения i; |
| ArrayPtr | | указатель на локальную часть массива (размещённую в памяти вместе с граничными элементами ); |
| TypeSize | | размер в байтах одного элемента распределённого массива. |
Тогда:
| | n |
| | n-1 |
| ArrayHeader[n] = { | ArrayHeader[n] ( (long)ArrayPtr (long)BasePtr )/TypeSize | при BasePtr ≠ NULL, при BasePtr = NULL. |
При обращении к функции crtda_ с ненулевым значением параметра *ExtHdrSignPtr заголовок распределённого массива может быть статически задан как
long ArrayHeader[2*n+2]; /* расширенный заголовок */
Первые (n+1) слов расширенного заголовка совпадают с рассмотренным выше стандартным заголовком. Слова от (n+2)-го до (2*n+1)-го должны быть заданы программой пользователя до размещения массива в памяти с помощью функции align_ (malign) (предполагается, что в этих словах задаются нижние значения индексов распределённых массивов, используемых в Фортране). (n+1)-е слово расширенного заголовка вычисляется системой поддержки при отображении или переотображении массива в процессорную систему как
| | n i=2 |
Отметим, что система поддержки при выполнении функций align_ и realn_ размещает в памяти локальную часть распределённого массива таким образом, чтобы разность (ArrayPtr BasePtr) была кратна TypeSize.
Доступ к элементам локальной части распределённого массива осуществляется либо непосредственно по его заголовку и базовому указателю, либо, что менее эффективно, с помощью рассмотренных ниже функций rlocel_ , wlocel_ и clocel_ .
13.4.1Опрос принадлежности элемента распределенного массива его локальной части
| long tstelm_( | long | ArrayHeader[], |
| ArrayHeader | | заголовок распределённого массива. |
| IndexArray | | массив, i-й элемент которого содержит значение индекса элемента распределённого массива по его (i+1)-му измерению. |
Число задаваемых индексов должно быть равно размерности распределённого массива.















