High-Level Operations

Macros
#define	stDestroy(type, pobj, ...)    _stDestroy(stFullType(type), stArgPtr(type, pobj), opt_flags(__VA_ARGS__))
#define	stCmp(type, obj1, obj2, ...)    _stCmp(stFullType(type), stArg(type, obj1), stArg(type, obj2), opt_flags(__VA_ARGS__))
#define	stCopy(type, pdest, src, ...)    _stCopy(stFullType(type), stArgPtr(type, pdest), stArg(type, src), opt_flags(__VA_ARGS__))
#define	stHash(type, obj, ...)   _stHash(stFullType(type), stArg(type, obj), opt_flags(__VA_ARGS__))
#define	stConvert(desttype, pdest, srctype, src, ...)

Detailed Description

Type-safe wrappers for common operations on typed values. These macros expand to the appropriate function calls with compile-time type checking.

Macro Definition Documentation

stCmp

#define stCmp	(		type,
			obj1,
			obj2,
			...
	)		_stCmp(stFullType(type), stArg(type, obj1), stArg(type, obj2), opt_flags(__VA_ARGS__))

intptr stCmp(type, obj1, obj2, [flags])

Compare two typed values for ordering.

Parameters

type	Type name
obj1	First value
obj2	Second value
...	(flags) Optional operation flags: ST_CaseInsensitive: Case-insensitive comparison ST_Equality: Only check equality, not ordering

Returns

Negative if obj1 < obj2, zero if equal, positive if obj1 > obj2

Example:

if (stCmp(string, s1, s2) == 0) {
    // strings are equal
}

Definition at line 1408 of file stype.h.

stConvert

#define stConvert	(		desttype,
			pdest,
			srctype,
			src,
			...
	)

Value:

    _stConvert(stType(desttype),                      \
               stArgPtr(desttype, pdest),             \
               stFullType(srctype),                   \
               stArg(srctype, src),                   \
               opt_flags(__VA_ARGS__))

bool stConvert(desttype, pdest, srctype, src, [flags])

Convert a value from one type to another.

WARNING: Overwrites destination without destroying existing value.

Parameters

desttype	Destination type name
pdest	Pointer to destination
srctype	Source type name
src	Source value
...	(flags) Conversion flags: ST_Overflow: Allow overflow without error ST_Lossless: Fail if conversion loses precision

Returns

true if conversion succeeded

Example:

float32 f;
if (stConvert(float32, &f, int32, 42)) {
    // f now contains 42.0
}

Definition at line 1517 of file stype.h.

stCopy

#define stCopy	(		type,
			pdest,
			src,
			...
	)		_stCopy(stFullType(type), stArgPtr(type, pdest), stArg(type, src), opt_flags(__VA_ARGS__))

void stCopy(type, pdest, src, [flags])

Copy a typed value from source to destination.

WARNING: Overwrites destination without destroying existing value. For managed types, the destination must be uninitialized or already destroyed.

Parameters

type	Type name
pdest	Pointer to destination
src	Source value
...	(flags) Optional operation flags

Example:

int32 dest;  // uninitialized
stCopy(int32, &dest, 42);

Definition at line 1445 of file stype.h.

stDestroy

#define stDestroy	(		type,
			pobj,
			...
	)		_stDestroy(stFullType(type), stArgPtr(type, pobj), opt_flags(__VA_ARGS__))

void stDestroy(type, pobj, [flags])

Destroy a typed value, releasing any resources it owns.

Calls the appropriate destructor based on the type. For reference-counted types, decrements the reference count. For containers, recursively destroys elements. For primitives, this is typically a no-op.

Parameters

type	Type name (e.g., string, int32, object)
pobj	Pointer to the value to destroy
...	(flags) Optional operation flags

Example:

string s = _S"hello";
stDestroy(string, &s);  // s is now invalid

Definition at line 1377 of file stype.h.

stHash

#define stHash	(		type,
			obj,
			...
	)		_stHash(stFullType(type), stArg(type, obj), opt_flags(__VA_ARGS__))

uint32 stHash(type, obj, [flags])

Compute a hash value for a typed value.

Parameters

type	Type name
obj	Value to hash
...	(flags) Optional operation flags: ST_CaseInsensitive: Case-insensitive hash

Returns

32-bit hash value

Example:

uint32 h = stHash(string, s);

Definition at line 1481 of file stype.h.