Concatenating Strings

One can concatenate two GATString instances using the function

GATResult GATString_Concatenate( GATString_const head, 
                                 GATString_const tail, 
                                 GATString *result)

The first argument is the GATString instance which is to be at the ``head'' of the resultant GATString instance. the next argument is the GATString instance which is to be at the ``tail'' of the resultant GATString instance. The final argument is a pointer to a GATString through which the concatenation is returned to the caller. Finally this function returns a GATResult, covered in Appendix which indicates its completion status.