Home / Autodocs / datatypes.library
NAME
- FindToolNodeA
-
Find a tool node (V45)
SYNOPSIS
tn = FindToolNodeA( toollist, attrs );
d0 a0 a1
struct ToolNode *FindToolNodeA( struct List *,
tn = FindToolNode( toollist, tag1, ... );
ULONG FindToolNode( struct List *, ... );
d0 a0 a1
struct ToolNode *FindToolNodeA( struct List *,
struct TagItem * );
ULONG FindToolNode( struct List *, ... );
FUNCTION
This function searches for a given tool in a list of tool nodes.
INPUTS
- toollist
-
struct List * or a struct ToolNode * (which will be skipped) to search in. NULL is a valid arg.
- attrs
-
Search tags. A NULL arg returns simple the following node.
TAGS
- TOOLA_Program
-
name of the program to search for
- TOOLA_Which
-
one of the TW_#? types.
- TOOLA_LaunchType
-
Launch mode; TF_SHELL, TF_WORKBENCH or TF_RX
RESULT
struct ToolNode * or NULL
NOTES
This function is not limited to the (&(DataType -> dtn_ToolList)); programmers can set up their own lists. The (&(DataType -> dtn_ToolList)) entries are valid as long as the application obtains a lock to the DataType (as obtained from a dt object, ObtainDataTypeA or LockDataType).