Difference between revisions of "VisionaireObject Command: getBool"

From The Official Visionaire Studio: Adventure Game Engine Wiki
Line 39: Line 39:
 
'''Example 1:''' Get the boolean value of a condition.
 
'''Example 1:''' Get the boolean value of a condition.
 
<syntaxhighlight lang="lua">
 
<syntaxhighlight lang="lua">
-- Specify the field by the field constant
+
-- Specify the field by the field constant or by its id
 
local door_state = getObject("Conditions[door_closed]"):getBool(VConditionValue)
 
local door_state = getObject("Conditions[door_closed]"):getBool(VConditionValue)
 
-- Specify the field by its id
 
 
local door_state = getObject("Conditions[door_closed]"):getBool(194)
 
local door_state = getObject("Conditions[door_closed]"):getBool(194)
  

Revision as of 20:07, 11 August 2023

Returns the boolean value of a VisionaireObject field.


Syntax

getBool(field)


Parameters

Parameter Type Description
field int The field which specifies a boolean value. The field type must be "t_bool".

Specify the field by the field constant (V + object table name in singular + field name) or by its id, see the example.


Return values

Type Description
boolean The boolean value of the field.


Examples

Example 1: Get the boolean value of a condition.

-- Specify the field by the field constant or by its id
local door_state = getObject("Conditions[door_closed]"):getBool(VConditionValue)
local door_state = getObject("Conditions[door_closed]"):getBool(194)

-- The shorthand notation offers a more convenient way to achieve the same
local door_state = Conditions["door_closed"].Value