omp_get_interop_str (GNU libgomp)

#### 3.11.4 `omp_get_interop_str` – Obtain string-valued interoperability property ¶

Description:

  The `omp_get_interop_str` function returns the string value associated with the property_id interoperability property of the passed interop object. The ret_code argument is optional, i.e. it can be omitted in C++ and Fortran or used with `NULL` as argument in C and C++. If successful, ret_code (if present) is set to `omp_irc_success`.

  In GCC, the effect of running this routine in a `target` region that is not the initial device is unspecified.

  GCC implements the OpenMP 6.0 version of this function for C and C++, which is not compatible with its type signature in previous versions of the OpenMP specification. In older versions, the type `int*` was used for the ret_code argument in place of a pointer to the enumerated type `omp_interop_rc_t`.

C/C++:

  Prototype: | `const char *omp_get_interop_str(const omp_interop_t interop, omp_interop_property_t property_id, omp_interop_rc_t *ret_code)`

Fortran:

  Interface: | `character(:) function omp_get_interop_str(interop, property_id, ret_code)`
  | `pointer :: omp_get_interop_str`
  | `integer(omp_interop_kind), intent(in) :: interop`
  | `integer(omp_interop_property_kind) property_id`
  | `integer(omp_interop_rc_kind), optional, intent(out) :: ret_code`

See also:

  `omp_get_interop_int` – Obtain integer-valued interoperability property, `omp_get_interop_ptr` – Obtain pointer-valued interoperability property, `omp_get_interop_rc_desc` – Obtain error string to an `interop_rc` error code, Offload-Target Specifics

Reference:

  OpenMP specification v5.1, Section 3.12.4, OpenMP specification v6.0, Section 26.4