EIO_GRP(3)								 1								EIO_GRP(3)

eio_grp - Createsa request group.

SYNOPSIS

       resource eio_grp (callable  $callback, [string  $data = NULL])

DESCRIPTION

       eio_grp(3) creates a request group.

PARAMETERS

	      o $callback
		-$callback function is called when the request is done. It should match the following prototype:

	      void callback(mixed $data, int $result[, resource $req]);

		     o $data
		       -is custom data passed to the request.

		     o $result
		       -request-specific result value; basically, the value returned by corresponding system call.

		     o $req
		       -is optional request resource which can be used with functions like eio_get_last_error(3)

	      o $data
		- Arbitrary variable passed to $callback.

RETURN VALUES

       eio_grp(3) returns request group resource on success or FALSE on error.

EXAMPLES

       Example #1

	      eio_grp(3) 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();
	      ?>

	      The above example will output something similar to:

	      string(4) "some"

SEE ALSO eio_grp_cancel, eio_grp_add.
PHP Documentation Group 														EIO_GRP(3)