#include "detect.h"
#include "types.h"
#include <chrono>
#include <cinttypes>
#include <cstdarg>
#include <cstdint>
#include <cstring>
#include <ctime>
#include <functional>
#include <mutex>
#include <optional>
#include <string>
#include <sys/un.h>
#include <semaphore.h>

Include dependency graph for system.h:

Classes
struct	NETSTATS

class	CCmdlineFix

struct	std::hash< NETADDR >

Macros
#define	__USE_GNU

#define	PRIzu "zu"

#define	MAYBE_UNUSED

#define	dbg_assert(test, msg) dbg_assert_imp(__FILE__, __LINE__, test, msg)

#define	GNUC_ATTRIBUTE(x)

#define	str_format str_format_opt

#define	FORMAT_TIME "%H:%M:%S"

#define	FORMAT_SPACE "%Y-%m-%d %H:%M:%S"

#define	FORMAT_NOSPACE "%Y-%m-%d_%H-%M-%S"

Typedefs
typedef std::function< void(const char *message)>	DBG_ASSERT_HANDLER

typedef struct ASYNCIO	ASYNCIO

typedef sem_t	SEMAPHORE

typedef int	UNIXSOCKET

typedef struct sockaddr_un	UNIXSOCKETADDR

typedef pid_t	PROCESS

Enumerations
enum	{ IOFLAG_READ = 1 , IOFLAG_WRITE = 2 , IOFLAG_APPEND = 4 , IOSEEK_START = 0 , IOSEEK_CUR = 1 , IOSEEK_END = 2 }

enum	ETimeSeason { SEASON_SPRING = 0 , SEASON_SUMMER , SEASON_AUTUMN , SEASON_WINTER , SEASON_EASTER , SEASON_HALLOWEEN , SEASON_XMAS , SEASON_NEWYEAR }

enum	{ TIME_DAYS , TIME_HOURS , TIME_MINS , TIME_HOURS_CENTISECS , TIME_MINS_CENTISECS , TIME_SECS_CENTISECS }

enum class	EShellExecuteWindowState { EShellExecuteWindowState::FOREGROUND , EShellExecuteWindowState::BACKGROUND }

Functions
void	dbg_assert_imp (const char filename, int line, bool test, const char msg)

bool	dbg_assert_has_failed ()

void	dbg_break ()

void	dbg_assert_set_handler (DBG_ASSERT_HANDLER handler)

void	dbg_msg (const char sys, const char fmt,...)

void	mem_copy (void dest, const void source, size_t size)

void	mem_move (void dest, const void source, size_t size)

template<typename T >
void	mem_zero (T *block, size_t size)

int	mem_comp (const void a, const void b, size_t size)

bool	mem_has_null (const void *block, size_t size)

IOHANDLE	io_open (const char *filename, int flags)

unsigned	io_read (IOHANDLE io, void *buffer, unsigned size)

void	io_read_all (IOHANDLE io, void *result, unsigned result_len)

char *	io_read_all_str (IOHANDLE io)

int	io_skip (IOHANDLE io, int size)

int	io_seek (IOHANDLE io, int offset, int origin)

long int	io_tell (IOHANDLE io)

long int	io_length (IOHANDLE io)

unsigned	io_write (IOHANDLE io, const void *buffer, unsigned size)

bool	io_write_newline (IOHANDLE io)

int	io_close (IOHANDLE io)

int	io_flush (IOHANDLE io)

int	io_sync (IOHANDLE io)

int	io_error (IOHANDLE io)

IOHANDLE	io_stdin ()

IOHANDLE	io_stdout ()

IOHANDLE	io_stderr ()

IOHANDLE	io_current_exe ()

ASYNCIO *	aio_new (IOHANDLE io)

void	aio_lock (ASYNCIO *aio)

void	aio_unlock (ASYNCIO *aio)

void	aio_write (ASYNCIO aio, const void buffer, unsigned size)

void	aio_write_newline (ASYNCIO *aio)

void	aio_write_unlocked (ASYNCIO aio, const void buffer, unsigned size)

void	aio_write_newline_unlocked (ASYNCIO *aio)

int	aio_error (ASYNCIO *aio)

void	aio_close (ASYNCIO *aio)

void	aio_wait (ASYNCIO *aio)

void	aio_free (ASYNCIO *aio)

void *	thread_init (void(threadfunc)(void ), void user, const char name)

void	thread_wait (void *thread)

