format.h File Reference

📊 String Formatting Utilities More...

Go to the source code of this file.

Functions
void	format_bytes_pretty (size_t bytes, char *out, size_t out_capacity)
	Format byte count into human-readable string.
void	format_number_compact (uint64_t value, char *out, size_t out_capacity)

Detailed Description

📊 String Formatting Utilities

Definition in file util/format.h.

Function Documentation

format_number_compact()

void format_number_compact	(	uint64_t	value,
		char *	out,
		size_t	out_capacity )

Format a decimal count with lowercase k/m/b/t/p/e suffixes. Uses at most one rounded decimal place, omitting a trailing .0. Values below 1,000 stay exact; rounded 1,000-unit values promote a tier. Output is NUL-terminated when capacity is nonzero; NULL output is ignored.

Definition at line 46 of file util/format.c.

                                                                           {
  if (!out || !out_capacity)
    return;
  static const char suffixes[] = "kmbtpe";
  if (value < 1000) {
    SAFE_IGNORE_PRINTF_RESULT(safe_snprintf(out, out_capacity, "%" PRIu64, value));
    return;
  }
  uint64_t scale = 1000;
  size_t unit = 0;
  while (unit + 1 < sizeof(suffixes) - 1 && value / scale >= 1000) {
    scale *= 1000;
    ++unit;
  }
  uint64_t whole = value / scale;
  uint64_t step = scale / 10;
  uint64_t fraction = (value % scale + step / 2) / step;
  if (fraction == 10) {
    ++whole;
    fraction = 0;
  }
  if (whole == 1000 && unit + 1 < sizeof(suffixes) - 1) {
    whole = 1;
    ++unit;
  }
  if (fraction)
    SAFE_IGNORE_PRINTF_RESULT(
        safe_snprintf(out, out_capacity, "%" PRIu64 ".%" PRIu64 "%c", whole, fraction, suffixes[unit]));
  else
    SAFE_IGNORE_PRINTF_RESULT(safe_snprintf(out, out_capacity, "%" PRIu64 "%c", whole, suffixes[unit]));
}

References out, SAFE_IGNORE_PRINTF_RESULT, and safe_snprintf().

Referenced by ui_sync_render().