Literals Reference

From the Fallout4 CreationKit Wiki
Jump to navigation Jump to search

Papyrus supports five kinds of literal values: boolean, integer, float, string, and None.

Boolean Literals[edit | edit source]

<boolean> ::= 'true' | 'false'
 bool myBoolean
 if myBoolean == true
    ;do something
 endif

Boolean literals are simple, they are just true or false values.

Integer Literals[edit | edit source]

<integer> ::= (['-'] <digit>+) | ('0x' (<digit>|<hex digit>)+)
 int count
 if count < 5
    ;do something
    count +=1
 endif

Integer literals are sequences of digits (0 though 9) optionally prefixed by a minus sign. If you want a hex number, prefix it with "0x". Valid hex digits are A through F (case-insensitive). Integers are 32-bits in size, signed, which means their valid range is −2,147,483,648 to 2,147,483,647.

Examples[edit | edit source]

10
-15365
0x0001F2C8

Float Literals[edit | edit source]

<float> ::= ['-'] <digit>+ '.' <digit>+
 float myValue
 if myValue ==  5.123
    ;do something
 endif


Float literals are sequences of digits (0 through 9) optionally prefixed by a minus sign, and followed by a dot and another sequence of digits. Floats are 32-bits in size, and have a range of 1.175494351 E – 38 to 3.402823466 E + 38 with 7 significant digits.

Examples[edit | edit source]

1.5234
-125412.0

String Literals[edit | edit source]

<string> ::= '"' <anything but another ", \, newline, or linefeed> '"'
 string myText = "Hello World."
debug.trace(myText)

String literals are simply text surrounded by double quotes. Newlines, line feeds, quotes, and back slashes are not allowed in the string. If you want one of these special characters, or a tab, then you can use the following escape codes:

\n Newline
\t Tab
\\ Backslash
\" Double quote

Examples[edit | edit source]

"Hello, World!"
"" ; Empty string
"\\\n" ; a string with a backslash followed by a new line

None Literal[edit | edit source]

None

The None literal simply represents 'nothing' for object types. (Similar to NULL in C) If you want to know if an object variable contains a valid object, just compare it to None.