parallel\Runtime::run

(0.8.0)

parallel\Runtime::run — ExĂ©cution

Description

public function parallel\Runtime::run(Closure $task): ?Future

Planifie task pour l'exécution en parallÚle.

public function parallel\Runtime::run(Closure $task, array $argv): ?Future

Planifie task pour l'exécution en parallÚle, en passant argv au moment de l'exécution.

Liste de paramĂštres

task
Une Closure avec des caractéristiques spécifiques.
argv
Un array d'arguments avec des caractéristiques spécifiques à passer à task au moment de l'exécution.

Caractéristiques de la tùche

Les fermetures planifiées pour l'exécution en parallÚle ne doivent pas :

  • accepter ou retourner par rĂ©fĂ©rence
  • accepter ou retourner des objets internes (voir notes)
  • exĂ©cuter un ensemble limitĂ© d'instructions

Les instructions interdites dans les fermetures destinées à l'exécution en parallÚle sont :

  • yield
  • utiliser by-reference
  • dĂ©clarer des classes
  • dĂ©clarer des fonctions nommĂ©es

Note: Les fermetures imbriquées peuvent yield ou utiliser by-reference, mais ne doivent pas contenir de déclarations de classes ou de fonctions nommées.

Note: Aucune instruction n'est interdite dans les fichiers que la tĂąche peut inclure.

Caractéristiques des arguments

Les arguments ne doivent pas:

  • contenir des rĂ©fĂ©rences
  • contenir des ressources
  • contenir des objets internes (voir notes)

Note: Dans le cas des ressources de flux de fichiers, la ressource sera convertie en descripteur de fichier et passée en int si possible, ceci n'est pas supporté sur Windows.

Notes sur les objets internes

Les objets internes utilisent gĂ©nĂ©ralement une structure personnalisĂ©e qui ne peut pas ĂȘtre copiĂ©e en toute sĂ©curitĂ© par valeur, PHP manque actuellement des mĂ©canismes pour le faire (sans sĂ©rialisation) et donc seuls les objets qui n'utilisent pas une structure personnalisĂ©e peuvent ĂȘtre partagĂ©s.

Certains objets internes n'utilisent pas de structure personnalisĂ©e, par exemple parallel\Events\Event et peuvent donc ĂȘtre partagĂ©s.

Les fermetures sont un type spĂ©cial d'objet interne et peuvent ĂȘtre copiĂ©es par valeur, et peuvent donc ĂȘtre partagĂ©es.

Les canaux sont centraux pour l'Ă©criture de code parallĂšle et supportent l'accĂšs et l'exĂ©cution concurrents par nĂ©cessitĂ©, et peuvent donc ĂȘtre partagĂ©s.

Avertissement

Une classe utilisateur qui Ă©tend une classe interne peut utiliser une structure personnalisĂ©e telle que dĂ©finie par la classe interne, auquel cas elle ne peut pas ĂȘtre copiĂ©e en toute sĂ©curitĂ© par valeur, et ne peut donc pas ĂȘtre partagĂ©e.

Valeurs de retour

Avertissement

La Future retournĂ©e ne doit pas ĂȘtre ignorĂ©e lorsque la tĂąche contient une dĂ©claration de retour ou de lancer.

Exceptions

Avertissement

Lance une parallel\Runtime\Error\Closed si parallel\Runtime était fermé.

Avertissement

Lance une parallel\Runtime\Error\IllegalFunction si task est une fermeture créée à partir d'une fonction interne.

Avertissement

Lance une parallel\Runtime\Error\IllegalInstruction si task contient des instructions illégales.

Avertissement

Lance une parallel\Runtime\Error\IllegalParameter si task accepte ou argv contient des variables illégales.

Avertissement

Lance une parallel\Runtime\Error\IllegalReturn si task retourne illégalement.

Found A Problem?

Learn How To Improve This Page ‱ Submit a Pull Request ‱ Report a Bug
add a note

User Contributed Notes

There are no user contributed notes for this page.