Utilities

Classes
struct	uvco::UvHandleDeleter
class	uvco::RefCounted< T >
class	uvco::LifetimeTracker< T >
class	uvco::FlagGuard
class	uvco::ZeroAtExit< T >

Typedefs
using	uvco::uv_status = int
	Result of a libuv operation, an errno error code.

Functions
void	uvco::allocator (uv_handle_t *, size_t sugg, uv_buf_t *buf)
	libuv allocator.
void	uvco::freeUvBuf (const uv_buf_t *buf)
template<typename R , typename F > requires std::is_invocable_r_v<R, F, std::string_view>
R	uvco::callWithNullTerminated (std::string_view view, F &&f)
template<typename Into , typename Handle >
Into *	uvco::getData (const Handle *handle)
template<typename Into , typename Request >
Into *	uvco::getRequestData (const Request *req)
template<typename Handle , typename Data >
void	uvco::setData (Handle *handle, Data *data)
template<typename Request , typename Data >
void	uvco::setRequestData (Request *req, Data *data)
template<typename Handle >
bool	uvco::dataIsNull (Handle *handle)
template<typename Request >
bool	uvco::requestDataIsNull (Request *req)
template<typename T , typename... Args> requires std::derived_from<T, RefCounted<T>>
T *	uvco::makeRefCounted (Args... args)
	Create a new refcounted value. T must derive from RefCounted<T>.

Variables
const bool	uvco::TRACK_LIFETIMES = true

Detailed Description

Typedef Documentation

uv_status

using uvco::uv_status = int

Result of a libuv operation, an errno error code.

Function Documentation

allocator()

void uvco::allocator	(	uv_handle_t *	,
		size_t	sugg,
		uv_buf_t *	buf
	)

libuv allocator.

                                                            {
  constexpr static size_t defaultSize = 4080;
  const size_t size = std::min(defaultSize, sugg);
  char *underlying = new char[size];
  buf->base = underlying;
  buf->len = size;
}

callWithNullTerminated()

template<typename R , typename F >
requires std::is_invocable_r_v<R, F, std::string_view>

R uvco::callWithNullTerminated	(	std::string_view	view,
		F &&	f
	)

                                                     {
  if (view.data()[view.size()] == '\0') {
    return f(view.data());
  }
  std::string str(view);
  return f(str.c_str());
}

dataIsNull()

template<typename Handle >

bool uvco::dataIsNull

(

Handle *

handle

)

                                                           {
  return nullptr == uv_handle_get_data((const uv_handle_t *)handle);
}

freeUvBuf()

void uvco::freeUvBuf

(

const uv_buf_t *

buf

)

                                    {
  if (buf)
    delete[] buf->base;
}

getData()

template<typename Into , typename Handle >

Into * uvco::getData

(

const Handle *

handle

)

                                                                              {
  const void *data = uv_handle_get_data((const uv_handle_t *)handle);
  BOOST_ASSERT(nullptr != data);
  return (Into *)data;
}

getRequestData()

template<typename Into , typename Request >

Into * uvco::getRequestData

(

const Request *

req

)

                                         {
  const void *data = uv_req_get_data((const uv_req_t *)req);
  BOOST_ASSERT(nullptr != data);
  return (Into *)data;
}

makeRefCounted()

template<typename T , typename... Args>
requires std::derived_from<T, RefCounted<T>>

T * uvco::makeRefCounted

(

Args...

args

)

Create a new refcounted value. T must derive from RefCounted<T>.

{
  if constexpr (sizeof...(args) == 0) {
    return new T{};
  } else {
    return new T{std::forward<Args...>(args...)};
  }
}

requestDataIsNull()

template<typename Request >

bool uvco::requestDataIsNull

(

Request *

req

)

                                                                 {
  return nullptr == uv_req_get_data((const uv_req_t *)req);
}

setData()

template<typename Handle , typename Data >

void uvco::setData	(	Handle *	handle,
		Data *	data
	)

                                         {
  BOOST_ASSERT(handle != nullptr);
  uv_handle_set_data((uv_handle_t *)handle, (void *)data);
}

setRequestData()

template<typename Request , typename Data >

void uvco::setRequestData	(	Request *	req,
		Data *	data
	)

                                              {
  BOOST_ASSERT(req != nullptr);
  uv_req_set_data((uv_req_t *)req, (void *)data);
}

Variable Documentation

TRACK_LIFETIMES

const bool uvco::TRACK_LIFETIMES = true