Differences

This shows you the differences between two versions of the page.

--- ru:abckin:kin-util:src:index [2026/11/02 18:36] – abc
+++ ru:abckin:kin-util:src:index [2026/11/02 22:31] (current) – abc
@@ Line 1: / Line 1: @@
 ====== Kin-util C++ interfaces ======
-Main routine of //kin-util// program is the parser of the input [[..:dtd|XML-file with the job instructions]]. It looks for the job commands and pass their XML-text to the corresponding subroutins.
+Main routine of //kin-util// program is the parser of the input [[..:dtd|XML-file with the job instructions]]. It looks for the job commands and pass their XML texts to the corresponding subroutines. There are two groups of the commands: import/export commands and instructions for computations.
+**Import/Export**. The result is returned as a reference via the second argument of the subroutine:
   CLIStatus importSchema(const XMLElement&, Schema*& schema_ptr);
-  CLIStatus importSchemaInstance(const XMLElement& elem, SchemaInstance*& instance_ptr);
+  CLIStatus importSchemaInstance(const XMLElement&, SchemaInstance*& instance_ptr);
-  CLIStatus importInstanceExptlData(const XMLElement& exptl_elem);
+  CLIStatus importInstanceExptlData(const XMLElement&);
+**Computations**:
   CLIStatus doComputation(const XMLElement& calc_elem);
   CLIStatus displayResult(const XMLElement&);
   CLIStatus optimize(const XMLElement& optimize_elem);
-  extern std::vector<Schema*> globalSchemaList;
+**Global containers** are used by the main routine:
-  extern std::vector<SchemaInstance*> globalInstanceList;
+  std::vector<Schema*> globalSchemaList;
-  extern std::map<String, CalculationResult*> globalResultMap;
+  std::vector<SchemaInstance*> globalInstanceList;
-  extern std::map<String, ABCKIN::ExptlDataContainer> globalExptlMap;
+  std::map<String, CalculationResult*> globalResultMap;
+  std::map<String, ExptlDataContainer*> globalExptlMap;
+And there are several misc functions to find objects by their means:
+  Schema* findSchemaById(const Clip& schema_id);
+  SchemaInstance* findInstanceById(const Clip& instance_id);
+  CalculationResult* findResultById(const Clip& result_id);
+  InstanceExperimentalData* findExptlById(const Clip& exptl_id);
+//CLIStatus// is the class which objects depict results of any parsing or calculation subroutine. It declares an Error/Warning ID, textual description of the error and the error's context (e.g. an invalid command syntax).
-//CLIStatus// is the class which objects depict results of any parsing or calculation subroutine. It declares an Error/Warning ID, textual description of the error and the error context (e.g. an invalid command syntax).