void	thread_yield ()

void	thread_detach (void *thread)

void	thread_init_and_detach (void(threadfunc)(void ), void user, const char name)

void	sphore_init (SEMAPHORE *sem)

void	sphore_wait (SEMAPHORE *sem)

void	sphore_signal (SEMAPHORE *sem)

void	sphore_destroy (SEMAPHORE *sem)

void	set_new_tick ()

int64_t	time_get_impl ()

int64_t	time_get ()

int64_t	time_freq ()

int64_t	time_timestamp ()

int	time_houroftheday ()

ETimeSeason	time_season ()

void	net_init ()

int	net_host_lookup (const char hostname, NETADDR addr, int types)

int	net_addr_comp (const NETADDR a, const NETADDR b)

int	net_addr_comp_noport (const NETADDR a, const NETADDR b)

bool	net_addr_str (const NETADDR addr, char string, int max_length, int add_port)

int	net_addr_from_url (NETADDR addr, const char string, char *host_buf, size_t host_buf_size)

int	net_addr_from_str (NETADDR addr, const char string)

int	net_socket_type (NETSOCKET sock)

NETSOCKET	net_udp_create (NETADDR bindaddr)

int	net_udp_send (NETSOCKET sock, const NETADDR addr, const void data, int size)

int	net_udp_recv (NETSOCKET sock, NETADDR addr, unsigned char *data)

int	net_udp_close (NETSOCKET sock)

NETSOCKET	net_tcp_create (NETADDR bindaddr)

int	net_tcp_listen (NETSOCKET sock, int backlog)

int	net_tcp_accept (NETSOCKET sock, NETSOCKET new_sock, NETADDR addr)

int	net_tcp_connect (NETSOCKET sock, const NETADDR *addr)

int	net_tcp_send (NETSOCKET sock, const void *data, int size)

int	net_tcp_recv (NETSOCKET sock, void *data, int maxsize)

int	net_tcp_close (NETSOCKET sock)

UNIXSOCKET	net_unix_create_unnamed ()

int	net_unix_send (UNIXSOCKET sock, UNIXSOCKETADDR addr, void data, int size)

void	net_unix_set_addr (UNIXSOCKETADDR addr, const char path)

void	net_unix_close (UNIXSOCKET sock)

void	str_append (char dst, const char src, int dst_size)

template<int N>
void	str_append (char(&dst)[N], const char *src)

int	str_copy (char dst, const char src, int dst_size)

template<int N>
void	str_copy (char(&dst)[N], const char *src)

void	str_utf8_truncate (char dst, int dst_size, const char src, int truncation_len)

void	str_truncate (char dst, int dst_size, const char src, int truncation_len)

int	str_length (const char *str)

int	str_format_v (char buffer, int buffer_size, const char format, va_list args)

int	str_format (char buffer, int buffer_size, const char format,...)

int	str_format_int (char *buffer, size_t buffer_size, int value)

template<typename... Args>
int	str_format_opt (char buffer, int buffer_size, const char format, Args... args)

template<>
int	str_format_opt (char buffer, int buffer_size, const char format, int val)

const char *	str_trim_words (const char *str, int words)

bool	str_has_cc (const char *str)

void	str_sanitize_cc (char *str)

void	str_sanitize (char *str)

void	str_sanitize_filename (char *str)

void	str_clean_whitespaces (char *str)

char *	str_skip_to_whitespace (char *str)

const char *	str_skip_to_whitespace_const (const char *str)

char *	str_skip_whitespaces (char *str)

const char *	str_skip_whitespaces_const (const char *str)

int	str_comp_nocase (const char a, const char b)

int	str_comp_nocase_num (const char a, const char b, int num)

int	str_comp (const char a, const char b)

int	str_comp_num (const char a, const char b, int num)

int	str_comp_filenames (const char a, const char b)

const char *	str_startswith_nocase (const char str, const char prefix)

const char *	str_startswith (const char str, const char prefix)

const char *	str_endswith_nocase (const char str, const char suffix)

const char *	str_endswith (const char str, const char suffix)

int	str_utf8_dist (const char a, const char b)

int	str_utf8_dist_buffer (const char a, const char b, int *buf, int buf_len)

int	str_utf32_dist_buffer (const int a, int a_len, const int b, int b_len, int *buf, int buf_len)

const char *	str_find_nocase (const char haystack, const char needle)

const char *	str_find (const char haystack, const char needle)

