十六进制数值包装类更多...

#include <hexadecimal.hpp>

类 hexadecimal 继承关系图:

Public 类型
using	value_type = int64_t
	值类型
using	base = ipackage
	基类类型
Public 类型继承自 ipackage< hexadecimal, int64_t >
using	package_type
	包装类型

Public 成员函数
constexpr	hexadecimal (const int16_t value) noexcept
	从16位有符号整数构造
constexpr	hexadecimal (const int32_t value) noexcept
	从32位有符号整数构造
constexpr	hexadecimal (const uint16_t value) noexcept
	从16位无符号整数构造
constexpr	hexadecimal (const uint32_t value) noexcept
	从32位无符号整数构造
constexpr	hexadecimal (const uint64_t value) noexcept
	从64位无符号整数构造
constexpr	hexadecimal (const string_view view)
	从字符串视图构造
constexpr	hexadecimal (const char *str)
	从C风格字符串构造
constexpr	hexadecimal (const string &str)
	从字符串对象构造
constexpr	operator bool () const noexcept
	转换为bool操作符
constexpr bool	get_bit (const size_t position) const
	获取指定位的值
constexpr hexadecimal &	set_bit (const size_t position, const bool bit_value_=true)
	设置指定位的值
constexpr hexadecimal &	flip_bit (const size_t position)
	翻转指定位
constexpr string	to_string () const
	转换为字符串
Public 成员函数继承自 iobject< hexadecimal >
constexpr bool	try_parse (const string_view str) noexcept
	尝试从字符串解析对象
Public 成员函数继承自 istringify< hexadecimal >
constexpr string	to_string () const
	转换为字符串
Public 成员函数继承自 ipackage< hexadecimal, int64_t >
constexpr	operator package_type () const noexcept
	类型转换操作符
constexpr package_type	value () const noexcept
	获取数值
constexpr int64_t	to_int64 () const noexcept
	转换为64位整数
constexpr size_t	to_hash () const noexcept
	计算哈希值
constexpr void	swap (hexadecimal &other) noexcept
	交换内容
constexpr bool	equal_to (const hexadecimal &other) const noexcept
	相等比较操作符
constexpr bool	less_than (const hexadecimal &other) const noexcept
	小于比较操作符
constexpr hexadecimal &	operator+= (const hexadecimal &other) noexcept
	加法赋值操作符
constexpr hexadecimal &	operator-= (const hexadecimal &other) noexcept
	减法赋值操作符
constexpr hexadecimal &	operator*= (const hexadecimal &other) noexcept
	乘法赋值操作符
constexpr hexadecimal &	operator/= (const hexadecimal &other)
	除法赋值操作符
constexpr hexadecimal &	operator%= (const hexadecimal &other)
	取模赋值操作符
constexpr hexadecimal	operator- () const noexcept
	一元负号操作符
constexpr hexadecimal &	operator++ () noexcept
	前置递增操作符
constexpr hexadecimal &	operator-- () noexcept
	前置递减操作符
constexpr hexadecimal	operator~ () const noexcept
	按位取反操作符
constexpr hexadecimal &	operator&= (const hexadecimal &other) noexcept
	按位与赋值操作符
constexpr hexadecimal &	operator\|= (const hexadecimal &other) noexcept
	按位或赋值操作符
constexpr hexadecimal &	operator^= (const hexadecimal &other) noexcept
	按位异或赋值操作符
constexpr hexadecimal &	operator<<= (const uint32_t shift)
	左移赋值操作符
constexpr hexadecimal &	operator>>= (const uint32_t shift)
	右移赋值操作符
Public 成员函数继承自 icomparable< hexadecimal >
constexpr bool	operator== (const hexadecimal &rhs) const noexcept(noexcept(derived().equal_to(rhs)))
	相等比较运算符
constexpr bool	operator!= (const hexadecimal &rhs) const noexcept(noexcept(!(derived().equal_to(rhs))))
	不等比较运算符
constexpr bool	operator< (const hexadecimal &rhs) const noexcept(noexcept(derived().less_than(rhs)))
	小于比较运算符
