Guardian Programming Reference Summary for C

Functions Summary (D-F)
Guardian Programming Reference Summary for C—522630-001
5-39
FILENAME_DECOMPOSE_
Extracts and returns one or more parts of a file name or file-name pattern.
level
options
subpart
#include <cextdecs(FILENAME_DECOMPOSE_)>
short FILENAME_DECOMPOSE_ ( const char *filename /* i */
,short length /* i */
,char *piece /* o */
,short maxlen /* i */
,short *piece-length /* o */
,short level /* i */
,[ short options ] /* i */
,[ short subpart ] ); /* i */
-1 = Node name
0 = Destination name (for example, volume, device or process)
1 = First qualifier (for example, subvolume)
2 = Second qualifier (file identifier if disk file)
Bits 0-12 Reserved (specify 0).
Bit 13 = 1
= 0
Do not return default values; that is, if a requested part is not present
in filename but a default exists for it, return a null string instead
of the default value.
Default values can be returned.
Bit 14 = 1
= 0
Include prefix, that is, the entire portion of filename that precedes
the part specified by level.
Do not include prefix.
Bit 15 = 1
= 0
Include suffix, that is, the entire portion of filename that follows
the part specified by level.
Do not include suffix.
0 = Extract all sections occurring before the period (.).
1 = Extract processor for an unnamed process.
2 = Extract PIN for an unnamed process.
3 = Extract sequence number of a process.
4 = Extract name (begins with a dollar sign, ends at the first colon or period).