rtsIDr (1158390), страница 21
Текст из файла (страница 21)
Замечание 2. Функции dvm_fread и dvm_fwrite могут быть использованы для чтения и записи распределённых массивов. Для этого BufferPtr должен указывать на заголовок распределённого массива. В этом случае размер элемента массива полагается равным не Size, а *TypeSizePtr (тому значению, которое было задано при создании массива с помощью функции crtda_). Число читаемых или записываемых элементов полагается равным минимуму между Count*Size/(*TypeSizePtr) и числом элементов распределённого массива (см. также описание функций dvm_dfread и dvm_dfwrite в п.п.16.2 и 16.3).
Распределённый массив, задаваемый при обращении к функциям dvm_fread и dvm_fwrite, должен быть отображён в процессорную систему, каждый элемент которой обязан принадлежать текущей процессорной системе.
Замечание 3. Доступ к стандартному потоку stdaux (stdprn) через указатель DVMSTDAUX (DVMSTDPRN) возможен лишь при компиляции системы поддержки с определённой переменной компиляции _DVM_STDAUX_ (_DVM_STDPRN_).
16.1.2Функции ввода/вывода нижнего уровня
BORLAND-C & MICROSOFT-C & PORTLAND GROUP-C:
| int | dvm_close | (DVMHANDLE *HandlePtr); |
| int | dvm_fstat | (DVMHANDLE *HandlePtr, struct stat *BufferPtr); |
| long | dvm_lseek | (DVMHANDLE *HandlePtr, long Offset,int Origin); |
| DVMHANDLE | *dvm_open | (const char *FileNamePtr, int OFlag, int PMode); |
| int | dvm_read | (DVMHANDLE *HandlePtr, char *BufferPtr, |
| int | dvm_write | (DVMHANDLE *HandlePtr, const void *BufferPtr, |
Для доступа к стандартным потокам ввода/вывода в функциях ввода/вывода нижнего уровня могут использоваться следующие указатели:
| DVMSTREAM0 | | стандартный ввод; |
| DVMSTREAM1 | | стандартный вывод; |
| DVMSTREAM2 | | стандартный вывод сообщений об ошибках; |
| DVMSTREAM3 | | стандартный последовательный порт; |
| DVMSTREAM4 | | стандартное устройство печати. |
16.1.3Операции над каталогами и файлами
ANSI:
| int | dvm_remove | (const char *FileNamePtr); |
| int | dvm_rename | (const char *OldNamePtr, const char *NewNamePtr); |
| char | *dvm_tmpnam | (char *FileNamePtr); |
BORLAND-C & MICROSOFT-C & PORTLAND GROUP-C:
| int | dvm_access | (const char *FileNamePtr, int Mode); |
| int | dvm_stat | (const char *FileName, struct stat *BufferPtr); |
| int | dvm_unlink | (const char *FileNamePtr); |
Замечание. Функции ввода/вывода нижнего уровня, а также функции dvm_access и dvm_stat доступны пользовательской программе лишь в том случае, если библиотека используемого компилятора языка C содержит соответствующие им функции. Для использования функций ввода/вывода нижнего уровня система поддержки и программа пользователя должны быть скомпилированы с определённой переменной компиляции _LLIO_ . Подключение функции dvm_access (dvm_stat) достигается компиляцией с определённой переменной _ACCESS_FUN_ (_STRUCT_STAT_).
При работе в среде WINDOWS+MPI+MICROSOFT_C (WINDOWS+MICROSOFT_C) подключение всех перечисленных выше функций осуществляется компиляцией системы поддержки и программы пользователя с определённой переменной компиляции _WIN_MPI_ (_DVM_MSC_).
16.2Чтение файла в подмассив распределенного массива
| long DisArrRead ( | DVMFILE | *StreamPtr, |
| *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].















