ufm::numb::Integers 類別 參考文件

整數靜態工具類 更多...

#include <Integers.h>

類別ufm::numb::Integers的繼承圖:

靜態公開方法(Static Public Methods)
static uint32	castUnsigned (int value)
	轉換為無符號整數
static int	castSigned (uint32 value)
	轉換為有符號整數
static bool	isInteger (const char *str, int limit=-1)
	判斷字串是否為有效整數格式
static bool	parseInteger (int &result, const char *str, int limit=-1)
	將字串解析為整數

靜態公開屬性
static constexpr const char *const	TEXT_MAX_VALUE
	最大值字符串表示
static constexpr const char *const	TEXT_MIN_VALUE
	最小值字符串表示
static constexpr const int	MAX_ASCII_VALUE
	最大ASCII值長度
static constexpr const int	MAX_ASCII_OCTAL
	最大八進制ASCII長度
static constexpr const int	MAX_ASCII_HEX
	最大十六進制ASCII長度
static constexpr const int32	MAX_VALUE = static_cast<int32>(0x7FFFFFFF)
	整數類型的最大值
static constexpr const int32	MIN_VALUE = static_cast<int32>(0x80000000)
	整數類型的最小值

保護方法(Protected Methods)
virtual	~Integers (void) override=default
	Destroy the Integers object.
保護方法(Protected Methods) 繼承自 ufm::lang::NonInstantiable
	NonInstantiable (void)=delete
	禁止實例化 NonInstantiable 類別
	NonInstantiable (const NonInstantiable &)=delete
	禁止複製建構函式
virtual	~NonInstantiable (void) override=default
	Destroy the Non Instantiable object.
NonInstantiable &	operator= (const NonInstantiable &)=delete
NonInstantiable &	operator= (NonInstantiable &&)=delete

額外的繼承成員
公開方法(Public Methods) 繼承自 ufm::lang::Object
void *	operator new (size_t n)
	使用運算子 new 分配記憶體
void *	operator new (size_t n, void *p)
	在指定記憶體上調用運算子 new
virtual ufm::lang::Object &	getObject (void) override
	取得對應的 Object 物件
void	delay (int milliseconds) const
	延遲指定的毫秒數進行執行緒等待
bool	equals (Object *object) const
	判斷與另一物件是否為相同參照（指標型態比較）
bool	equals (Object &object) const
	判斷與另一物件是否為相同參照（參照型態比較）
void	wait (void) const
	使當前線程等待直到被通知
bool	wait (int timeout) const
	等待通知或超時
bool	yield (void) const
	讓執行緒讓渡控制權給同優先權的下一個執行緒
int	lock (void) const
	核心鎖定，鎖定期間禁止線程切換
int	unlock (void) const
	核心解鎖
ufm::sys::Thread *	currentThread (void) const
	取得當前執行緒指標
virtual int	hashcode (void) const
	返回對象的哈希碼值。支持這種方法是為了散列表，如HashMap提供的那樣。
公開方法(Public Methods) 繼承自 ufm::lang::Interface
virtual	~Interface (void)=default
	虛擬析構函式

詳細描述

整數靜態工具類

此類提供了整數(int)類型的靜態工具方法，用於型別轉換、字串解析和格式判斷。 作為工具類，Integers類不能被實例化，所有方法均為靜態方法。 主要功能包括：

• 有符號和無符號整數間的轉換
• 字串解析為整數
• 判斷字串格式是否為有效整數
• 提供整數相關常數與基本信息

自

1.0.0

函式成員說明文件

castSigned()

static int ufm::numb::Integers::castSigned ( uint32 value )

inlinestatic

轉換為有符號整數

參數

value

無符號整數值

傳回值

int 轉換後的有符號整數

castUnsigned()

static uint32 ufm::numb::Integers::castUnsigned ( int value )

inlinestatic

轉換為無符號整數

參數

value

有符號整數值

傳回值

uint32 轉換後的無符號整數

isInteger()

static bool ufm::numb::Integers::isInteger ( const char * str, int limit = -1 )

static

判斷字串是否為有效整數格式

支援十進制、前置 0 表示八進制、0x 前置表示十六進制。

參數

str	字串來源 (非 nullptr)
limit	檢查的字符數，-1 表示自動判斷至 '\0'

傳回值

true 表示為有效整數格式

false 表示非整數格式

parseInteger()

static bool ufm::numb::Integers::parseInteger ( int & result, const char * str, int limit = -1 )

static

將字串解析為整數

解析 str 為 int 值，支援十進制、八進制、十六進制。

參數

result	參考參數，存放解析後的整數值
str	字串來源 (非 nullptr)
limit	檢查的字符數，-1 表示自動判斷至 '\0'

傳回值

true 解析成功

false 解析失敗或格式不合法

資料成員說明文件

MAX_ASCII_HEX

const int ufm::numb::Integers::MAX_ASCII_HEX

staticconstexpr

初值:

=
      static_cast<int>(sizeof("0xFFFFFFFF"))

最大十六進制ASCII長度

MAX_ASCII_OCTAL

const int ufm::numb::Integers::MAX_ASCII_OCTAL

staticconstexpr

初值:

=
      static_cast<int>(sizeof("07777777777777777"))

最大八進制ASCII長度

MAX_ASCII_VALUE

const int ufm::numb::Integers::MAX_ASCII_VALUE

staticconstexpr

初值:

=
      static_cast<int>(sizeof("-2147483648"))

最大ASCII值長度

TEXT_MAX_VALUE

const char* const ufm::numb::Integers::TEXT_MAX_VALUE

staticconstexpr

初值:

=
      "+2147483647"

最大值字符串表示

TEXT_MIN_VALUE

const char* const ufm::numb::Integers::TEXT_MIN_VALUE

staticconstexpr

初值:

=
      "-2147483648"

最小值字符串表示

---

此類別(class) 文件是由下列檔案中產生:

• Integers.h