log_numbers.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif

#define LOG_DIGITS_MAX 40
#define LOG_UNIT_MAX   12

typedef enum {
    LOG_CONV_AUTO = 0, 
    LOG_CONV_DE,       
    LOG_CONV_EN        
} log_conv_t;

typedef enum {
    LOG_AMBIG_THOUSANDS = 0, 
    LOG_AMBIG_DECIMAL        
} log_ambig_t;

typedef enum {
    LOG_EV_NONE = 0,  
    LOG_EV_AMBIGUOUS, 
    LOG_EV_DE,
    LOG_EV_EN
} log_evidence_t;

typedef struct {
    char digits[LOG_DIGITS_MAX];  
    char unit[LOG_UNIT_MAX];      
    int  sign; 
    int  exp;  
} log_value_t;

bool log_split_value(const char *raw, log_value_t *out);

log_evidence_t log_evidence_of(const char *digits);

typedef struct {
    int  de;           
    int  en;           
    int  ambiguous;    
    char ambiguous_sep; 
} log_votes_t;

void log_votes_reset(log_votes_t *v);

void log_votes_add(log_votes_t *v, const char *raw);

log_conv_t log_votes_result(const log_votes_t *v, log_ambig_t fallback,
                            bool *confident, bool *conflict);

bool log_is_well_formed(const char *digits, log_conv_t convention);

bool log_parse_with(const char *raw, log_conv_t convention,
                    double *value, char *unit, size_t unit_size);

bool log_parse_loose(const char *raw, log_ambig_t fallback, double *value);

#define LOG_UNIT_SLOTS 4
/* --------------------------------------------------------------- units --- */

typedef struct {
    char units[LOG_UNIT_SLOTS][LOG_UNIT_MAX];  
    int  counts[LOG_UNIT_SLOTS];               
    int  used;                                 
    bool overflowed; 
} log_unit_tally_t;

void log_unit_tally_reset(log_unit_tally_t *t);

void log_unit_tally_add(log_unit_tally_t *t, const char *unit);

void log_unit_dominant(const log_unit_tally_t *t, char *out, size_t out_size,
                       bool *mixed);

void log_unit_from_header(const char *header, char *name, size_t name_size,
                          char *unit, size_t unit_size);

double log_time_unit_scale(const char *unit);
 
#ifdef __cplusplus
}
#endif