Ogólne
[Moduł Base]

Komponenty
class	common::Singleton< T >
	Wzorzec projektowy Singleton - klasa bazowa. Więcej...
Wyliczenia
enum	common::ORIENTATION { common::O_NONE, common::O_VERT, common::O_HORIZ }
	Orientacja, czyli ułożenie - pionowa lub pozioma. Więcej...
Funkcje
template<typename T>
bool	common::IsPow2 (T x)
	Zwraca true, jeśli podana liczba jest potęgą dwójki.
uint4	common::log2u (uint4 x)
	Zwraca logarytm dwójkowy z podanej liczby całkowitej bez znaku, tzn numer najstarszego niezerowego bitu.
uint4	common::GetBitMask (uint4 n)
	Zwraca maskę bitową z ustawionymi na jedynkę n najmłodszymi bitami.
template<typename T>
T **	common::new_2d (size_t cx, size_t cy)
	Alokuje nową tablicę dynamiczną 2D.
template<typename T>
void	common::delete_2d (T **a, size_t cx)
	Zwalnia tablicę dynamiczną 2D.
void	common::strcpy0 (tchar *dest, const tstring &src)
	Kopiuje string do char* łącznie ze znakami '\0' (czego nie zapewnia strcpy).
void	common::ZeroMem (void *Data, size_t NumBytes)
	Zeruje pamięć.
void	common::CopyMem (void *Out, const void *In, size_t NumBytes)
	Kopuje pamięć.
bool	common::CompareMem (const void *Data1, const void *Data2, size_t NumBytes)
	Zwraca true, jeśli pamięć jest identyczna.
void	common::FillMem (void *Data, size_t NumBytes, uint1 Byte)
	Wypełnia pamięć podanym bajtem.
template<class Iterator>
void	common::InsertionSort (Iterator b, Iterator e)
	Algorytm jak te z STL - sortowanie przez wstawianie.
template<class Iterator, typename Compare>
void	common::InsertionSort (Iterator b, Iterator e, Compare Comp)
	Algorytm jak te z STL - sortowanie przez wstawianie, z własnym komparatorem.

---

Opis szczegółowy

---

Dokumentacja typów wyliczanych

enum common::ORIENTATION

Orientacja, czyli ułożenie - pionowa lub pozioma.

Wartości wyliczeń:

O_NONE
O_VERT
O_HORIZ

---

Dokumentacja funkcji

bool common::CompareMem	(	const void *	Data1,
		const void *	Data2,
		size_t	NumBytes
	)

Zwraca true, jeśli pamięć jest identyczna.

void common::CopyMem	(	void *	Out,
		const void *	In,
		size_t	NumBytes
	)

Kopuje pamięć.

template<typename T>

void common::delete_2d	(	T **	a,
		size_t	cx
	)			[inline]

Zwalnia tablicę dynamiczną 2D.

void common::FillMem	(	void *	Data,
		size_t	NumBytes,
		uint1	Byte
	)

Wypełnia pamięć podanym bajtem.

uint4 common::GetBitMask

(

uint4

n

)

Zwraca maskę bitową z ustawionymi na jedynkę n najmłodszymi bitami.

n musi być z z zakresu 0..32.

template<class Iterator, typename Compare>

void common::InsertionSort	(	Iterator	b,
		Iterator	e,
		Compare	Comp
	)			[inline]

Algorytm jak te z STL - sortowanie przez wstawianie, z własnym komparatorem.

template<class Iterator>

void common::InsertionSort	(	Iterator	b,
		Iterator	e
	)			[inline]

Algorytm jak te z STL - sortowanie przez wstawianie.

template<typename T>

bool common::IsPow2

(

T

x

)

[inline]

Zwraca true, jeśli podana liczba jest potęgą dwójki.

T musi być liczbą całkowitą bez znaku - uint1, uint2, uint4, uint8, albo liczbą ze znakiem ale na pewno dodatnią.

uint4 common::log2u

(

uint4

x

)

Zwraca logarytm dwójkowy z podanej liczby całkowitej bez znaku, tzn numer najstarszego niezerowego bitu.

Innymi słowy, o ile bitów przesunąć w lewo jedynkę żeby otrzymać najstarszą jedynkę podanej liczby. Wartość 0 zwraca dla liczb 0 i 1.

template<typename T>

T** common::new_2d	(	size_t	cx,
		size_t	cy
	)			[inline]

Alokuje nową tablicę dynamiczną 2D.

void common::strcpy0	(	tchar *	dest,
		const tstring &	src
	)			[inline]

Kopiuje string do char* łącznie ze znakami '\0' (czego nie zapewnia strcpy).

• Na końcu dołącza '\0'.
• Oczywiście dest musi być dostatecznie pojemne.

void common::ZeroMem	(	void *	Data,
		size_t	NumBytes
	)

Zeruje pamięć.