CLEARATTR - Revision history

Admin: Created page with "= Action = Clears the file Attribute. =
2015-06-15T21:32:04Z

Created page with "= <span class="f_Header">Action</span> = Clears the file Attribute. <span style="font-family: Arial;"> </span> <span style="font-family: Arial;"> </span> = <span..."

New page
= <span class="f_Header">Action</span> =

Clears the file Attribute.

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Syntax</span> =

<span class="f_Syntax">CLEARATTR  </span>[sFile] , bFileAttribute

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Remarks</span> =
<div style="font-size: 13.3333330154419px; padding: 0px; margin: 0px 0px 0px 4px;">
{| width="609" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="19%" style="width: 150px; border: 1px solid rgb(0, 0, 0);" |
sFile

| valign="top" width="56%" style="width: 450px; border: 1px solid rgb(0, 0, 0);" |
The name of the file (no wildcard) which attribute need to be cleared.

You may also omit the name in which case the file will be used previous found by the DIR() function.

|- style="vertical-align: top;"
| valign="top" width="19%" style="width: 150px; border: 1px solid rgb(0, 0, 0);" |
bFileAttribute

| valign="top" width="56%" style="width: 450px; border: 1px solid rgb(0, 0, 0);" |
Numeric variable holding the attribute bits to clear.

|}
</div>
<span style="font-family: Arial;"> </span>

This functions clears the DOS file attributes. A file can have multiple attributes.

You should not use attributes 8(Volume) and 16(Sub Directory) on a normal file.

 

<span style="font-family: Arial;"> </span>
<div style="font-size: 13.3333330154419px; padding: 0px; margin: 0px 0px 0px 4px;">
{| width="214" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="59%" bgcolor="#ffff99" style="width: 122px; border: 1px solid rgb(0, 0, 0); background-color: rgb(255, 255, 153);" |
<span style="font-weight: bold;">Return value</span>

| valign="top" width="68%" bgcolor="#ffff99" style="width: 83px; border: 1px solid rgb(0, 0, 0); background-color: rgb(255, 255, 153);" |
<span style="font-weight: bold;">DOS Attribute</span>

|- style="vertical-align: top;"
| valign="top" width="59%" style="width: 122px; border: 1px solid rgb(0, 0, 0);" |
1

| valign="top" width="68%" style="width: 83px; border: 1px solid rgb(0, 0, 0);" |
Read Only

|- style="vertical-align: top;"
| valign="top" width="59%" style="width: 122px; border: 1px solid rgb(0, 0, 0);" |
2

| valign="top" width="68%" style="width: 83px; border: 1px solid rgb(0, 0, 0);" |
Hidden

|- style="vertical-align: top;"
| valign="top" width="59%" style="width: 122px; border: 1px solid rgb(0, 0, 0);" |
4

| valign="top" width="68%" style="width: 83px; border: 1px solid rgb(0, 0, 0);" |
System File

|- style="vertical-align: top;"
| valign="top" width="59%" style="width: 122px; border: 1px solid rgb(0, 0, 0);" |
<span style="color: rgb(255, 0, 0);">8</span>

| valign="top" width="68%" style="width: 83px; border: 1px solid rgb(0, 0, 0);" |
<span style="color: rgb(255, 0, 0);">Volume Label</span>

|- style="vertical-align: top;"
| valign="top" width="59%" style="width: 122px; border: 1px solid rgb(0, 0, 0);" |
<span style="color: rgb(255, 0, 0);">16</span>

| valign="top" width="68%" style="width: 83px; border: 1px solid rgb(0, 0, 0);" |
<span style="color: rgb(255, 0, 0);">Sub Directory</span>

|- style="vertical-align: top;"
| valign="top" width="59%" style="width: 122px; border: 1px solid rgb(0, 0, 0);" |
32

| valign="top" width="68%" style="width: 83px; border: 1px solid rgb(0, 0, 0);" |
Archive

|- style="vertical-align: top;"
| valign="top" width="59%" style="width: 122px; border: 1px solid rgb(0, 0, 0);" |
64,128

| valign="top" width="68%" style="width: 83px; border: 1px solid rgb(0, 0, 0);" |
reserved

|}
</div>
<span style="font-family: Arial;"> </span>

A file can have multiple bits set like 3 (hidden + read only). So you can clear multiple bits by combining the bits.

 

When you specify the filename, make sure it does not have a wildcard. CLEARTTR does not support wildcards.

When you omit the filename, the last found file from [[DIR]]() will be used for the operation.

 

In VB, CLEARATTR expects a new value for the attribute which replaces the old attribute byte.

In AVR-DOS you specify the bits to clear. So old attribute bits which are not altered are kept.

In AVR-DOS you can also set the individual bits using the SETRATTR statement.

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">See also</span> =

[[SETATTR]] , [[INITFILESYSTEM]] , [[OPEN]] , [[CLOSE]], [[FLUSH]] , [[PRINT]], [[LINE INPUT]], [[LOC]], [[LOF]] , [[EOF]] , [[FREEFILE]] , [[FILEATTR]] , [[SEEK]] , [[BSAVE]] ,[[BLOAD]] , [[KILL]] , [[DISKFREE]] , [[DISKSIZE]] , [[PUT]] , [[FILEDATE]] , [[FILETIME]] , [[FILEDATETIME]] , [[DIR]] , [[FILELEN]] , [[WRITE]] , [[INPUT]]

= <span style="font-size: 14pt; font-weight: bold;">Example</span> =

<span class="f_CodeExample">See [[SETATTR]]</span>

<br/>{{Languages}}

[[Category:BASCOM Language Reference]]