Main central library. More...

Detailed Description

Main central library.

AUI's core central library without graphical components used by other modules. Adds these features to C++:

Modules
	Signal-slot
	Signal-slots is an object messaging mechanism that creates seamless relations between objects.

	Useful macros
	A set of functionality that introduces non-standard syntax which seems like the C++ features.

	IO streams
	Input-output streams.

Classes
class	AAbstractSignal
	Base class for signal. More...

struct	ABoxFields
	Represents a rectangle fields. Useful for margin and padding around AViews. More...

class	AByteBuffer
	std::vector-like growing array for byte storage. More...

class	AByteBufferView
	Acts like std::string_view but for AByteBuffer. More...

class	AChar
	Represents a single 32-bit char. More...

class	AColor
	Represents a 4-component floating point color. More...

class	ADeque< StoredType, Allocator >
	A std::deque with AUI extensions. More...

class	AException
	Abstract AUI exception. More...

class	AFatalException
	An exception that thrown when non-c++ unhandled error occurs (i.e. access violation). More...

class	ABaseMap< KeyType, ValueType, Parent >
	Base class for maps with AUI extensions. More...

class	AMap< KeyType, ValueType, Predicate, Allocator >
	A std::map with AUI extensions. More...

class	AUnorderedMap< KeyType, ValueType, Hasher, Comparer, Allocator >
	A std::unordered_map with AUI extensions. More...

class	AObject
	A base object class. More...

class	AQueue< StoredType >
	A std::queue with AUI extensions. More...

class	ASet< KeyType, Comparator, Allocator >
	A std::set with AUI extensions. More...

class	ASmallVector< StoredType, StaticVectorSize, Allocator >
	Vector-like container consisting of few elements on stack and switches to dynamic allocation vector if needed. More...

class	AStaticVector< StoredType, MaxSize >
	Vector-like container up to maxSize elements inplace. More...

class	AString
	Represents a Unicode character string. More...

class	AStringVector
	An AVector with string-related functions. More...

class	ATimer
	Async timer. More...

class	AUuid
	Implements universally unique identifier (UUID) More...

class	AVector< StoredType, Allocator >
	A std::vector with AUI extensions. More...

class	IStringable
	Object that can be converted to string. More...

struct	ALineSegment< T >
	2D line segment. More...

struct	ARect< T >
	Axis aligned 2D rectangle. More...

class	AI18n
	Provides i18n (internationalization) support. More...

class	ALanguageCode
	Represents a language code in ISO 639-1, for example, en-US or ru-RU. More...

class	ADynamicPipe
	An asynchronous buffer that converts an IInputStream to IOutputStream (and otherwise). More...

class	APipe
	A thread safe buffer that converts an IInputStream to IOutputStream (and otherwise). More...

class	ALogger
	A logger class. More...

class	APerformanceFrame
	Defines beginning and ending of window frame by RAII. More...

class	APerformanceSection
	Defines performance profiling named (and colored) span within RAII range. More...

class	AStacktrace
	Stacktrace consisting of a collection of stack function frames. More...

class	AEnumerate< enum_t >
	Enum trait to transform enum to name, name to enum, list all enums and vise versa. More...

class	AAsyncHolder
	Holds a set of futures keeping them valid. More...

class	AComplexFutureOperation< T >
	Helper class to construct AFuture values. More...

class	AConditionVariable
	Represents a condition variable. More...

class	ACutoffSignal
	One-shot event communication. More...

class	AEventLoop
	Default event loop implementation. More...

class	AFuture< T >
	Represents a value that will be available at some point in the future. More...

struct	AMutex
	Basic syscall-based synchronization primitive. More...

struct	ARecursiveMutex
	Like AMutex but can handle multiple locks for one thread (recursive). More...

struct	ASharedMutex
	Like AMutex but has shared lock type (in addition to basic lock which is unique locking) implementing RW synchronization. More...

class	AMutexWrapper< T >
	Wraps the object with mutex, providing thread-safety layer and a runtime check. More...

class	AAbstractThread
	Represents an abstract thread. Not all threads are created through AThread - these are interfaced with AAbstractThread. More...

class	AThread
	Represents a user-defined thread. More...

class	AFutureSet< T >
	Manages multiple futures. More...

class	AUrl
	Uniform Resource Locator implementation. More...

class	ACleanup
	Cleanup helper. More...

class	ACommandLineArgs
	Simple command line arguments parser. More...

class	AFieldObservable< T >
	Stores a value and observes it's changes, notifying observers. More...

class	AFieldSignalEmitter< T >
	Stores a value and observes it's changes, emitting a signal. More...

class	AFunctionQueue
	Thread-safe implementation of function queue. More...

struct	AImplementationManager< Base, Implementations >
	Helps with picking implementation specified in template arguments which does not throw an exception in tryAllUntilSuccess. More...

class	AMessageQueue< Mutex, Args >
	Universal thread-safe message (callback) queue implementation. More...

class	AScheduler
	Basic scheduler used for timers. More...

class	ASharedRaiiHelper
	Shared completion marker for multithreaded callback-based future handling. More...

struct	AStringLiteral< chars >
	Compile-time string literal. More...

class	AWatchdog
	Watchdog helper class. More...

Typedefs
template<typename T >
using	APoint2D = glm::vec< 2, T >
	2D point.

Functions
	AUI_ENUM_FLAG (ASide)
	Describes sides of a 2D rectangle. More...

API_AUI_CORE void	aui::importPlugin (const AString &name)
	imports plugin by it's name. More...

API_AUI_CORE void	aui::importPluginPath (const APath &path)
	imports plugin by it's path. More...

	AUI_ENUM_FLAG (ASubProcessExecutionFlags)
	Flag enum for AChildProcess::run. More...

