Clarion Community Help

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
| **Navigation:**  [[abc library reference.htm|ABC Library Reference]] > INIClass > INIClass Methods >====== TryFetchField (return comma delimited INI file value) {{c6h0009.jpg|C6H0009.jpg}} ====== | [[tryfetch  get a value from the ini file .htm|{{btn_prev_n.gif|Previous page}}]][[abc library reference.htm|{{btn_home_n.gif|Return to chapter overview}}]][[update  write ini file entries .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**TryFetchField( **//section, entry, field //**)**

{{blk2blue.jpg|blk2blue.jpg}}

| **TryFetchField** | Returns a comma delimited value from the INI file. |
| //section// | A string constant, variable, EQUATE, or expression containing the INI file section name. |
| //entry// | A string constant, variable, EQUATE, or expression containing the INI file entry name. |
| //field// | An integer constant, variable, EQUATE, or expression identifying the comma delimited value to return. |

The **TryFetchField **method returns one of several comma delimited values from the INI file. If the specified section and entry do not exist, TryFetchField returns an empty string. This allows you to check the return value and take appropriate action when the INI file entry is missing.

TryFetchField assumes the //entry //value is a comma delimited string of the form V1,V2,...,Vn. A //field //value of one (1) returns the value prior to the first comma in the string; a value of two (2) returns the value between the first and second commas; a three (3) returns the value between the second and third commas, etc.

| **Return Data Type:** | STRING |

**Example:**

**Sound   STRING(3)**

**Volume  BYTE**

**  CODE**

** Sound=INIMgr.TryFetchField('Preferences','Sound&amp;Volume',1)**

** !get Sound value**

** IF NOT Sound               !if not present**

**  Sound='ON'                !default to on**

** END **

** Volume=INIMgr.TryFetchField('Preferences','Sound&amp;Volume',2)**

**!get Volume value**

** IF NOT Volume              !if not present**

**  Volume=3                  !default to 3**

** END**

** !program code**

** INIMgr.Update('Preferences','Sound&amp;Volume', |  !create INI entry like**

**        CLIP(Sound)&amp;','&amp;Volume)                 !Sound&amp;Volume=ON,3**

**See Also:** [[getini  return ini file entry .htm|GETINI]]