指標陣列類別更多...

#include <PArray.h>

類別ufm::util::PArray的繼承圖:

公開方法(Public Methods)
	PArray (ufm::lang::Memory memory, int elementSize) noexcept
	使用現有內存構造指標陣列

	PArray (int length, int elementSize)
	構造指定長度和元素大小的指標陣列

	PArray (PArray &&other) noexcept=default
	移動構造函數

	PArray (PArray &other) noexcept=default
	淺層複製構造函數

virtual	~PArray (void) override
	解構函數

template<typename E >
	operator const Array< E > & (void) const
	轉換操作符，將 PArray 轉換為指定類型的常量引用陣列

template<typename E >
	operator Array< E > & (void)
	轉換操作符，將 PArray 轉換為指定類型的陣列引用

virtual int	length (void) const override
	取得陣列長度

virtual int	indexOf (void *&element) const override
	搜尋元素位置

virtual void *&	get (int index) const override
	取得指定索引的元素

virtual bool	set (void *const &e, int index) override
	設置指定索引的元素值

virtual int	elementSize (void) const override
	取得元素大小

公開方法(Public Methods) 繼承自 ufm::lang::Memory
	Memory (const Data &data)
	以資料物件建構 Memory 實例

	Memory (const void *pointer, int length)
	以 const 指標與長度建構 Memory 實例

	Memory (void *pointer, int length)
	以指標與長度建構 Memory 實例

	Memory (void *pointer, uint32 length)
	以 const 指標與長度建構 Memory 實例

	Memory (int length)
	以指定長度建構 Memory 實例

	Memory (Memory &other) noexcept
	淺層複製構造器（移動語意）

	Memory (Memory &&other) noexcept
	移動構造器

virtual	~Memory (void) override
	釋放記憶體資源並執行清理

bool	isHeapMemory (void) const
	判斷是否為堆記憶體

bool	resize (int size)
	調整記憶體大小

公開方法(Public Methods) 繼承自 ufm::lang::Data
	Data (void)
	建立新的 Data 物件

	Data (const char *pointer)
	根據字元指標建立 Data 物件

	Data (const void *pointer, int length)
	使用常數 void 指標及長度建立 Data 物件

	Data (void *pointer, int length)
	使用可修改 void 指標及長度建立 Data 物件

	Data (const Data &other)
	複製建構子，根據現有 Data 物件建立新物件

Data &	operator= (const Data &other)=default
	賦值運算子，將另一個 Data 物件的內容複製到當前物件

virtual int	copy (const void *source, int shift, int start, int length) override
	將來源資料複製到 Data 物件中

bool	isReadOnly (void) const
	檢查資料是否唯讀

int	length (void) const
	取得資料有效長度

uint32	lengthUnsigned (void) const
	取得資料無符號長度

int	wipe (void)
	以預設值 0x00 擦除所有資料

int	wipe (uint8 value)
	以指定值擦除所有資料

int	wipe (uint8 value, int length)
	從起始處以指定長度使用指定值擦除資料

int	popArray (int start, int length)
	從指定起始位置取出陣列資料（不儲存結果）

int	popArray (void *source, int start, int length)
	從指定起始位置取出陣列資料並儲存至指定來源

int	insertArray (const void *source, int start, int length)
	將來源陣列資料插入到 Data 物件中

bool	inRange (void *address) const
	檢查指定位址是否落在資料範圍內

int	wipe (uint8 value, int start, int length)
	從指定起始位置以指定長度擦除資料

ufm::lang::Data	subData (int beginIndex, int length) const
	取得子資料區段

int	insertArray (const void *source, int shift, int start, int length)
	將來源陣列資料依指定位移複製至 Data 物件中

int	popArray (void *source, int shift, int start, int length)
	從 Data 物件中依指定位移取出陣列資料

virtual int	hashdata (void) const
	計算資料雜湊值

int	copy (const void *source, int length)
	複製來源資料至內部資料區塊，使用預設偏移參數

int	copy (const void *source, int offset, int length)
	複製來源資料至內部資料區塊，可指定目標位址偏移

公開方法(Public Methods) 繼承自 ufm::lang::Pointer
	Pointer (void)
	儲存指標的內部成員變數

	Pointer (const void *pointer)
	建立一個 Pointer 物件，並以 const void* 初始化內部指標

	Pointer (void *pointer)
	建立一個 Pointer 物件，並以 void* 初始化內部指標

	Pointer (uint32 pointer)
	建立一個 Pointer 物件，並以 32 位元整數表示的位址初始化

	Pointer (const Pointer &other)
	複製建構子，從另一個 Pointer 物件複製內部位址

	operator void * (void)
	隱式轉換為 void*，可直接取得內部指標

	operator const char * (void)
	隱式轉換為 const char*，適用於字串存取

