Flecs v4.0
A fast entity component system (ECS) for C & C++
Loading...
Searching...
No Matches
Script
Collaboration diagram for Script:

Classes

struct  flecs::script_builder
 Script builder interface. More...
 

Functions

int script_run (const char *name, const char *str) const
 Run script.
 
int script_run_file (const char *filename) const
 Run script from file.
 
script_builder script (const char *name=nullptr) const
 Build script.
 
flecs::string to_expr (flecs::entity_t tid, const void *value)
 Convert value to string.
 
template<typename T >
flecs::string to_expr (const T *value)
 Convert value to string.
 
template<typename T >
get_const_var (const char *name, const T &default_value={}) const
 Get value of exported script variable.
 
template<typename T >
void get_const_var (const char *name, T &out, const T &default_value={}) const
 Get value of exported script variable.
 

Detailed Description

Data definition format for loading entity data.

Function Documentation

◆ get_const_var() [1/2]

template<typename T >
T get_const_var ( const char * name,
const T & default_value = {} ) const

Get value of exported script variable.

This operation will panic if no const var with the provided name was found, or if the type of the variable cannot be converted to the provided type.

An exported variable can be created in a script like this:

export const x = f64: 10

See the Flecs script manual for more details.

Template Parameters
TThe type of the value to obtain.
Parameters
nameThe name of the exported variable.
default_valueOptional default value. Returned when const var lookup failed.
Returns
The value of the variable.

◆ get_const_var() [2/2]

template<typename T >
void get_const_var ( const char * name,
T & out,
const T & default_value = {} ) const

Get value of exported script variable.

This operation will panic if no const var with the provided name was found, or if the type of the variable cannot be converted to the provided type.

An exported variable can be created in a script like this:

export const x = f64: 10

See the Flecs script manual for more details.

Template Parameters
TThe type of the value to obtain.
Parameters
nameThe name of the exported variable.
outOptional pointer to out variable. Can be used to automatically deduce T.
default_valueOptional default value. Returned when const var lookup failed.

◆ script()

script_builder script ( const char * name = nullptr) const

Build script.

See also
ecs_script_init

Definition at line 31 of file mixin.inl.

◆ script_run()

int script_run ( const char * name,
const char * str ) const

Run script.

See also
ecs_script_run

Definition at line 17 of file mixin.inl.

◆ script_run_file()

int script_run_file ( const char * filename) const

Run script from file.

See also
ecs_script_run_file

Definition at line 24 of file mixin.inl.

◆ to_expr() [1/2]

template<typename T >
flecs::string to_expr ( const T * value)

Convert value to string.

Definition at line 43 of file mixin.inl.

◆ to_expr() [2/2]

flecs::string to_expr ( flecs::entity_t tid,
const void * value )

Convert value to string.

Definition at line 36 of file mixin.inl.