X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=lib%2Fhuman.c;h=600614e011a54bca7ee6668d5d776b5500ce7ea6;hb=3e6339641eedb691ab9a8f2435b972aac725ea5c;hp=b647649d514ec391cce4a18e3b062d59adb82d0e;hpb=1bbd61b95a3b89e7ca993880d5c44ca391d54f0a;p=gnulib.git diff --git a/lib/human.c b/lib/human.c index b647649d5..600614e01 100644 --- a/lib/human.c +++ b/lib/human.c @@ -1,5 +1,5 @@ /* human.c -- print human readable file size - Copyright (C) 1996, 1997 Free Software Foundation, Inc. + Copyright (C) 1996, 1997, 1998, 1999 Free Software Foundation, Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -16,12 +16,11 @@ Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ /* Originally contributed by lm@sgi.com; - --si and large file support added by eggert@twinsun.com. */ + --si, output block size selection, and large file support + added by eggert@twinsun.com. */ -#include - -#if HAVE_INTTYPES_H -# include +#if HAVE_CONFIG_H +# include #endif #include @@ -31,13 +30,37 @@ # include #endif +#if HAVE_STRING_H +# include +#else +# include +#endif + #ifndef CHAR_BIT -#define CHAR_BIT 8 +# define CHAR_BIT 8 +#endif +#if HAVE_STDLIB_H +# include #endif +#ifndef HAVE_DECL_GETENV +char *getenv (); +#endif + +#if ENABLE_NLS +# include +# define _(Text) gettext (Text) +#else +# define _(Text) Text +#endif + +#include +#include +#include + #include "human.h" -static const char suffixes[] = +static const char suffixes[] = { 0, /* not used */ 'k', /* kilo */ @@ -50,33 +73,48 @@ static const char suffixes[] = 'Y' /* Yotta */ }; +/* Like human_readable_inexact, except always round to even. */ +char * +human_readable (uintmax_t n, char *buf, + int from_block_size, int output_block_size) +{ + return human_readable_inexact (n, buf, from_block_size, output_block_size, + human_round_to_even); +} + /* Convert N to a human readable format in BUF. - - N is expressed in units of FROM_UNITS; use units of TO_UNITS in the - output number. FROM_UNITS and TO_UNITS must be positive, and one must - be a multiple of the other. - - If BASE is nonzero, use a format like "127k" if possible, - using powers of BASE; otherwise, use ordinary decimal format. - Normally BASE is either 1000 or 1024; it must be at least 2. - Most people visually process strings of 3-4 digits effectively, - but longer strings of digits are more prone to misinterpretation. - Hence, converting to an abbreviated form usually improves readability. - Use a suffix indicating which power is being used. - For example, assuming BASE is 1024, 8500 would be converted to 8.3k, + + N is expressed in units of FROM_BLOCK_SIZE. FROM_BLOCK_SIZE must + be nonnegative. + + If OUTPUT_BLOCK_SIZE is positive, use units of OUTPUT_BLOCK_SIZE in + the output number. OUTPUT_BLOCK_SIZE must be a multiple of + FROM_BLOCK_SIZE or vice versa. + + Use INEXACT_STYLE to determine whether to take the ceiling or floor + of any result that cannot be expressed exactly. + + If OUTPUT_BLOCK_SIZE is negative, use a format like "127k" if + possible, using powers of -OUTPUT_BLOCK_SIZE; otherwise, use + ordinary decimal format. Normally -OUTPUT_BLOCK_SIZE is either + 1000 or 1024; it must be at least 2. Most people visually process + strings of 3-4 digits effectively, but longer strings of digits are + more prone to misinterpretation. Hence, converting to an + abbreviated form usually improves readability. Use a suffix + indicating which power is being used. For example, assuming + -OUTPUT_BLOCK_SIZE is 1024, 8500 would be converted to 8.3k, 133456345 to 127M, 56990456345 to 53G, and so on. Numbers smaller - than BASE aren't modified. */ + than -OUTPUT_BLOCK_SIZE aren't modified. */ char * -human_readable (n, buf, from_units, to_units, base) - uintmax_t n; - char *buf; - int from_units; - int to_units; - int base; +human_readable_inexact (uintmax_t n, char *buf, + int from_block_size, int output_block_size, + enum human_inexact_style inexact_style) { uintmax_t amt; - int tenths; + int base; + int to_block_size; + int tenths = 0; int power; char *p; @@ -84,19 +122,33 @@ human_readable (n, buf, from_units, to_units, base) 1 means AMT.TENTHS < adjusted N < AMT.TENTHS + 0.05; 2 means adjusted N == AMT.TENTHS + 0.05; 3 means AMT.TENTHS + 0.05 < adjusted N < AMT.TENTHS + 0.1. */ - int rounding; + int rounding = 0; + + if (output_block_size < 0) + { + base = -output_block_size; + to_block_size = 1; + } + else + { + base = 0; + to_block_size = output_block_size; + } p = buf + LONGEST_HUMAN_READABLE; *p = '\0'; - - /* Adjust AMT out of FROM_UNITS units and into TO_UNITS units. */ - - if (to_units <= from_units) +#ifdef lint + /* Suppress `used before initialized' warning. */ + power = 0; +#endif + + /* Adjust AMT out of FROM_BLOCK_SIZE units and into TO_BLOCK_SIZE units. */ + + if (to_block_size <= from_block_size) { - int multiplier = from_units / to_units; + int multiplier = from_block_size / to_block_size; amt = n * multiplier; - tenths = rounding = 0; if (amt / multiplier != n) { @@ -120,7 +172,7 @@ human_readable (n, buf, from_units, to_units, base) e *= base; power++; } - while (e * base <= amt && power < sizeof suffixes - 1); + while (e * base <= damt && power < sizeof suffixes - 1); damt /= e; @@ -132,9 +184,11 @@ human_readable (n, buf, from_units, to_units, base) return buf; } } + else if (from_block_size == 0) + amt = 0; else { - int divisor = to_units / from_units; + int divisor = to_block_size / from_block_size; int r10 = (n % divisor) * 10; int r2 = (r10 % divisor) * 2; amt = n / divisor; @@ -142,7 +196,7 @@ human_readable (n, buf, from_units, to_units, base) rounding = r2 < divisor ? 0 < r2 : 2 + (divisor < r2); } - + /* Use power of BASE notation if adjusted AMT is large enough. */ if (base && base <= amt) @@ -166,24 +220,33 @@ human_readable (n, buf, from_units, to_units, base) if (amt < 10) { - tenths += 2 < rounding + (tenths & 1); - - if (tenths == 10) + if (2 * (1 - (int) inexact_style) + < rounding + (tenths & (inexact_style == human_round_to_even))) { - amt++; - tenths = 0; + tenths++; + rounding = 0; + + if (tenths == 10) + { + amt++; + tenths = 0; + } } if (amt < 10) { *--p = '0' + tenths; *--p = '.'; - tenths = 0; + tenths = rounding = 0; } } } - - if (5 < tenths + (2 < rounding + (amt & 1))) + + if (inexact_style == human_ceiling + ? 0 < tenths + rounding + : inexact_style == human_round_to_even + ? 5 < tenths + (2 < rounding + (amt & 1)) + : /* inexact_style == human_floor */ 0) { amt++; @@ -202,3 +265,58 @@ human_readable (n, buf, from_units, to_units, base) return p; } + + +/* The default block size used for output. This number may change in + the future as disks get larger. */ +#ifndef DEFAULT_BLOCK_SIZE +# define DEFAULT_BLOCK_SIZE 1024 +#endif + +static char const *const block_size_args[] = { "human-readable", "si", 0 }; +static int const block_size_types[] = { -1024, -1000 }; + +static int +default_block_size (void) +{ + return getenv ("POSIXLY_CORRECT") ? 512 : DEFAULT_BLOCK_SIZE; +} + +static strtol_error +humblock (char const *spec, int *block_size) +{ + int i; + + if (! spec && ! (spec = getenv ("BLOCK_SIZE"))) + *block_size = default_block_size (); + else if (0 <= (i = ARGMATCH (spec, block_size_args, block_size_types))) + *block_size = block_size_types[i]; + else + { + char *ptr; + unsigned long val; + strtol_error e = xstrtoul (spec, &ptr, 0, &val, "eEgGkKmMpPtTyYzZ0"); + if (e != LONGINT_OK) + return e; + if (*ptr) + return LONGINT_INVALID_SUFFIX_CHAR; + if ((int) val < 0 || val != (int) val) + return LONGINT_OVERFLOW; + *block_size = (int) val; + } + + return LONGINT_OK; +} + +void +human_block_size (char const *spec, int report_errors, int *block_size) +{ + strtol_error e = humblock (spec, block_size); + if (*block_size == 0) + { + *block_size = default_block_size (); + e = LONGINT_INVALID; + } + if (e != LONGINT_OK && report_errors) + STRTOL_FATAL_ERROR (spec, _("block size"), e); +}