bool	str_delimiters_around_offset (const char haystay, const char delim, int offset, int start, int end)

const char *	str_rchr (const char *haystack, char needle)

int	str_countchr (const char *haystack, char needle)

void	str_hex (char dst, int dst_size, const void data, int data_size)

void	str_hex_cstyle (char dst, int dst_size, const void data, int data_size, int bytes_per_line=12)

int	str_hex_decode (void dst, int dst_size, const char src)

void	str_base64 (char dst, int dst_size, const void data, int data_size)

int	str_base64_decode (void dst, int dst_size, const char data)

void	str_timestamp (char *buffer, int buffer_size)

void	str_timestamp_format (char buffer, int buffer_size, const char format)

void	str_timestamp_ex (time_t time, char buffer, int buffer_size, const char format)

bool	timestamp_from_str (const char string, const char format, time_t *timestamp)

int	str_time (int64_t centisecs, int format, char *buffer, int buffer_size)

int	str_time_float (float secs, int format, char *buffer, int buffer_size)

void	str_escape (char *dst, const char src, const char *end)

void	fs_listdir (const char dir, FS_LISTDIR_CALLBACK cb, int type, void user)

void	fs_listdir_fileinfo (const char dir, FS_LISTDIR_CALLBACK_FILEINFO cb, int type, void user)

int	fs_makedir (const char *path)

int	fs_removedir (const char *path)

int	fs_makedir_rec_for (const char *path)

int	fs_storage_path (const char appname, char path, int max)

int	fs_is_file (const char *path)

int	fs_is_dir (const char *path)

int	fs_is_relative_path (const char *path)

int	fs_chdir (const char *path)

char *	fs_getcwd (char *buffer, int buffer_size)

const char *	fs_filename (const char *path)

void	fs_split_file_extension (const char filename, char name, size_t name_size, char *extension=nullptr, size_t extension_size=0)

int	fs_parent_dir (char *path)

int	fs_remove (const char *filename)

int	fs_rename (const char oldname, const char newname)

int	fs_file_time (const char name, time_t created, time_t *modified)

int	net_tcp_connect_non_blocking (NETSOCKET sock, NETADDR bindaddr)

int	net_set_non_blocking (NETSOCKET sock)

int	net_set_blocking (NETSOCKET sock)

int	net_errno ()

int	net_would_block ()

int	net_socket_read_wait (NETSOCKET sock, int time)

void	swap_endian (void *data, unsigned elem_size, unsigned num)

void	net_stats (NETSTATS *stats)

int	str_toint (const char *str)

bool	str_toint (const char str, int out)

int	str_toint_base (const char *str, int base)

unsigned long	str_toulong_base (const char *str, int base)

int64_t	str_toint64_base (const char *str, int base=10)

float	str_tofloat (const char *str)

bool	str_tofloat (const char str, float out)

int	str_isspace (char c)

char	str_uppercase (char c)

bool	str_isnum (char c)

int	str_isallnum (const char *str)

int	str_isallnum_hex (const char *str)

unsigned	str_quickhash (const char *str)

int	str_utf8_to_skeleton (const char str, int buf, int buf_len)

int	str_utf8_comp_confusable (const char str1, const char str2)

int	str_utf8_tolower (int code)

int	str_utf8_comp_nocase (const char a, const char b)

int	str_utf8_comp_nocase_num (const char a, const char b, int num)

const char *	str_utf8_find_nocase (const char haystack, const char needle, const char **end=nullptr)

int	str_utf8_isspace (int code)

int	str_utf8_isstart (char c)

const char *	str_utf8_skip_whitespaces (const char *str)

void	str_utf8_trim_right (char *param)

int	str_utf8_rewind (const char *str, int cursor)

int	str_utf8_fix_truncation (char *str)

int	str_utf8_forward (const char *str, int cursor)

int	str_utf8_decode (const char **ptr)

int	str_utf8_encode (char *ptr, int chr)

int	str_utf8_check (const char *str)

void	str_utf8_copy_num (char dst, const char src, int dst_size, int num)

void	str_utf8_stats (const char str, size_t max_size, size_t max_count, size_t size, size_t *count)

size_t	str_utf8_offset_bytes_to_chars (const char *str, size_t byte_offset)

size_t	str_utf8_offset_chars_to_bytes (const char *str, size_t char_offset)

const char *	str_next_token (const char str, const char delim, char *buffer, int buffer_size)

int	str_in_list (const char list, const char delim, const char *needle)

