eio_grp

Creates a request group

&reftitle.description; `resource` `eio_grp` `callable` `callback` `string` `data` NULL

`eio_grp` creates a request group.

&reftitle.parameters;

`callback`

- &eio.callback.proto;

`data`

- Arbitrary variable passed to `callback`.

&reftitle.returnvalues;

`eio_grp` returns request group resource on success,&return.falseforfailure;.

&reftitle.examples;

### `eio_grp` example

    <?php
    $temp_filename = dirname(__FILE__) ."/eio-file.tmp";
    $fp = fopen($temp_filename, "w");
    fwrite($fp, "some data");
    fclose($fp);
    $my_file_fd = NULL;

    /* Is called when the group requests are done */
    function my_grp_done($data, $result) {
     // Remove the file, if it still exists
     @unlink($data);
    }

    /* Is called when the temporary file is opened */
    function my_grp_file_opened_callback($data, $result) {
     global $my_file_fd, $grp;

     $my_file_fd = $result;

     $req = eio_read($my_file_fd, 4, 0,
       EIO_PRI_DEFAULT, "my_grp_file_read_callback");
     eio_grp_add($grp, $req);
    }

    /* Is called when the file is read */
    function my_grp_file_read_callback($data, $result) {
     global $my_file_fd, $grp;

     var_dump($result);

     // Create request to close the file
     $req = eio_close($my_file_fd);

     // Add request to the group
     eio_grp_add($grp, $req);
    }

    // Create request group
    $grp = eio_grp("my_grp_done", $temp_filename);

    // Create request
    $req = eio_open($temp_filename, EIO_O_RDWR | EIO_O_APPEND , NULL,
      EIO_PRI_DEFAULT, "my_grp_file_opened_callback", NULL);

    // Add request to the group
    eio_grp_add($grp, $req);

    // Process requests
    eio_event_loop();
    ?>

&example.outputs.similar;

    string(4) "some"

&reftitle.seealso;

- `eio_grp_cancel`
- `eio_grp_add`