omp_get_supported_teams_dim (GNU libgomp)

#### 3.4.9 `omp_get_supported_teams_dim` – Get upper limit of teams in a dimension ¶

Description:

  The routine returns an upper bound for the number of teams supported in dimension dim on device device_num. If dim specifies a number that exceeds the number of supported active spatial dimensions for teams, the routine returns one.

  Note: The actually supported number of teams by dimension might be lower, depending on used number of teams in other dimensions and other parameters.

  The effect when the routine is invoked from within a `target` region is unspecified.

  Fortran note: In GCC, this routine does not support passing default-kind integer arguments with `-fdefault-integer-8`.

C/C++:

  Prototype: | `int omp_get_supported_teams_dim(int device_num, int dim)`

Fortran:

  Interface: | `integer function omp_get_supported_teams_dim(device_num, dim)`
  | `integer :: device_num, dim`

See also:

  `omp_get_supported_active_team_dims` – Number of supported team dimensions, `omp_get_num_teams_dim` – Number of teams along a dimension, `OMP_NUM_TEAMS` – Specifies the number of teams to use by teams region

Reference:

  OpenMP Technical Report 15, Section 29.9