[ library(instrument) | Reference Manual | Alphabetic Index ]
set_callsite_data(+SiteId, ?UserData)
Associate arbitrary data with an instrumentation callsite 
   in a non-logical store.
- SiteId
- Integer
- UserData
- Valid Prolog term
Description
   Each code instrumentation point within a file is 
   uniquely identified by its callsite identifier.
   The callsite identifier is a monotonically increasing 
   integer incrementing from the initial value of 0 for a 
   new module. 
   
   The predicate associates arbitrary data (a valid Prolog term) 
   with a specified instrumentation callsite within a module or 
   file.
   
   The data is stored in a non-logical store and can be 
   retrieved using instrument:get_callsite_data/2.
   
   The predicate is a tool and data for a callsite 
   of a module other than the current calling module context 
   can be stored by invoking 
   set_callsite_data(SiteId, UserData)@Module.
Modules
This predicate is sensitive to its module context (tool predicate, see @/2).
Fail Conditions
no
Resatisfiable
no
Exceptions
- (4) instantiation fault 
- SiteId is not instantiated.
- (5) type error 
- SiteId is not an integer.
See Also
file_callsites / 3, get_callsite_data / 2, instrument / 2, instrument / 3, library(instrument), module_callsites / 2, struct(itemplate), defined_modules / 2