8.2.13 _gfortran_caf_sendget — Пересылка данных между удалёнными образами
- Описание:
-
Вызывается для пересылки скаляра, секции массива или всего массива из удалённого образа, идентифицированного по src_image_index, в удалённый образ, идентифицированный по dst_image_index.
- Синтаксис:
-
void _gfortran_caf_sendget (caf_token_t dst_token, size_t dst_offset, int dst_image_index, gfc_descriptor_t *dest, caf_vector_t *dst_vector, caf_token_t src_token, size_t src_offset, int src_image_index, gfc_descriptor_t *src, caf_vector_t *src_vector, int dst_kind, int src_kind, bool may_require_tmp, int *stat) - Аргументы:
-
dst_token intent(in) Непрозрачный указатель, идентифицирующий целевой комассив. dst_offset intent(in) Смещение в байтах фактических данных по отношению к базовому адресу целевого комассива. dst_image_index intent(in) Идентификатор целевого удалённого образа; должно быть положительное число. dest intent(in) Описание массива для целевого удалённого образа для границ и размера. base_addrнедоступен.dst_vector intent(int) Если не NULL, содержит индексный вектор целевого массива; значения относительны к тройке размерностей аргумента dest. src_token intent(in) Непрозрачный указатель, идентифицирующий исходный комассив. src_offset intent(in) Смещение в байтах фактических данных по отношению к базовому адресу исходного комассива. src_image_index intent(in) Идентификатор исходного удалённого образа; должно быть положительное число. src intent(in) Описание локального массива, который должен быть передан удалённому образу. src_vector intent(in) Описание локального массива, который должен быть передан удалённому образу. dst_kind intent(in) Тип данных целевого аргумента src_kind intent(in) Тип данных исходного аргумента may_require_tmp intent(in) Переменная false, если на этапе компиляции известно, что массивы dest и src либо не пересекаются, либо пересекаются (полностью или частично) таким образом, что обход src и dest в порядке элементов (с учётом шага) не приведёт к неверным результатам. В противном случае, значениеtrue.stat intent(out) Если не NULL, содержит результат операции: ноль при успехе и ненулевое значение при ошибке. Если NULL и произошла ошибка, то выводится сообщение об ошибке, и программа завершается. - ПРИМЕЧАНИЯ
-
Разрешается использование одного и того же индекса образа для src_image_index и dst_image_index; в этом случае память объекта "отправить-в" и "отправить-из" может (частично) перекрываться. Реализация должна учитывать этот случай, например, используя
memmove, который обрабатывает (частично) перекрывающуюся память. Если may_require_tmp истинно, библиотека может дополнительно создать временную переменную, если дополнительные проверки не покажут, что это не требуется (например, если возможен обратный обход или оба массива непрерывны иmemmoveобрабатывает проблемы перекрытия).Обратите внимание, что разрешено присваивание скаляра массиву. Кроме того, библиотека должна обрабатывать преобразование числовых типов и, в случае строк, заполнение и различие типов символов.
Далее: _gfortran_caf_send_by_ref, Предыдущее: _gfortran_caf_get, Вверх: Документация по ABI функций [Содержание][Индекс]
© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-8.4.0/gfortran/_005fgfortran_005fcaf_005fsendget.html