unsigned	bytes_be_to_uint (const unsigned char *bytes)

void	uint_to_bytes_be (unsigned char *bytes, unsigned value)

int	pid ()

void	cmdline_fix (int argc, const char **argv)

void	cmdline_free (int argc, const char **argv)

PROCESS	shell_execute (const char *file, EShellExecuteWindowState window_state)

int	kill_process (PROCESS process)

bool	is_process_alive (PROCESS process)

int	open_link (const char *link)

int	open_file (const char *path)

void	generate_password (char buffer, unsigned length, const unsigned short random, unsigned random_length)

int	secure_random_init ()

int	secure_random_uninit ()

void	secure_random_password (char *buffer, unsigned length, unsigned pw_length)

void	secure_random_fill (void *bytes, unsigned length)

int	secure_rand ()

int	secure_rand_below (int below)

bool	os_version_str (char *version, size_t length)

void	os_locale_str (char *locale, size_t length)

std::chrono::nanoseconds	time_get_nanoseconds ()

int	net_socket_read_wait (NETSOCKET sock, std::chrono::nanoseconds nanoseconds)

Variables
const NETADDR	NETADDR_ZEROED

constexpr PROCESS	INVALID_PROCESS = 0

Macro Definition Documentation

◆ __USE_GNU

#define __USE_GNU

◆ FORMAT_NOSPACE

#define FORMAT_NOSPACE "%Y-%m-%d_%H-%M-%S"

◆ FORMAT_SPACE

#define FORMAT_SPACE "%Y-%m-%d %H:%M:%S"

◆ FORMAT_TIME

#define FORMAT_TIME "%H:%M:%S"

◆ GNUC_ATTRIBUTE

#define GNUC_ATTRIBUTE ( x )

◆ MAYBE_UNUSED

#define MAYBE_UNUSED

◆ PRIzu

#define PRIzu "zu"

◆ str_format

#define str_format str_format_opt

Typedef Documentation

◆ DBG_ASSERT_HANDLER

typedef std::function<void(const char *message)> DBG_ASSERT_HANDLER

◆ SEMAPHORE

typedef sem_t SEMAPHORE

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Enumerator
TIME_DAYS
TIME_HOURS
TIME_MINS
TIME_HOURS_CENTISECS
TIME_MINS_CENTISECS
TIME_SECS_CENTISECS

Function Documentation

◆ bytes_be_to_uint()

unsigned bytes_be_to_uint ( const unsigned char * bytes )

Packs 4 big endian bytes into an unsigned.

Parameters

bytes Pointer to an array of bytes that will be packed.

Returns: The packed unsigned.

Remarks: Assumes the passed array is least 4 bytes in size.; Assumes unsigned is 4 bytes in size.

See also: uint_to_bytes_be

◆ dbg_assert_imp()

void dbg_assert_imp	(	const char *	filename,
		int	line,
		bool	test,
		const char *	msg
	)

◆ dbg_assert_set_handler()

void dbg_assert_set_handler ( DBG_ASSERT_HANDLER handler )

◆ net_addr_from_str()

int net_addr_from_str	(	NETADDR *	addr,
		const char *	string
	)

Turns string into a network address.

Parameters

addr	Address to fill in.
string	String to parse.

Returns: 0 on success

◆ net_addr_from_url()

int net_addr_from_url	(	NETADDR *	addr,
		const char *	string,
		char *	host_buf,
		size_t	host_buf_size
	)

Turns url string into a network address struct. The url format is tw-0.6+udp://{ipaddr}[:{port}] ipaddr: can be ipv4 or ipv6 port: is a optional internet protocol port

This format is used for parsing the master server, be careful before changing it.

Examples: tw-0.6+udp://127.0.0.1 tw-0.6+udp://127.0.0.1:8303

Parameters

addr	Address to fill in.
string	String to parse.
host_buf	Pointer to a buffer to write the host to It will include the port if one is included in the url It can also be set to NULL then it will be ignored
host_buf_size	Size of the host buffer or 0 if no host_buf pointer is given

Returns: 0 on success, positive if the input wasn't a valid DDNet URL, negative if the input is a valid DDNet URL but the host part was not a valid IPv4/IPv6 address

◆ net_errno()

int net_errno ( )

◆ net_host_lookup()

int net_host_lookup	(	const char *	hostname,
		NETADDR *	addr,
		int	types
	)

◆ net_set_blocking()

