fileattrib

Установите или получите атрибуты файла или папки

Описание

пример

fileattrib В перечислены значения атрибутов для текущей папки. Значения перечисляются с помощью этой структуры:

Name
archive
system
hidden
directory
UserRead
UserWrite
UserExecute
GroupRead
GroupWrite
GroupExecute
OtherRead
OtherWrite
OtherExecute

Первое поле, Name, отображает имя файла или папки. В остальных полях отображается значение 0 если атрибут отключен, 1 если атрибут включен, и NaN если атрибут не применяется.

fileattrib аналогичен DOS attrib команда, или UNIX® chmod команда.

Примечание

В Windows®, установка атрибута доступа на запись ('w') только для чтения не обязательно препятствует доступу к записи. Поэтому значение для UserWrite может отличаться от ожидаемого.

пример

fileattrib filename перечисляет значения атрибутов для именованного файла или папки.

пример

fileattrib filename attribs устанавливает заданные атрибуты для именованного файла или папки.

пример

fileattrib filename attribs users устанавливает атрибуты файла или папки для заданного подмножества пользователей.

пример

fileattrib filename attribs users s устанавливает заданные атрибуты для указанных пользователей для содержимого именованной папки.

пример

[status,values] = fileattrib(filename) возвращает статус и последние успешно установленные значения атрибутов для именованного файла или папки. Если файл существует, status является 1. В противном случае status является 0.

пример

[status,msg,msgID] = fileattrib(filename,attribs,___) устанавливает указанные атрибуты файла и возвращает состояние операции, а также сообщение об ошибке и идентификатор сообщения об ошибке, если операция аппарата неудачна.

Примеры

свернуть все

Просмотрите атрибуты текущей папки в системе Windows, предположив, что текущая папка C:\my_MATLAB_files. Атрибуты указывают, что у вас есть разрешения на чтение, запись и выполнение для текущей папки.

fileattrib
            Name: 'C:\my_MATLAB_files'
         archive: 0
          system: 0
          hidden: 0
       directory: 1
        UserRead: 1
       UserWrite: 1
     UserExecute: 1
       GroupRead: NaN
      GroupWrite: NaN
    GroupExecute: NaN
       OtherRead: NaN
      OtherWrite: NaN
    OtherExecute: NaN

Просмотрите атрибуты файла myfile.m в системе Windows. Атрибуты указывают, что указанный элемент является файлом. Вы можете считать и выполнять файл, но не можете обновить его. Файл заархивирован.

fileattrib myfile.m
            Name: 'C:\my_MATLAB_files\myfile.m'
         archive: 1
          system: 0
          hidden: 0
       directory: 0
        UserRead: 1
       UserWrite: 0
     UserExecute: 1
       GroupRead: NaN
      GroupWrite: NaN
    GroupExecute: NaN
       OtherRead: NaN
      OtherWrite: NaN
    OtherExecute: NaN

Просмотрите атрибуты для папки C:\my_MATLAB_files\doc. Атрибуты указывают, что у вас есть разрешения на чтение, запись и выполнение для папки.

fileattrib C:\my_MATLAB_files\doc
ans = 

            Name: 'C:\my_MATLAB_files\doc'
         archive: 0
          system: 0
          hidden: 0
       directory: 1
        UserRead: 1
       UserWrite: 1
     UserExecute: 1
       GroupRead: NaN
      GroupWrite: NaN
    GroupExecute: NaN
       OtherRead: NaN
      OtherWrite: NaN
    OtherExecute: NaN

Просмотрите атрибуты для папки /public в системе UNIX. Атрибуты указывают, что у вас есть разрешения на чтение, запись и выполнение для папки. В сложение пользователи в группе UNIX и все остальные имеют разрешения на чтение и выполнение для папки, но не права на запись.

fileattrib /public
ans = 

            Name: '/public'
         archive: NaN
          system: NaN
          hidden: NaN
       directory: 1
        UserRead: 1
       UserWrite: 1
     UserExecute: 1
       GroupRead: 1
      GroupWrite: 0
    GroupExecute: 1
       OtherRead: 1
      OtherWrite: 0
    OtherExecute: 1

Делайте myfile.m доступно для записи.

fileattrib('myfile.m','+w')

Сделайте папку /home/work/results папка только для чтения для всех пользователей на платформах UNIX. Минус (-), предшествующий атрибуту write, w, удаляет доступ на запись, делая файл доступным только для чтения.

fileattrib('/home/work/results','-w','a')

Сделайте папку D:\work\results и все его содержимое доступно только для чтения и скрыто. Потому что значение для users аргумент не применяется в системах Windows, users задается как пустой символьный вектор, ''. The 's' аргумент применяет скрытые и записываемые атрибуты доступа к содержимому папки и к самой папке.

fileattrib('D:\work\results','+h -w','','s')

Получите атрибуты для папки results и вернуть их как структуру. A status Значение 1 указывает, что операция выполнена успешно. Структура values содержит атрибуты папки.

[status,values] = fileattrib('results')
status =
     1

values = 
            Name: 'D:\work\results'
         archive: 0
          system: 0
          hidden: 0
       directory: 1
        UserRead: 1
       UserWrite: 1
     UserExecute: 1
       GroupRead: NaN
      GroupWrite: NaN
    GroupExecute: NaN
       OtherRead: NaN
      OtherWrite: NaN
    OtherExecute: NaN

