Функция _FileWriteFromArray

         Описание функции


_FileWriteFromArray

Записывает массив построчно в указанный файл.

#include <File.au3>
_FileWriteFromArray($sFilePath, $aArray [, $iBase = 0 [, $iUbound = 0 [, $sDelimeter= "|"]]])

Параметры

$sFilePath Путь к файлу для записи, или указатель файла возвращаемый функцией FileOpen().
$aArray Массив, который необходимо записать в файл.
$iBase [необязательный] Начальный индекс массива, от которого чтение, обычно 0 или 1. По умолчанию=0
$iUbound [необязательный] Последний индекс массива, до которого чтение. По умолчанию 0 - означает до конца массива.
$sDelimeter [необязательный] Символ разделителя для двумерного массива. По умолчанию "|"

Возвращаемое значение

Успех:Возвращает 1
Ошибка:Возвращает 0 и устанавливает @error
@error:1 = Ошибка открытия указанного файла
2 = Указанный массив не является массивом
3 = Невозможно записать в файл
4 = Размерность массива > 2

Примечания

Если указан путь, то файл перезаписывается и закрывается.
Для использования других способов записи, как добавление в конец файла или формат Unicode, сначала откройте файл функцией FileOpen() и передайте указатель возвращаемый функцией FileOpen().
Если указан указатель, то файл остаётся открытым после выполнения этой функции.

См. также

_FileReadToArray

Пример

#include<File.au3>

$avCommon = _FileListToArray(@CommonFilesDir)
$avUser = _FileListToArray(@UserProfileDir)
$sFile = @ScriptDir & "\Test.txt"

; Записывает первый массив в файл содержащий строки имён файлов
_FileWriteFromArray($sFile, $avCommon, 1)

; Открывает файл и добавляет второй массив
$hFile = FileOpen($sFile, 1) ; 1 = добавляет
_FileWriteFromArray($hFile, $avUser, 1)
FileClose($hFile)

; Просмотр результата
Run("notepad.exe " & $sFile)