====== zlist_SortA ======

===== Description =====

Sort an item in a list to another index. In ''zlist_SortA'', the item to be sorted is specified by its name (compare: [[zeolite:functions:zlist_SortI]]). 

===== Files =====

^ Declaration | ''Zeolite.h'' |
^ Implementation | ''Zeolite.cpp'' |

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

<code="C">bool zlist_SortA(ZLIST hList, const char* lpItemName, long To);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| hList | ZLIST | A handle to a ZLIST variable containing the item to be sorted. |
| lpItemName | const char* | A handle to a C-style string containing the name of the item to be sorted. |
| To | long | The desired index of the item. |

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

False if an error occurred, and true otherwise. 

===== Comments =====

None.