uvcc
libuv C++ bindings
uv::fs::close Class Reference

Close a file handle. More...

#include "request-fs.hpp"

Inheritance diagram for uv::fs::close:
uv::fs uv::request

Public Types

using on_request_t = std::function< void(close _request) >
 The function type of the callback called when the close request has completed.
 
- Public Types inherited from uv::fs
using uv_t = ::uv_fs_t
 
- Public Types inherited from uv::request
using uv_t = ::uv_req_t
 
using on_destroy_t = std::function< void(void *_data) >
 The function type of the callback called when the request object is about to be destroyed.
 

Public Member Functions

 close (const close &)=default
 
closeoperator= (const close &)=default
 
 close (close &&) noexcept=default
 
closeoperator= (close &&) noexcept=default
 
on_request_ton_request () const noexcept
 
file handle () const noexcept
 The file which this close request has been running on. More...
 
int run (file &_file)
 Run the request. Close a _file handle. More...
 
 operator const uv_t * () const noexcept
 
 operator uv_t * () noexcept
 
- Public Member Functions inherited from uv::fs
 fs (const fs &)=default
 
fsoperator= (const fs &)=default
 
 fs (fs &&) noexcept=default
 
fsoperator= (fs &&) noexcept=default
 
::uv_fs_type fs_type () const noexcept
 The tag indicating a subtype of the filesystem request. More...
 
uv::loop loop () const noexcept
 The libuv loop that started this filesystem request and where completion will be reported.
 
 operator const uv_t * () const noexcept
 
 operator uv_t * () noexcept
 
- Public Member Functions inherited from uv::request
 request (const request &_that)
 
requestoperator= (const request &_that)
 
 request (request &&_that) noexcept
 
requestoperator= (request &&_that) noexcept
 
void swap (request &_that) noexcept
 
std::uintptr_t id () const noexcept
 
long nrefs () const noexcept
 The current number of existing references to the same object as this request variable refers to.
 
int uv_status () const noexcept
 The status value returned by the last executed libuv API function on this request.
 
on_destroy_ton_destroy () const noexcept
 
::uv_req_type type () const noexcept
 The tag indicating a libuv type of the request. More...
 
const char * type_name () const noexcept
 A string containing the name of the request type.
 
void *const & data () const noexcept
 The pointer to the user-defined arbitrary data. libuv and uvcc does not use this field.
 
void *& data () noexcept
 
int cancel () noexcept
 Cancel a pending request. More...
 
 operator const uv_t * () const noexcept
 
 operator uv_t * () noexcept
 
 operator bool () const noexcept
 Equivalent to (uv_status() >= 0).
 

Detailed Description

Close a file handle.

Definition at line 129 of file request-fs.hpp.

Member Function Documentation

◆ handle()

file uv::fs::close::handle ( ) const
inlinenoexcept

The file which this close request has been running on.

It is guaranteed that it will be a valid instance at least within the request callback.

Definition at line 180 of file request-fs.hpp.

◆ run()

int uv::fs::close::run ( file _file)
inline

Run the request. Close a _file handle.

If the _file is in reading state being put in by io::read_start() function, the request calls io::read_stop() for the _file.

See also
libuv API documentation: uv_fs_close().
Linux: close().
Note
If the request callback is empty (has not been set), the request runs synchronously.

Definition at line 188 of file request-fs.hpp.


The documentation for this class was generated from the following file: