<?php

namespace Safe;

use Safe\Exceptions\EioException;

/**
 * eio_busy artificially increases load taking
 * delay seconds to execute. May be used for debugging,
 * or benchmarking.
 *
 * @param int $delay Delay in seconds
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback This callback is called when all the group requests are done.
 * @param mixed $data Arbitrary variable passed to callback.
 * @return resource eio_busy returns request resource on success.
 * @throws EioException
 *
 */
function eio_busy(int $delay, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_busy($delay, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_chmod changes file, or directory permissions. The
 * new permissions are specified by mode.
 *
 * @param string $path Path to the target file or directory
 * Avoid relative
 * paths
 * @param int $mode The new permissions. E.g. 0644.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_chmod returns request resource on success.
 * @throws EioException
 *
 */
function eio_chmod(string $path, int $mode, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_chmod($path, $mode, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * Changes file, or directory permissions.
 *
 * @param string $path Path to file or directory.
 * Avoid relative
 * paths
 * @param int $uid User ID. Is ignored when equal to -1.
 * @param int $gid Group ID. Is ignored when equal to -1.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_chown returns request resource on success.
 * @throws EioException
 *
 */
function eio_chown(string $path, int $uid, int $gid = -1, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_chown($path, $uid, $gid, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_close closes file specified by
 * fd.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_close returns request resource on success.
 * @throws EioException
 *
 */
function eio_close($fd, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_close($fd, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_custom executes custom function specified by
 * execute processing it just like any other eio_* call.
 *
 * @param callable $execute Specifies the request function that should match the following prototype:
 *
 *
 * callback is event completion callback that should match the following
 * prototype:
 *
 *
 * data is the data passed to
 * execute via data argument
 * without modifications
 * result value returned by execute
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_custom returns request resource on success.
 * @throws EioException
 *
 */
function eio_custom(callable $execute, int $pri, callable $callback, $data = null)
{
    error_clear_last();
    $safeResult = \eio_custom($execute, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_dup2 duplicates file descriptor.
 *
 * @param mixed $fd Source stream, Socket resource, or numeric file descriptor
 * @param mixed $fd2 Target stream, Socket resource, or numeric file descriptor
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_dup2 returns request resource on success.
 * @throws EioException
 *
 */
function eio_dup2($fd, $fd2, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_dup2($fd, $fd2, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_event_loop polls libeio until all requests proceeded.
 *
 * @throws EioException
 *
 */
function eio_event_loop(): void
{
    error_clear_last();
    $safeResult = \eio_event_loop();
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
}


/**
 * eio_fallocate allows the caller to directly manipulate the allocated disk space for the
 * file specified by fd file descriptor for the byte
 * range starting at offset and continuing for
 * length bytes.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor, e.g. returned by eio_open.
 * @param int $mode Currently only one flag is supported for mode:
 * EIO_FALLOC_FL_KEEP_SIZE (the same as POSIX constant
 * FALLOC_FL_KEEP_SIZE).
 * @param int $offset Specifies start of the byte range.
 * @param int $length Specifies length the byte range.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_fallocate returns request resource on success.
 * @throws EioException
 *
 */
function eio_fallocate($fd, int $mode, int $offset, int $length, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_fallocate($fd, $mode, $offset, $length, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_fchmod changes permissions for the file specified
 * by fd file descriptor.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor, e.g. returned by eio_open.
 * @param int $mode The new permissions. E.g. 0644.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_fchmod returns request resource on success.
 * @throws EioException
 *
 */
function eio_fchmod($fd, int $mode, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_fchmod($fd, $mode, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_fchown changes ownership of the file specified by
 * fd file descriptor.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor.
 * @param int $uid User ID. Is ignored when equal to -1.
 * @param int $gid Group ID. Is ignored when equal to -1.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_chmod returns request resource on success.
 * @throws EioException
 *
 */
function eio_fchown($fd, int $uid, int $gid = -1, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_fchown($fd, $uid, $gid, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_fdatasync synchronizes a file's in-core state with storage device.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor, e.g. returned by eio_open.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_fdatasync returns request resource on success.
 * @throws EioException
 *
 */
function eio_fdatasync($fd, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_fdatasync($fd, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_fstat returns file status information in
 * result argument of callback
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_busy returns request resource on success.
 * @throws EioException
 *
 */
function eio_fstat($fd, int $pri, callable $callback, $data = null)
{
    error_clear_last();
    if ($data !== null) {
        $safeResult = \eio_fstat($fd, $pri, $callback, $data);
    } else {
        $safeResult = \eio_fstat($fd, $pri, $callback);
    }
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_fstatvfs returns file system statistics in
 * result of callback.
 *
 * @param mixed $fd A file descriptor of a file within the mounted file system.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_fstatvfs returns request resource on success.
 * @throws EioException
 *
 */
function eio_fstatvfs($fd, int $pri, callable $callback, $data = null)
{
    error_clear_last();
    if ($data !== null) {
        $safeResult = \eio_fstatvfs($fd, $pri, $callback, $data);
    } else {
        $safeResult = \eio_fstatvfs($fd, $pri, $callback);
    }
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * Synchronize a file's in-core state with storage device
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_fsync returns request resource on success.
 * @throws EioException
 *
 */
function eio_fsync($fd, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_fsync($fd, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_ftruncate causes a regular file referenced by
 * fd file descriptor to be truncated to precisely
 * length bytes.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor.
 * @param int $offset Offset from beginning of the file
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_ftruncate returns request resource on success.
 * @throws EioException
 *
 */
function eio_ftruncate($fd, int $offset = 0, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_ftruncate($fd, $offset, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_futime changes file last access and modification
 * times.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor, e.g. returned by eio_open
 * @param float $atime Access time
 * @param float $mtime Modification time
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_futime returns request resource on success.
 * @throws EioException
 *
 */
function eio_futime($fd, float $atime, float $mtime, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_futime($fd, $atime, $mtime, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_grp creates a request group.
 *
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param string $data is custom data passed to the request.
 * @return resource eio_grp returns request group resource on success.
 * @throws EioException
 *
 */
function eio_grp(callable $callback, string $data = null)
{
    error_clear_last();
    $safeResult = \eio_grp($callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_lstat returns file status information in
 * result argument of callback
 *
 * @param string $path The file path
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_lstat returns request resource on success.
 * @throws EioException
 *
 */
function eio_lstat(string $path, int $pri, callable $callback, $data = null)
{
    error_clear_last();
    $safeResult = \eio_lstat($path, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_mkdir creates directory with specified access
 * mode.
 *
 * @param string $path Path for the new directory.
 * @param int $mode Access mode, e.g. 0755
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_mkdir returns request resource on success.
 * @throws EioException
 *
 */
function eio_mkdir(string $path, int $mode, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_mkdir($path, $mode, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_mknod creates ordinary or special(often) file.
 *
 * @param string $path Path for the new node(file).
 * @param int $mode Specifies both the permissions to use and the type of node to be
 * created. It should be a combination (using bitwise OR) of one of the
 * file types listed below and the permissions for the new node(e.g. 0640).
 *
 * Possible file types are: EIO_S_IFREG(regular file),
 * EIO_S_IFCHR(character file),
 * EIO_S_IFBLK(block special file),
 * EIO_S_IFIFO(FIFO - named pipe) and
 * EIO_S_IFSOCK(UNIX domain socket).
 *
 * To specify permissions EIO_S_I* constants could be
 * used.
 * @param int $dev If  the  file type is EIO_S_IFCHR or
 * EIO_S_IFBLK then dev specifies the major and minor
 * numbers of the newly created device special file. Otherwise
 * dev ignored. See mknod(2) man page for
 * details.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_mknod returns request resource on success.
 * @throws EioException
 *
 */
function eio_mknod(string $path, int $mode, int $dev, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_mknod($path, $mode, $dev, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_nop does nothing, except go through the whole
 * request cycle. Could be useful in debugging.
 *
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_nop returns request resource on success.
 * @throws EioException
 *
 */
function eio_nop(int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_nop($pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_readahead populates the page cache with data from a file so that subsequent reads from
 * that file will not block on disk I/O. See READAHEAD(2) man page for details.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor
 * @param int $offset Starting point from which data is to be read.
 * @param int $length Number of bytes to be read.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_readahead returns request resource on success.
 * @throws EioException
 *
 */
function eio_readahead($fd, int $offset, int $length, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_readahead($fd, $offset, $length, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * Reads through a whole directory(via the opendir, readdir and
 * closedir system calls) and returns either the names or an array in
 * result argument of callback
 * function, depending on the flags argument.
 *
 * @param string $path Directory path.
 * @param int $flags Combination of EIO_READDIR_* constants.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param string $data is custom data passed to the request.
 * @return resource eio_readdir returns request resource on success.
 * Sets result argument of
 * callback function according to
 * flags:
 *
 *
 *
 *
 *
 *
 * EIO_READDIR_DENTS
 * (int)
 *
 *
 *
 * eio_readdir flag. If specified, the result argument of the callback
 * becomes an array with the following keys:
 * 'names' - array of directory names
 * 'dents' - array of struct
 * eio_dirent-like arrays having the following keys each:
 * 'name' - the directory name;
 * 'type' - one of EIO_DT_*
 * constants;
 * 'inode' - the inode number, if available, otherwise
 * unspecified;
 *
 *
 *
 *
 *
 * EIO_READDIR_DIRS_FIRST
 * (int)
 *
 *
 *
 * When this flag is specified, the names will be returned in an order
 * where likely directories come first, in optimal stat order.
 *
 *
 *
 *
 *
 * EIO_READDIR_STAT_ORDER
 * (int)
 *
 *
 *
 * When this flag is specified, then the names will be returned in an order
 * suitable for stat'ing each one. When planning to
 * stat all files in the given directory, the
 * returned order will likely be
 * fastest.
 *
 *
 *
 *
 *
 * EIO_READDIR_FOUND_UNKNOWN
 * (int)
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 * Node types:
 *
 *
 *
 *
 *
 * EIO_DT_UNKNOWN
 * (int)
 *
 *
 *
 * Unknown node type(very common). Further stat needed.
 *
 *
 *
 *
 *
 * EIO_DT_FIFO
 * (int)
 *
 *
 *
 * FIFO node type
 *
 *
 *
 *
 *
 * EIO_DT_CHR
 * (int)
 *
 *
 *
 * Node type
 *
 *
 *
 *
 *
 * EIO_DT_MPC
 * (int)
 *
 *
 *
 * Multiplexed char device (v7+coherent) node type
 *
 *
 *
 *
 *
 * EIO_DT_DIR
 * (int)
 *
 *
 *
 * Directory node type
 *
 *
 *
 *
 *
 * EIO_DT_NAM
 * (int)
 *
 *
 *
 * Xenix special named file node type
 *
 *
 *
 *
 *
 * EIO_DT_BLK
 * (int)
 *
 *
 *
 * Node type
 *
 *
 *
 *
 *
 * EIO_DT_MPB
 * (int)
 *
 *
 *
 * Multiplexed block device (v7+coherent)
 *
 *
 *
 *
 *
 * EIO_DT_REG
 * (int)
 *
 *
 *
 * Node type
 *
 *
 *
 *
 *
 * EIO_DT_NWK
 * (int)
 *
 *
 *
 *
 *
 *
 *
 *
 * EIO_DT_CMP
 * (int)
 *
 *
 *
 * HP-UX network special node type
 *
 *
 *
 *
 *
 * EIO_DT_LNK
 * (int)
 *
 *
 *
 * Link node type
 *
 *
 *
 *
 *
 * EIO_DT_SOCK
 * (int)
 *
 *
 *
 * Socket node type
 *
 *
 *
 *
 *
 * EIO_DT_DOOR
 * (int)
 *
 *
 *
 * Solaris door node type
 *
 *
 *
 *
 *
 * EIO_DT_WHT
 * (int)
 *
 *
 *
 * Node type
 *
 *
 *
 *
 *
 * EIO_DT_MAX
 * (int)
 *
 *
 *
 * Highest node type value
 *
 *
 *
 *
 *
 *
 *
 * @throws EioException
 *
 */
function eio_readdir(string $path, int $flags, int $pri, callable $callback, string $data = null)
{
    error_clear_last();
    $safeResult = \eio_readdir($path, $flags, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 *
 *
 * @param string $path Source symbolic link path
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param string $data is custom data passed to the request.
 * @return resource eio_readlink returns request resource on success.
 * @throws EioException
 *
 */
function eio_readlink(string $path, int $pri, callable $callback, string $data = null)
{
    error_clear_last();
    $safeResult = \eio_readlink($path, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_rename renames or moves a file to new location.
 *
 * @param string $path Source path
 * @param string $new_path Target path
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_rename returns request resource on success.
 * @throws EioException
 *
 */
function eio_rename(string $path, string $new_path, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_rename($path, $new_path, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_rmdir removes a directory.
 *
 * @param string $path Directory path
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_rmdir returns request resource on success.
 * @throws EioException
 *
 */
function eio_rmdir(string $path, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_rmdir($path, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_seek repositions the offset of the open file associated with
 * stream, Socket resource, or file descriptor specified by fd to the argument offset according to the directive whence as follows:
 *
 * EIO_SEEK_SET - Set position equal to offset bytes.
 * EIO_SEEK_CUR - Set position to current location plus offset.
 * EIO_SEEK_END - Set position to end-of-file plus offset.
 *
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor
 * @param int $offset Starting point from which data is to be read.
 * @param int $whence Number of bytes to be read.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_seek returns request resource on success.
 * @throws EioException
 *
 */
function eio_seek($fd, int $offset, int $whence, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_seek($fd, $offset, $whence, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_sendfile copies  data between one file descriptor
 * and another. See SENDFILE(2) man page for details.
 *
 * @param mixed $out_fd Output stream, Socket resource, or file descriptor. Should be opened for writing.
 * @param mixed $in_fd Input stream, Socket resource, or file descriptor. Should be opened for reading.
 * @param int $offset Offset within the source file.
 * @param int $length Number of bytes to copy.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param string $data is custom data passed to the request.
 * @return resource eio_sendfile returns request resource on success.
 * @throws EioException
 *
 */
function eio_sendfile($out_fd, $in_fd, int $offset, int $length, int $pri = null, callable $callback = null, string $data = null)
{
    error_clear_last();
    if ($data !== null) {
        $safeResult = \eio_sendfile($out_fd, $in_fd, $offset, $length, $pri, $callback, $data);
    } elseif ($callback !== null) {
        $safeResult = \eio_sendfile($out_fd, $in_fd, $offset, $length, $pri, $callback);
    } elseif ($pri !== null) {
        $safeResult = \eio_sendfile($out_fd, $in_fd, $offset, $length, $pri);
    } else {
        $safeResult = \eio_sendfile($out_fd, $in_fd, $offset, $length);
    }
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_stat returns file status information in
 * result argument of callback
 *
 * @param string $path The file path
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_stat returns request resource on success. On success assigns result argument of
 * callback to an array.
 * @throws EioException
 *
 */
function eio_stat(string $path, int $pri, callable $callback, $data = null)
{
    error_clear_last();
    $safeResult = \eio_stat($path, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_statvfs returns file system statistics information in
 * result argument of callback
 *
 * @param string $path Pathname of any file within the mounted file system
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_statvfs returns request resource on success.
 * On success assigns result argument of
 * callback to an array.
 * @throws EioException
 *
 */
function eio_statvfs(string $path, int $pri, callable $callback, $data = null)
{
    error_clear_last();
    if ($data !== null) {
        $safeResult = \eio_statvfs($path, $pri, $callback, $data);
    } else {
        $safeResult = \eio_statvfs($path, $pri, $callback);
    }
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_symlink creates a symbolic link
 * new_path to path.
 *
 * @param string $path Source path
 * @param string $new_path Target path
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_symlink returns request resource on success.
 * @throws EioException
 *
 */
function eio_symlink(string $path, string $new_path, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_symlink($path, $new_path, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_sync_file_range permits fine control when synchronizing the open file referred to by the file
 * descriptor fd with disk.
 *
 * @param mixed $fd File descriptor
 * @param int $offset The starting byte of the file range to be synchronized
 * @param int $nbytes Specifies the length of the range to be synchronized, in bytes. If
 * nbytes is zero, then all bytes from offset through
 * to the end of file are synchronized.
 * @param int $flags A bit-mask. Can include any of the following values:
 * EIO_SYNC_FILE_RANGE_WAIT_BEFORE,
 * EIO_SYNC_FILE_RANGE_WRITE,
 * EIO_SYNC_FILE_RANGE_WAIT_AFTER. These flags have
 * the same meaning as their SYNC_FILE_RANGE_*
 * counterparts(see SYNC_FILE_RANGE(2) man page).
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_sync_file_range returns request resource on success.
 * @throws EioException
 *
 */
function eio_sync_file_range($fd, int $offset, int $nbytes, int $flags, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_sync_file_range($fd, $offset, $nbytes, $flags, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 *
 *
 * @param int $pri
 * @param callable $callback
 * @param mixed $data
 * @return resource eio_sync returns request resource on success.
 * @throws EioException
 *
 */
function eio_sync(int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_sync($pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 *
 *
 * @param mixed $fd File descriptor
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_syncfs returns request resource on success.
 * @throws EioException
 *
 */
function eio_syncfs($fd, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_syncfs($fd, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_truncate causes the regular file named by path to be truncated to
 * a size of precisely length bytes
 *
 * @param string $path File path
 * @param int $offset Offset from beginning of the file.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_busy returns request resource on success.
 * @throws EioException
 *
 */
function eio_truncate(string $path, int $offset = 0, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_truncate($path, $offset, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_unlink deletes  a  name from the file system.
 *
 * @param string $path Path to file
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_unlink returns request resource on success.
 * @throws EioException
 *
 */
function eio_unlink(string $path, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_unlink($path, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 *
 *
 * @param string $path Path to the file.
 * @param float $atime Access time
 * @param float $mtime Modification time
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_utime returns request resource on success.
 * @throws EioException
 *
 */
function eio_utime(string $path, float $atime, float $mtime, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_utime($path, $atime, $mtime, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}


/**
 * eio_write writes up to length
 * bytes from str at offset
 * offset from the beginning of the file.
 *
 * @param mixed $fd Stream, Socket resource, or numeric file descriptor, e.g. returned by eio_open
 * @param string $str Source string
 * @param int $length Maximum number of bytes to write.
 * @param int $offset Offset from the beginning of file.
 * @param int $pri The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL.
 * If NULL passed, pri internally is set to
 * EIO_PRI_DEFAULT.
 * @param callable $callback
 * callback function is called when the request is done.
 * It should match the following prototype:
 *
 *
 * data
 * is custom data passed to the request.
 *
 *
 * result
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 *
 * req
 * is optional request resource which can be used with functions like eio_get_last_error
 *
 *
 *
 * is custom data passed to the request.
 *
 * request-specific result value; basically, the value returned by corresponding
 * system call.
 *
 * is optional request resource which can be used with functions like eio_get_last_error
 * @param mixed $data is custom data passed to the request.
 * @return resource eio_write returns request resource on success.
 * @throws EioException
 *
 */
function eio_write($fd, string $str, int $length = 0, int $offset = 0, int $pri = EIO_PRI_DEFAULT, callable $callback = null, $data = null)
{
    error_clear_last();
    $safeResult = \eio_write($fd, $str, $length, $offset, $pri, $callback, $data);
    if ($safeResult === false) {
        throw EioException::createFromPhpError();
    }
    return $safeResult;
}
