Cold Help System: Programming: ColdC Reference Manual: Functions: System: anticipate_assignment()


INTEGER anticipate_assignment()

Do not use this unless you know exactly what you are doing, and how stacks and frames work in the ColdC driver.

This function is used to reduce the amount of references to data on the stack, in order to keep from unecessarily copying data. It does this by breaking encapsulation and looking at the calling frame's execution stack. If an assignment will be made to data passed as an argument, as a result of the current method's return--the variable is cleared of any references before the data is modified in the current frame.

Because of how this works be careful to only call anticipate_assignment() after any Errors are thrown. Any errors thrown after this function is called will have the potential of losing data in the calling method.


backup() | set_heartbeat() | shutdown() | anticipate_assignment() | config() | cache_info()


the Cold Dark