Задания на лабы 2007 / LABS / labview1_5 / DOC / FILE

Название и пиктограмма VI

Функции VI

File Dialog.VI

Показывает окно диалога, позволяющее пользователю определить путь к файлу или директории. Можно использовать это окно диалога, чтобы выбрать существующие файлы или директории, а также для того чтобы создать новые файлы или директории.

Входные данные:

• Prompt - сообщение, которое появляется под списком файлов и директорий в окне диалога. По умолчанию - пустая строка.

• Start path - путь до директория, которую LabVIEW первоначально показывает в окне диалога. Если start path задан, но определяет несуществующую директорию, то LabVIEW просматривает с конца названия директорий пока не найдет существующий путь или пустой путь. Если start path не задан, то LabVIEW показывает последнюю директорию, рассматриваемую в окне File Dialog. Если заданный start path не доступен, LabVIEW показывает последнюю директорию.

• Select Mode позволяет выбрать способ использования окна диалога. По умолчанию =2.

0: Выбор существующего файла.

1: Выбор нового файла, создаваемого пользователем

2: Выбор существующего или создаваемого файла

3: Выбор существующей директории

4: Выбор новой директории, создаваемой пользователем

5: Выбор существующей или создаваемой директории

• Default name - имя, которое появится как начальное имя файла или директории в окне диалога.

• Pattern - маска файла, использующая символы “*” и “?”.

• Datalog type - тип данных, которые будут содержаться в файле. Пользователь может определить произвольный тип данных.

Выходные данные:

• Path - полная путь к файлу или директории, выбранным при использовании этого окна диалога. Если пользователь щелкает на кнопке CANCEL, то эта функция устанавливает путь к not-a-path.

• Exists = TRUE если путь определяет существующий файл или директорию

Сancelled = TRUE если пользователь закрывает окно диалога, используя кнопку CANCEL или если ошибка происходит во время выполнения окна диалога.

Open File.VI

Открывает файл для чтения или записи.

Входные данные:

• File path - полный путь к файлу, который надо открыть

• Open mode определяет вид доступа к открываемому файлу. По умолчанию =0.

0: Для чтения и записи

1: Только для чтения

2: Только для записи. Не удаляет старые данные. Под любым ПО кроме MACINTOSH этот способ действует подобно способу 0.

3: Только для записи. Удаляет старые данные.

• Deny mode определяет виды доступа других пользователей к файлу. По умолчанию =2.

0: Недоступен для чтения и записи

1: Только для чтения

2: Доступен для чтения и записи

• Datalog type - тип данных, которые находятся в файле. Функция возвращает ошибку, если формат файла не соответствует формату определенного в datalog type типу данных. По умолчанию тип данных в файле - поток байтов.

Выходные данные:

• Refnum ссылка на открытый файл. Если путь файла относится к несуществующему файлу, или если относится к существующему файлу, недоступному для открытия указанным способом, то refnum= not-a-refnum

• Error - код ошибки. 0 - отсутствие ошибки.

New File.VI

Создает файл и открывает его для чтения и записи

Входные данные:

• file path - полный путь к файлу, которыый надо создать. Если путь относится к существующему файлу, или директории и overwrite=false, то эта функция не создает новый файл, а устанавливает refnum=not-a-refnum и возвращает ошибку.

• Group определяет тип файла, который нужно связать с новым файлом. По умолчанию файл не будет привязан к какой-либо группе.

• Deny mode аналогично Open File.VI

• Permissions определяет разрешенные способы доступа к новому файлу

• Datalog type аналогично Open File.VI

• Overwrite. Если определен путь, которая уже существует, то если overwrite=false, то функция возвращает ошибку: “duplicate path error”, а если overwrite=true, то функция заменяет файл на новый. По умолчанию overwrite=false.

Выходные данные:

• Refnum аналогично Open File.VI

• Error аналогично Open File.VI

Read File.VI

