mirror of
https://git.tukaani.org/xz.git
synced 2024-04-04 12:36:23 +02:00
cad62551c5
format character with snprintf() on POSIX systems but not on non-POSIX systems and still keep xgettext working.
79 lines
2.7 KiB
C
79 lines
2.7 KiB
C
///////////////////////////////////////////////////////////////////////////////
|
|
//
|
|
/// \file util.h
|
|
/// \brief Miscellaneous utility functions
|
|
//
|
|
// Author: Lasse Collin
|
|
//
|
|
// This file has been put into the public domain.
|
|
// You can do whatever you want with this file.
|
|
//
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
/// \brief Safe malloc() that never returns NULL
|
|
///
|
|
/// \note xmalloc(), xrealloc(), and xstrdup() must not be used when
|
|
/// there are files open for writing, that should be cleaned up
|
|
/// before exiting.
|
|
#define xmalloc(size) xrealloc(NULL, size)
|
|
|
|
|
|
/// \brief Safe realloc() that never returns NULL
|
|
extern void *xrealloc(void *ptr, size_t size);
|
|
|
|
|
|
/// \brief Safe strdup() that never returns NULL
|
|
extern char *xstrdup(const char *src);
|
|
|
|
|
|
/// \brief Fancy version of strtoull()
|
|
///
|
|
/// \param name Name of the option to show in case of an error
|
|
/// \param value String containing the number to be parsed; may
|
|
/// contain suffixes "k", "M", "G", "Ki", "Mi", or "Gi"
|
|
/// \param min Minimum valid value
|
|
/// \param max Maximum valid value
|
|
///
|
|
/// \return Parsed value that is in the range [min, max]. Does not return
|
|
/// if an error occurs.
|
|
///
|
|
extern uint64_t str_to_uint64(const char *name, const char *value,
|
|
uint64_t min, uint64_t max);
|
|
|
|
|
|
/// \brief 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).
|
|
extern const char *uint64_to_str(uint64_t value, uint32_t slot);
|
|
|
|
|
|
/// \brief Convert double to a string with one decimal place
|
|
///
|
|
/// This is like uint64_to_str() except that this converts a double and
|
|
/// uses exactly one decimal place.
|
|
extern const char *double_to_str(double value);
|
|
|
|
|
|
/// \brief Check if filename is empty and print an error message
|
|
extern bool is_empty_filename(const char *filename);
|
|
|
|
|
|
/// \brief Test if stdin is a terminal
|
|
///
|
|
/// If stdin is a terminal, an error message is printed and exit status set
|
|
/// to EXIT_ERROR.
|
|
extern bool is_tty_stdin(void);
|
|
|
|
|
|
/// \brief Test if stdout is a terminal
|
|
///
|
|
/// If stdout is a terminal, an error message is printed and exit status set
|
|
/// to EXIT_ERROR.
|
|
extern bool is_tty_stdout(void);
|