int net_set_blocking ( NETSOCKET sock )

◆ net_set_non_blocking()

int net_set_non_blocking ( NETSOCKET sock )

◆ net_socket_read_wait() [1/2]

int net_socket_read_wait	(	NETSOCKET	sock,
		int	time
	)

◆ net_socket_read_wait() [2/2]

int net_socket_read_wait	(	NETSOCKET	sock,
		std::chrono::nanoseconds	nanoseconds
	)

◆ net_socket_type()

int net_socket_type ( NETSOCKET sock )

◆ net_stats()

void net_stats ( NETSTATS * stats )

◆ net_tcp_connect_non_blocking()

int net_tcp_connect_non_blocking	(	NETSOCKET	sock,
		NETADDR	bindaddr
	)

◆ net_udp_create()

NETSOCKET net_udp_create ( NETADDR bindaddr )

◆ net_udp_recv()

int net_udp_recv	(	NETSOCKET	sock,
		NETADDR *	addr,
		unsigned char **	data
	)

◆ net_would_block()

int net_would_block ( )

◆ str_base64()

void str_base64	(	char *	dst,
		int	dst_size,
		const void *	data,
		int	data_size
	)

◆ str_base64_decode()

int str_base64_decode	(	void *	dst,
		int	dst_size,
		const char *	data
	)

◆ str_endswith()

const char * str_endswith	(	const char *	str,
		const char *	suffix
	)

◆ str_endswith_nocase()

const char * str_endswith_nocase	(	const char *	str,
		const char *	suffix
	)

◆ str_escape()

void str_escape	(	char **	dst,
		const char *	src,
		const char *	end
	)

◆ str_find()

const char * str_find	(	const char *	haystack,
		const char *	needle
	)

◆ str_find_nocase()

const char * str_find_nocase	(	const char *	haystack,
		const char *	needle
	)

◆ str_format_int()

int str_format_int	(	char *	buffer,
		size_t	buffer_size,
		int	value
	)

◆ str_format_opt() [1/2]

template<typename... Args>

int str_format_opt	(	char *	buffer,
		int	buffer_size,
		const char *	format,
		Args...	args
	)

◆ str_format_opt() [2/2]

template<>

int str_format_opt	(	char *	buffer,
		int	buffer_size,
		const char *	format,
		int	val
	)

inline

◆ str_hex()

void str_hex	(	char *	dst,
		int	dst_size,
		const void *	data,
		int	data_size
	)

Takes a datablock and generates a hex string of it, with spaces between bytes.

Parameters

dst	Buffer to fill with hex data.
dst_size	Size of the buffer (at least 3 * data_size + 1 to contain all data).
data	Data to turn into hex.
data_size	Size of the data.

Remarks: The destination buffer will be zero-terminated.

◆ str_hex_cstyle()

void str_hex_cstyle	(	char *	dst,
		int	dst_size,
		const void *	data,
		int	data_size,
		int	bytes_per_line = `12`
	)

Takes a datablock and generates a hex string of it, in the C style array format, i.e. with bytes formatted in 0x00-0xFF notation and commas with spaces between the bytes. The output can be split over multiple lines by specifying the maximum number of bytes that should be printed per line.

Parameters

dst	Buffer to fill with hex data.
dst_size	Size of the buffer (at least 6 * data_size + 1 to contain all data).
data	Data to turn into hex.
data_size	Size of the data.
bytes_per_line	After this many printed bytes a newline will be printed.

Remarks: The destination buffer will be zero-terminated.

◆ str_hex_decode()

int str_hex_decode	(	void *	dst,
		int	dst_size,
		const char *	src
	)

◆ str_in_list()

int str_in_list	(	const char *	list,
		const char *	delim,
		const char *	needle
	)

◆ str_isallnum()

int str_isallnum ( const char * str )

◆ str_isallnum_hex()

int str_isallnum_hex ( const char * str )

◆ str_isnum()

bool str_isnum ( char c )

◆ str_next_token()

const char * str_next_token	(	const char *	str,
		const char *	delim,
		char *	buffer,
		int	buffer_size
	)

◆ str_quickhash()

unsigned str_quickhash ( const char * str )

◆ str_sanitize_filename()

void str_sanitize_filename ( char * str )

Replaces all invalid filename characters with whitespace.

Parameters

str	String to sanitize.

Remarks: The strings are treated as zero-terminated strings.

◆ str_startswith_nocase()

