File Vis (визуальные инструменты для работы с файлами)
Этот раздел описывает file Vis (виртуальные инструменты для работы с файлами), которые выполняют I/O операции высокого и промежуточного уровня.
Следующий рисунок показывает палитру File, к которой Вы обращаетесь из подменю меню Function. Нажмите на иконку в палитре для всплывающей справки.
Описания File VIs представлены в порядке, в котором они появляются на палитре, начиная с левого верхнего и перемещаясь слева направо.
Вы можете использовать file VIs, чтобы записывать или читать следующие типы данных:
1) Строки в текстовых файлах
2) Одномерный (1D) или двумерные (2D) массивы чисел с одинарной точностью в файлах электронных таблиц.
3) 1D или 3D массивы знаковых целых чисел или чисел с одинарной точностью в байтовых потоках.
Инструмент file Vls высокого уровня, описанный здесь, вызывает Vls промежуточного уровня , чтобы выполнить полные, легкие в использованиии файловые операции. Эти VIs открывают или создают файл, записывают или читают из него, и закрывают его.
Если происходит ошибка, эти VIs отображают диалоговое окно, которое описывает проблему и дает Вам выбор: остановить выполнение или продолжить.
Vis промежуточного уровня вызывает файловые функции, описанные в Главе 8, Функциии Ввода - вывода Файла. Эти функции выполняют обнаружение ошибок в дополнение к другим их функциям.
Эти VIs используют три стиля метки терминала в окне справки VI, чтобы отличить важность каждого ввода и вывода. Метки в полужирном шрифте - все, что Вы должны использовать в многих приложениях. Вы используете метки в простом тексте менее часто, а метки, включенные в [] скобки меньше всего.
Описание файловых VI:
Write Characters To File – запись символов в файл.
Записывает символьную строку в новый байтовый потоковый файл или конкатенирует строку к существующему файлу. VI открывает или создает файл заранее и закрывает его впоследствии.
File path – путь файла. Если путь файла - пустое (значение по умолчанию) или Not A Path, VI отображает диалоговое окно File, из которого Вы можете выбрать файл. Ошибка 43 происходит, если пользователь отменяет диалог.
Character string - данные, которые VI записывает в файл.
Append to file. Установите в True, если Вы хотите конкатенировать данные к существующему файлу; Вы можете также установить True, чтобы записать в новый файл. Установите False (значению по умолчанию), если Вы хотите записать данные в новый файл или заменить существующий файл.
New file path - путь файла, в который VI записал данные. Вы можете использовать этот вывод, чтобы определить путь файла, который вы открыли используя диалога. New file path возвращает Not A Path , если пользователь выбирает Отмену из диалогового окна.
Write To Spreadsheet File - запись в файл электронной таблицы
Преобразовывает 2D или 1D массив чисел с одинарной точностью (SGL) в текстовую строку и записывает строку в новый файл потока байта или конкатенирует строку к существующему файлу. Вы можете произвольно перемещать данные. Этот VI открывает или создает файл заранее и закрывает его впоследствии. Вы можете использовать этот VI, чтобы создать текстовый файл, читаемый большинством приложений электронных таблиц. Этот VI вызывает функцию Array to Spreadsheet String чтобы преобразовать данные.
File path - имя пути файла. Если путь файла - пустое (значение по умолчанию) или – Not A Path, VI отображает диалоговое окно File, из которого Вы можете выбрать файл. Ошибка 43 происходит, если пользователь отменяет диалог.
2D data - содержат числа с одинарной точностью, которые VI записывает в файл, если 1D данные не зашиты или пусты.
1D data - содержат числа с одинарной точностью, которые VI записывает в файл, если этот ввод не пуст. VI преобразовывает 1D массив в 2D массив перед продолжением. Если transpose? Установлен в FALSE, каждое обращение к этому VI создает новую линию или строку в файле.
format определяет, как преобразовать числа в символы. Если строка формата - %.3f (значение по умолчанию), VI создает строку достаточно длинной, чтобы содержать число, с тремя цифрами справа от десятичной точки. Если формат - % d, VI преобразовывает данные к целочисленной форме, используя столько символов, сколько необходимо, чтобы содержать все число. Обратитесь к обсуждению строк формата и функции Array To Spreadsheet String в раздел String Functions.
Append to file? Установите в True, если Вы хотите конкатенировать данные к существующему файлу; Вы можете также устанавить True, чтобы записать в новый файл. Установите в False (значению по умолчанию), если Вы хотите записывать данные в новый файл или заменить существующий файл.
transpose? Установите TRUE, чтобы переместить данные перед преобразованием в строку. Значение по умолчанию FALSE.
new file path - путь файла, в который VI записал данные. Вы можете использовать этот вывод, чтобы определить путь файла, который вы открыли используя диалога. New file path возвращает Not A Path , если пользователь выбирает Отмену из диалогового окна.
Write To I16 File - запись в I16 файл.
Записывает 2D или 1D массив целых слов со знаком (I16) в новый файл потока байта или конкатенирует данные к существующему файлу. VI открывает или создает файл заранее и закрывает его впоследствии. Вы можете использовать этот VI, чтобы записать немасштабируемые или двоичные данные из сбора данных (data acquisition) Vis.
File path – путь файла. Если путь файла - пустое (значение по умолчанию) или Not A Path, VI отображает диалоговое окно File, из которого Вы можете выбрать файл. Ошибка 43 происходит, если пользователь отменяет диалог.
2D data - содержат шестнадцатиразрядные числа, которые VI записывает в файл, если 1D данные не зашиты или пусты.
1D data - содержат шестнадцатиразрядные числа, которые VI записывает в файл, если этот ввод не пуст.
append to file? Установите в True, если Вы хотите конкатенировать данные к существующему файлу; Вы можете также установить True, чтобы записать в новый файл. Установите False (значению по умолчанию), если Вы хотите записать данные в новый файл или заменить существующий файл.
new file path - путь файла, в который VI записал данные. Вы можете использовать этот вывод, чтобы определить путь файла, который вы открыли используя диалога. New file path возвращает Not A Path , если пользователь выбирает Отмену из диалогового окна.
Write To SGL File - запись в SGL файл.
Записывает 2D или 1D массив чисел с одинарной точностью (SGL) в новый файл потока байтов или конкатенирует данные к существующему файлу. VI открывает или создает файл заранее и закрывает его впоследствии. Вы можете использовать этот VI, чтобы записать масштабируемые данные из сбора данных VIs без изменения их представления.
File path – путь файла. Если путь файла - пустое (значение по умолчанию) или Not A Path, VI отображает диалоговое окно File, из которого Вы можете выбрать файл. Ошибка 43 происходит, если пользователь отменяет диалог.
2D data - содержат числа с одинарной точностью, которые VI записывает в файл, если 1D данные не зашиты или пусты.
1D data - содержит числа с одинарной точностью, которые VI записывает в файл, если этот ввод не пуст.
append to file? Установите в True, если Вы хотите конкатенировать данные к существующему файлу; Вы можете также установить True, чтобы записать в новый файл. Установите False (значению по умолчанию), если Вы хотите записать данные в новый файл или заменить существующий файл.
new file path - путь файла, в который VI записал данные. Вы можете использовать этот вывод, чтобы определить путь файла, который вы открыли используя диалога. New file path возвращает Not A Path , если пользователь выбирает Отмену из диалогового окна.
Read Characters From File - чтение симвоов из файла
Читает определенное число символов из файла потока байтов, начиная с заданного символьного смещения. VI открывает файл заранее и закрывает его впоследствии.
File path – путь файла. Если путь файла - пустое (значение по умолчанию) или Not A Path, VI отображает диалоговое окно File, из которого Вы можете выбрать файл. Ошибка 43 происходит, если пользователь отменяет диалог.
Number of characters - максимальное число символов читаемых VI. VI читает меньшее количество символов, если достигает EOF. Если число символов < 0, VI будет читать весь файл. Значение по умолчанию -1.
Start of read offset - позиция в файле, измеряемая в символах (или байтах), с которой VI начинает читать.
new file path - путь файла, из которого VI прочитал данные. Вы можете использовать этот вывод, чтобы определить путь файла, который вы открыли используя диалога. New file path возвращает Not A Path , если пользователь выбирает Отмену из диалогового окна.
Character string – данные, читаемые из файла.
Mark after read - положение метки файла после чтения; она указывает на символ (байт) в файле следующий после последнего прочитанного символа.
EOF? Устанавливается в TRUE, если Вы пытаетесь читать после конца файла.
Read From Spreadsheet File - чтение из файла электронной таблицы
Читает определенное число линий или строк из числового текстового файла, начиная с заданного символьного смещения и преобразовывает данные в 2D массив чисел с одинарной точностью. Вы можете произвольно перемещать массив. VI открывает файл заранее и закрывает его впоследствии. Вы можете использовать этот VI, чтобы читать файл электронной таблицы, сохраненный в текстовом формате. Этот VI вызывает Spreadsheet String to Array , чтобы преобразовать данные.
File path – путь файла. Если путь файла - пустое (значение по умолчанию) или Not A Path, VI отображает диалоговое окно File, из которого Вы можете выбрать файл. Ошибка 43 происходит, если пользователь отменяет диалог
Number of rows - максимальное число линий или строк, читаемых VI . Для этого VI, строка(row) – строка символов, заканчивающаюся возвратом каретки, переводом строки, или возвратом каретки, сопровождаемым переводом строки; строка заканчивающаяся EOF; или строка, которая имеет максимальную длину строки, определенную максимальным кол-вом символов на строку. Если число строк < 0, VI будет читать весь файл. Значение по умолчанию -1.
Format - определяет, как преобразовать символы в числа; значение по умолчанию - %.3f. Обратитесь к обсуждению строк формата и функции Spreadsheet String To Array в разделе String Functions.
Start of read offset - позиция в файле, измеряемая в символах (или байтах), с которой VI начинает читать.
Max characters per row - максимальное число символов, читаемых VI перед окончанием поиска конца строки или строки. Значение по умолчанию - 0, что означает, что не имеется никакого ограничения на число символов, читаемых VI.
transpose? Установите TRUE, чтобы переместить данные перед преобразованием в строку. Значение по умолчанию FALSE.
All rows- данные, считываемые из файла в форме 2-ого массива чисел с одинарной точностью.
new file path - путь файла, из которого VI читает данные. Вы можете использовать этот вывод, чтобы определить путь файла, который вы открыли используя диалога. New file path возвращает Not A Path , если пользователь выбирает Отмену из диалогового окна
first row - первая строка all rows массива в форме 1D массива чисел с одинарной точностью. Вы можете использовать этот вывод, когда Вы хотите читать одну строку в 1D массив.
Mark after read - положение метки файла после чтения; она указывает на символ (байт) в файле следующий после последнего прочитанного символа.
EOF? Устанавливается в TRUE, если Вы пытаетесь читать после конца файла.
Read From I16 File - чтение из I16 файла
Читает 2D или 1D массив данных из файла потока знаковых целых слов (I16). VI открывает файл заранее и закрывает его впоследствии. Вы можете использовать этот VI, чтобы читать немасштабируемые или двоичные данные, приобретенные из VIs сбора данных и записанные в файл с помощью Write to I16 File.
File path – путь файла. Если путь файла - пустое (значение по умолчанию) или Not A Path, VI отображает диалоговое окно File, из которого Вы можете выбрать файл. Ошибка 43 происходит, если пользователь отменяет диалог.
2D number of rows - число строк 2D массива, когда данные возвращены в 2D массив. Значение по умолчанию - 0. См. следующее Примечание.
2D number columns/1D count - число создаваемых столбцов, если данные возвращены в 2D массив, или - число элементов для возвращаемого 1D массива. Значение по умолчанию -1. См. следующее примечание.
Примечание: Чтобы читать весь файл в 1D массив, установите 1D count < 0 (значение по умолчанию); Вы можете оставить 2D number of rows неподключенным. Это - заданная по умолчанию операция, если оба ввода неподключены. Чтобы читать N элементов в 1D массив, установите 1D Count + N, и оставьте 2D number of rows подключенными или установите в 0. Чтобы читать весь файл в 2D массив, установите 2D number of rows < 0 и 2D number of columns = N> 0. VI вычисляет число строк как целочисленную часть file size/N. Чтобы прочитать М строк или N столбцов в 2-D массив, устанавите 2D number of rows =M и 2D number of columns = N. Информация в этом примечании показывается в следующей таблице.