statusCallBack
handle status output in OpenMaple
Calling Sequence
Parameters
Description
Examples
statusCallBack(data, kilobytesUsed, kilobytesAlloc, cpuTime)
data
-
user_data pointer passed to StartMaple (long)
kilobytesUsed
total kilobytes used (long)
kilobytesAlloc
total kilobytes allocated (long)
cpuTime
total CPU time used (double)
This OpenMaple function is part of the MapleCallBack structure passed as an argument to StartMaple.
The statusCallBack function is called when Maple reports resource usage information (equivalent to the "bytes used" messages in stand-alone Maple). This usually happens after every sweep of the garbage collector.
The prototype for the function you can assign to the entry in the MapleCallBack must look like the following.
Sub StatusCallBack(ByVal data As Long,
ByVal kilobytesUsed As Long,
ByVal kilobytesAlloc As Long,
ByVal CPUTime As Double)
The cpuTime parameter is the number of seconds of CPU time consumed since the Maple kernel was started. This includes time spent in any callback functions.
The kilobytesUsed parameter indicates the number of kilobytes of storage allocated by the Maple internal storage manager.
The kilobytesAlloc parameter indicates the number of kilobytes of storage allocated by the operating system by the Maple internal storage manager.
If no statusCallBack function is specified, status information is sent to the textCallBack function in the form "bytes used=%ld, alloc=%ld, time=%1.2f", with the MAPLE_TEXT_STATUS tag.
The data parameter contains the same data as passed to StartMaple in the user_data parameter.
Public Sub StatusCallBack(ByVal data As Long, ByVal kilobytesUsed As Long, _
ByVal kilobytesAlloc As Long, ByVal CPUTime As Double)
MainForm.BytesUsed.Text = kilobytesUsed
MainForm.BytesAlloc.Text = kilobytesAlloc
MainForm.CPUTime.Text = CPUTime
End Sub
' assignment to MapleCallback entry
cb.lpStatusCallBack = GetProc(AddressOf StatusCallBack)
' test statement that will invoke the CallBackCallBack
EvalMapleStatement kv, "gc();"
See Also
callBackCallBack
errorCallBack
OpenMaple
OpenMaple/VB/API
OpenMaple/VB/Examples
queryInterrupt
readLineCallBack
redirectCallBack
StartMaple
streamCallBack
textCallBack
Download Help Document
