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:**  [[templates.htm|Templates]] > [[tlrcontents.htm|Template Language Reference]] > Complete Alpha Listing >====== #FIX (fix a multi-value symbol) {{c6h0068.jpg|C6H0068.jpg}} ====== | [[ find   super fix  multi value symbols .htm|{{btn_prev_n.gif|Previous page}}]][[tlrcontents.htm|{{btn_home_n.gif|Return to chapter overview}}]][[ for  generate code multiple times .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**#FIX(** //symbol//, //fixsymbol// **)** **[, NOCASE]**

{{blk2blue.jpg|blk2blue.jpg}}

| **#FIX** | FIXes a multi-valued symbol to the value of a single instance. |
| //symbol// | A multi-valued symbol. |
| //fixsymbol// | A symbol or expression containing the value to fix the //symbol //to. |
| **NOCASE** | The //fixsymbol// value case does not need to match the case of the //symbol // |

The **#FIX** statement fixes the current value of the multi-valued //symbol// to the value contained in the //fixsymbol//. This is done so that one instance of the //symbol// may be referenced outside a #FOR loop structure, or so you can reference the symbols dependent upon the multi-valued //symbol//.

The //fixsymbol// must contain a valid instance of one of the //symbol's// multiple values. If the //fixsymbol// does not contain a valid instance, the //symbol// is cleared and contains no value when referenced. Unless #ADD has been used to add a new value and fix to that instance, #FIX or #SELECT must be used to set the value in a //symbol// before it contains any value for Template processing outside of a #FOR loop.

#FIX is completely independent of #FOR in that #FOR always loops through every instance of the //symbol//, whether there is a previous #FIX for that //symbol// or not. If there is a previous #FIX statement for that //symbol// before the #FOR loop, that //symbol// reverts to that previous //fixvalue// after the #FOR terminates.

If #FIX is used within a #FOR structure, the scope of the #FIX is limited to within the #FOR in which it is used. It does not change the #FOR symbol's iteration value if both the #FOR and #FIX happen to use the same symbol.

**Example:**
<code>
#SET(%OneFile,'HEADER')          #! Put values into two User-defined symbols
#SET(%TwoFile,'DETAIL')
#FIX(%File,%OneFile)             #! %File refers to 'HEADER'
#FIX(%File,'Header'),NOCASE      #! %File refers to 'HEADER', 'Header' or any case
#FOR(%File)                      #! %File iteratively refers to all file names
#FIX(%File,%TwoFile)             #! %File refers to 'DETAIL'
#ENDFOR
                                 #! %File refers to 'HEADER' again
</code>

**See Also:     **[[ select  fix a multi value symbol .htm|#SELECT]] ,[[ find   super fix  multi value symbols .htm|#FIND]]