Differences

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

--- placeholder_expression [2017/06/01 08:07] – justin
+++ placeholder_expression [2021/04/21 20:23] (current) – 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 include entity properties, global properties, or 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.
+<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>
+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>
+As with [[string|strings]], any double quotation marks in the placeholder expression must be escaped with backslashes.
 ====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