Difference between revisions of "Macro Constants"

From GiderosMobile
m (Text replacement - "</source>" to "</syntaxhighlight>")
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
'''Supported platforms:''' android, ios, mac, pc<br/>
+
<!-- GIDEROSOBJ:Macro Constants -->
 +
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]]<br/>
 
'''Available since:''' Gideros 2017.10<br/>
 
'''Available since:''' Gideros 2017.10<br/>
 +
 
=== Description ===
 
=== Description ===
<translate><br />
+
Another great Gideros feature is macros. Currently Lua has no constants, you just have to define variables like ''pi=3.14159''.
Macro Constants can be used for string and numeric constants.<br /><br />
 
  
Just use @ rather than = when defining the macro.<br /><br />
+
Now you can define symbolic constants like this ''pi @ 3.14159'' and then simply use ''pi'' in the code as normal. When the Lua code is byte compiled, the constants are replaced with their literal values which saves CPU time.
 +
 
 +
Macro Constants can be used for string and numeric constants. Just use @ rather than = when defining the macro.
 +
 
 +
You can use any of these delimiters after @ but they must be used in pairs. Numbers are auto-detected.
 +
 
 +
'''\`~ ! # $ % ^ & * / + = |'''
  
You can use any of these delimiters after @ but they must be used in pairs.  Numbers are auto-detected.<br />
 
\`~ ! # $ % ^ & * / + = |<br /></translate>
 
 
=== Examples ===
 
=== Examples ===
'''Simple examples'''<br/>
+
'''Simple examples'''
<source lang="lua">  
+
<syntaxhighlight lang="lua">
pi@3.14159265358979324
+
num1 @ &2^0&
num1 @ -100.54
+
num2 @ &2^1&
num2 @ 232
+
num3 @ &num1 + num2&
num3 @ 444.10
+
 
 +
pi @ 3.14159265358979324
 +
num4 @ -100.54
 +
num5 @ 232
 +
num6 @ 444.10
 
str1 @ 'hello'
 
str1 @ 'hello'
 
str2 @ "world"
 
str2 @ "world"
Line 22: Line 31:
 
Hello,
 
Hello,
 
world!
 
world!
]]</source>
+
]]
'''Commenting out the print command'''<br/>
+
</syntaxhighlight>
<source lang="lua">  
+
 
 +
'''Commenting out the print command'''
 +
<syntaxhighlight lang="lua">
 
print @ |--|
 
print @ |--|
  
print(x, y, z, x + y, y * z) -- this line will be skipped</source>
+
print(x, y, z, x + y, y * z) -- this line will be skipped
 +
</syntaxhighlight>
 +
 
 +
'''Advanced example'''
 +
<syntaxhighlight lang="lua">
 +
pi @ |math.atan(1.0)*4|
 +
</syntaxhighlight>
 +
 
 
{|-
 
{|-
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
Line 35: Line 53:
 
=== Constants ===
 
=== Constants ===
 
|}
 
|}
 +
 +
{{GIDEROS IMPORTANT LINKS}}

Latest revision as of 15:31, 13 July 2023

Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.png
Available since: Gideros 2017.10

Description

Another great Gideros feature is macros. Currently Lua has no constants, you just have to define variables like pi=3.14159.

Now you can define symbolic constants like this pi @ 3.14159 and then simply use pi in the code as normal. When the Lua code is byte compiled, the constants are replaced with their literal values which saves CPU time.

Macro Constants can be used for string and numeric constants. Just use @ rather than = when defining the macro.

You can use any of these delimiters after @ but they must be used in pairs. Numbers are auto-detected.

\`~ ! # $ % ^ & * / + = |

Examples

Simple examples

num1 @ &2^0&
num2 @ &2^1&
num3 @ &num1 + num2&

pi @ 3.14159265358979324
num4 @ -100.54
num5 @ 232
num6 @ 444.10
str1 @ 'hello'
str2 @ "world"
str3 @ [[
Hello,
world!
]]

Commenting out the print command

print @ |--|

print(x, y, z, x + y, y * z) -- this line will be skipped

Advanced example

pi @ |math.atan(1.0)*4|

Methods

Events

Constants