/* unit_strings.h
 * Units to append to field values
 *
 * Wireshark - Network traffic analyzer
 * By Gerald Combs <gerald@wireshark.org>
 * Copyright 1998 Gerald Combs
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */

#ifndef __UNIT_STRINGS_H__
#define __UNIT_STRINGS_H__

#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

/** @file
 * Units to append to field values
 */

/** For BASE_UNIT_STRING, the display format for adding units */
typedef struct unit_name_string {
    char *singular;     /**< name to use for 1 unit */
    char *plural;       /**< name to use for < 1 or > 1 units */
} unit_name_string;

/** Returns the unit string appropriate for the 32 bit value.
 *
 * From the given unit_name_string return the appropriate string pointer
 * @param[in] value The value for which to get the appropriate string
 * @param[in] units The unit_name_string containing the relevant strings
 * @return          Pointer to the appropriate string
 */
const char* unit_name_string_get_value(uint32_t value, const unit_name_string* units);

/** Returns the unit string appropriate for the 64 bit value.
 *
 * From the given unit_name_string return the appropriate string pointer
 * @param[in] value The value for which to get the appropriate string
 * @param[in] units The unit_name_string containing the relevant strings
 * @return          Pointer to the appropriate string
 */
const char* unit_name_string_get_value64(uint64_t value, const unit_name_string* units);

/** Returns the unit string appropriate for the double value.
 *
 * From the given unit_name_string return the appropriate string pointer
 * @param[in] value The value for which to get the appropriate string
 * @param[in] units The unit_name_string containing the relevant strings
 * @return          Pointer to the appropriate string
 */
const char* unit_name_string_get_double(double value, const unit_name_string* units);

/*
 * A default set of unit strings that dissectors can use for
 * header fields.
 */
const unit_name_string units_foot_feet;
const unit_name_string units_bit_bits;
const unit_name_string units_byte_bytes;
const unit_name_string units_byte_bytespsecond;
const unit_name_string units_octet_octets;
const unit_name_string units_word_words;
const unit_name_string units_tick_ticks;
const unit_name_string units_meters;
const unit_name_string units_meter_meters;
const unit_name_string units_centimeters;
const unit_name_string units_centimeter_centimeters;
const unit_name_string units_millimeters;
const unit_name_string units_millimeter_millimeters;
const unit_name_string units_week_weeks;
const unit_name_string units_day_days;
const unit_name_string units_hour_hours;
const unit_name_string units_hours;
const unit_name_string units_minute_minutes;
const unit_name_string units_minutes;
const unit_name_string units_second_seconds; // full unit name "second[s?]"
const unit_name_string units_seconds;        //only seconds abbreviation "s"
const unit_name_string units_millisecond_milliseconds; // full unit name "millisecond[s?]"
const unit_name_string units_milliseconds;        //only seconds abbreviation "ms"
const unit_name_string units_microsecond_microseconds; // full unit name "microsecond[s?]"
//const unit_name_string units_microseconds;        //only seconds abbreviation "us"
const unit_name_string units_nanosecond_nanoseconds; // full unit name "nanosecond[s?]"
const unit_name_string units_nanoseconds; //only seconds abbreviation "ns"
const unit_name_string units_nanometers;
const unit_name_string units_degree_degrees;
//const unit_name_string units_degree_celsius;
//const unit_name_string units_degree_bearing;
const unit_name_string units_centibels;
const unit_name_string units_decibels;
const unit_name_string units_dbm;
const unit_name_string units_dbi;
const unit_name_string units_dbhz;
const unit_name_string units_mbm;
const unit_name_string units_percent;
const unit_name_string units_khz;
const unit_name_string units_ghz;
const unit_name_string units_mhz;
const unit_name_string units_hz;
const unit_name_string units_hz_s;
const unit_name_string units_kbit;
const unit_name_string units_kbps;
const unit_name_string units_kibps;
const unit_name_string units_pkts;
const unit_name_string units_pkts_per_sec;
const unit_name_string units_km;
const unit_name_string units_kmh;
const unit_name_string units_m_s;
const unit_name_string units_cm_s;
const unit_name_string units_mm_s;
const unit_name_string units_milliamps;
//const unit_name_string units_microwatts;
const unit_name_string units_volt;
const unit_name_string units_grams_per_second;
const unit_name_string units_meter_sec;
//const unit_name_string units_meter_sec_squared;
const unit_name_string units_bit_sec;
const unit_name_string units_segment_remaining;
const unit_name_string units_frame_frames;
const unit_name_string units_revolutions_per_minute;
const unit_name_string units_kilopascal;
const unit_name_string units_newton_metre;
const unit_name_string units_liter_per_hour;
const unit_name_string units_amp;
const unit_name_string units_watthour;
const unit_name_string units_watt;
const unit_name_string units_bpm;
const unit_name_string units_calorie;
const unit_name_string units_cycle_cycles;

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* __UNIT_STRINGS_H__ */