EurekaLog options are stored in text ini-like file. EurekaLog options are stored as set of 'name=value' pairs. They are written under '[Exception Log]' section. You can edit options manually via text editor or Options / Custom/Manual page.
|•||We do not recommend to manually edit EurekaLog settings, unless you need to add/change your own custom options, or change undocumented or hidden settings (e.g. setting which has no option in UI).|
A short example of .eof file contents:
The following rules are applied:
|•||Each option has form of 'Name=Value';|
|•||Each option should occupy single line only (line breaks inside text parameters are allowed via encoding - see below);|
|•||Integer values are stored directly;|
|•||Boolean values are stored as 0 (False) or 1 (True);|
|•||Float values are stored as fixed-point values, decimal delimiter is always '.', e.g. '12.345';|
|•||Enumeration values are stored as integers (not as text);|
|•||String values are enclosed in double quotes ('"'). This allows you to store spaces and line breaks inside text parameters:|
|o||Empty strings may be stored as two double quotes ('""') or just as empty param ('');|
|o||'"' symbol should be escaped encoded as '\q';|
|o||Line breaks should be encoded as '\r\n';|
|o||'\' symbol should be escaped by doubling it (e.g. '\\');|
|o||'%' symbol should be escaped by doubling it (e.g. '%%');|
|o||While you can store non-ASCII symbols "as is" - we strongly recommend to encode them as '%Uhex-code', for example, '%U044F' for unicode character #$44F (aka #1103, aka Cyrillic Small Letter Ya).|
|•||Options are sorted for your convenience, but new options can be entered and placed in any order. There is no need to preserve sort order;|
|•||Options with names started with '_' will not be saved into executable. Those are design-time only options, they are saved in project options, but not injected into final executable. |
|•||There is no predefined list of allowed option names;|
|•||We suggest to use 'Custom_' prefix for your own keys. EurekaLog will never have any option name, starting with 'Custom_'. Thus, your names will not collide with EurekaLog settings;|
|•||You can retrieve any option at run-time via CurrentEurekaModuleOptions.CustomField['Option-Name'].|
Build date: 2021-02-14
Last edited: 2018-06-14
The documentation team uses the feedback submitted to improve the EurekaLog documentation.
We do not use your e-mail address for any other purpose.
We will remove your e-mail address from our system after the issue you are reporting has been resolved.
While we are working to resolve this issue, we may send you an e-mail message to request more information about your feedback.
After the issues have been addressed, we may send you an email message to let you know that your feedback has been addressed.
Permanent link to this article: https://www.eurekalog.com/help/eurekalog/options_syntax.php