7.2.16 _gfortran_caf_sendget_by_ref — Передача данных между удалёнными изображениями с использованием улучшенных ссылок с обеих сторон

Описание:

Вызывается для передачи скаляра, части массива или всего массива из удалённого изображения, идентифицируемого параметром src_image_index, в удалённое изображение, идентифицируемое параметром dst_image_index.

Синтаксис:

void _gfortran_caf_sendget_by_ref (caf_token_t dst_token, int dst_image_index, caf_reference_t *dst_refs, caf_token_t src_token, int src_image_index, caf_reference_t *src_refs, int dst_kind, int src_kind, bool may_require_tmp, int *dst_stat, int *src_stat, int dst_type, int src_type)

Аргументы:

dst_token	intent(in) Непрозрачный указатель, идентифицирующий целевой комассив.
dst_image_index	intent(in) Идентификатор целевого удалённого изображения; должно быть положительным числом.
dst_refs	intent(in) Ссылки на удалённый массив для хранения данных, предоставленных источником. Гарантируется, что содержит по крайней мере одну запись.
src_token	intent(in) Непрозрачный указатель, идентифицирующий исходный комассив.
src_image_index	intent(in) Идентификатор исходного удалённого изображения; должно быть положительным числом.
src_refs	intent(in) Ссылки для применения к удалённой структуре для получения данных.
dst_kind	intent(in) Тип целевого аргумента
src_kind	intent(in) Тип исходного аргумента
may_require_tmp	intent(in) Переменная имеет значение false, когда на этапе компиляции известно, что dest и src либо не могут перекрываться, либо перекрываются (полностью или частично) таким образом, что обход src и dest в порядке элементов (учитывая шаг) не приведёт к неправильным результатам. В противном случае значение равно true.
dst_stat	intent(out) Если не NULL, возвращает результат операции передачи, т.е. ноль в случае успеха и ненулевое значение в случае ошибки. Если NULL, а произошла ошибка, то выводится сообщение об ошибке и программа завершается.
src_stat	intent(out) Если не NULL, возвращает результат операции получения, т.е. ноль в случае успеха и ненулевое значение в случае ошибки. Если NULL, а произошла ошибка, то выводится сообщение об ошибке и программа завершается.
dst_type	intent(in) Указывает тип назначения. Если назначение не является массивом, то точный тип, например, компонента в производном типе, неизвестен, но предоставляется здесь.
src_type	intent(in) Указывает тип источника. Если источник не является массивом, то точный тип, например, компонента в производном типе, неизвестен, но предоставляется здесь.

ЗАМЕЧАНИЯ

Допускается, чтобы индекс изображения для src_image_index и dst_image_index был одинаковым; память для отправки и получения в этом случае может (частично) перекрываться. Реализация должна учитывать этот случай, например, используя memmove, который обрабатывает (частично) перекрывающуюся память. Если may_require_tmp истинно, библиотека может дополнительно создать временную переменную, если дополнительные проверки показывают, что это не требуется (например, если обратный обход возможен или если оба массива являются сплошными и memmove обрабатывает проблемы перекрытия).

Обратите внимание, что присваивание скаляра массиву разрешено. Кроме того, библиотека должна обрабатывать преобразование типов чисел и для строк, заполнение и различные типы символов.

Из-за более сложных возможных ссылок некоторые операции могут быть не поддерживаемы определёнными библиотеками. Библиотека должна выводить точное сообщение об ошибке, почему операция не разрешена.

Далее: _gfortran_caf_lock, Предыдущее: _gfortran_caf_get_by_ref, Вверх: Документация ABI функций [Содержание][Индекс]