DitsGetSelfPath - Return the path to this task.

Function

Return the path to this task.

Description

Each task always maintains a path to itself, which can be used to send messages to the task itself - which is often usefull.

This function returns this path. The buffer size for thisi path is set during the call to DitsAppInit(3) can can be modified by the arguments to that call.

Previously (prior to DITS Version 3.25) this was often obtained by using DitsGetTaskName(3) to fetch the name of the task and then using DitsGetPath(3) to fetch the patch. This function is much simplier and more efficent.

Language

C

Call

(DitsPathType) = DitsGetSelfPath()

Function Value

The path to the task itself.

Include files

DitsInteraction.h

External functions used

None

External values used

DitsTask - Details of the current task

Prior requirements

DitsAppInit must have been called.

See Also

The Dits Specification Document, DitsGetPath(3), DitsPathGet(3), DitsAppInit(3).

Support

Tony Farrell, AAO

Click here for the DRAMA home page and here for the AAO home page.

 For more information, contact tony.farrell@mq.edu.au