DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
Message store functions

Data structure instantiation/destruction functions

The following functions are used to obtain structures from free storage and to release them:

These functions, all named mail_new*, create a new structure of the given type and initialize all of its elements to zero or empty.

The following functions, all named mail_free_*, take a pointer to a structure pointer, free all contained strings and structures within the structure, and finally free the structure itself and set its pointer to NIL. For example, mail_free_envelope frees all the ADDRESS structures contained in the envelope.

Normally, mail_free_elt and mail_free_lelt are used only if the main program has a private pointer to cache elements. If so, it is expected to increment the cache element's lockcount when it makes a private pointer, and to call this function when it is finished with it.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 27 April 2004