Exponenta Banner
exponenta event banner

fileattrib

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

свернуть все на странице

Синтаксис

fileattrib
имя файла fileattrib
атрибуты имени файла fileattrib
fileattrib имя файла атрибуты пользователи
fileattrib имя файла атрибуты пользователей
[status, values] = fileattrib (имя файла)
[status, msg, msgID] = 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. Минус (-) перед атрибутом записи, w, удаляет доступ для записи, делая файл доступным только для чтения.

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

Создать папку D:\work\results и все его содержимое доступно только для чтения и скрыто. Потому что значение для users аргумент неприменим в системах Windows, users указывается как пустой символьный вектор, ''. '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

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

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

     1

msg =

     ''

msgID =

     ''

Показывать выходные данные, полученные при неудачной попытке установки атрибутов файла. 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 отключает право «записи» для папки, делая ее доступной только для чтения, файлы в папке могут быть доступны для записи для некоторых платформ или приложений.

'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 (набор), или NaN (не применимо)
system0 (не установлен), 1 (набор), или NaN (не применимо)
hidden0 (не установлен), 1 (набор), или NaN (не применимо)
directory0 (не установлен), 1 (набор), или NaN (не применимо)
UserRead0 (не установлен), 1 (набор), или NaN (не применимо)
UserWrite0 (не установлен), 1 (набор), или NaN (не применимо)
UserExecute0 (не установлен), 1 (набор), или NaN (не применимо)
GroupRead0 (не установлен), 1 (набор), или NaN (не применимо)
GroupWrite0 (не установлен), 1 (набор), или NaN (не применимо)
GroupExecute0 (не установлен), 1 (набор), или NaN (не применимо)
OtherRead0 (не установлен), 1 (набор), или NaN (не применимо)
OtherWrite0 (не установлен), 1 (набор), или NaN (не применимо)
OtherExecute0 (не установлен), 1 (набор), или NaN (не применимо)

Примечание

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

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

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

См. также

| | | | | | |

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

Документация MATLAB

Поддержка