zvar_Rename

Changes the name of a variable.

bool zvar_Rename(ZVAR hVar, const char* lpNewName);

False if:

• The hVar argument is NULL.
• The variable is in a list, and the given lpNewName is already in use by another item in that list.
• The given lpNewName contains an illegal character, and particularly, the '.' (dot) character, which is used as the nested member delimiter.
• Any other unspecified error occurred (consult L3DT event log in such cases.)

True otherwise.

This function allows you to rename any variable in the shared memory (e.g. those created by zvar_CreateShared), including those created by other plugins. Furthermore, you can re-name important stuff like L3DT's project maps or file formats, which will only result in pain and suffering for all. Hence, plugins should only call zvar_Rename on variables they have created, and only then in moderation.