Читает данные из файла, указанного в refnum. Чтение начинается с момента, указанного в pos mode и pos offset, и зависит от формата указанной файла.

Входные и выходные данные:

• Line mode, count, type и формат указанного файла определяют количество читаемых данных.

• Line mode, convert eol, type, count и параметры данных ведут себя по-разному для файлов datalog и для файлов потока байта. Refnum, pos mode, pos offset, dup refnum, offset и error ведут себя следующим способом для, и datalog файла и файла потока байта.

• Refnum аналогично Open File.VI

• Pos mode и pos offset определяет место начала чтения:

Pos mode = 0: Начиная с начала файла + pos offset

Pos mode = 1: Начиная с конца файла + pos offset

Pos mode = 2: Начиная с текущего положения + pos offset

Если вычисленное местоположение не существует в файле, то никакие данные не читаются, и функция возвращает ошибку. Если тип файла, указанный в refnum - файл datalog, pos offset выражается в сроках типа данных, заданного datalog; в противном случае pos offset выражается в байтах. Pos offset по умолчанию = 0.

• Формат dup refnum аналогичен refnum

• Оffset indicates указывает новое местоположение курсора в файле относительно начала файла. Оffset выражено в тех же самых единицах, что и pos offset (строка для файлов datalog и байты для файлов потока байта).

• Error - код ошибки. 0 - отсутствие ошибки.

Write File.VI

Записывает данные в файл, указанный в refnum. Запись начинается с позиции, указанной в pos mode и pos offset для файлов потока байтов и с конца файла для файлов datalog. Data, header, и формат указанной файла определяют количество записываемых данных.

Входные данные:

• Refnum ссылка на открытый файл, в который будут записываться данные.

• Pos mode и pos offset определяет место начала записи:

Pos mode = 0: Начиная с начала файла + pos offset

Pos mode = 1: Начиная с конца файла + pos offset

Pos mode = 2: Начиная с текущего положения + pos offset

Если тип файла, указанный в refnum - файл datalog, pos offset выражается в сроках типа данных, заданного datalog; в противном случае pos offset выражается в байтах. Pos offset по умолчанию = 0.

• Header по умолчанию = FALSE.

• Convert eol решает, преобразовывать ли функцию конец строки в системно-определенный конец строки файла. Convert eol можно использовать только, если данные имеют строковый тип. Если header = TRUE, то LabVIEW игнорирует, convert eol.

• Для файлов потока байта, LabVIEW устанавливает курсор после последнего записанного байта. Для файлов datalog, LabVIEW устанавливает курсор после последней записи.

• Запись в datalog файл всегда производится в конец файла. Convert eol, header, pos mode и pos offset не применяются для datalog файлов.

Выходные данные:

• Формат dup refnum аналогичен refnum

• Error - код ошибки. 0 - отсутствие ошибки.

• Оffset indicates указывает новое местоположение курсора в файле относительно начала файла. Оffset выражено в тех же самых единицах, что и pos offset (строка для файлов datalog и байты для файлов потока байта).

Close File.VI

Закрывает файлы, связанные с refnum

Входные данные:

• Refnum ссылка на файл, который будет закрыт

Выходные данные:

• Error - код ошибки. 0 - отсутствие ошибки.

Seek.VI

Перемещает курсор в файле, связанному с refnum к положению, определяемому pos mode и pos offset

Входные данные:

• Refnum ссылка на файл

• Pos mode и pos offset определяет место начала чтения:

Pos mode = 0: Начиная с начала файла + pos offset

Pos mode = 1: Начиная с конца файла + pos offset

Pos mode = 2: Начиная с текущего положения + pos offset

Если вычисленное местоположение не существует в файле, то никакие данные не читаются, и функция возвращает ошибку. Если тип файла, указанный в refnum - файл datalog, pos offset выражается в сроках типа данных, заданного datalog; в противном случае pos offset выражается в байтах. Pos offset по умолчанию = 0.

Выходные данные:

