xref: /linux/drivers/gpu/drm/xe/xe_rtp_helpers.h (revision a3a02a52bcfcbcc4a637d4b68bf1bc391c9fad02)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2023 Intel Corporation
4  */
5 
6 #ifndef _XE_RTP_HELPERS_
7 #define _XE_RTP_HELPERS_
8 
9 #ifndef _XE_RTP_INCLUDE_PRIVATE_HELPERS
10 #error "This header is supposed to be included by xe_rtp.h only"
11 #endif
12 
13 #include "xe_args.h"
14 
15 /*
16  * Helper macros - not to be used outside this header.
17  */
18 #define _XE_ESC(...) __VA_ARGS__
19 
20 #define _XE_TUPLE_TAIL(...) (DROP_FIRST_ARG(__VA_ARGS__))
21 
22 #define _XE_RTP_CONCAT(a, b) CONCATENATE(XE_RTP_, CONCATENATE(a, b))
23 
24 #define __XE_RTP_PASTE_SEP_COMMA		,
25 #define __XE_RTP_PASTE_SEP_BITWISE_OR		|
26 
27 /*
28  * XE_RTP_PASTE_FOREACH - Paste XE_RTP_<@prefix_> on each element of the tuple
29  * @args, with the end result separated by @sep_. @sep must be one of the
30  * previously declared macros __XE_RTP_PASTE_SEP_*, or declared with such
31  * prefix.
32  *
33  * Examples:
34  *
35  * 1) XE_RTP_PASTE_FOREACH(TEST_, COMMA, (FOO, BAR))
36  *    expands to:
37  *
38  *	XE_RTP_TEST_FOO , XE_RTP_TEST_BAR
39  *
40  * 2) XE_RTP_PASTE_FOREACH(TEST2_, COMMA, (FOO))
41  *    expands to:
42  *
43  *	XE_RTP_TEST2_FOO
44  *
45  * 3) XE_RTP_PASTE_FOREACH(TEST3, BITWISE_OR, (FOO, BAR))
46  *    expands to:
47  *
48  *	XE_RTP_TEST3_FOO | XE_RTP_TEST3_BAR
49  *
50  * 4) #define __XE_RTP_PASTE_SEP_MY_SEP	BANANA
51  *    XE_RTP_PASTE_FOREACH(TEST_, MY_SEP, (FOO, BAR))
52  *    expands to:
53  *
54  *	XE_RTP_TEST_FOO BANANA XE_RTP_TEST_BAR
55  */
56 #define XE_RTP_PASTE_FOREACH(prefix_, sep_, args_) _XE_RTP_CONCAT(PASTE_, COUNT_ARGS args_)(prefix_, sep_, args_)
57 #define XE_RTP_PASTE_1(prefix_, sep_, args_) _XE_RTP_CONCAT(prefix_, FIRST_ARG args_)
58 #define XE_RTP_PASTE_2(prefix_, sep_, args_) _XE_RTP_CONCAT(prefix_, FIRST_ARG args_) __XE_RTP_PASTE_SEP_ ## sep_ XE_RTP_PASTE_1(prefix_, sep_, _XE_TUPLE_TAIL args_)
59 #define XE_RTP_PASTE_3(prefix_, sep_, args_) _XE_RTP_CONCAT(prefix_, FIRST_ARG args_) __XE_RTP_PASTE_SEP_ ## sep_ XE_RTP_PASTE_2(prefix_, sep_, _XE_TUPLE_TAIL args_)
60 #define XE_RTP_PASTE_4(prefix_, sep_, args_) _XE_RTP_CONCAT(prefix_, FIRST_ARG args_) __XE_RTP_PASTE_SEP_ ## sep_ XE_RTP_PASTE_3(prefix_, sep_, _XE_TUPLE_TAIL args_)
61 #define XE_RTP_PASTE_5(prefix_, sep_, args_) _XE_RTP_CONCAT(prefix_, FIRST_ARG args_) __XE_RTP_PASTE_SEP_ ## sep_ XE_RTP_PASTE_4(prefix_, sep_, _XE_TUPLE_TAIL args_)
62 #define XE_RTP_PASTE_6(prefix_, sep_, args_) _XE_RTP_CONCAT(prefix_, FIRST_ARG args_) __XE_RTP_PASTE_SEP_ ## sep_ XE_RTP_PASTE_5(prefix_, sep_, _XE_TUPLE_TAIL args_)
63 
64 /*
65  * XE_RTP_DROP_CAST - Drop cast to convert a compound statement to a initializer
66  *
67  * Example:
68  *
69  *	#define foo(a_)	((struct foo){ .a = a_ })
70  *	XE_RTP_DROP_CAST(foo(10))
71  *	expands to:
72  *
73  *	{ .a = 10 }
74  */
75 #define XE_RTP_DROP_CAST(...) _XE_ESC(DROP_FIRST_ARG _XE_ESC __VA_ARGS__)
76 
77 #endif
78