annotate foosdk/sdk/libPPUI/win32_op.h @ 1:20d02a178406 default tip

*: check in everything else yay
author Paper <paper@tflc.us>
date Mon, 05 Jan 2026 02:15:46 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
1 #pragma once
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
2
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
3 PFC_NORETURN PFC_NOINLINE void WIN32_OP_FAIL();
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
4 PFC_NORETURN PFC_NOINLINE void WIN32_OP_FAIL_CRITICAL(const char * what);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
5
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
6 #ifdef _DEBUG
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
7 void WIN32_OP_D_FAIL(const wchar_t * _Message, const wchar_t *_File, unsigned _Line);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
8 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
9
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
10 //Throws an exception when (OP) evaluates to false/zero.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
11 #define WIN32_OP(OP) \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
12 { \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
13 SetLastError(NO_ERROR); \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
14 if (!(OP)) WIN32_OP_FAIL(); \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
15 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
16
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
17 // Kills the application with appropriate debug info when (OP) evaluates to false/zero.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
18 #define WIN32_OP_CRITICAL(WHAT, OP) \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
19 { \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
20 SetLastError(NO_ERROR); \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
21 if (!(OP)) WIN32_OP_FAIL_CRITICAL(WHAT); \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
22 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
23
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
24 //WIN32_OP_D() acts like an assert specialized for win32 operations in debug build, ignores the return value / error codes in release build.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
25 //Use WIN32_OP_D() instead of WIN32_OP() on operations that are extremely unlikely to fail, so failure condition checks are performed in the debug build only, to avoid bloating release code with pointless error checks.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
26 #ifdef _DEBUG
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
27 #define WIN32_OP_D(OP) \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
28 { \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
29 SetLastError(NO_ERROR); \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
30 if (!(OP)) WIN32_OP_D_FAIL(PFC_WIDESTRING(#OP), PFC_WIDESTRING(__FILE__), __LINE__); \
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
31 }
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
32
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
33 #else
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
34 #define WIN32_OP_D(OP) (void)( (OP), 0);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
35 #endif
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
36