TAU_PROFILER_CREATE - Creates a profiler object referenced as a standard pointer

C/C++:

TAU_PROFILER_CREATE(Timer timer, char* or string& function_name, char* or string& type, taugroup_t group);

TAU_PROFILER_CREATE
creates a timer the that can be controlled by the Timer pointer object.

The TAU_PROFILER_* API is intended for applications to easily layer their legacy timing measurements APIs on top of TAU, Unlike other TAU API calls (TAU_PROFILE_TIMER) that are statically expanded in the source code, these calls allocate TAU entities on the heap. So the pointer to the TAU timer may be used as a handle to access the TAU performance data.

>C/C++:

void *ptr;
TAU_PROFILER_CREATE(ptr, "foo","", TAU_USER);
TAU_PROFILER_START(ptr);
foo(2);
TAU_PROFILER_STOP(ptr); 

TAU_PROFILER_START TAU_PROFILER_STOP TAU_PROFILER_GET_CALLS TAU_PROFILER_GET_CHILD_CALLS TAU_PROFILER_GET_INCLUSIVE_VALUES TAU_PROFILER_GET_ExCLUSIVE_VALUES TAU_PROFILER_GET_COUNTER_INFO