constexpr bool	operator> (const hexadecimal &rhs) const noexcept(noexcept(rhs.less_than(derived())))
	大于比较运算符
constexpr bool	operator<= (const hexadecimal &rhs) const noexcept(noexcept(!(rhs.less_than(derived()))))
	小于等于比较运算符
constexpr bool	operator>= (const hexadecimal &rhs) const noexcept(noexcept(!(derived().less_than(rhs))))
	大于等于比较运算符
Public 成员函数继承自 ihashable< hexadecimal >
constexpr size_t	to_ihash () const noexcept(noexcept(derived().to_hash()))
	获取对象的哈希值
Public 成员函数继承自 iarithmetic< hexadecimal >
constexpr hexadecimal	operator+ (const hexadecimal &other) const noexcept(noexcept(const_cast< hexadecimal & >(derived()).operator+=(other)))
	加法运算符
constexpr hexadecimal	operator- (const hexadecimal &other) const noexcept(noexcept(const_cast< hexadecimal & >(derived()).operator-=(other)))
	减法运算符
constexpr hexadecimal	operator* (const hexadecimal &other) const noexcept(noexcept(const_cast< hexadecimal & >(derived()).operator*=(other)))
	乘法运算符
constexpr hexadecimal	operator/ (const hexadecimal &other) const noexcept(noexcept(const_cast< hexadecimal & >(derived()).operator/=(other)))
	除法运算符
constexpr hexadecimal	operator% (const hexadecimal &other) const noexcept(noexcept(const_cast< hexadecimal & >(derived()).operator%=(other)))
	取模运算符
constexpr hexadecimal &	operator+= (const hexadecimal &other) noexcept(noexcept(derived().operator+=(other)))
	加法赋值运算符
constexpr hexadecimal &	operator-= (const hexadecimal &other) noexcept(noexcept(derived().operator-=(other)))
	减法赋值运算符
constexpr hexadecimal &	operator= (const hexadecimal &other) noexcept(noexcept(derived().operator=(other)))
	乘法赋值运算符
constexpr hexadecimal &	operator/= (const hexadecimal &other)
	除法赋值运算符
constexpr hexadecimal &	operator%= (const hexadecimal &other)
	取模赋值运算符
constexpr hexadecimal &	operator++ () noexcept(noexcept(derived().operator++()))
	前置自增运算符
constexpr hexadecimal &	operator-- () noexcept(noexcept(derived().operator--()))
	前置自减运算符
Public 成员函数继承自 ibinary< hexadecimal >
constexpr hexadecimal	operator& (const hexadecimal &other) const noexcept(noexcept(const_cast< hexadecimal & >(derived()).operator&=(other)))
	按位与运算符
constexpr hexadecimal	operator\| (const hexadecimal &other) const noexcept(noexcept(const_cast< hexadecimal & >(derived()).operator\|=(other)))
	按位或运算符
constexpr hexadecimal	operator^ (const hexadecimal &other) const noexcept(noexcept(const_cast< hexadecimal & >(derived()).operator^=(other)))
	按位异或运算符
constexpr hexadecimal	operator~ () const noexcept(noexcept(derived().operator~()))
	按位取反运算符
constexpr hexadecimal	operator<< (const uint32_t shift) const
	左移运算符
constexpr hexadecimal	operator>> (const uint32_t shift) const
	右移运算符
constexpr hexadecimal &	operator&= (const hexadecimal &other) noexcept(noexcept(derived().operator&=(other)))
	按位与赋值运算符
constexpr hexadecimal &	operator\|= (const hexadecimal &other) noexcept(noexcept(derived().operator\|=(other)))
	按位或赋值运算符
constexpr hexadecimal &	operator^= (const hexadecimal &other) noexcept(noexcept(derived().operator^=(other)))
	按位异或赋值运算符
constexpr hexadecimal &	operator<<= (const uint32_t shift)
	左移赋值运算符
constexpr hexadecimal &	operator>>= (const uint32_t shift)
	右移赋值运算符

