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` является изменяемым или указателем и его ссылки позволяют перевыделение, т.е. весь массив или компонент ссылаются.
`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-13.3.0/gfortran/_005fgfortran_005fcaf_005fget_005fby_005fref.html