Differences

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

--- placeholder_expression [2017/06/01 08:35] – justin
+++ placeholder_expression [2021/04/11 21:00] – justin
@@ Line 2: / Line 2: @@
 ----
-**Placeholder expressions** provide a way to insert dynamic values into [[string|strings]] that will get evaluated at game runtime. Examples of supported values include entity properties, global properties, and arithmetical expressions.
+**Placeholder expressions** provide a way to insert dynamic values into [[string|strings]] that will get evaluated at game runtime for displaying to the player or printing to the [[developer console]]. Generally, any sort of expression that can be stored into a variable can also be used in a placeholder expression.
-The expression must be enclosed using the following syntax, which consists of a dollar sign and curly braces:
+<WRAP center round info 100%>
+Since placeholder expressions are parsed during a [[script|script's]] execution, they should be used sparingly to avoid potential slowdowns or hesitations. When possible, it's best to first store the expression into a variable and then use [[string|string concatenation]] to generate the desired [[string]].
+</WRAP>
-<code lua>
+In regards to usage, the expression must be enclosed using the following syntax consisting of a dollar sign and curly braces:
+<code bauxite>
 ${expression}
 </code>
@@ Line 13: / Line 17: @@
 ====Example:====
-<code lua>
+<code bauxite>
-display_message("Hello world! This is a string. ${global.property[\"test\"]}")
+display_message("The value of property ABC is ${global.property[\"ABC\"]}")
 </code>
 ~~NOTOC~~

RPG in a BoxOfficial Documentation

User Tools

Site Tools

Differences

Page Tools

RPG in a Box
Official Documentation