AROS - The Amiga Replacement OS

NAME: #include <utility/tagitem.h>
#include <proto/utility.h>
void RefreshTagItemClones()

SYNOPSIS: struct TagItem * clone
struct TagItem * original

LOCATION: In UtilityBase at offset 14

FUNCTION: If (and only if) the Tag list 'clone' was created by calling CloneTagItems on the Tag list 'original', and the list original has NOT been changed in any way, then this function will change the list 'clone' back to its original state.

INPUTS

original: The source TagList (unaltered)
clone: The destination TagList (MUST be allocated by CloneTagItems())

RESULT: The second TagList now has the same values as the first.

NOTES: If either of the inputs is NULL, then the function will not do anything.

EXAMPLE

struct TagItem *orig, clone;

\* TagList orig has some values already *\
clone = CloneTagList( orig );

\* In between here we do something to the TagItems in clone,
    but we need to have them restored.
*\

RefreshTagItemClones( clone, orig );

BUGS

None, however if either of the two pre-conditions is not fulfilled then this function will probably be unreliable, or trash memory.

We warned you...

SEE ALSO: CloneTagItems()

INTERNALS

HISTORY

03.02.1997 ldp: Changed <proto/*_protos.h> to <proto/*.h>
02.02.1997 iaint: Some bug fixes, math functions and native Amiga support
27.01.1997 ldp: Polish
10.12.1996 aros: Moved #include into first column to allow makedepend to see it.
24.10.1996 aros: Use the official AROS macros over the __AROS versions.
23.10.1996 aros: Formatted
Added parens to all assignments which are used truth expressions
22.10.1996 aros: Some more utility.library functions.