From 59d24567f3ef3118580524e52379ca01a09366d2 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 7 Jul 2026 18:07:37 +0200 Subject: [PATCH] Synchronise 3 fichiers en retard sur doc-en (pcntl QoS + DateInterval::createFromDateString) --- .../dateinterval/createfromdatestring.xml | 5 +- .../pcntl/functions/pcntl-getqos-class.xml | 25 +++-- .../pcntl/functions/pcntl-setqos-class.xml | 95 +++++++++++++++---- 3 files changed, 99 insertions(+), 26 deletions(-) diff --git a/reference/datetime/dateinterval/createfromdatestring.xml b/reference/datetime/dateinterval/createfromdatestring.xml index e98abe82f5..9507ee2f21 100644 --- a/reference/datetime/dateinterval/createfromdatestring.xml +++ b/reference/datetime/dateinterval/createfromdatestring.xml @@ -1,6 +1,5 @@ - - + DateInterval::createFromDateString @@ -85,6 +84,8 @@ A désormais un type de retour provisoire de DateInterval. Auparavant, il était DateIntervalfalse. + + 8.3.0 DateInterval::createFromDateString lance désormais diff --git a/reference/pcntl/functions/pcntl-getqos-class.xml b/reference/pcntl/functions/pcntl-getqos-class.xml index fd2e98b71e..165817fa23 100644 --- a/reference/pcntl/functions/pcntl-getqos-class.xml +++ b/reference/pcntl/functions/pcntl-getqos-class.xml @@ -1,10 +1,9 @@ - - + pcntl_getqos_class - Récupère la classe de qualité de service actuelle du processus + Récupère la classe de QoS du thread courant @@ -14,10 +13,11 @@ - Retourne la classe de qualité de service (QoS) actuelle du processus appelant. - Cette fonction n'est disponible que sur macOS, qui utilise les classes QoS pour - gérer l'efficacité énergétique et les performances. + Récupère la classe de qualité de service (QoS) du thread courant. + + Cette fonction n'est disponible que sur les plateformes Apple. + @@ -28,8 +28,16 @@ &reftitle.returnvalues; - Retourne une valeur de l'énumération Pcntl\QosClass représentant - la classe QoS actuelle. + Retourne la classe QoS actuelle sous la forme d'une + Pcntl\QosClass. + + + + + &reftitle.errors; + + Une Error est levée si l'appel sous-jacent à + pthread_get_qos_class_np() échoue. @@ -37,6 +45,7 @@ &reftitle.seealso; pcntl_setqos_class + Pcntl\QosClass diff --git a/reference/pcntl/functions/pcntl-setqos-class.xml b/reference/pcntl/functions/pcntl-setqos-class.xml index 64e318708f..72e95e2703 100644 --- a/reference/pcntl/functions/pcntl-setqos-class.xml +++ b/reference/pcntl/functions/pcntl-setqos-class.xml @@ -1,22 +1,20 @@ - - + pcntl_setqos_class - Définit la classe de qualité de service du processus + Définit la classe de QoS du thread courant &reftitle.description; voidpcntl_setqos_class - Pcntl\QosClassqos_classPcntl\QosClass::Default + Pcntl\QosClassqos_classPcntl\QosClass::Default - Définit la classe de qualité de service (QoS) du processus appelant. - Cette fonction n'est disponible que sur macOS, qui utilise les classes QoS pour - gérer l'efficacité énergétique et les performances. + Définit la classe de qualité de service (QoS) du thread + courant. @@ -27,19 +25,75 @@ qos_class - La classe QoS à définir. Doit être l'une des - valeurs de l'énumération Pcntl\QosClass : + La classe de qualité de service à assigner au thread courant. Le système + d'exploitation l'utilise comme une indication pour planifier le temps + CPU, la priorité d'E/S et la + consommation d'énergie, les classes supérieures étant prioritaires sur + les inférieures. Voir Pcntl\QosClass pour les cas + disponibles. - - Pcntl\QosClass::UserInteractive - Pcntl\QosClass::UserInitiated - Pcntl\QosClass::Default - Pcntl\QosClass::Utility - Pcntl\QosClass::Background - + + + Pcntl\QosClass::UserInteractive + + + Priorité la plus élevée. Destinée au travail qui pilote directement une + interface utilisateur et qui doit s'achever quasiment instantanément + pour éviter tout délai perçu, comme la gestion d'événements ou le + dessin. + + + + + Pcntl\QosClass::UserInitiated + + + Priorité élevée, juste en dessous de + UserInteractive. Destinée au travail que + l'utilisateur a explicitement initié et qu'il attend activement, censé + s'achever en quelques secondes. + + + + + Pcntl\QosClass::Default + + + Priorité standard, utilisée lorsqu'aucune classe plus spécifique ne + s'applique. S'exécute après le travail de priorité supérieure mais + avant Utility et Background. + + + + + Pcntl\QosClass::Utility + + + Priorité inférieure, destinée au travail de longue durée dont + l'utilisateur a conscience mais qu'il n'attend pas activement, comme + les téléchargements, les imports ou les calculs en masse. Planifiée de + manière économe en énergie. + + + + + Pcntl\QosClass::Background + + + Priorité la plus basse, destinée au travail dont l'utilisateur n'a pas + conscience, comme le préchargement, l'indexation ou la maintenance. + Fortement optimisée pour l'efficacité énergétique et pouvant être + différée lorsque le système est sous charge. + + + + + + Cette fonction n'est disponible que sur les plateformes Apple. + @@ -49,10 +103,19 @@ + + &reftitle.errors; + + Une Error est levée si l'appel sous-jacent à + pthread_set_qos_class_self_np() échoue. + + + &reftitle.seealso; pcntl_getqos_class + Pcntl\QosClass