util.c File Reference

Miscellaneous utility functions. More...

#include "private.h"
#include <stdarg.h>

Macros
#define	FORMAT_THOUSAND_SEP(prefix, suffix)

Enumerations
enum	{ UNKNOWN , WORKS , BROKEN }

Functions
void *	xrealloc (void *ptr, size_t size)
	Safe realloc() that never returns NULL.
char *	xstrdup (const char *src)
	Safe strdup() that never returns NULL.
uint64_t	str_to_uint64 (const char *name, const char *value, uint64_t min, uint64_t max)
	Fancy version of strtoull()
uint64_t	round_up_to_mib (uint64_t n)
	Round an integer up to the next full MiB and convert to MiB.
const char *	uint64_to_str (uint64_t value, uint32_t slot)
	Convert uint64_t to a string.
const char *	uint64_to_nicestr (uint64_t value, enum nicestr_unit unit_min, enum nicestr_unit unit_max, bool always_also_bytes, uint32_t slot)
	Convert uint64_t to a nice human readable string.
void	my_snprintf (char **pos, size_t *left, const char *fmt,...)
bool	is_tty (int fd)
	Test if file descriptor is a terminal.
bool	is_tty_stdin (void)
	Test if stdin is a terminal.
bool	is_tty_stdout (void)
	Test if stdout is a terminal.

Detailed Description

Miscellaneous utility functions.

Macro Definition Documentation

FORMAT_THOUSAND_SEP

#define FORMAT_THOUSAND_SEP	(		prefix,
			suffix )

Value:

            ((thousand == WORKS) \
            ? prefix "'" suffix \
            : prefix suffix)

Enumeration Type Documentation

anonymous enum

anonymous enum

Enumerator
UNKNOWN
WORKS
BROKEN

Function Documentation

is_tty()

bool is_tty ( int fd )

extern

Test if file descriptor is a terminal.

For POSIX systems, this is a simple wrapper around isatty(). However on Windows, isatty() returns true for all character devices, not just terminals.

Parameters

fd	File descriptor to test

Returns

bool:

• true if file descriptor is a terminal
• false otherwise

is_tty_stdin()

bool is_tty_stdin ( void )

extern

Test if stdin is a terminal.

If stdin is a terminal, an error message is printed and exit status set to EXIT_ERROR.

is_tty_stdout()

bool is_tty_stdout ( void )

extern

Test if stdout is a terminal.

If stdout is a terminal, an error message is printed and exit status set to EXIT_ERROR.

my_snprintf()

void my_snprintf ( char ** pos, size_t * left, const char * fmt, ... )

extern

round_up_to_mib()

uint64_t round_up_to_mib ( uint64_t n )

extern

Round an integer up to the next full MiB and convert to MiB.

This is used when printing memory usage and limit.

str_to_uint64()

uint64_t str_to_uint64 ( const char * name, const char * value, uint64_t min, uint64_t max )

extern

Fancy version of strtoull()

Parameters

name	Name of the option to show in case of an error
value	String containing the number to be parsed; may contain suffixes "k", "M", "G", "Ki", "Mi", or "Gi"
min	Minimum valid value
max	Maximum valid value

Returns

Parsed value that is in the range [min, max]. Does not return if an error occurs.

uint64_to_nicestr()

const char * uint64_to_nicestr ( uint64_t value, enum nicestr_unit unit_min, enum nicestr_unit unit_max, bool always_also_bytes, uint32_t slot )

extern

Convert uint64_t to a nice human readable string.

This is like uint64_to_str() but uses B, KiB, MiB, GiB, or TiB suffix and optionally includes the exact size in parenthesis.

Parameters

value	Value to be printed
unit_min	Smallest unit to use. This and unit_max are used e.g. when showing the progress indicator to force the unit to MiB.
unit_max	Biggest unit to use. assert(unit_min <= unit_max).
always_also_bytes	Show also the exact byte value in parenthesis if the nicely formatted string uses bigger unit than bytes.
slot	Which static buffer to use to hold the string. This is shared with uint64_to_str().

Returns

Pointer to statically allocated buffer containing the string.

Note

This uses double_to_str() internally so the static buffer in double_to_str() will be overwritten.

uint64_to_str()

const char * uint64_to_str ( uint64_t value, uint32_t slot )

extern

Convert uint64_t to a string.

Convert the given value to a string with locale-specific thousand separators, if supported by the snprintf() implementation. The string is stored into an internal static buffer indicated by the slot argument. A pointer to the selected buffer is returned.

This function exists, because non-POSIX systems don't support thousand separator in format strings. Solving the problem in a simple way doesn't work, because it breaks gettext (specifically, the xgettext tool).

xrealloc()

void * xrealloc ( void * ptr, size_t size )

extern

Safe realloc() that never returns NULL.

Tar related function, version 1.34

xstrdup()

char * xstrdup ( const char * src )

extern

Safe strdup() that never returns NULL.

Function to duplicate a string

Parameters

string

the input string

Returns

the duplicated new address