单位和数量分析

详细描述

提供单位和数量分析的功能，包括单位和数量值的加法、减法、乘法、除法等操作。

类
class	ast::Quantity
class	ast::Unit
class	ast::UnitConverter
class	ast::UnitManager

函数
Quantity	ast::aQuantityAdd (const Quantity &q1, const Quantity &q2)
Quantity	ast::aQuantitySub (const Quantity &q1, const Quantity &q2)
Quantity	ast::aQuantityMul (const Quantity &q1, const Quantity &q2)
Quantity	ast::aQuantityMul (const Quantity &q, const Unit &unit)
Quantity	ast::aQuantityDiv (const Quantity &q1, const Quantity &q2)
Quantity	ast::aQuantityDiv (const Quantity &q, const Unit &unit)
void	ast::aQuantityReduce (Quantity &q)
std::string	ast::aQuantityToString (const Quantity &q)
A_ALWAYS_INLINE std::string	ast::aFormatQuantity (const Quantity &q)
Quantity	ast::operator* (double value, const Unit &unit)
Quantity	ast::operator* (double value, const Quantity &q)
Quantity	ast::operator/ (double value, const Quantity &q)
errc_t	ast::aQuantityParse (StringView str, double &magnitude, Unit &unit)
errc_t	ast::aQuantityParse (StringView str, Quantity &quantity)
Quantity	ast::aQuantityParse (StringView str)
Unit	ast::aUnitMultiply (const Unit &unit1, const Unit &unit2)
Unit	ast::aUnitMultiply (const Unit &unit1, const Unit &unit2, StringView newname)
Unit	ast::aUnitDivide (const Unit &unit1, const Unit &unit2)
Unit	ast::aUnitDivide (const Unit &unit1, const Unit &unit2, StringView newname)
Unit	ast::aUnitPower (const Unit &unit, int exponent)
Unit	ast::aUnitPower (const Unit &unit, int exponent, StringView newname)
Unit	ast::aUnitInvert (const Unit &unit)
Unit	ast::aUnitInvert (const Unit &unit, StringView newname)
void	ast::aUnitFactorize (const Unit &unit, Unit &newUnit, double &scale)
void	ast::aUnitFactorize (Unit &unit, double &scale)
Unit *	ast::aUnitGet (StringView name)
errc_t	ast::aUnitAdd (const Unit &unit)
errc_t	ast::aUnitAdd (StringView name, const Unit &unit)
errc_t	ast::aUnitParse (StringView str, Unit &unit)
Unit	ast::aUnitParse (StringView str)
void	ast::Quantity::changeUnit (const Unit &unit)

函数说明

aQuantityAdd()

AST_UTIL_API Quantity ast::aQuantityAdd	(	const Quantity &	q1,
		const Quantity &	q2 )

数量值加法

参数

q1	数量值1
q2	数量值2

返回

数量值1与数量值2的和

aQuantityDiv() [1/2]

AST_UTIL_API Quantity ast::aQuantityDiv	(	const Quantity &	q,
		const Unit &	unit )

数量值单位除法

参数

q	数量值
unit	单位

返回

数量值与单位的商

aQuantityDiv() [2/2]

AST_UTIL_API Quantity ast::aQuantityDiv	(	const Quantity &	q1,
		const Quantity &	q2 )

数量值除法

参数

q1	数量值1
q2	数量值2

返回

数量值1与数量值2的商

aQuantityMul() [1/2]

AST_UTIL_API Quantity ast::aQuantityMul	(	const Quantity &	q,
		const Unit &	unit )

数量值单位乘法

参数

q	数量值
unit	单位

返回

数量值与单位的积

aQuantityMul() [2/2]

AST_UTIL_API Quantity ast::aQuantityMul	(	const Quantity &	q1,
		const Quantity &	q2 )

数量值乘法

参数

q1	数量值1
q2	数量值2

返回

数量值1与数量值2的积

aQuantityParse() [1/3]

AST_UTIL_API Quantity ast::aQuantityParse

(

StringView

str

)

解析量字符串

例如 "123.456 m/s", "123.456m", "123.456[m/s]"。

参数

[in]

str

量字符串

返回

Quantity 解析得到的量，如果解析失败返回 Quantity::NaN()

aQuantityParse() [2/3]

AST_UTIL_API errc_t ast::aQuantityParse	(	StringView	str,
		double &	magnitude,
		Unit &	unit )

解析量字符串，将其解析为数值和单位。

例如 "123.456 m/s", "123.456m", "123.456[m/s]"。

参数

[in]	str	量字符串
[out]	magnitude	解析得到的数值
[out]	unit	解析得到的单位

返回

errc_t 错误码

aQuantityParse() [3/3]

AST_UTIL_API errc_t ast::aQuantityParse	(	StringView	str,
		Quantity &	quantity )

解析量字符串

例如 "123.456 m/s", "123.456m", "123.456[m/s]"。

参数

[in]	str	量字符串
[out]	quantity	解析后的量

返回

errc_t 错误码

aQuantityReduce()

AST_UTIL_API void ast::aQuantityReduce

(

Quantity &

q

)

数量值简化

参数

q

数量值

aQuantitySub()

AST_UTIL_API Quantity ast::aQuantitySub	(	const Quantity &	q1,
		const Quantity &	q2 )

数量值减法

参数

q1	数量值1
q2	数量值2

返回

数量值1与数量值2的差

aQuantityToString()

AST_UTIL_API std::string ast::aQuantityToString

(

const Quantity &

q

)

数量值转换为字符串

参数

q

数量值

返回

数量值的字符串表示

aUnitAdd() [1/2]

AST_UTIL_API errc_t ast::aUnitAdd

(

const Unit &

unit

)

添加单位

参数

unit

要添加的单位

返回

errc_t 错误码

aUnitAdd() [2/2]

AST_UTIL_API errc_t ast::aUnitAdd	(	StringView	name,
		const Unit &	unit )

添加单位

参数

name	单位名称
unit	要添加的单位

返回

errc_t 错误码

aUnitFactorize() [1/2]

AST_UTIL_API void ast::aUnitFactorize	(	const Unit &	unit,
		Unit &	newUnit,
		double &	scale )

单位分解

参数

[in]	unit	分解前的单位
[out]	newUnit	分解后的单位
[out]	scale	单位缩放因子

aUnitFactorize() [2/2]

AST_UTIL_API void ast::aUnitFactorize	(	Unit &	unit,
		double &	scale )

单位分解

参数

[in,out]	unit	约简前后的单位
[out]	scale	单位缩放因子

aUnitGet()

AST_UTIL_API Unit * ast::aUnitGet

(

StringView

name

)

获取单位

参数

name

单位名称

返回

单位

aUnitParse() [1/2]

AST_UTIL_API Unit ast::aUnitParse

(

StringView

str

)

解析单位字符串

参数

[in]

str

单位字符串

返回

Unit 解析得到的单位，如果解析失败返回 Unit::NaN()

aUnitParse() [2/2]

AST_UTIL_API errc_t ast::aUnitParse	(	StringView	str,
		Unit &	unit )

解析单位字符串

参数

[in]	str	单位字符串
[out]	unit	解析后的单位

返回

errc_t 错误码

changeUnit()

void ast::Quantity::changeUnit ( const Unit & unit )

inline

切换当前单位

切换当前单位后，数量值会自动转换为该单位 例如将1000m转换为1km，将1000kg转换为1t等

参数

unit

当前单位

operator*()

AST_UTIL_API Quantity ast::operator*	(	double	value,
		const Unit &	unit )

单位乘法运算符

参数

value	数值
unit	单位

返回

新单位