| **Navigation:**  [[templates.htm|Templates]] > [[tlrcontents.htm|Template Language Reference]] > Built-in Template Procedures >====== INVOKE (call a named #GROUP as a function) {{c6h0068.jpg|C6H0068.jpg}} ====== | [[instance return current instance number .htm|{{btn_prev_n.gif|Previous page}}]][[tlrcontents.htm|{{btn_home_n.gif|Return to chapter overview}}]][[items  return multi valued symbol instances .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**INVOKE(** //symbol //[, //parameters// ] **)**

{{blk2blue.jpg|blk2blue.jpg}}

| **INVOKE** | Calls a named #GROUP as a function. |
| //symbol// | A symbol that contains the name of a #GROUP section in the current template set. |
| //parameters// | The parameters passed to the #GROUP. Each parameter must be separated by a comma. All parameters defined for the #GROUP must be passed; they may not be omitted. |

The **INVOKE** procedure places the return value from the #GROUP named in the //symbol //into the expression containing the INVOKE.

The //parameters// passed to the #GROUP fall into two categories: value-parameters and variable-parameters. Value-parameters are declared by the #GROUP as a user-defined symbol, while variable-parameters are declared by the #GROUP as a user-defined symbol with a prepended asterisk (*). Either a symbol or an expression may be passed as a value-parameter. Only a symbol may be passed as a variable-parameter.

**Return Data Type:**     STRING

**Example:**

**#SET(%SomeGroup,CALL(%SelectAGroup))    #!Call %SelectAGroup to get a #GROUP name**

**#SET(%AnotherGroup,****INVOKE****(%SomeGroup))  #!Call Selected Group for another #GROUP name**

**#INVOKE(%AnotherGroup)                  #!Insert either %DoTrueGroup or %DoFalseGroup**

**#GROUP(%SelectAGroup)**

**#IF (%SomeCondition)**

**  #RETURN('%TrueGroup(Clarion)')**

**#ELSE**

**  #RETURN('%FalseGroup(Clarion)')**

**#ENDIF**

**#GROUP(%TrueGroup)**

**  #RETURN('%DoTrueGroup(Clarion)')**

**#GROUP(%FalseGroup)**

**  #RETURN('%DoFalseGroup(Clarion)')**

**See Also:     **[[ group  reusable statement group .htm|#GROUP]] ,[[call  call a  group as a function .htm|CALL]] ,[[ return  return from  group .htm|#RETURN]] ,[[ call  insert code from a  group  without indention .htm|#CALL]] ,[[ invoke  insert code from a named  group .htm|#INVOKE]]

[[built in template procedures.htm|Built-In Template Procedures]]