DOKK / manpages / debian 13 / libzycore-doc / Status.h.3.en
include/Zycore/Status.h(3) Library Functions Manual include/Zycore/Status.h(3)

include/Zycore/Status.h

#include <Zycore/Types.h>


#define ZYAN_MAKE_STATUS(error, module, code) (ZyanStatus)((((error) & 0x01u) << 31u) | (((module) & 0x7FFu) << 20u) | ((code) & 0xFFFFFu))
#define ZYAN_SUCCESS(status) (!((status) & 0x80000000u))
#define ZYAN_FAILED(status) ((status) & 0x80000000u)
#define ZYAN_CHECK(status)
#define ZYAN_STATUS_MODULE(status) (((status) >> 20) & 0x7FFu)
#define ZYAN_STATUS_CODE(status) ((status) & 0xFFFFFu)
#define ZYAN_MODULE_ZYCORE 0x001u
#define ZYAN_MODULE_ARGPARSE 0x003u
#define ZYAN_MODULE_USER 0x3FFu
#define ZYAN_STATUS_SUCCESS ZYAN_MAKE_STATUS(0u, ZYAN_MODULE_ZYCORE, 0x00u)
#define ZYAN_STATUS_FAILED ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x01u)
#define ZYAN_STATUS_TRUE ZYAN_MAKE_STATUS(0u, ZYAN_MODULE_ZYCORE, 0x02u)
#define ZYAN_STATUS_FALSE ZYAN_MAKE_STATUS(0u, ZYAN_MODULE_ZYCORE, 0x03u)
#define ZYAN_STATUS_INVALID_ARGUMENT ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x04u)
#define ZYAN_STATUS_INVALID_OPERATION ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x05u)
#define ZYAN_STATUS_ACCESS_DENIED ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x06u)
#define ZYAN_STATUS_NOT_FOUND ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x07u)
#define ZYAN_STATUS_OUT_OF_RANGE ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x08u)
#define ZYAN_STATUS_INSUFFICIENT_BUFFER_SIZE ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x09u)
#define ZYAN_STATUS_NOT_ENOUGH_MEMORY ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x0Au)
#define ZYAN_STATUS_BAD_SYSTEMCALL ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x0Bu)
#define ZYAN_STATUS_OUT_OF_RESOURCES ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x0Cu)
#define ZYAN_STATUS_MISSING_DEPENDENCY ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ZYCORE, 0x0Du)
#define ZYAN_STATUS_ARG_NOT_UNDERSTOOD ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ARGPARSE, 0x00u)
#define ZYAN_STATUS_TOO_FEW_ARGS ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ARGPARSE, 0x01u)
#define ZYAN_STATUS_TOO_MANY_ARGS ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ARGPARSE, 0x02u)
#define ZYAN_STATUS_ARG_MISSES_VALUE ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ARGPARSE, 0x03u)
#define ZYAN_STATUS_REQUIRED_ARG_MISSING ZYAN_MAKE_STATUS(1u, ZYAN_MODULE_ARGPARSE, 0x04u)


typedef ZyanU32 ZyanStatus

Status code definitions and check macros.

Value:.PP


do \
{ \
const ZyanStatus status_047620348 = (status); \
if (!ZYAN_SUCCESS(status_047620348)) \
{ \
return status_047620348; \
} \
} while (0)

Checks if a zyan operation was successful and returns with the status-code, if not.

Parameters

status The zyan status-code to check.

Checks if a zyan operation failed.

Parameters

status The zyan status-code to check.

Returns

ZYAN_TRUE, if the operation failed or ZYAN_FALSE, if not.

Defines a zyan status code.

Parameters

error 1, if the status code signals an error or 0, if not.
module The module id.
code The actual code.

Returns

The zyan status code.

The zycore arg-parse submodule id.

The base module id for user-defined status codes.

The zycore generic module id.

Insufficient privileges to perform the requested operation.

An argument that expected a value misses its value.

Argument was not expected.

An unknown error occurred during a system function call.

Returns the code of a zyan status-code.

Parameters

status The zyan status-code.

Returns

The code of the zyan status-code.

The operation failed with an generic error.

The operation completed successfully and returned ZYAN_FALSE.

A buffer passed to a function was too small to complete the requested operation.

An invalid argument was passed to a function.

An attempt was made to perform an invalid operation.

A dependency library was not found or does have an unexpected version number or feature-set.

Returns the module id of a zyan status-code.

Parameters

status The zyan status-code.

Returns

The module id of the zyan status-code.

Insufficient memory to perform the operation.

The requested entity was not found.

An index passed to a function was out of bounds.

The process ran out of resources while performing an operation.

A required argument is missing.

The operation completed successfully.

Too few arguments were provided.

Too many arguments were provided.

The operation completed successfully and returned ZYAN_TRUE.

Checks if a zyan operation was successful.

Parameters

status The zyan status-code to check.

Returns

ZYAN_TRUE, if the operation succeeded or ZYAN_FALSE, if not.

Defines the ZyanStatus data type.

Generated automatically by Doxygen for Zycore from the source code.

Version 1.5.2.0 Zycore