expression

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

Both sides previous revision Previous revision Next revision | Previous revision | ||

expression [2014/06/16 05:36] l [Invalid and and or usage] |
expression [2017/10/10 00:39] (current) |
||
---|---|---|---|

Line 1: | Line 1: | ||

+ | <- [[display|Displaying A Passage Within Another]] --------- [[function|About Functions]]-> | ||

+ | |||

===== About Expressions ===== | ===== About Expressions ===== | ||

Line 14: | Line 16: | ||

This evaluates to the number 13. The computer follows the normal order of operations in mathematics: first multiplying and dividing, then adding and subtracting. You can group subexpressions together and force them to be evaluated first with parentheses. | This evaluates to the number 13. The computer follows the normal order of operations in mathematics: first multiplying and dividing, then adding and subtracting. You can group subexpressions together and force them to be evaluated first with parentheses. | ||

+ | |||

+ | If you're not familiar with some of those symbols, here's a review: | ||

+ | ^ Operator ^ Function ^ Example ^ | ||

+ | | ''+'' | Addition. | ''5 + 5'' (is 10) | | ||

+ | | ''-'' | Subtraction. Can also be used to negate a number. | ''5 - -5'' (is 10) | | ||

+ | | ''*'' | Multiplication. | ''5 * 5'' (is 25) | | ||

+ | | ''/'' | Division. | ''5 / 5'' (is 1) | | ||

+ | | ''%'' | Modulo (remainder of a division). | ''5 % 26'' (is 1) | | ||

+ | | ''('' and '')'' | Brackets/parentheses (causes an expression to be evaluated earlier). | ''(5 + 10) * 2'' (is 30, not 25) | | ||

+ | |||

+ | ==== A note about modulo ==== | ||

+ | |||

+ | Modulo may seem somewhat obtuse an operator, but think of it like this: if you had a sequence of numbers: ''0, 1, 2, 3, 4, 5, 6...'', and you did ''% 3'' to each of them, they would become ''0, 1, 2, 0, 1, 2, 0...'' - that is, a constantly looping sequence. This ability to simplify rising sequences allows you to perform some otherwise complicated calculations easily. See the [[function#visited_string_string|visited()]] function for one such example. | ||

+ | |||

+ | ==== Strings of text ==== | ||

You can also use **strings** in an expression. A string is a bunch of characters strung together, demarcated by matching pairs of either double or single quotes. You can use strings in expressions: | You can also use **strings** in an expression. A string is a bunch of characters strung together, demarcated by matching pairs of either double or single quotes. You can use strings in expressions: | ||

<code> | <code> | ||

- | <<print "The" + ' former ' + "Prime Minister">> | + | <<print "The" + ' former ' + "Prime Minister's">> |

</code> | </code> | ||

- | This expression pushes the strings together, and evaluates to "The former Prime Minister". Notice that spaces had to be added between the words in order to produce a properly spaced final string. Also, notice that you can only add strings together. You can't subtract them, much less multiply or divide them. | + | This expression pushes the strings together, and evaluates to "The former Prime Minister's". Notice that spaces had to be added between the words in order to produce a properly spaced final string. Also, notice that you can only add strings together. You can't subtract them, much less multiply or divide them. Finally, notice that the apostrophe in "Prime Minister's" couldn't be included if that string had used single quotes, as they are the same character. (This is why both sets of quotes are permitted to build strings.) |

==== A note about strings and numbers ==== | ==== A note about strings and numbers ==== | ||

Line 37: | Line 54: | ||

Strings can thus be considered a "contagious" data type - when they are added to other data types, the other data type becomes a string. | Strings can thus be considered a "contagious" data type - when they are added to other data types, the other data type becomes a string. | ||

- | (One upshot of this is that you can convert a number to a string by simply adding the "empty string" to it - a string with zero characters, just two quotation marks with nothing between: | + | (One upshot of this is that you can **convert** a number to a string by simply adding the "empty string" to it - a string with zero characters, just two quotation marks with nothing between: |

<code> | <code> | ||

Line 44: | Line 61: | ||

Usually, though, there isn't much call for this - numbers are generally as useful as strings.) | Usually, though, there isn't much call for this - numbers are generally as useful as strings.) | ||

+ | |||

+ | ==== Printing Lists ==== | ||

+ | |||

+ | If you have a list, you can print the contents separated by a comma like so: | ||

+ | |||

+ | <<set $myarray = ["this", "that"]>> | ||

+ | <<print $myarray.join(", ")>> | ||

+ | |||

+ | This will print the following: | ||

+ | |||

+ | this,that | ||

+ | |||

+ | |||

+ | If you have specific questions about using lists in Twine, the [[frequently_asked_questions#how_do_i_get_things_in_and_out_of_a_list_variable|FAQ]] may help. | ||

+ | |||

==== Functions ==== | ==== Functions ==== | ||

Line 108: | Line 140: | ||

Some macros, such as [[<<if>>]], are designed to only accept conditions. But, if such macros receive an expression, then, depending on the value, it can be treated as if it was a condition in and of itself. The number 0, and a string with no characters in it "", are both treated as //false//. The other numbers, and every other string, are treated as //true//. This means that you can simplify a number of expressions: <<if $numberOfJavelins > 0>> can simply become <<if $numberOfJavelins>>. | Some macros, such as [[<<if>>]], are designed to only accept conditions. But, if such macros receive an expression, then, depending on the value, it can be treated as if it was a condition in and of itself. The number 0, and a string with no characters in it "", are both treated as //false//. The other numbers, and every other string, are treated as //true//. This means that you can simplify a number of expressions: <<if $numberOfJavelins > 0>> can simply become <<if $numberOfJavelins>>. | ||

+ | ====Summary of types of data values==== | ||

+ | |||

+ | To conclude, here is a summary of the types of values that you will most often encounter in macro expressions: | ||

+ | |||

+ | ^ Example of value ^ Description ^ | ||

+ | | "Some text", "2", "true", 'More text', '4', 'true' | **Strings**: snippets of text characters that can be [[<<print>>]]ed, joined up, or compared. Note that "2" and "true" resemble other types but are nonetheless strings. | | ||

+ | | 0, 2, 5, -11, 45.25, Infinity | **Numbers** that can be used in arithmetic calculations. ''Infinity'' isn't really a number, but has the special property that it's always ''>'' and ''>='' every actual number, so you can use it in that case. (The same applies to ''-Infinity'' and ''<''/''<='') | | ||

+ | | true, false | **Logical values**, created using the logical operators, and commonly used with to the [[<<if>>]] macro. True and false are the only values of this type. | ||

+ | |||

+ | <- [[display|Displaying A Passage Within Another]] --------- [[function|About Functions]]-> |

expression.1402896996.txt.gz ยท Last modified: 2017/10/10 00:37 (external edit)