Programmer Guide/Shell Items/File/FILE Item Attributes

FILE Item Attributes

The following file item attributes can be queried in the format $#fileItem[AttributeId].

General file item attributes

Attribute Id	Value(s) and Description
!PATH	full path of file attached to the file item
!DRIVE	drive letter (without trailing :) of file attached to the file item
!DIRECTORY	directory (without trailing \) of file attached to the file item
!NAME	name of file attached to the file item
!EXTENSION	filetype-extension (without leading .) of file attached to the file item
!CREATED	creation date and time (yyyy.mm.dd hh.mm.ss) of file attached to the file item
!MODIFIED	time of last modification (yyyy.mm.dd hh.mm.ss) of file attached to the file item
!ATTRIBUTES	HIDDEN|NORMALtype attributes of file attached to the file item
!ACCESS	APPENDaccess attributes of file attached to the file item
!SIZE	filesize,size of file attached to the file item in bytes
!TYPE	TEXT|SECTION|XMLtype of file item (set in NEW command)
!SHELL	ownershellidid of shell creating the file item (8 hex digits)
!USERS	numusersnumber of linked items sharing the file item
!LASTACCESS	lastaccesseddatetime(yyyy.mm.dd hh.mm.ss) date and time of the last access to the file attached to the file item
!CHANGED	1|0 A value of 1 indicates that the file has been changed in memory and has not been saved yet. A value of 0 indicates that the file in memory is identical to that on disk. 0|1 If a value of 1 or 0 is specified as the second parameter, the changed attribute can be explicitly set or reset: $#file[!changed] := 1 // set the attribute $#file[!changed] := 0 // reset the attribute Warning: this functionality changed in version 3.9.0. Previously, setting the attribute using '1' would *reset* the attribute, and using the value '0' was unsupported.

Binary file item attributes

Attribute Id	Value(s) and Description
!BININFO	number of sectionsAfter a LIST commandindex of last loaded/saved sectionAfter a LOAD command-1If the file is not a binary file, or the last command failed.

GDX file item attributes

The GDX file item supports the following attributes in addition to the general file item attributes.

!DATA

The !DATA attribute returns data from the GDX file.

$#gdx[!DATA] // returns all the data

$#gdx[!DATA,index,count] // returns one or more columns

index determines the first column, and count the number of columns to return.

!DATATYPE

The !DATATYPE attribute returns the data type of this GDX file (See Creating a GDX file for details).

!NCOL

The !NCOL attribute returns the number of columns.

!NROW

The !NROW attribute returns the number of rows.

!NWRITTEN

The !NWRITTEN attribute returns the number of columns which have been written (rather than defined).

XML file item attributes

General attributes of XML file items

Attribute Id	Value(s) and Description
!XROOT	root_element_nametag name of the root element
!XPARENT	parent_element_nametag name of the parent element
!XPARENTPATH	root_element_name\..\parent_element_name full path of the parent element
!XELEMENTS	elementcountnumber of elements on selected element level
!XNODETYPE	COMMENT|PROC|DOCTYPE type of the selected node

Attributes of the selected element of a XML file item

Attribute Id	Argument	Value(s) and Description
!XALL	tag empy cdata childs size nattr attr0 ... attrN	a list of all element parts: tag → element tag name empty → 1 if element data is empty, 0 otherwise cdata → 1 if element data is a CData-section, 0 otherwise childs → number of child elements size → size of data section (characters) nattr → number of attributes attr0, ... → name of attribute 0, ... (0 to nattr-1)
!XTAG	-	element_tag
!XATTRIBUTES	-	number_of_attributes
!XATTRIBUTE	index	attribute_name name of attribute number index
!XATTRIBUTE	name	attribute_value value of attribute named name
!XEMPTY	-	returns 1 if element is empty (no data) and 0 otherwise
!XCDATA	-	returns 1 if element contains a CData section and 0 otherwise
!XCHILDS or !XCHILDREN	-	returns number of child elements of the selected element
!XSIZE	-	size of data section in characters
!XDATA	-	content of data section

XML file item document/element type definition attributes

Attribute-Id	Sub-Id 1	Sub-Id 2	Value(s) and Description
!XDTNAME	-	-	name of document type definition
!XDTROOT	-	-	tag of root element
!XDTELEMENTS	-	-	number of defined element types
!XDTELEMENT	index or tag	-	definition of element type with specified index or tag; the result is tag parent base nobase datawith: tag element tag parent parent element tag or * base base element tag or * nobase nobase element tag or * data data type name or *
!XDTCHILDREN	tag	-	number of children defined for element tag
!XDTCHILD	tag	cindex or ctag	definition of child cindex or ctag of the element tag. The result is:ctag min maxwith: ctag tag of child element min number of minimum occurrences max number of maximum occurrences or -1 if not defined
!XDTATTRIBUTES	tag	-	number of attributes defined for element tag
!XTDATTRIBUTE	tag	aindex or aname	definition of attribute aindex or aname of element tag. The result is:aname req vis val type paramswith: aname name of attribute req required flag (0=no, 1=yes) vis visibility flag (0=hidden, 1=value, 2=name and value) val default value of * if not set type attribute value type (INTEGER, NUMBER, STRING, VALUELIST) params INTEGER * NUMBER * STRING 1} VALUELIST value1 value2 ...

|}

!XDTISA

Sub-Id1:

tag

Value(s) and Description:

returns 1 if the selected element of the file item is of type tag or is derived from tag and 0 otherwise