Reference Manual Volume II Advanced Programming Guide Version 6.31 June 12th 2019 CLIPS Reference Manual CLIPS Advanced Programming Guide Version 6.31 June 12th 2019 CONTENTS License Information ....................................................................................................................... i Preface ........................................................................................................................................... iii Acknowledgements ..................................................................................................................... vii Section 1: Introduction ..................................................................................................................1 1.1 Warning About Interfacing With CLIPS .............................................................................1 1.2 C++ Compatibility ...............................................................................................................2 1.3 Threads and Concurrency ....................................................................................................2 1.4 Garbage Collection ..............................................................................................................3 Section 2: Installing and Tailoring CLIPS ..................................................................................9 2.1 Installing CLIPS...................................................................................................................9 2.1.1 Makefiles...................................................................................................................12 2.2 Tailoring CLIPS .................................................................................................................14 Section 3: Integrating CLIPS with External Functions ..........................................................19 3.1 Declaring User-Defined External Functions ......................................................................19 3.2 Passing Arguments from CLIPS to External Functions ....................................................23 3.2.1 Determining the Number of Passed Arguments .......................................................23 3.2.2 Passing Symbols, Strings, Instance Names, Floats, and Integers .............................24 3.2.3 Passing Unknown Data Types ..................................................................................25 3.2.4 Passing Multifield Values .........................................................................................28 3.3 Returning Values To CLIPS From External Functions .....................................................30 3.3.1 Returning Symbols, Strings, and Instance Names ....................................................31 3.3.2 Returning Boolean Values ........................................................................................32 3.3.3 Returning Fact and Instance Addresses ....................................................................34 3.3.4 Returning External Addresses...................................................................................34 3.3.5 Returning Unknown Data Types ..............................................................................35 3.3.6 Returning Multifield Values .....................................................................................37 3.4 User-Defined Function Example .......................................................................................41 Section 4: Embedding CLIPS .....................................................................................................45 4.1 Environment Functions ......................................................................................................45 4.1.1 EnvAddClearFunction ..............................................................................................45 4.1.2 EnvAddPeriodicFunction ..........................................................................................46 4.1.3 EnvAddResetFunction ..............................................................................................47 4.1.4 EnvBatchStar ............................................................................................................47 CLIPS Basic Programming Guide i CLIPS Reference Manual 4.1.5 EnvBload...................................................................................................................48 4.1.6 EnvBsave ..................................................................................................................48 4.1.7 EnvBuild ...................................................................................................................48 4.1.8 EnvClear ...................................................................................................................49 4.1.9 EnvEval .....................................................................................................................49 4.1.10 EnvFunctionCall .....................................................................................................50 4.1.11 EnvGetAutoFloatDividend .....................................................................................50 4.1.12 EnvGetDynamicConstraintChecking ......................................................................51 4.1.13 EnvGetSequenceOperatorRecognition ...................................................................51 4.1.14 EnvGetStaticConstraintChecking ...........................................................................51 4.1.15 InitializeEnvironment .............................................................................................52 4.1.16 EnvLoad ..................................................................................................................52 4.1.17 EnvRemoveClearFunction ......................................................................................53 4.1.18 EnvRemovePeriodicFunction .................................................................................53 4.1.19 EnvRemoveResetFunction ......................................................................................53 4.1.20 EnvReset .................................................................................................................54 4.1.21 EnvSave ..................................................................................................................54 4.1.22 EnvSetAutoFloatDividend ......................................................................................54 4.1.23 EnvSetDynamicConstraintChecking ......................................................................55 4.1.24 EnvSetSequenceOperator Recognition ...................................................................55 4.1.25 EnvSetStaticConstraintChecking ............................................................................56 4.2 Debugging Functions .........................................................................................................56 4.2.1 EnvDribbleActive .....................................................................................................56 4.2.2 EnvDribbleOff ..........................................................................................................57 4.2.3 EnvDribbleOn ...........................................................................................................57 4.2.4 EnvGetWatchItem.....................................................................................................57 4.2.5 EnvUnwatch ..............................................................................................................58 4.2.6 EnvWatch ..................................................................................................................58 4.3 Deftemplate Functions .......................................................................................................59 4.3.1 EnvDeftemplateModule ............................................................................................59 4.3.2 EnvDeftemplateSlotAllowedValues .........................................................................59 4.3.3 EnvDeftemplateSlotCardinality ................................................................................60 4.3.4 EnvDeftemplateSlotDefaultP ....................................................................................60 4.3.5 EnvDeftemplateSlotDefaultValue ............................................................................61 4.3.6 EnvDeftemplateSlotExistP .......................................................................................61 4.3.7 EnvDeftemplateSlotMultiP .......................................................................................61 4.3.8 EnvDeftemplateSlotNames .......................................................................................62 4.3.9 EnvDeftemplateSlotRange ........................................................................................62 4.3.10 EnvDeftemplateSlotSingleP ...................................................................................63 4.3.11 EnvDeftemplateSlotTypes ......................................................................................63 4.3.12 EnvFindDeftemplate ...............................................................................................64 4.3.13 EnvGetDeftemplateList ..........................................................................................64 4.3.14 EnvGetDeftemplateName .......................................................................................64