@WATTRIB

<< Click to Display Table of Contents >>

Navigation:  TCC-RT > Variables & Functions > Functions >

@WATTRIB

@WATTRIB[filename[,-attributes[,p]]]:  If you do not specify any attributes, @WATTRIB returns the attributes of the specified file in the format RHSADECIJNOFTVPU, rather than 0 or 1. If two or more parameters are specified, @WATTRIB returns a 1 if the specified file has the matching attribute(s); otherwise it returns a 0. If the optional third argument ,p is included (partial match), then @WATTRIB will return 1 if any of the attributes match

 

This function is similar to @ATTRIB, but supports file selection based on the following extended attributes available on NTFS volumes.

 

EEncrypted
CCompressed
FSparse file
INot content-indexed
JJunction or symbolic link
LJunction or symbolic link
NNormal
OOffline
PPinned
TTemporary
UUnpinned
VVirtualized

 

Attributes which are not set will be replaced with an underscore. For example, if SECURE.DAT has the read-only, hidden, and archive attributes set, %@WATTRIB[SECURE.DAT] would return RH_A_______. If the file does not exist, @WATTRIB returns an empty string.

 

The attributes (other than N) can be combined (for example %@ATTRIB[MYFILE,HS]). For example, %@WATTRIB[MYFILE,HS,p] will return 1 if MYFILE has the hidden, system, or both attributes. Without ,p the function will return 1 only if MYFILE has both attributes (and no extended attributes).

 

Filename must be in quotes if it contains white space or special characters.

 

See also: Attributes Switches and the ATTRIB command.