From 62aa5397036216480c859849a8d983b7bce5bf47 Mon Sep 17 00:00:00 2001 From: David Phillips Date: Mon, 18 Jun 2018 21:07:28 +1200 Subject: Document make_unit_whatsit with more comment than code --- unit_label.c | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/unit_label.c b/unit_label.c index d163404..b050b89 100644 --- a/unit_label.c +++ b/unit_label.c @@ -1,5 +1,22 @@ #include +/* Assign *unit a unit string from table unit_label that best fits value. + * returns the value reduced by the chosen unit's magnitude + * + * Tables are worked through in order, stopping at an entry with a falsey + * label. While the value is larger than the current unit's maximum count, + * the value is divided by this count and the next unit in the table is + * examined. Example: + * 100 flooby + * 500 glargle + * 30 lafplop // Can be any count + * 0 NULL // Can be any count + * + * Given this table, a value of: + * 150 will store glargle and return 1.5 + * 50 will store flooby and return 50 + * 55000 will store lafplop and return 1.1 + */ double make_unit_whatsit(const struct unit_label l[], char **unit, double value) { size_t i = 0; -- cgit v1.1