FileGetAttrib

Reports whether a file or folder is read-only, hidden, etc.

FileGetAttrib, OutputVar , Filename

Parameters

OutputVar

The name of the output variable in which to store the attributes of the file or folder. This string is a subset of RASHNDOCT, where each letter means the following:

Filename

If blank or omitted, the current file of the innermost enclosing file loop will be used. Otherwise, specify the name of the target file, which is assumed to be in %A_WorkingDir% if an absolute path isn't specified. Unlike FileExist(), this must be a true filename, not a pattern.

Error Handling

[v1.1.04+]: This command is able to throw an exception on failure. For more information, see Runtime Errors.

ErrorLevel is set to 1 if there was a problem or 0 otherwise.

A_LastError is set to the result of the operating system's GetLastError() function.

Remarks

To check if a particular attribute is present in the retrieved string, see example #2 below.

On a related note, to retrieve a file's 8.3 short name, follow this example:

Loop, C:\My Documents\Address List.txt
    ShortPathName := A_LoopFileShortPath  ; Will yield something similar to C:\MYDOCU~1\ADDRES~1.txt

A similar method can be used to get the long name of an 8.3 short name.

FileExist(), FileSetAttrib, FileGetTime, FileSetTime, FileGetSize, FileGetVersion, file loop

Examples

Stores the attribute letters of a directory in OutputVar. Note that existing directories always have the attribute letter D.

FileGetAttrib, OutputVar, C:\New Folder

Checks if the Hidden attribute is present in the retrieved string.

FileGetAttrib, Attributes, C:\My File.txt
if InStr(Attributes, "H")
    MsgBox The file is hidden.