Differences

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

--- tools:config [2017/12/14 08:00] – created graf
+++ tools:config [2020/12/03 12:01] (current) – ursgraf
@@ Line 4: / Line 4: @@
 TestConfig : public eeros::config::FileConfig {
 public:
-  TestConfig(const char *name) :
+  TestConfig(const char *name) : FileConfig(name), b(2.2), d("127.0.0.0") {
-    FileConfig(name),
-    // set default values
-    a(1),
-    b(2.2),
-    c{0.1, 0.2, 0.3},
-    d("127.0.0.0") {
       add("id", a);
       add("offset", b);
-      add("init values", c);
+      add("initValues", c);
       add("ip", d);
   }
@@ Line 23: / Line 17: @@
 </code>
+The above example shows such a configuration class. When an object of this class is created, some of the values are initialized with default values and then added to the configuration.
+<code cpp>
+  TestConfig configFile("config.txt");	// choose an appropriate path
+</code>
+If a configuration file exists at the given location, you can load the values from there and overwrite the default values with the values given in the file.
+<code cpp>
+  TestConfig configFile("config.txt");	// choose an appropriate path
+  configFile.load();
+</code>
+WARNING Valid name for the identifiers of the values must not include spaces. 'myText10' is valid while 'my_text 10' is not! \\ \\
+You can manually create a suitable configuration file at the given location, e.g.
+<code>
+id = 1
+offset = 2.200000
+initValues = 0.1, 0.4, 0.3
+ip = 127.0.0.0
+</code>
+or you could save the values of your configuration class object into the file (and possible change an existing content).
+<code cpp>
+  configFile.save();
+</code>
+It's also possible to save to or restore from another file by writing:
+<code cpp>
+  configFile.save("config2.txt");
+  configFile.load("config2.txt");
+</code>
+There is a complete example in the example directory of EEROS. Open a shell in the build directory of your EEROS library and run
+<code>
+$ ./examples/config/configExample
+</code>