7.2.15 _gfortran_caf_get_by_ref — Получение данных из удаленного изображения с использованием улучшенных ссылок

Описание:

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

Синтаксис:

void _gfortran_caf_get_by_ref (caf_token_t token, int image_index, caf_reference_t *refs, gfc_descriptor_t *dst, int dst_kind, int src_kind, bool may_require_tmp, bool dst_reallocatable, int *stat, int src_type)

Аргументы:

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

ПРИМЕЧАНИЯ

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

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

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

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-14.2.0/gfortran/_005fgfortran_005fcaf_005fget_005fby_005fref.html