• Формат dup refnum аналогичен refnum

• Error - код ошибки. 0 - отсутствие ошибки.

• Оffset indicates указывает новое местоположение курсора в файле относительно начала файла. Оffset выражено в тех же самых единицах, что и pos offset (строка для файлов datalog и байты для файлов потока байта).

EOF.VI

Устанавливает или возвращает логический конец файла, идентифицированного refnum. Pos mode и pos offset определяют новое местоположение конца файла. Offset возвращает местоположение конца файла относительно начала файла.

Flush File.VI

Данные написанные в файле часто находятся в буфере, до тех пор пока буфер не заполняется или пока Вы не закрываете файл. Эта функция вынуждает систему записывать все буферные данные в файл.

Входные данные:

• Refnum ссылка на файл

Выходные данные:

• Error - код ошибки. 0 - отсутствие ошибки.

• Формат dup refnum аналогичен refnum

Lock Range.VI

Управляет доступом к файлу, указанному в refnum (решает могут ли другие пользователи читать и записывать в этот файл). Пользователь не может управлять доступом к datalog файлу.

Входные данные:

• Refnum ссылка на файл

• Pos mode и pos offset определяет место начала чтения:

Pos mode = 0: Начиная с начала файла + pos offset

Pos mode = 1: Начиная с конца файла + pos offset

Pos mode = 2: Начиная с текущего положения + pos offset

Если вычисленное местоположение не существует в файле, то никакие данные не читаются, и функция возвращает ошибку.

• Count число байтов которые надо сделать доступными или недоступными. Можно сделать доступным или недоступным диапазон, который находится после конца файла, чтобы гарантировать, что никакие другие пользователи не добавят свою информацию в конец файла, в то время как вы добавляете свою. Эта функция возвращает ошибку, если count меньше чем ноль.

Если set lock = TRUE, то доступ закрывается, иначе открывается. Если два диапазона, с захваченным доступом, накладываются, то эта функция обращается с ними как с единственным “захваченным” диапазоном. При “незахвате” поддиапазона “запертого” диапазона функция обращается с обоими наборами данных как с отдельными диапазонами.

Выходные данные:

• Error - код ошибки. 0 - отсутствие ошибки.

• Формат dup refnum аналогичен refnum

Access Rights.VI

Возвращает владельца, группу, и права доступа для файла или директории, указанных в path. Если Вы не определяете нового владельца, новую группу, или новые права, то эта функция возвращает текущие неизмененные значения. DOS/Windows не поддерживает понятия владельца и группы. Для DOS/Windows, функция игнорирует нового владельца и новую группу и возвращает пустые строки для owner и group.

Входные данные:

• Path определяет файл или директорию, права доступа к которым надо изменить

• New owner определяет новую установку владельца для файла или директории

• New group определяет новую установку группы для файла или директории

• New permissions определяет новую установку прав доступа для файла или директории.

Выходные данные:

• Error - код ошибки. 0 - отсутствие ошибки.

• Owner определяет текущую установку владельца для файла или директории после выполнения функции

• Group определяет текущую установку группы для файла или директории после выполнения функции

• Permissions определяет текущую установку прав доступа для файла или директории после выполнения функции

Type and Creator.VI

Читает и устанавливает тип и создателя файла, указанного в path. Тип файла и создатель - строки из четырех символов. Если Вы не определяете нового владельца, новую группу, или новые права, то эта функция возвращает текущие неизмененные значения. Если новый тип или новый создатель имеет формат отличный от строки из 4 символов, то функция выдает ошибку. Обратите внимание: Windows не поддерживают тип и сооздателя файла. Попытка устанавливать тип или создателя файла под этой ОС приводит к ошибке. Однако, если в ОС Windows указанный файл имеет расширение , распознаваемое LabVIEW (например .vi для типа файла LVIN и .llb для типа файла LVAR), то эти значения функции будут выведены в type и LBVW в creator. Иначе, функция возвращает???? и в type и в creator.

