uv::fs::truncate Class Reference

Truncate a file to a specified length. More...

#include "request-fs.hpp"

Inheritance diagram for uv::fs::truncate:

Public Types
using	on_request_t = std::function< void(truncate _request) >
	The function type of the callback called when the truncate 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
	truncate (const truncate &)=default
truncate &	operator= (const truncate &)=default
	truncate (truncate &&) noexcept=default
truncate &	operator= (truncate &&) noexcept=default
on_request_t &	on_request () const noexcept
file	handle () const noexcept
	The file which this truncate request has been running on. More...
int64_t	offset () const noexcept
	The offset this trucate request has been performed at.
int	run (file &_file, int64_t _offset)
	Run the request. Truncate the _file to a size of _offset bytes. More...
	operator const uv_t * () const noexcept
	operator uv_t * () noexcept
Public Member Functions inherited from uv::fs
	fs (const fs &)=default
fs &	operator= (const fs &)=default
	fs (fs &&) noexcept=default
fs &	operator= (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)
request &	operator= (const request &_that)
	request (request &&_that) noexcept
request &	operator= (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_t &	on_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

Truncate a file to a specified length.

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

Member Function Documentation

handle()

file uv::fs::truncate::handle ( ) const

inlinenoexcept

The file which this truncate request has been running on.

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

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

run()

int uv::fs::truncate::run ( file &  _file, int64_t  _offset  )

inline

Run the request. Truncate the _file to a size of _offset bytes.

See also

libuv API documentation: uv_fs_ftruncate().

Linux: ftruncate().

Note

If the request callback is empty (has not been set), the request runs synchronously.

The _offset value of < 0 means using of the current file position.

See also

Windows: _tell(), _telli64().

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

---

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

• request-fs.hpp