Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.14.7  lbox_free_items                                            TOS

 Name:         »List box free items« - Release items list.

 Opcode:       175 (sub-opcode 2)

 Syntax:       void lbox_free_items ( LIST_BOX *box );

 Description:  The call lbox_free_items frees the memory used for the 
               chained list from LBOX_ITEM. The following applies:

                Parameter  Meaning

                box        Pointer to the list box structure

               Hint: A prerequisite for this is that memory was 
               allocated with Malloc for each item of the list.

               If custom memory management was used for LBOX_ITEM 
               (e.g. the C standard functions), then a custom function 
               must also be called to free the memory.

 Return value: The function does not return a result.

 Availability: The presence of this call should be checked for using 
               appl_getinfo (Opcode 7).

 Group:        List boxes

 See Also:     Binding   lbox_free_list   lbox_delete