statusCallBack - Maple Help

Online Help

All Products    Maple    MapleSim


statusCallBack

handle status output in OpenMaple

 

Calling Sequence

Parameters

Description

Calling Sequence

statusCallBack(data, kilobytesUsed, kilobytesAlloc, cpuTime)

Parameters

data

-

user_data pointer passed to StartMaple (void*)

kilobytesUsed

-

total kilobytes used (long)

kilobytesAlloc

-

total kilobytes allocated (long)

cpuTime

-

total CPU time used (double)

Description

• 

This OpenMaple function is part of the MCallBackVector 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 MCallBackVector must look like the following.

void M_DECL statusCallBack( void *data, long kilobytesUsed,

                            long kilobytesAlloc, double cpuTime )

• 

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 to 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.

• 

Source code for a statusCallBack example is provided in the samples/OpenMaple/HelpExamples subdirectory of your Maple installation.

See Also

callBackCallBack

CustomWrapper

errorCallBack

OpenMaple

OpenMaple/C/API

OpenMaple/C/Examples

queryInterrupt

readLineCallBack

redirectCallBack

StartMaple

streamCallBack

textCallBack