インテル® Fortran コンパイラー 19.1 デベロッパー・ガイドおよびリファレンス

FAILED_IMAGES

Transformational Intrinsic Function (Generic): Returns an array of index images that have failed.

result = FAILED_IMAGES ([kind])

kind

(Input; optional) Must be a scalar integer expression with a value that is a valid INTEGER kind type parameter.

Results

The result is a rank-one integer array with the same type kind parameters as kind if present; otherwise, default integer. The size of the array is equal to the number of images in the current (initial) team that are known to have failed.

The result array elements are the image index values of images on the current team that are known to have failed. The indices are arranged in increasing numeric order.

If the image executing the FAILED_IMAGES reference previously executed a collective subroutine whose STAT argument returned the value STAT_FAILED_IMAGES defined in the intrinsic module ISO_FORTRAN_ENV, or if the image executed an image control statement whose STAT= specifier returned the value STAT_FAILED_IMAGE, at least one image in the team executing the collective or image control statement is known to have failed.

Note

FAILED_IMAGES argument team has not yet been implemented. It will be added in a future release.

Example

If image 5 and 12 of the current team are known to have failed, the result of FAILED_IMAGES ( ) is an array of default integer type with size 2 defined with the value [5, 12]. If no images in the current team are known to have failed, the result of FAILED_IMAGES ( ) is a zero-sized array.

See Also