GetAttr Function /text/sbasic/shared/03020409.xhp
GetAttr function

GetAttr Function

Returns a bit pattern that identifies the file type or the name of a volume or a directory.

Syntax:

GetAttr (Text As String)

Return value:

Integer

Parameters:

Text: Any string expression that contains an unambiguous file specification. You can also use URL notation. This function determines the attributes for a specified file and returns the bit pattern that can help you to identify the following file attributes:

Value

Named constant Value Definition ATTR_NORMAL 0 Normal files. ATTR_READONLY 1 Read-only files. ATTR_HIDDEN 2 Hidden file ATTR_SYSTEM 4 System file ATTR_VOLUME 8 Returns the name of the volume ATTR_DIRECTORY 16 Returns the name of the directory only. ATTR_ARCHIVE 32 File was changed since last backup (Archive bit).
If you want to know if a bit of the attribute byte is set, use the following query method:

Example:

Sub ExampleSetGetAttr On Error GoTo ErrorHandler ' Define target for error handler If Dir("C:\test",16)="" Then MkDir "C:\test" If Dir("C:\test\autoexec.sav")="" Then FileCopy "c:\autoexec.bat", "c:\test\autoexec.sav" SetAttr "c:\test\autoexec.sav" ,0 FileCopy "c:\autoexec.bat", "c:\test\autoexec.sav" SetAttr "c:\test\autoexec.sav" ,1 Print GetAttr( "c:\test\autoexec.sav" ) End ErrorHandler: Print Error End End Sub