ACSUtils Wiki

An ACS library for ZDoom-based ports

User Tools

Site Tools

Trace: • FIXED_MAX • GetCVarFixed • CursorDeltaY • GDCC • Multiple return values • StrIsXDigit • StrFind • StrIsAlNum • Clientside/serverside detection
multiple_return_values

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
multiple_return_values [2019/04/19 18:17] – korshunmultiple_return_values [2019/04/21 21:32] (current) – korshun
Line 1: Line 1:
-====== Multiple return values convention ======+====== Multiple return values ======
  
-Some ACSUtils functions return multiple values (e.g. [[math#vector_math|vector math functions]]). ACS doesn't support returning multiple values from a function.+Some ACSUtils functions return multiple values (e.g. [[math#vector_math|vector math functions]], but also some non-math functions). ACS doesn't support returning multiple values from a function.
  
 ACSUtils uses a convention to fake returning multiple values from a function. The convention is as follows: there are 8 global variables with names ''r1'' through ''r8''. If a function returns multiple values, it actually returns no value and writes the first "returned" value to ''r1'', the second one to ''r2'', and so on. ACSUtils uses a convention to fake returning multiple values from a function. The convention is as follows: there are 8 global variables with names ''r1'' through ''r8''. If a function returns multiple values, it actually returns no value and writes the first "returned" value to ''r1'', the second one to ''r2'', and so on.
  
-Here's an example, RotateVector returns X and Y:+Here's an example, ''RotateVector'' returns X and Y:
  
 <code> <code>
Line 32: Line 32:
 </code> </code>
 </note> </note>
 +
 +<note important>Another shortcoming is that ''r1''..''r8'' are declared ''raw'' in BCC to be able to accomodate any type of return value, and thus bypass [[strict typing]], even if it's enabled.
 +
 +<code>
 +ParseFixed("1.0", 10);
 +int error = r1;
 +int result = r2; // no compiler error, despite assigning a fixed to int
 +</code>
 +
 +</note>
 +
 +But overwriting argument variables immediately after calling the function is valid:
 +<code>
 +RotateVector(x, y, angle);
 +x = r1;
 +y = r2;
 +</code>
 +
 +An example of a function returning three values:
 +<code>
 +normalize3d(x, y, z);
 +int newX = r1;
 +int newY = r2;
 +int newZ = r3;
 +</code>
  
multiple_return_values.1555697854.txt.gz · Last modified: by korshun

Page Tools

Flag Counter