![]() |
![]() |
![]() |
Cattle Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <cattle/cattle.h> enum CattleOnEOFAction; struct CattleConfiguration; CattleConfiguration * cattle_configuration_new (void
); void cattle_configuration_set_on_eof_action (CattleConfiguration *configuration
,CattleOnEOFAction action
); CattleOnEOFAction cattle_configuration_get_on_eof_action (CattleConfiguration *configuration
); void cattle_configuration_set_debug_is_enabled (CattleConfiguration *configuration
,gboolean enabled
); gboolean cattle_configuration_get_debug_is_enabled (CattleConfiguration *configuration
);
"debug-is-enabled" gboolean : Read / Write "on-eof-action" CattleOnEOFAction : Read / Write
typedef enum { CATTLE_ON_EOF_STORE_ZERO, CATTLE_ON_EOF_STORE_EOF, CATTLE_ON_EOF_DO_NOTHING } CattleOnEOFAction;
Possible actions to be performed by a CattleInterpreter when an EOF character is encountered in the input.
struct CattleConfiguration;
Opaque data structure representing a configuration. It should never be accessed directly; use the methods below instead.
CattleConfiguration * cattle_configuration_new (void
);
Create and initialize a new configuration.
A single configuration object can be shared between multiple interpreters, but modifying it while an interpreter is running can lead to unexpected and unpredictable results.
Returns : |
a new CattleConfiguration. [transfer full] |
void cattle_configuration_set_on_eof_action (CattleConfiguration *configuration
,CattleOnEOFAction action
);
Set the action to be performed when an EOF character is encountered in the input.
Accepted values are from the CattleOnEOFAction enumeration.
|
a CattleConfiguration |
|
the action to be performed |
CattleOnEOFAction cattle_configuration_get_on_eof_action
(CattleConfiguration *configuration
);
Get the action to be performed when an EOF character is read from
the input source. See cattle_configuration_set_on_eof_action()
.
|
a CattleConfiguration |
Returns : |
the current action |
void cattle_configuration_set_debug_is_enabled (CattleConfiguration *configuration
,gboolean enabled
);
Set the status of the debugging support. It is disabled by default.
If debugging is disabled, instructions whose value is
CATTLE_INSTRUCTION_DEBUG
will be ignored by the interpreter.
|
a CattleConfiguration |
|
TRUE to enable debug, FALSE otherwise |
gboolean cattle_configuration_get_debug_is_enabled
(CattleConfiguration *configuration
);
Get the current status of the debugging support.
See cattle_configuration_set_debug_is_enabled()
.
|
a CattleConfiguration |
Returns : |
TRUE if debugging is enabled, FALSE otherwise |
"debug-is-enabled"
property"debug-is-enabled" gboolean : Read / Write
If FALSE
, instructions whose value is
CATTLE_INSTRUCTION_DEBUG
are not executed by the interpreter.
Changes to this property are not notified.
Default value: FALSE
"on-eof-action"
property"on-eof-action" CattleOnEOFAction : Read / Write
Action to be performed when an EOF character is encountered in the input.
Changes to this property are not notified.
Default value: CATTLE_ON_EOF_STORE_ZERO