ds_list_copy

With this function you can copy the contents of one list into another. Both lists must have been created previously and if the list being copied to already has information within it, this list will be cleared first. The end result is two independent lists which contain the same information.

 

Syntax:

ds_list_copy( id, source );

ArgumentTypeDescription
idDS ListThe id of the list being copied to.
sourceDS ListThe id of the list to be copied from.

 

Returns:

N/A

 

Example:

if (!ds_list_empty(main_list))
{
    old_list = ds_list_create();
    ds_list_copy(old_list, main_list);
    ds_list_clear(main_list);
}

The above code will check a DS list to see if it is empty. If it is not empty it is copied into another DS list (which has been created previously) and then the original list is cleared.