静态 Public 成员函数
static constexpr byte_t	xdigit_value (const char c) noexcept
	将十六进制字符转换为对应的数值
static constexpr pair< bool, byte_t >	xdigit_value (const char high, const char low) noexcept
	将两个十六进制数字字符转换为对应的字节值。
static constexpr hexadecimal	parse (const string_view str)
	从字符串解析十六进制值
静态 Public 成员函数继承自 iobject< hexadecimal >
static constexpr hexadecimal	parse (const string_view str)
	从字符串解析对象
静态 Public 成员函数继承自 ipackage< hexadecimal, int64_t >
static constexpr size_t	bytes () noexcept
	获取类型字节大小
static constexpr size_t	bits () noexcept
	获取类型位大小

额外继承的成员函数
Protected 成员函数继承自 ipackage< hexadecimal, int64_t >
constexpr	~ipackage ()=default
	受保护的析构函数
Protected 属性继承自 ipackage< hexadecimal, int64_t >
package_type	value_
	存储的数值

详细描述

十六进制数值包装类

提供十六进制数值的包装，支持从字符串解析、位操作、格式化等功能。内部使用int64_t存储，支持64位以内的十六进制值。

在文件 hexadecimal.hpp 第 29 行定义.

构造及析构函数说明

◆ hexadecimal() [1/8]

hexadecimal::hexadecimal ( const int16_t value )

inlineexplicitconstexprnoexcept

从16位有符号整数构造

参数

value 整数值

在文件 hexadecimal.hpp 第 140 行定义.

引用了 ipackage< hexadecimal, int64_t >::value().

被这些函数引用 flip_bit(), hexadecimal(), hexadecimal(), parse() , 以及 set_bit().

◆ hexadecimal() [2/8]

hexadecimal::hexadecimal ( const int32_t value )

inlineexplicitconstexprnoexcept

从32位有符号整数构造

参数

value 整数值

在文件 hexadecimal.hpp 第 147 行定义.

引用了 ipackage< hexadecimal, int64_t >::value().

◆ hexadecimal() [3/8]

hexadecimal::hexadecimal ( const uint16_t value )

inlineexplicitconstexprnoexcept

从16位无符号整数构造

参数

value 整数值

在文件 hexadecimal.hpp 第 154 行定义.

引用了 ipackage< hexadecimal, int64_t >::value().

◆ hexadecimal() [4/8]

hexadecimal::hexadecimal ( const uint32_t value )

inlineexplicitconstexprnoexcept

从32位无符号整数构造

参数

value 整数值

在文件 hexadecimal.hpp 第 161 行定义.

引用了 ipackage< hexadecimal, int64_t >::value().

◆ hexadecimal() [5/8]

hexadecimal::hexadecimal ( const uint64_t value )

inlineexplicitconstexprnoexcept

从64位无符号整数构造

参数

value 整数值

在文件 hexadecimal.hpp 第 168 行定义.

引用了 ipackage< hexadecimal, int64_t >::value().

◆ hexadecimal() [6/8]

hexadecimal::hexadecimal ( const string_view view )

inlineexplicitconstexpr

从字符串视图构造

参数

view 十六进制字符串视图

异常

value_exception 解析失败时抛出

在文件 hexadecimal.hpp 第 176 行定义.

◆ hexadecimal() [7/8]

hexadecimal::hexadecimal ( const char * str )

inlineexplicitconstexpr

从C风格字符串构造

参数

str 十六进制字符串

异常

value_exception 解析失败时抛出

在文件 hexadecimal.hpp 第 184 行定义.

引用了 hexadecimal().

◆ hexadecimal() [8/8]

hexadecimal::hexadecimal ( const string & str )

inlineexplicitconstexpr

从字符串对象构造

参数

str 十六进制字符串

异常

value_exception 解析失败时抛出

在文件 hexadecimal.hpp 第 192 行定义.

引用了 hexadecimal().

成员函数说明

◆ flip_bit()

hexadecimal & hexadecimal::flip_bit ( const size_t position )

