<?xml version="1.0" encoding="utf-8"?>

<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="parallel-runtime.run">

<refnamediv>

<refname>parallel\Runtime::run</refname>

<refpurpose>Exécution</refpurpose>

</refnamediv>

<refsect1 role="description" audience="execute">

&reftitle.description;

<methodsynopsis>

<modifier>public</modifier> <type class="union"><type>Future</type><type>null</type></type><methodname>parallel\Runtime::run</methodname>

<methodparam><type>Closure</type><parameter>task</parameter></methodparam>

</methodsynopsis>

<simpara>

Planifie <parameter>task</parameter> pour l'exécution en parallèle.

</simpara>

<methodsynopsis>

<modifier>public</modifier> <type class="union"><type>Future</type><type>null</type></type><methodname>parallel\Runtime::run</methodname>

<methodparam><type>Closure</type><parameter>task</parameter></methodparam>

<methodparam><type>array</type><parameter>argv</parameter></methodparam>

</methodsynopsis>

<simpara>

Planifie <parameter>task</parameter> pour l'exécution en parallèle, en passant <parameter>argv</parameter> au moment de l'exécution.

</simpara>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<variablelist>

<varlistentry>

<term><parameter>task</parameter></term>

<listitem>

<simpara>

Une <classname>Closure</classname> avec des caractéristiques spécifiques.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>argv</parameter></term>

<listitem>

<simpara>

Un <type>array</type> d'arguments avec des caractéristiques spécifiques à passer à <parameter>task</parameter> au moment de l'exécution.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 role="closure-characteristics">

<title>Caractéristiques de la tâche</title>

<para>

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

<simplelist>

<member>accepter ou retourner par référence</member>

<member>accepter ou retourner des objets internes (voir notes)</member>

<member>exécuter un ensemble limité d'instructions</member>

</simplelist>

</para>

<para>

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

<simplelist>

<member>yield</member>

<member>utiliser by-reference</member>

<member>déclarer des classes</member>

<member>déclarer des fonctions nommées</member>

</simplelist>

</para>

<note>

<simpara>

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.

</simpara>

</note>

<note>

<simpara>

Aucune instruction n'est interdite dans les fichiers que la tâche peut inclure.

</simpara>

</note>

</refsect1>

<refsect1 role="argv-characteristics">

<title>Caractéristiques des arguments</title>

<para>

Les arguments ne doivent pas:

<simplelist>

<member>contenir des références</member>

<member>contenir des ressources</member>

<member>contenir des objets internes (voir notes)</member>

</simplelist>

<note>

<simpara>

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

</simpara>

</note>

</para>

</refsect1>

<refsect1 role="object-characteristics">

<title>Notes sur les objets internes</title>

<simpara>

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.

</simpara>

<simpara>

Certains objets internes n'utilisent pas de structure personnalisée, par exemple <classname>parallel\Events\Event</classname> et peuvent donc être partagés.

</simpara>

<simpara>

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

</simpara>

<simpara>

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.

</simpara>

<warning>

<simpara>

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.

</simpara>

</warning>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<warning>

<simpara>

La <type>Future</type> retournée ne doit pas être ignorée lorsque la tâche contient une déclaration de retour ou de lancer.

</simpara>

</warning>

</refsect1>

<refsect1 role="exceptions">

<title>Exceptions</title>

<warning>

<simpara>

Lance une <type>parallel\Runtime\Error\Closed</type> si <type>parallel\Runtime</type> était fermé.

</simpara>

</warning>

<warning>

<simpara>

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

</simpara>

</warning>

<warning>

<simpara>

Lance une <type>parallel\Runtime\Error\IllegalInstruction</type> si <parameter>task</parameter> contient des instructions illégales.

</simpara>

</warning>

<warning>

<simpara>

Lance une <type>parallel\Runtime\Error\IllegalParameter</type> si <parameter>task</parameter> accepte ou <parameter>argv</parameter> contient des variables illégales.

</simpara>

</warning>

<warning>

<simpara>

Lance une <type>parallel\Runtime\Error\IllegalReturn</type> si <parameter>task</parameter> retourne illégalement.

</simpara>

</warning>

</refsect1>

</refentry>