const char * str_startswith_nocase	(	const char *	str,
		const char *	prefix
	)

◆ str_time()

int str_time	(	int64_t	centisecs,
		int	format,
		char *	buffer,
		int	buffer_size
	)

◆ str_time_float()

int str_time_float	(	float	secs,
		int	format,
		char *	buffer,
		int	buffer_size
	)

◆ str_timestamp()

void str_timestamp	(	char *	buffer,
		int	buffer_size
	)

◆ str_timestamp_ex()

void str_timestamp_ex	(	time_t	time,
		char *	buffer,
		int	buffer_size,
		const char *	format
	)

◆ str_timestamp_format()

void str_timestamp_format	(	char *	buffer,
		int	buffer_size,
		const char *	format
	)

◆ str_tofloat() [1/2]

float str_tofloat ( const char * str )

◆ str_tofloat() [2/2]

bool str_tofloat	(	const char *	str,
		float *	out
	)

◆ str_toint() [1/2]

int str_toint ( const char * str )

◆ str_toint() [2/2]

bool str_toint	(	const char *	str,
		int *	out
	)

◆ str_toint64_base()

int64_t str_toint64_base	(	const char *	str,
		int	base = `10`
	)

◆ str_toint_base()

int str_toint_base	(	const char *	str,
		int	base
	)

◆ str_toulong_base()

unsigned long str_toulong_base	(	const char *	str,
		int	base
	)

◆ str_uppercase()

char str_uppercase ( char c )

◆ str_utf32_dist_buffer()

int str_utf32_dist_buffer	(	const int *	a,
		int	a_len,
		const int *	b,
		int	b_len,
		int *	buf,
		int	buf_len
	)

◆ str_utf8_check()

int str_utf8_check ( const char * str )

◆ str_utf8_comp_confusable()

int str_utf8_comp_confusable	(	const char *	str1,
		const char *	str2
	)

◆ str_utf8_comp_nocase()

int str_utf8_comp_nocase	(	const char *	a,
		const char *	b
	)

◆ str_utf8_comp_nocase_num()

int str_utf8_comp_nocase_num	(	const char *	a,
		const char *	b,
		int	num
	)

◆ str_utf8_copy_num()

void str_utf8_copy_num	(	char *	dst,
		const char *	src,
		int	dst_size,
		int	num
	)

◆ str_utf8_decode()

int str_utf8_decode ( const char ** ptr )

◆ str_utf8_dist()

int str_utf8_dist	(	const char *	a,
		const char *	b
	)

Computes the edit distance between two strings.

Parameters

a	First string for the edit distance.
b	Second string for the edit distance.

Returns: The edit distance between the both strings.

Remarks: The strings are treated as zero-terminated strings.

◆ str_utf8_encode()

int str_utf8_encode	(	char *	ptr,
		int	chr
	)

◆ str_utf8_find_nocase()

const char * str_utf8_find_nocase	(	const char *	haystack,
		const char *	needle,
		const char **	end = `nullptr`
	)

◆ str_utf8_fix_truncation()

int str_utf8_fix_truncation ( char * str )

◆ str_utf8_forward()

int str_utf8_forward	(	const char *	str,
		int	cursor
	)

◆ str_utf8_isspace()

int str_utf8_isspace ( int code )

◆ str_utf8_isstart()

int str_utf8_isstart ( char c )

◆ str_utf8_offset_bytes_to_chars()

size_t str_utf8_offset_bytes_to_chars	(	const char *	str,
		size_t	byte_offset
	)

Converts a byte offset of a utf8 string to the utf8 character offset.

Parameters

text	Pointer to the string.
byte_offset	Offset in bytes.

Returns: Offset in utf8 characters. Clamped to the maximum length of the string in utf8 characters.

Remarks: The string is treated as a zero-terminated utf8 string.; It's the user's responsibility to make sure the bounds are aligned.

◆ str_utf8_offset_chars_to_bytes()

size_t str_utf8_offset_chars_to_bytes	(	const char *	str,
		size_t	char_offset
	)

Converts a utf8 character offset of a utf8 string to the byte offset.

Parameters

text	Pointer to the string.
char_offset	Offset in utf8 characters.

Returns: Offset in bytes. Clamped to the maximum length of the string in bytes.

Remarks: The string is treated as a zero-terminated utf8 string.; It's the user's responsibility to make sure the bounds are aligned.

◆ str_utf8_rewind()