inlineconstexpr

翻转指定位

参数

position 位位置（0-63）

返回: 自身引用

异常

value_exception 位置超出范围时抛出

在文件 hexadecimal.hpp 第 256 行定义.

引用了 hexadecimal() , 以及 ipackage< hexadecimal, int64_t >::value_.

◆ get_bit()

bool hexadecimal::get_bit ( const size_t position ) const

inlinenodiscardconstexpr

获取指定位的值

参数

position 位位置（0-63）

返回: 该位的值（0或1）

异常

value_exception 位置超出范围时抛出

在文件 hexadecimal.hpp 第 224 行定义.

引用了 ipackage< hexadecimal, int64_t >::value_.

◆ operator bool()

hexadecimal::operator bool ( ) const

inlineexplicitnodiscardconstexprnoexcept

转换为bool操作符

返回: 值是否非零

在文件 hexadecimal.hpp 第 216 行定义.

引用了 ipackage< hexadecimal, int64_t >::value_.

◆ parse()

constexpr hexadecimal hexadecimal::parse ( const string_view str )

inlinestaticnodiscardconstexpr

从字符串解析十六进制值

参数

str 要解析的字符串

返回: 解析得到的十六进制对象

异常

value_exception 解析失败时抛出

在文件 hexadecimal.hpp 第 276 行定义.

引用了 hexadecimal().

被这些函数引用 color::parse().

◆ set_bit()

hexadecimal & hexadecimal::set_bit	(	const size_t	position,
		const bool	bit_value_ = true )

inlineconstexpr

设置指定位的值

参数

position	位位置（0-63）
bit_value_	要设置的值（true为1，false为0）

返回: 自身引用

异常

value_exception 位置超出范围时抛出

在文件 hexadecimal.hpp 第 238 行定义.

引用了 hexadecimal() , 以及 ipackage< hexadecimal, int64_t >::value_.

◆ to_string()

string hexadecimal::to_string ( ) const

nodiscardconstexpr

转换为字符串

返回: 十六进制格式的字符串（带0x前缀）

◆ xdigit_value() [1/2]

constexpr byte_t hexadecimal::xdigit_value ( const char c )

inlinestaticconstexprnoexcept

将十六进制字符转换为对应的数值

参数

c	十六进制字符（0-9, a-f, A-F）

返回: 对应的数值（0-15），当字符无效时返回invalid_xdigit

在文件 hexadecimal.hpp 第 42 行定义.

被这些函数引用 xdigit_value().

◆ xdigit_value() [2/2]

constexpr pair< bool, byte_t > hexadecimal::xdigit_value	(	const char	high,
		const char	low )

inlinestaticconstexprnoexcept

将两个十六进制数字字符转换为对应的字节值。

参数

high	高半字节十六进制字符（'0'-'9', 'A'-'F', 'a'-'f'）
low	低半字节十六进制字符（'0'-'9', 'A'-'F', 'a'-'f'）

返回

pair<bool, byte_t>

first: true 表示转换成功，false 表示存在非法字符。
second: 转换成功时为 (xdigit_value(high) << 4) | xdigit_value(low) 的字节值；失败时为 #invalid_xdigit。

在文件 hexadecimal.hpp 第 64 行定义.

引用了 xdigit_value().

该结构体的文档由以下文件生成:

hexadecimal.hpp

Public 类型

Public 成员函数

静态 Public 成员函数

额外继承的成员函数

详细描述

构造及析构函数说明

◆ hexadecimal() [1/8]

◆ hexadecimal() [2/8]

◆ hexadecimal() [3/8]

◆ hexadecimal() [4/8]

◆ hexadecimal() [5/8]

◆ hexadecimal() [6/8]

◆ hexadecimal() [7/8]

◆ hexadecimal() [8/8]

成员函数说明

◆ flip_bit()

◆ get_bit()

◆ operator bool()

◆ parse()

◆ set_bit()

◆ to_string()

◆ xdigit_value() [1/2]

◆ xdigit_value() [2/2]