8.2.14 _gfortran_caf_send_by_ref — Передача данных из локального образа в удалённый образ с расширенными возможностями ссылок

Описание:

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

Синтаксис:

void _gfortran_caf_send_by_ref (caf_token_t token, int image_index, gfc_descriptor_t *src, caf_reference_t *refs, int dst_kind, int src_kind, bool may_require_tmp, bool dst_reallocatable, int *stat, int dst_type)

Аргументы:

token	intent(in) Непрозрачный указатель, идентифицирующий комассив.
image_index	intent(in) Идентификатор удалённого образа; должно быть положительным числом.
src	intent(in) Описание массива локального массива, подлежащего передаче в удалённый образ.
refs	intent(in) Ссылки на элементы удалённого массива, в которые будут сохранены данные из src. Гарантируется, что содержит хотя бы одну запись.
dst_kind	intent(in) Тип назначения.
src_kind	intent(in) Тип источника.
may_require_tmp	intent(in) Переменная имеет значение false, когда во время компиляции известно, что dest и src либо не могут перекрываться, либо перекрываются (полностью или частично) таким образом, что обход src и dest в порядке элементов (с учётом шага) не приведёт к неверным результатам. В противном случае значение равно true.
dst_reallocatable	intent(in) Устанавливается, когда назначение является типа allocatable или pointer, и ссылки позволяют перераспределить память, т.е., ссылка — это ссылка на весь массив или компонент.
stat	intent(out) Если не NULL, возвращает результат операции: ноль при успехе и ненулевое значение при ошибке. Если NULL, а произошла ошибка, то выводится сообщение об ошибке и программа завершается.
dst_type	intent(in) Тип назначения. Если назначение не массив, то предоставлен точный тип, например, компонента в производном типе.

ПРИМЕЧАНИЯ

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

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

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

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