====== var_GetVar ======

===== Description =====

Retrieve the ZVAR handle of a named variable.


===== Function prototype =====

<code>ZVAR CExtAPI::var_GetVar(const char* lpVarName);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| lpVarName | const char* | A pointer to a C-style string naming the variable to be retrieved. |

===== Return value =====

Null if an error occurred or the named variable does not exist, and a non-null ZVAR handle otherwise. 

===== Comments =====

==== Nested list members ====

You can retrieve items in nested lists using the '.' (dot) delimiter. For example, using an //lpVarName// of "list1.list2.list3.varname" will retrieve the variable named //varname// from the list //list3//, which is in //list2//, which is in //list1//, which is in the root of the shared memory.