Differences

This shows you the differences between two versions of the page.

--- functions:cond [2017/03/15 10:45] – created korshun
+++ functions:cond [2017/06/15 15:34] (current) – korshun
@@ Line 1: / Line 1: @@
-====== swap ======
+====== cond ======
-{{tag>math}}
+{{tag>math acs_enhancements}}
-''any, any swap(any a, any b)''
+''any cond(bool condition, any a, any b)''
 [[:types|any - any type (int, fixed or str)]]
-[[:Multiple_return_values|This function returns multiple values.]]
 ===== Description =====
-Returns two variables in a swapped order. This function exists to improve readability.
+If condition is true, returns a. Otherwise, returns b.
+It simulates the ''?:'' operator from C.
+<note important>Both a and b are evaluated. Do not do this:
+<code>
+int y = cond(x, DoSomething(), DoSomethingElse())
+</code>
+as both ''DoSomething()'' and ''DoSomethingElse()'' will be called.
+If you are using [[:BCC]] or [[:GDCC]], it is recommended to use the real ''?:'' operator instead, which is not subject to this problem.
+</note>
 ===== Examples =====
-Without swap():
 <code>
-int tmp = x;
+cond(true, A, B) -> A
-x = y;
+cond(false, A, B) -> B
-y = tmp;
+</code>
+Without cond():
+<code>
+int color = CR_RED;
+if (PlayerTeam() == TEAM_BLUE)
+    color = CR_BLUE;
+DrawSomething(color);
 </code>
-With swap():
+With cond():
 <code>
-swap(x, y);
+DrawSomething(cond(PlayerTeam() == TEAM_BLUE, CR_BLUE, CR_RED));
-x = r1;
-y = r2;
 </code>

ACSUtils Wiki