Входные данные:

• Path определяет файл или директорию, type или creator которых вы хотите установить

• New type определяет новую установку типа для файла или директории

• New creator определяет новую установку создателя файла или директории

Выходные данные:

• Error - код ошибки. 0 - отсутствие ошибки.

• Type определяет текущую установку типа файла или директории после выполнения функции

• Сreator определяет текущую установку создателя файла или директории после выполнения функции

File/Directory Info.VI

Возвращает информацию о файле или директории, указанных в path, включая размер, последнюю дату модификации, и является ли это директорией. Входные данные:

• Path определяет файл или директорию, информацию о которых необходимо получить

Выходные данные:

• Error - код ошибки. 0 - отсутствие ошибки.

• Size указывает размер файла или директории, указанного в paht. Если путь определяет директорию, то размер указывает число элементов в директории. Иначе, размер указывает длину в байтах указанного файла, является ли файл файлом datalog или файлом потока байта.

• Last mod указывает дату и время, в которое файл или директория были последний раз изменены. Например 12:00 a.m., January 1, 1904, GMT (по Гринвичу).

• Directory = TRUE, если путь указывает на директорию, и =FALSE иначе.

Volume Info.VI

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

Move.VI

Перемещает файл или директорию, указанные в source path к местоположению, указанному в target path. New path определяет новое местоположение файла или директории, если перемещение прошло успешно: иначе функция устанавливает new path = not-a-path.

Copy.VI

Копирует файл или директорию, указанные в source path к местоположению, указанному в target path. New path определяет новое местоположение файла или директории, если копирование прошло успешно: иначе функция устанавливает new path = not-a-path.

Del.VI

Удаляет файл или директорию, указанные в path. Если path определяет непустую директорию то эта функция не удаляет директории и возвращает ошибку.

List Directory.VI

Возвращает два массива строк, содержащих список имен всех файлов и директорий, найденных в directory path, отфильтрованный в соответствии с маской (pattern) и типом (datalog type).

Входные данные:

• Directory path задает директорию, содержание которой необходимо определить. Если это несуществующая директория, то функция устанавливает file names и directory names равными empty arrays и возвращает ошибку.

• Pattern - маска файла, использующая символы “*” и “?”.

• Datalog type - тип данных, которые содержатся в файле. Пользователь может определить произвольный тип данных.

Выходные данные:

• Error - код ошибки. 0 - отсутствие ошибки.

• Формат dup directory path аналогичен directory path

• File names содержит имена файлов, найденных в указанной директории

• Directory names содержит имена файлов, найденных в указанной директории

New Directory.VI

Создает директорию, указанную в directory path. Если файл или директория уже существует по указанному адресу, то эта функция возвращает ошибку.

Входные данные:

• Directory path задает директорию, которую необходимо создать.

• Group определяет тип файлов, который нужно связать с новой директорией. По умолчанию директория не будет привязана к какой-либо группе файлов.

• Permissions определяет разрешенные способы доступа к новой директории

Выходные данные:

• Error - код ошибки. 0 - отсутствие ошибки.

• Формат dup directory path аналогичен directory path

Build Path.VI

Создает новый путь добавляя в конец существующего пути название.

Strip Path.VI

Возвращает название последнего компонента пути и путь, который ведет к этому компоненту.

Path Type.VI

Возвращает тип указанного пути (0: абсолютный, 1: относительный, 2: недействительный)

Not a refnum

Константа

VI Library

Возвращает путь каталога библиотеки LAB VIEW на данном компьютере. Эта информация содержится в конфигурации LAB VIEW.

Current VI’s Path

Возвращает путь файлу, содержащему VI, в котором эта функция появляется. Если перемещать VI, то значение этой постоянной изменяется.

Default Directory

Возвращает полный путь до основного каталога

Temporary Directory

Возвращает полный путь до временного каталога

Empty Path

Константа

Not a Path

Константа