int str_utf8_rewind	(	const char *	str,
		int	cursor
	)

◆ str_utf8_skip_whitespaces()

const char * str_utf8_skip_whitespaces ( const char * str )

◆ str_utf8_stats()

void str_utf8_stats	(	const char *	str,
		size_t	max_size,
		size_t	max_count,
		size_t *	size,
		size_t *	count
	)

◆ str_utf8_to_skeleton()

int str_utf8_to_skeleton	(	const char *	str,
		int *	buf,
		int	buf_len
	)

◆ str_utf8_tolower()

int str_utf8_tolower ( int code )

◆ str_utf8_trim_right()

void str_utf8_trim_right ( char * param )

◆ swap_endian()

void swap_endian	(	void *	data,
		unsigned	elem_size,
		unsigned	num
	)

Swaps the endianness of data. Each element is swapped individually by reversing its bytes.

Parameters

data	Pointer to data to be swapped.
elem_size	Size in bytes of each element.
num	Number of elements.

Remarks: The caller must ensure that the data is at least elem_size * num bytes in size.

◆ timestamp_from_str()

bool timestamp_from_str	(	const char *	string,
		const char *	format,
		time_t *	timestamp
	)

Parses a string into a timestamp following a specified format.

Parameters

string	Pointer to the string to parse
format	The time format to use (for example FORMAT_NOSPACE below)
timestamp	Pointer to the timestamp result

Returns: true on success, false if the string could not be parsed with the specified format

◆ uint_to_bytes_be()

void uint_to_bytes_be	(	unsigned char *	bytes,
		unsigned	value
	)

Packs an unsigned into 4 big endian bytes.

Parameters

bytes	Pointer to an array where the bytes will be stored.
value	The values that will be packed into the array.

Remarks: Assumes the passed array is least 4 bytes in size.; Assumes unsigned is 4 bytes in size.

See also: bytes_be_to_uint

Variable Documentation

◆ NETADDR_ZEROED

const NETADDR NETADDR_ZEROED

extern

Classes

Macros

Typedefs

Enumerations

Functions

Variables

Macro Definition Documentation

◆ __USE_GNU

◆ FORMAT_NOSPACE

◆ FORMAT_SPACE

◆ FORMAT_TIME

◆ GNUC_ATTRIBUTE

◆ MAYBE_UNUSED

◆ PRIzu

◆ str_format

Typedef Documentation

◆ DBG_ASSERT_HANDLER

◆ SEMAPHORE

Enumeration Type Documentation

◆ anonymous enum

Function Documentation

◆ bytes_be_to_uint()

◆ dbg_assert_imp()

◆ dbg_assert_set_handler()

◆ net_addr_from_str()

◆ net_addr_from_url()

◆ net_errno()

◆ net_host_lookup()

◆ net_set_blocking()

◆ net_set_non_blocking()

◆ net_socket_read_wait() [1/2]

◆ net_socket_read_wait() [2/2]

◆ net_socket_type()

◆ net_stats()

◆ net_tcp_connect_non_blocking()

◆ net_udp_create()

◆ net_udp_recv()

◆ net_would_block()

◆ str_base64()

◆ str_base64_decode()

◆ str_endswith()

◆ str_endswith_nocase()

◆ str_escape()

◆ str_find()

◆ str_find_nocase()

◆ str_format_int()

◆ str_format_opt() [1/2]

◆ str_format_opt() [2/2]

◆ str_hex()

◆ str_hex_cstyle()

◆ str_hex_decode()

◆ str_in_list()

◆ str_isallnum()

◆ str_isallnum_hex()

◆ str_isnum()

◆ str_next_token()

◆ str_quickhash()

◆ str_sanitize_filename()

◆ str_startswith_nocase()

◆ str_time()

◆ str_time_float()

◆ str_timestamp()

◆ str_timestamp_ex()

◆ str_timestamp_format()

◆ str_tofloat() [1/2]

◆ str_tofloat() [2/2]

◆ str_toint() [1/2]

◆ str_toint() [2/2]

◆ str_toint64_base()

◆ str_toint_base()

◆ str_toulong_base()

◆ str_uppercase()

◆ str_utf32_dist_buffer()

◆ str_utf8_check()

◆ str_utf8_comp_confusable()

◆ str_utf8_comp_nocase()

◆ str_utf8_comp_nocase_num()

◆ str_utf8_copy_num()

◆ str_utf8_decode()

◆ str_utf8_dist()