a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 iffparse.library
  AllocIFF
  AllocLocalItem
  CloseClipboard
  CloseIFF
  CollectionChunk
  CollectionChunks
  CurrentChunk
  EntryHandler
  ExitHandler
  FindCollection
  FindLocalItem
  FindProp
  FindPropContext
  FreeIFF
  FreeLocalItem
  GoodID
  GoodType
  IDtoStr
  InitIFF
  InitIFFasClip
  InitIFFasDOS
  LocalItemData
  OpenClipboard
  OpenIFF
  ParentChunk
  ParseIFF
  PopChunk
  PropChunk
  PropChunks
  PushChunk
  ReadChunkBytes
  ReadChunkRecords
  SetLocalItemPurge
  StopChunk
  StopChunks
  StopOnExit
  StoreItemInContext
  StoreLocalItem
  WriteChunkBytes
  WriteChunkRecords
Include
GuruMeditation
Docs » Autodocs » iffparse.library » SetLocalItemPurge

NAME

	SetLocalItemPurge -- set purge vector for a local context item. (V36)

SYNOPSIS

	SetLocalItemPurge(localItem, purgeHook);
A0 A1
VOID SetLocalItemPurge(struct LocalContextItem *, struct Hook *);

FUNCTION

	Sets a local context item to use a client-supplied cleanup (purge)
vector for disposal when its context is popped. The purge vector
will be called when the ContextNode containing this local item is
popped off the context stack and is about to be deleted itself. If
the purge vector has not been set, the parser will use FreeLocalItem()
to delete the item, but if this function is used to set the purge
vector, the supplied vector will be called with the following
arguments:
A0: pointer to purgeHook.
A2: pointer to LocalContextItem to be freed.
A1: pointer to a LONG containing the value
IFFCMD_PURGELCI.
The user purge vector is then responsible for calling FreeLocalItem()
as part of its own cleanup. Although the purge vector can return a
value, it will be ignored -- purge vectors must always work (best to
return 0, though).

INPUTS

	localItem - pointer to a local context item.
purgeHook - pointer to a Hook structure.

SEE ALSO

AllocLocalItem(), FreeLocalItem(), <utility/hooks.h>, <libraries/iffparse.h>

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

The Silents

RSI
TSL
KEF
DC

Comments:

$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se