thrd_yield

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für nebenläufige Programmierung

Threads thrd_create thrd_equal thrd_current    thrd_sleep thrd_yield thrd_exit thrd_detach thrd_join thrd_successthrd_timedoutthrd_busythrd_nomemthrd_error    Atomare Operationen atomic_init ATOMIC_VAR_INIT (bis C23) ATOMIC_***_LOCK_FREE atomic_is_lock_free atomic_store atomic_load atomic_exchange atomic_compare_exchange atomic_fetch_add atomic_fetch_sub atomic_fetch_or atomic_fetch_xor atomic_fetch_and

Atomare Flags atomic_flag ATOMIC_FLAG_INIT atomic_flag_test_and_set atomic_flag_clear Speicherordnung memory_order kill_dependency atomic_thread_fence atomic_signal_fence Gegenseitiger Ausschluss mtx_init mtx_lock mtx_timedlock mtx_trylock call_once mtx_unlock mtx_destroy mtx_plainmtx_recursivemtx_timed Bedingungsvariablen cnd_init cnd_signal cnd_broadcast cnd_wait cnd_timedwait cnd_destroy Thread-lokaler Speicher thread_local TSS_DTOR_ITERATIONS    tss_create tss_get tss_set tss_delete

 

Definiert im Header <threads.h>
void thrd_yield(void);		(seit C11)

Gibt einen Hinweis an die Implementierung, die Ausführung von Threads neu zu planen, sodass andere Threads laufen können.

Parameter

(keine)

Rückgabewert

(keine)

Hinweise

Das genaue Verhalten dieser Funktion hängt von der Implementierung ab, insbesondere von der Mechanik des verwendeten Betriebssystem-Schedulers und dem Zustand des Systems. Zum Beispiel würde ein First-In-First-Out-Echtzeit-Scheduler (SCHED_FIFO unter Linux) den aktuellen Thread suspendieren und ihn an das Ende der Warteschlange von lauffähigen Threads gleicher Priorität stellen. Wenn keine anderen Threads mit der gleichen Priorität vorhanden sind, hat yield keine Auswirkung.

Das POSIX-Äquivalent dieser Funktion ist sched_yield.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <time.h>
#include <threads.h>
 
// utility function: difference between timespecs in microseconds
double usdiff(struct timespec s, struct timespec e)
{
    double sdiff = difftime(e.tv_sec, s.tv_sec);
    long nsdiff = e.tv_nsec - s.tv_nsec;
    if(nsdiff < 0) return 1000000*(sdiff-1) + (1000000000L+nsdiff)/1000.0;
    else return 1000000*(sdiff) + nsdiff/1000.0;
}
 
// busy wait while yielding
void sleep_100us()
{
    struct timespec start, end;
    timespec_get(&start, TIME_UTC);
    do {
        thrd_yield();
        timespec_get(&end, TIME_UTC);
    } while(usdiff(start, end) < 100.0);
}
 
int main()
{
    struct timespec start, end;
    timespec_get(&start, TIME_UTC);
    sleep_100us();
    timespec_get(&end, TIME_UTC);
    printf("Waited for %.3f us\n", usdiff(start, end));
}

Mögliche Ausgabe

Waited for 100.344 us

Referenzen

• C17-Standard (ISO/IEC 9899:2018)

• 7.26.5.8 Die Funktion thrd_yield (S. 281)

• C11-Standard (ISO/IEC 9899:2011)

• 7.26.5.8 Die Funktion thrd_yield (S. 385)

Siehe auch

thrd_sleep (C11)	setzt die Ausführung des aufrufenden Threads für die angegebene Zeitspanne aus (Funktion)
C++ Dokumentation für yield