bool	operator== (const void *pointer)
	比較內部指標與外部指標是否相同

bool	operator== (const Pointer &pointer)
	比較兩個 Pointer 物件的內部指標是否相同

template<typename E >
	operator E* (void)
	模板運算子，將內部指標轉換為指定型態的指標（非 const 版本）

template<typename E >
	operator E* (void) const
	模板運算子，將內部指標轉換為指定型態的指標（const 版本）

Pointer &	operator= (const Pointer &other)=default
	賦值運算子，將另一個 Pointer 物件的內部指標複製到當前物件

int	copyTo (void *destination, int length) const
	複製內部資料至目標記憶體區塊

int	copyTo (void *destination, int start, int length) const
	複製內部資料至目標記憶體區塊，可指定來源起始位置

bool	compairStrings (const char *str) const
	比較內部資料與傳入字串是否相同（從起始位置開始比較）

bool	compairStrings (const char *str, int start) const
	比較內部資料與傳入字串是否相同，可指定來源資料起始位置

bool	compair (const void *source, int length) const
	比較內部資料與來源資料是否相等（從起始位置開始比較）

bool	compair (const void *source, int start, int length) const
	比較內部資料與來源資料是否相等，可指定來源資料的起始偏移

int	indexOf (char ch, int start, int limit) const
	在內部資料中查找指定字元 ch，回傳該字元的偏移位置

int	indexOfStrings (const char *str, int limit) const
	在內部資料中查找指定字串，回傳該字串的偏移位置（使用預設起始位置）

int	indexOfStrings (const char *str, int start, int limit) const
	在內部資料中查找指定字串，回傳該字串的偏移位置

int	copy (const void *source, int length)
	複製來源資料至內部資料區塊，使用預設偏移參數

int	copy (const void *source, int offset, int length)
	複製來源資料至內部資料區塊，可指定目標位址偏移

char	getByte (int shift) const
	取得指定偏移處的 byte 值

int	getInteger (int shift) const
	取得指定偏移處的整數值

short	getShort (int shift) const
	取得指定偏移處的 short 值

Pointer	getPointer (int offset) const
	以指定偏移建立新的 Pointer 物件

uint32	getAddress (void) const
	取得內部記憶體位址的整數表示

bool	isAlignment32Bit (void)
	檢查內部位址是否 32 位元對齊

bool	isAlignment64Bit (void)
	檢查內部位址是否 64 位元對齊

bool	isNull (void) const
	檢查內部指標是否為空

template<typename E = void*>
E *	pointer (void) const
	模板方法，取得內部指標並轉換為指定型態（不指定偏移）

template<typename E = void*>
E *	pointer (int offset) const
	模板方法，取得內部指標並轉換為指定型態（指定偏移）

template<typename E = void*>
E *	pointer (uint32 offset) const
	模板方法，取得內部指標並轉換為指定型態（指定偏移，使用 uint32 參數）

virtual int	copyTo (void *destination, int offset, int destinationOffset, int length) const
	將內部資料複製到目標記憶體區塊，可指定來源與目標的起始偏移

virtual bool	compair (const void *source, int offset, int sourceOffset, int length) const
	比較內部資料與來源資料是否相等，可指定各自的起始偏移與比較長度

virtual int	indexOfData (const void *destination, int destinationLen, int start=0, int limit=0) const
	尋找指定 pattern 是否存在於內部資料中，並返回第一個符合條件的偏移量

virtual void	move (int head, int offset, int length)
	將來源位置的資料以中間緩衝區方式移動至新的位置