Получите доступ к значению атрибута имени в структуре. MATLAB® возвращает путь для results.

values.Name
ans =
D:\work\results

Получите атрибуты для всех файлов в текущей папке с именами, которые начинаются с new. Возвращенный 1x3 массив структур values указывает, что существует три соответствующих файла.

[status,values] = fileattrib('new*')
status =
     1

values = 
1x3 struct array with fields:
    Name
    archive
    system
    hidden
    directory
    UserRead
    UserWrite
    UserExecute
    GroupRead
    GroupWrite
    GroupExecute
    OtherRead
    OtherWrite
    OtherExecute

Просмотрите имена файлов.

values.Name
ans =
D:\work\results\newname.m

ans =
D:\work\results\newone.m

ans =
D:\work\results\newtest.m

Просмотрите только второе имя файла.

values(2).Name
ans =
D:\work\results\newname.m

Показать выход, который будет получен при успешной попытке задать атрибуты файла. The status значение 1 указывает, что операция набора выполнена успешно. Поэтому никакой ошибки msg или msgID возвращается.

[status,msg,msgID] = fileattrib('C:\my_MATLAB_files\doc',...
'+h -w','','s')
status =

     1

msg =

     ''

msgID =

     ''

Показать выход, который появляется при неудачной попытке задать атрибуты файла. The status значение 0 указывает, что операция аппарата была неудачной. Знак минус неправильно появляется после wВместо того, чтобы предстать перед ним. msg описывает ошибку, которая произошла и msgID содержит идентификатор сообщения для возникшей ошибки.

[status,msg,msgID] = fileattrib('C:\my_MATLAB_files\doc',...
'+h w-','','s')
status =

     0


msg =

Illegal file mode characters on the current platform.


msgID =

MATLAB:FILEATTRIB:ModeSyntaxError

Входные параметры

свернуть все

Имя файла или папки, заданное как вектор символов или строковый скаляр. Можно задать абсолютный или относительный путь. filename может включать подстановочные знаки (*).

Пример: fileattrib('myfile.m')

Типы данных: char | string

Значения атрибутов файла или папки, заданные как вектор символов или строковый скаляр, состоящий из одного или нескольких из следующих значений, разделенных пространствами:

Значение

Описание

'a'

Архив (Microsoft® Только платформа Windows).

'h'

Скрытый файл (только для платформы Windows).

's'

Системный файл (только для платформы Windows).

'w'

Доступ для записи (платформы Windows и UNIX). Результаты различаются по платформе и приложению. Для примера, хотя fileattrib отключает привилегию «write» для папки, делая ее доступной только для чтения, файлы в папке могут быть доступными для записи для некоторых платформ или приложений.

'x'

Исполняемый файл (только для платформы UNIX).

Используйте плюс (+) квалификатор перед атрибутом, чтобы задать его, и минус (-) квалификатор перед атрибутом, чтобы удалить его.

Пример: fileattrib('myfile.m', '+w -h')

Типы данных: char | string

Подмножество пользователей (только на платформах UNIX), заданное в качестве одного из следующих значений:

Значение для систем UNIX

Описание

'a'

Все пользователи

'g'

Группа пользователей

'o'

Все другие пользователи

'u'

Текущий пользователь

Задайте пустое значение '' для всех платформ, кроме UNIX. Это значение не возвращается fileattrib получите операции.

Пример: fileattrib('/home/work/results','-w','a')

Выходные аргументы

свернуть все

Индикация того, была ли попытка задать или получить атрибуты успешной, указывается как 0 или 1. Если попытка задать или получить атрибуты была успешной, status является 1. В противном случае status является 0.

Структура атрибута, заданная как массив структур, содержащий эти поля и возможные значения:

Имя поляВозможные значения
NameВектор символов, содержащий имя файла или папки
archive0 (не установлен), 1 (set), или NaN (не применяется)
system0 (не установлен), 1 (set), или NaN (не применяется)
hidden0 (не установлен), 1 (set), или NaN (не применяется)
directory0 (не установлен), 1 (set), или NaN (не применяется)
UserRead0 (не установлен), 1 (set), или NaN (не применяется)
UserWrite0 (не установлен), 1 (set), или NaN (не применяется)
UserExecute0 (не установлен), 1 (set), или NaN (не применяется)
GroupRead0 (не установлен), 1 (set), или NaN (не применяется)
GroupWrite0 (не установлен), 1 (set), или NaN (не применяется)
GroupExecute0 (не установлен), 1 (set), или NaN (не применяется)
OtherRead0 (не установлен), 1 (set), или NaN (не применяется)
OtherWrite0 (не установлен), 1 (set), или NaN (не применяется)
OtherExecute0 (не установлен), 1 (set), или NaN (не применяется)

Примечание

В системах Windows установка атрибута доступа к записи ('w') только для чтения не обязательно препятствует доступу к записи. Поэтому значение для UserWrite может отличаться от ожидаемого.

Сообщение об ошибке, заданное как вектор символов. Если status является 0, msg содержит текст сообщения об ошибке. Если status является 1, msg пуст, ''.

Идентификатор сообщения об ошибке, заданный как вектор символов. Если status является 0, msgID содержит идентификатор сообщения об ошибке. Если status является 1, msgID пуст, ''.

См. также

| | | | | | |

Представлено до R2006a