omp_get_schedule

Definition

The function omp_get_schedule returns the kind of scheduling and the chunk size used when a runtime schedule is encountered. Conversely, the schedule to apply when a runtime schedule is encountered can be set with OMP_SCHEDULE and omp_set_schedule.

Copy

Feedback

void omp_get_schedule(omp_sched_t policy,
                      int chunk_size);

Parameters

policy: The variable in which store the OpenMP scheduling policy to use when a runtime schedule is encountered.
chunk_size: The variable in which store the number of iterations that make a chunk.

Example

Copy

Feedback

#include <stdio.h>
#include <stdlib.h>
#include <omp.h>

/**
 * @brief Illustrates the use the omp_get_schedule function.
 * @details The application retrieves the schedule and chunk size applied when
 * a runtime schedule is encountered.
 **/
int main(int argc, char* argv[])
{
    // Get the schedule to apply when a runtime schedule is encountered
    omp_sched_t kind;
    int chunk_size;
    omp_get_schedule(&kind, &chunk_size);

    printf("In case a runtime schedule is encountered, the ");
    switch(kind)
    {
        case omp_sched_static:
            printf("static");
            break;
        case omp_sched_dynamic:
            printf("dynamic");
            break;
        case omp_sched_guided:
            printf("guided");
            break;
        case omp_sched_auto:
            printf("auto");
            break;
        default:
            printf("other (implementation specific)");
            break;
    }
    printf(" schedule is applied, with chunks made of %d iteration%s.\n", chunk_size, (chunk_size > 1) ? "s" : "");

    return EXIT_SUCCESS;
}