公開方法(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
	虛擬析構函式

公開方法(Public Methods) 繼承自 ufm::lang::NonCopyable
	NonCopyable (void)=default
	建構一個新的 NonCopyable 物件

	NonCopyable (const NonCopyable &other)=delete
	禁止複製建構子

NonCopyable &	operator= (const NonCopyable &other)=delete
	禁止複製賦值運算子

公開屬性
int const	vLength
	陣列長度

int const	vElementSize
	每個元素的大小（位元組）

額外的繼承成員
靜態公開方法(Static Public Methods) 繼承自 ufm::lang::Memory
static ufm::lang::Memory	nullMemory (void)
	取得一個空的 Memory 物件

靜態公開方法(Static Public Methods) 繼承自 ufm::lang::Data
static void	wipe (void *pointer, uint8 value, int length)
	使用指定值擦除記憶體區塊

static void	wipe (void *pointer, int length)
	根據指定長度擦除記憶體區塊

詳細描述

指標陣列類別

此類別實現 Array<void*> 介面，用於存儲和管理任意指標類型元素的陣列。 PArray 提供內存管理功能，可以基於給定的內存區域或者自動分配所需內存。

自: 1.0.0

建構子與解構子說明文件

◆ PArray() [1/4]

ufm::util::PArray::PArray	(	ufm::lang::Memory	memory,
		int	elementSize )

noexcept

使用現有內存構造指標陣列

參數

memory	用於存儲陣列元素的內存區域
elementSize	每個元素的大小（位元組）

◆ PArray() [2/4]

ufm::util::PArray::PArray	(	int	length,
		int	elementSize )

inline

構造指定長度和元素大小的指標陣列

自動分配所需的內存空間來存儲陣列元素

參數

length	陣列長度
elementSize	每個元素的大小（位元組）

◆ PArray() [3/4]

ufm::util::PArray::PArray ( PArray && other )

defaultnoexcept

移動構造函數

從另一個 PArray 物件移動資源，釋放原有內存並接管其資源。

參數

other 要移動的 PArray 物件

◆ PArray() [4/4]

ufm::util::PArray::PArray ( PArray & other )

defaultnoexcept

淺層複製構造函數

從另一個 PArray 物件複製資源，僅複製指標，不分配新的內存。

參數

other 要複製的 PArray 物件

◆ ~PArray()

virtual ufm::util::PArray::~PArray ( void )

overridevirtual

解構函數

釋放陣列所佔用的資源

函式成員說明文件

◆ elementSize()

virtual int ufm::util::PArray::elementSize ( void ) const

overridevirtual

取得元素大小

返回陣列中單個元素的尺寸大小（以位元組為單位）。

傳回值: int 元素的尺寸大小

實作 ufm::util::Array< void * >.

◆ get()

virtual void *& ufm::util::PArray::get ( int index ) const

overridevirtual

取得指定索引的元素

返回陣列中指定位置的元素的參考。

參數

index 要獲取元素的索引位置

傳回值: E& 指定索引的元素參考

註: 如果索引超出陣列範圍，具體行為由實作類定義

實作 ufm::util::Array< void * >.

◆ indexOf()

virtual int ufm::util::PArray::indexOf ( void *& element ) const

overridevirtual

搜尋元素位置

返回此陣列中指定元素的第一次出現的索引，如果此陣列不包含該元素，則返回-1。

參數

element 要搜尋的元素

傳回值: int 此陣列中指定元素的首次出現的索引，如果不存在則為-1

實作 ufm::util::Array< void * >.

◆ length()

virtual int ufm::util::PArray::length ( void ) const

overridevirtual

取得陣列長度

返回此陣列的元素數量。

傳回值: int 陣列中元素的數量

實作 ufm::util::Array< void * >.

◆ operator Array< E > &()

template<typename E >

ufm::util::PArray::operator Array< E > & ( void )

inline

轉換操作符，將 PArray 轉換為指定類型的陣列引用

樣版參數

E 目標陣列元素類型

傳回值: 轉換後的陣列引用

◆ operator const Array< E > &()

template<typename E >

ufm::util::PArray::operator const Array< E > & ( void ) const

inline

轉換操作符，將 PArray 轉換為指定類型的常量引用陣列

樣版參數

E 目標陣列元素類型

傳回值: 轉換後的常量陣列引用

◆ set()

virtual bool ufm::util::PArray::set	(	void *const &	e,
		int	index )

overridevirtual

設置指定索引的元素值

將陣列中指定位置的元素值設置為新值。

參數

e	新的元素值
index	要設置元素的索引位置

傳回值: bool 操作是否成功

註: 如果索引超出陣列範圍，通常會返回 false

實作 ufm::util::Array< void * >.

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

PArray.h

公開方法(Public Methods)

公開屬性

額外的繼承成員

詳細描述

建構子與解構子說明文件

◆ PArray() [1/4]

◆ PArray() [2/4]

◆ PArray() [3/4]

◆ PArray() [4/4]

◆ ~PArray()

函式成員說明文件

◆ elementSize()

◆ get()

◆ indexOf()

◆ length()

◆ operator Array< E > &()

◆ operator const Array< E > &()

◆ set()