API_AUI_CORE const ACommandLineArgs &	aui::args () noexcept

template<typename Container >
void	aui::container::remove_at (Container &c, size_t index) noexcept
	Removes element at the specified index. More...

template<typename Container >
size_t	aui::container::index_of (const Container &c, const typename Container::const_reference value) noexcept
	Finds the index of the first occurrence of the value. More...

template<typename Container >
bool	aui::container::contains (const Container &c, const typename Container::const_reference value) noexcept

template<typename Iterator >
bool	aui::container::contains (Iterator begin, Iterator end, const typename std::iterator_traits< Iterator >::value_type &value) noexcept

template<typename Container >
void	aui::container::remove_all (Container &container, typename Container::const_reference value) noexcept
	Removes all occurrences of `value`.

template<typename Container >
AOptional< std::size_t >	aui::container::remove_first (Container &container, typename Container::const_reference value) noexcept
	Removes first occurrence of `value`. More...

template<typename Iterator , typename UnaryOperation >
auto	aui::container::to_map (Iterator begin, Iterator end, UnaryOperation &&transformer)
	Transforms sequence to map.

template<typename Iterator , typename UnaryOperation >
auto	aui::container::to_unordered_map (Iterator begin, Iterator end, UnaryOperation &&transformer)
	Transforms sequence to unordered_map.

template<typename LContainer , typename RContainer >
bool	aui::container::is_subset (LContainer &l, RContainer &r) noexcept

AStringFormatHelper	operator""_format (const char *str, size_t len)
	String literal format caller (see example) (https://fmt.dev/latest/syntax.html) More...

Variables
template<typename enum_t >
constexpr auto	aui::enumerate::ALL_VALUES
	constexpr std::array of all possible enum values is the order they've been passed to AUI_ENUM_VALUES. More...

Function Documentation

◆ args()

const ACommandLineArgs & aui::args ( )

noexcept

Returns: Arguments passed to program.

Examples: /github/workspace/aui.json/src/AUI/Json/Conversion.h.

◆ AUI_ENUM_FLAG() [1/2]

AUI_ENUM_FLAG ( ASide )

Describes sides of a 2D rectangle.

See also: ASides

Examples: /github/workspace/aui.core/src/AUI/IO/APath.h, and /github/workspace/aui.json/src/AUI/Json/Conversion.h.

◆ AUI_ENUM_FLAG() [2/2]

AUI_ENUM_FLAG ( ASubProcessExecutionFlags )

Flag enum for AChildProcess::run.

Merges stdin and stdout streams in a child process

If set, child and parent processes have the same stdout stream

If set, child and parent processes have the same stderr stream

◆ contains() [1/2]

template<typename Container >

bool aui::container::contains	(	const Container &	c,
		const typename Container::const_reference	value
	)

noexcept

Returns: true if container contains an element, false otherwise.

Examples: /github/workspace/aui.json/src/AUI/Json/Conversion.h.

◆ contains() [2/2]

template<typename Iterator >

bool aui::container::contains	(	Iterator	begin,
		Iterator	end,
		const typename std::iterator_traits< Iterator >::value_type &	value
	)

noexcept

Returns: true if container contains an element, false otherwise.

◆ importPlugin()

void aui::importPlugin ( const AString & name )

imports plugin by it's name.

Parameters

name	plugin name

◆ importPluginPath()

void aui::importPluginPath ( const APath & path )

imports plugin by it's path.

Parameters

path	plugin path

◆ index_of()

template<typename Container >

size_t aui::container::index_of	(	const Container &	c,
		const typename Container::const_reference	value
	)

noexcept

Finds the index of the first occurrence of the value.

Parameters

value element to find.

Returns: index of the specified element. If element is not found, -1 is returned.

◆ is_subset()

template<typename LContainer , typename RContainer >

bool aui::container::is_subset	(	LContainer &	l,
		RContainer &	r
	)

noexcept

Returns: true if r container is a subset of l container, false otherwise.

◆ operator""_format()

AStringFormatHelper operator""_format	(	const char *	str,
		size_t	len
	)

inline

String literal format caller (see example) (https://fmt.dev/latest/syntax.html)

"Hello {}!"_format("world") // -> "Hello world!"

"test {:.2}"_format(1.2f) // -> "test 1.2"

◆ remove_at()

template<typename Container >

void aui::container::remove_at	(	Container &	c,
		size_t	index
	)

noexcept

Removes element at the specified index.

Sneaky assertions: index points to the existing element.

Parameters

index index of the element.

◆ remove_first()

template<typename Container >

AOptional< std::size_t > aui::container::remove_first	(	Container &	container,
		typename Container::const_reference	value
	)

noexcept

Removes first occurrence of value.

Returns: If the item is removed, it's index returned.

Variable Documentation

◆ ALL_VALUES

template<typename enum_t >

constexpr auto aui::enumerate::ALL_VALUES

inlineconstexpr

Initial value:

= []<enum_t... values>(typename AEnumerate<enum_t>::template Values<values...>) {
        constexpr enum_t ITEMS[] = {values...};
        return std::to_array(ITEMS);
    }(AEnumerateAllValues<enum_t>::get())

constexpr std::array of all possible enum values is the order they've been passed to AUI_ENUM_VALUES.

See also: AUI_ENUM_VALUES

Collaboration diagram for aui::core:

Detailed Description

Modules

Classes

Typedefs

Functions

Variables

Function Documentation

◆ args()

◆ AUI_ENUM_FLAG() [1/2]

◆ AUI_ENUM_FLAG() [2/2]

◆ contains() [1/2]

◆ contains() [2/2]

◆ importPlugin()

◆ importPluginPath()

◆ index_of()

◆ is_subset()

◆ operator""_format()

◆ remove_at()

◆ remove_first()

Variable Documentation

◆ ALL_VALUES