Fungsi OpenMP
Menyediakan tautan ke fungsi yang digunakan dalam OPENMP API.
Implementasi Visual C++ dari standar OpenMP mencakup fungsi dan jenis data berikut.
Untuk eksekusi lingkungan:
Function | Deskripsi |
---|---|
omp_set_num_threads | Mengatur jumlah utas di wilayah paralel mendatang, kecuali ditimpa oleh klausa num_threads . |
omp_get_num_threads | Mengembalikan jumlah utas di wilayah paralel. |
omp_get_max_threads | Mengembalikan bilangan bulat yang sama dengan atau lebih besar dari jumlah utas yang akan tersedia jika wilayah paralel tanpa num_threads ditentukan pada saat itu dalam kode. |
omp_get_thread_num | Mengembalikan jumlah utas dari utas yang dijalankan dalam tim utasnya. |
omp_get_num_procs | Mengembalikan jumlah prosesor yang tersedia saat fungsi dipanggil. |
omp_in_parallel | Mengembalikan nonzero jika dipanggil dari dalam wilayah paralel. |
omp_set_dynamic | Menunjukkan bahwa jumlah utas yang tersedia di wilayah paralel mendatang dapat disesuaikan dengan waktu proses. |
omp_get_dynamic | Mengembalikan nilai yang menunjukkan apakah jumlah utas yang tersedia di wilayah paralel mendatang dapat disesuaikan dengan waktu proses. |
omp_set_nested | Mengaktifkan paralelisme berlapis. |
omp_get_nested | Mengembalikan nilai yang menunjukkan apakah paralelisme berlapis diaktifkan. |
Untuk kunci:
Function | Deskripsi |
---|---|
omp_init_lock | Menginisialisasi kunci sederhana. |
omp_init_nest_lock | Menginisialisasi kunci. |
omp_destroy_lock | Tidak menginisialisasi kunci. |
omp_destroy_nest_lock | Batal menginisialisasi kunci yang dapat disarangkan. |
omp_set_lock | Memblokir eksekusi utas hingga kunci tersedia. |
omp_set_nest_lock | Memblokir eksekusi utas hingga kunci tersedia. |
omp_unset_lock | Melepaskan kunci. |
omp_unset_nest_lock | Melepaskan kunci berlapis. |
omp_test_lock | Mencoba mengatur kunci tetapi tidak memblokir eksekusi utas. |
omp_test_nest_lock | Mencoba mengatur kunci berlapis tetapi tidak memblokir eksekusi utas. |
Jenis data | Deskripsi |
---|---|
omp_lock_t |
Jenis yang memegang status kunci, apakah kunci tersedia atau jika utas memiliki kunci. |
omp_nest_lock_t |
Jenis yang menyimpan salah satu informasi berikut tentang kunci: apakah kunci tersedia, dan identitas utas yang memiliki kunci dan jumlah berlapis. |
Untuk rutinitas waktu:
Function | Deskripsi |
---|---|
omp_get_wtime | Mengembalikan nilai dalam detik dari waktu yang berlalu dari beberapa titik. |
omp_get_wtick | Mengembalikan jumlah detik di antara tanda centang jam prosesor. |
omp_destroy_lock
Tidak menginisialisasi kunci.
void omp_destroy_lock(
omp_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_lock_t
yang diinisialisasi dengan omp_init_lock.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_destroy_lock dan omp_destroy_nest_lock 3.2.2.
Contoh
Lihat omp_init_lock untuk contoh penggunaan omp_destroy_lock
.
omp_destroy_nest_lock
Batal menginisialisasi kunci yang dapat disarangkan.
void omp_destroy_nest_lock(
omp_nest_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_nest_lock_t
yang diinisialisasi dengan omp_init_nest_lock.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_destroy_lock dan omp_destroy_nest_lock 3.2.2.
Contoh
Lihat omp_init_nest_lock untuk contoh penggunaan omp_destroy_nest_lock
.
omp_get_dynamic
Mengembalikan nilai yang menunjukkan apakah jumlah utas yang tersedia di wilayah paralel mendatang dapat disesuaikan dengan waktu proses.
int omp_get_dynamic();
Nilai hasil
Nilai bukan nol berarti utas akan disesuaikan secara dinamis.
Keterangan
Penyesuaian dinamis utas ditentukan dengan omp_set_dynamic dan OMP_DYNAMIC.
Untuk informasi selengkapnya, lihat fungsi 3.1.7 omp_set_dynamic.
Contoh
Lihat omp_set_dynamic untuk contoh penggunaan omp_get_dynamic
.
omp_get_max_threads
Mengembalikan bilangan bulat yang sama dengan atau lebih besar dari jumlah utas yang akan tersedia jika wilayah paralel tanpa num_threads ditentukan pada saat itu dalam kode.
int omp_get_max_threads( )
Keterangan
Untuk informasi selengkapnya, lihat fungsi 3.1.3 omp_get_max_threads.
Contoh
// omp_get_max_threads.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
int main( )
{
omp_set_num_threads(8);
printf_s("%d\n", omp_get_max_threads( ));
#pragma omp parallel
#pragma omp master
{
printf_s("%d\n", omp_get_max_threads( ));
}
printf_s("%d\n", omp_get_max_threads( ));
#pragma omp parallel num_threads(3)
#pragma omp master
{
printf_s("%d\n", omp_get_max_threads( ));
}
printf_s("%d\n", omp_get_max_threads( ));
}
8
8
8
8
8
omp_get_nested
Mengembalikan nilai yang menunjukkan apakah paralelisme berlapis diaktifkan.
int omp_get_nested( );
Nilai hasil
Nilai bukan nol berarti paralelisme berlapis diaktifkan.
Keterangan
Paralelisme berlapis ditentukan dengan omp_set_nested dan OMP_NESTED.
Untuk informasi selengkapnya, lihat fungsi 3.1.10 omp_get_nested.
Contoh
Lihat omp_set_nested untuk contoh penggunaan omp_get_nested
.
omp_get_num_procs
Mengembalikan jumlah prosesor yang tersedia saat fungsi dipanggil.
int omp_get_num_procs();
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_get_num_procs 3.1.5.
Contoh
// omp_get_num_procs.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
int main( )
{
printf_s("%d\n", omp_get_num_procs( ));
#pragma omp parallel
#pragma omp master
{
printf_s("%d\n", omp_get_num_procs( ));
}
}
// Expect the following output when the example is run on a two-processor machine:
2
2
omp_get_num_threads
Mengembalikan jumlah utas di wilayah paralel.
int omp_get_num_threads( );
Keterangan
Untuk informasi selengkapnya, lihat fungsi 3.1.2 omp_get_num_threads.
Contoh
// omp_get_num_threads.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
int main()
{
omp_set_num_threads(4);
printf_s("%d\n", omp_get_num_threads( ));
#pragma omp parallel
#pragma omp master
{
printf_s("%d\n", omp_get_num_threads( ));
}
printf_s("%d\n", omp_get_num_threads( ));
#pragma omp parallel num_threads(3)
#pragma omp master
{
printf_s("%d\n", omp_get_num_threads( ));
}
printf_s("%d\n", omp_get_num_threads( ));
}
1
4
1
3
1
omp_get_thread_num
Mengembalikan jumlah utas dari utas yang dijalankan dalam tim utasnya.
int omp_get_thread_num( );
Keterangan
Untuk informasi selengkapnya, lihat fungsi 3.1.4 omp_get_thread_num.
Contoh
Lihat paralel untuk contoh penggunaan omp_get_thread_num
.
omp_get_wtick
Mengembalikan jumlah detik di antara tanda centang jam prosesor.
double omp_get_wtick( );
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_get_wtick 3.3.2.
Contoh
Lihat omp_get_wtime untuk contoh penggunaan omp_get_wtick
.
omp_get_wtime
Mengembalikan nilai dalam detik dari waktu yang berlalu dari beberapa titik.
double omp_get_wtime( );
Nilai hasil
Mengembalikan nilai dalam detik dari waktu yang berlalu dari beberapa titik arbitrer, tetapi konsisten.
Keterangan
Titik itu akan tetap konsisten selama eksekusi program, memungkinkan perbandingan yang akan datang.
Untuk informasi selengkapnya, lihat fungsi omp_get_wtime 3.3.1.
Contoh
// omp_get_wtime.cpp
// compile with: /openmp
#include "omp.h"
#include <stdio.h>
#include <windows.h>
int main() {
double start = omp_get_wtime( );
Sleep(1000);
double end = omp_get_wtime( );
double wtick = omp_get_wtick( );
printf_s("start = %.16g\nend = %.16g\ndiff = %.16g\n",
start, end, end - start);
printf_s("wtick = %.16g\n1/wtick = %.16g\n",
wtick, 1.0 / wtick);
}
start = 594255.3671159324
end = 594256.3664474116
diff = 0.9993314791936427
wtick = 2.793651148400146e-007
1/wtick = 3579545
omp_in_parallel
Mengembalikan nonzero jika dipanggil dari dalam wilayah paralel.
int omp_in_parallel( );
Keterangan
Untuk informasi selengkapnya, lihat fungsi 3.1.6 omp_in_parallel.
Contoh
// omp_in_parallel.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
int main( )
{
omp_set_num_threads(4);
printf_s("%d\n", omp_in_parallel( ));
#pragma omp parallel
#pragma omp master
{
printf_s("%d\n", omp_in_parallel( ));
}
}
0
1
omp_init_lock
Menginisialisasi kunci sederhana.
void omp_init_lock(
omp_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_lock_t
.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_init_lock dan omp_init_nest_lock 3.2.1.
Contoh
// omp_init_lock.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
omp_lock_t my_lock;
int main() {
omp_init_lock(&my_lock);
#pragma omp parallel num_threads(4)
{
int tid = omp_get_thread_num( );
int i, j;
for (i = 0; i < 5; ++i) {
omp_set_lock(&my_lock);
printf_s("Thread %d - starting locked region\n", tid);
printf_s("Thread %d - ending locked region\n", tid);
omp_unset_lock(&my_lock);
}
}
omp_destroy_lock(&my_lock);
}
Thread 0 - starting locked region
Thread 0 - ending locked region
Thread 0 - starting locked region
Thread 0 - ending locked region
Thread 0 - starting locked region
Thread 0 - ending locked region
Thread 0 - starting locked region
Thread 0 - ending locked region
Thread 0 - starting locked region
Thread 0 - ending locked region
Thread 1 - starting locked region
Thread 1 - ending locked region
Thread 1 - starting locked region
Thread 1 - ending locked region
Thread 1 - starting locked region
Thread 1 - ending locked region
Thread 1 - starting locked region
Thread 1 - ending locked region
Thread 1 - starting locked region
Thread 1 - ending locked region
Thread 2 - starting locked region
Thread 2 - ending locked region
Thread 2 - starting locked region
Thread 2 - ending locked region
Thread 2 - starting locked region
Thread 2 - ending locked region
Thread 2 - starting locked region
Thread 2 - ending locked region
Thread 2 - starting locked region
Thread 2 - ending locked region
Thread 3 - starting locked region
Thread 3 - ending locked region
Thread 3 - starting locked region
Thread 3 - ending locked region
Thread 3 - starting locked region
Thread 3 - ending locked region
Thread 3 - starting locked region
Thread 3 - ending locked region
Thread 3 - starting locked region
Thread 3 - ending locked region
omp_init_nest_lock
Menginisialisasi kunci.
void omp_init_nest_lock(
omp_nest_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_nest_lock_t
.
Keterangan
Jumlah bersarang awal adalah nol.
Untuk informasi selengkapnya, lihat fungsi omp_init_lock dan omp_init_nest_lock 3.2.1.
Contoh
// omp_init_nest_lock.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
omp_nest_lock_t my_lock;
void Test() {
int tid = omp_get_thread_num( );
omp_set_nest_lock(&my_lock);
printf_s("Thread %d - starting nested locked region\n", tid);
printf_s("Thread %d - ending nested locked region\n", tid);
omp_unset_nest_lock(&my_lock);
}
int main() {
omp_init_nest_lock(&my_lock);
#pragma omp parallel num_threads(4)
{
int i, j;
for (i = 0; i < 5; ++i) {
omp_set_nest_lock(&my_lock);
if (i % 3)
Test();
omp_unset_nest_lock(&my_lock);
}
}
omp_destroy_nest_lock(&my_lock);
}
Thread 0 - starting nested locked region
Thread 0 - ending nested locked region
Thread 0 - starting nested locked region
Thread 0 - ending nested locked region
Thread 3 - starting nested locked region
Thread 3 - ending nested locked region
Thread 3 - starting nested locked region
Thread 3 - ending nested locked region
Thread 3 - starting nested locked region
Thread 3 - ending nested locked region
Thread 2 - starting nested locked region
Thread 2 - ending nested locked region
Thread 2 - starting nested locked region
Thread 2 - ending nested locked region
Thread 2 - starting nested locked region
Thread 2 - ending nested locked region
Thread 1 - starting nested locked region
Thread 1 - ending nested locked region
Thread 1 - starting nested locked region
Thread 1 - ending nested locked region
Thread 1 - starting nested locked region
Thread 1 - ending nested locked region
Thread 0 - starting nested locked region
Thread 0 - ending nested locked region
omp_set_dynamic
Menunjukkan bahwa jumlah utas yang tersedia di wilayah paralel mendatang dapat disesuaikan dengan waktu proses.
void omp_set_dynamic(
int val
);
Parameter
Val
Nilai yang menunjukkan apakah jumlah utas yang tersedia di wilayah paralel mendatang dapat disesuaikan dengan runtime. Jika bukan nol, runtime dapat menyesuaikan jumlah utas, jika nol, runtime tidak akan menyesuaikan jumlah utas secara dinamis.
Keterangan
Jumlah utas tidak akan pernah melebihi nilai yang ditetapkan oleh omp_set_num_threads atau menurut OMP_NUM_THREADS.
Gunakan omp_get_dynamic untuk menampilkan pengaturan saat ini dari omp_set_dynamic
.
Pengaturan untuk omp_set_dynamic
akan mengambil alih pengaturan variabel lingkungan OMP_DYNAMIC .
Untuk informasi selengkapnya, lihat fungsi 3.1.7 omp_set_dynamic.
Contoh
// omp_set_dynamic.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
int main()
{
omp_set_dynamic(9);
omp_set_num_threads(4);
printf_s("%d\n", omp_get_dynamic( ));
#pragma omp parallel
#pragma omp master
{
printf_s("%d\n", omp_get_dynamic( ));
}
}
1
1
omp_set_lock
Memblokir eksekusi utas hingga kunci tersedia.
void omp_set_lock(
omp_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_lock_t
yang diinisialisasi dengan omp_init_lock.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_set_lock dan omp_set_nest_lock 3.2.3.
Contoh
Lihat omp_init_lock untuk contoh penggunaan omp_set_lock
.
omp_set_nest_lock
Memblokir eksekusi utas hingga kunci tersedia.
void omp_set_nest_lock(
omp_nest_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_nest_lock_t
yang diinisialisasi dengan omp_init_nest_lock.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_set_lock dan omp_set_nest_lock 3.2.3.
Contoh
Lihat omp_init_nest_lock untuk contoh penggunaan omp_set_nest_lock
.
omp_set_nested
Mengaktifkan paralelisme berlapis.
void omp_set_nested(
int val
);
Parameter
Val
Nilai bukan nol memungkinkan paralelisme berlapis, sementara nol menonaktifkan paralelisme berlapis.
Keterangan
Paralelisme berlapis OMP dapat diaktifkan dengan omp_set_nested
, atau dengan mengatur variabel lingkungan OMP_NESTED .
Pengaturan untuk omp_set_nested
akan mengambil alih pengaturan OMP_NESTED
variabel lingkungan.
Mengaktifkan variabel lingkungan dapat merusak program operasional, karena jumlah utas meningkat secara eksponensial saat menyarangkan wilayah paralel. Misalnya, fungsi yang berulang enam kali dengan jumlah utas OMP yang diatur ke 4 memerlukan 4.096 (4 hingga daya 6) utas. Kecuali dengan aplikasi yang terikat I/O, performa aplikasi umumnya turun jika ada lebih banyak utas daripada prosesor.
Gunakan omp_get_nested untuk menampilkan pengaturan saat ini dari omp_set_nested
.
Untuk informasi selengkapnya, lihat fungsi 3.1.9 omp_set_nested.
Contoh
// omp_set_nested.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
int main( )
{
omp_set_nested(1);
omp_set_num_threads(4);
printf_s("%d\n", omp_get_nested( ));
#pragma omp parallel
#pragma omp master
{
printf_s("%d\n", omp_get_nested( ));
}
}
1
1
omp_set_num_threads
Mengatur jumlah utas di wilayah paralel mendatang, kecuali ditimpa oleh klausa num_threads .
void omp_set_num_threads(
int num_threads
);
Parameter
num_threads
Jumlah utas di wilayah paralel.
Keterangan
Untuk informasi selengkapnya, lihat fungsi 3.1.1 omp_set_num_threads.
Contoh
Lihat omp_get_num_threads untuk contoh penggunaan omp_set_num_threads
.
omp_test_lock
Mencoba mengatur kunci tetapi tidak memblokir eksekusi utas.
int omp_test_lock(
omp_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_lock_t
yang diinisialisasi dengan omp_init_lock.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_test_lock dan omp_test_nest_lock 3.2.5.
Contoh
// omp_test_lock.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
omp_lock_t simple_lock;
int main() {
omp_init_lock(&simple_lock);
#pragma omp parallel num_threads(4)
{
int tid = omp_get_thread_num();
while (!omp_test_lock(&simple_lock))
printf_s("Thread %d - failed to acquire simple_lock\n",
tid);
printf_s("Thread %d - acquired simple_lock\n", tid);
printf_s("Thread %d - released simple_lock\n", tid);
omp_unset_lock(&simple_lock);
}
omp_destroy_lock(&simple_lock);
}
Thread 1 - acquired simple_lock
Thread 1 - released simple_lock
Thread 0 - failed to acquire simple_lock
Thread 3 - failed to acquire simple_lock
Thread 0 - failed to acquire simple_lock
Thread 3 - failed to acquire simple_lock
Thread 2 - acquired simple_lock
Thread 0 - failed to acquire simple_lock
Thread 3 - failed to acquire simple_lock
Thread 0 - failed to acquire simple_lock
Thread 3 - failed to acquire simple_lock
Thread 2 - released simple_lock
Thread 0 - failed to acquire simple_lock
Thread 3 - failed to acquire simple_lock
Thread 0 - acquired simple_lock
Thread 3 - failed to acquire simple_lock
Thread 0 - released simple_lock
Thread 3 - failed to acquire simple_lock
Thread 3 - acquired simple_lock
Thread 3 - released simple_lock
omp_test_nest_lock
Mencoba mengatur kunci berlapis tetapi tidak memblokir eksekusi utas.
int omp_test_nest_lock(
omp_nest_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_nest_lock_t
yang diinisialisasi dengan omp_init_nest_lock.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_test_lock dan omp_test_nest_lock 3.2.5.
Contoh
// omp_test_nest_lock.cpp
// compile with: /openmp
#include <stdio.h>
#include <omp.h>
omp_nest_lock_t nestable_lock;
int main() {
omp_init_nest_lock(&nestable_lock);
#pragma omp parallel num_threads(4)
{
int tid = omp_get_thread_num();
while (!omp_test_nest_lock(&nestable_lock))
printf_s("Thread %d - failed to acquire nestable_lock\n",
tid);
printf_s("Thread %d - acquired nestable_lock\n", tid);
if (omp_test_nest_lock(&nestable_lock)) {
printf_s("Thread %d - acquired nestable_lock again\n",
tid);
printf_s("Thread %d - released nestable_lock\n",
tid);
omp_unset_nest_lock(&nestable_lock);
}
printf_s("Thread %d - released nestable_lock\n", tid);
omp_unset_nest_lock(&nestable_lock);
}
omp_destroy_nest_lock(&nestable_lock);
}
Thread 1 - acquired nestable_lock
Thread 0 - failed to acquire nestable_lock
Thread 1 - acquired nestable_lock again
Thread 0 - failed to acquire nestable_lock
Thread 1 - released nestable_lock
Thread 0 - failed to acquire nestable_lock
Thread 1 - released nestable_lock
Thread 0 - failed to acquire nestable_lock
Thread 3 - acquired nestable_lock
Thread 0 - failed to acquire nestable_lock
Thread 3 - acquired nestable_lock again
Thread 0 - failed to acquire nestable_lock
Thread 2 - failed to acquire nestable_lock
Thread 3 - released nestable_lock
Thread 2 - failed to acquire nestable_lock
Thread 3 - released nestable_lock
Thread 2 - failed to acquire nestable_lock
Thread 0 - acquired nestable_lock
Thread 2 - failed to acquire nestable_lock
Thread 2 - failed to acquire nestable_lock
Thread 2 - failed to acquire nestable_lock
Thread 0 - acquired nestable_lock again
Thread 2 - failed to acquire nestable_lock
Thread 0 - released nestable_lock
Thread 2 - failed to acquire nestable_lock
Thread 0 - released nestable_lock
Thread 2 - failed to acquire nestable_lock
Thread 2 - acquired nestable_lock
Thread 2 - acquired nestable_lock again
Thread 2 - released nestable_lock
Thread 2 - released nestable_lock
omp_unset_lock
Melepaskan kunci.
void omp_unset_lock(
omp_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_lock_t
yang diinisialisasi dengan omp_init_lock, dimiliki oleh utas dan dijalankan dalam fungsi.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_unset_lock dan omp_unset_nest_lock 3.2.4.
Contoh
Lihat omp_init_lock untuk contoh penggunaan omp_unset_lock
.
omp_unset_nest_lock
Melepaskan kunci berlapis.
void omp_unset_nest_lock(
omp_nest_lock_t *lock
);
Parameter
kunci
Variabel jenis omp_nest_lock_t
yang diinisialisasi dengan omp_init_nest_lock, dimiliki oleh utas dan dijalankan dalam fungsi.
Keterangan
Untuk informasi selengkapnya, lihat fungsi omp_unset_lock dan omp_unset_nest_lock 3.2.4.
Contoh
Lihat omp_init_nest_lock untuk contoh penggunaan omp_unset_nest_lock
.
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk