ObjectToFile

ObjectToFile (Системные функции)
Объект: Функции общего назначения Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в строку, ошибка при записи в файл Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Функции общего назначения

Функция кодирует внутрисистемным образом заданное значение в строку, значение может быть почти любым. К примеру, может представлять собой список, таблицу, объект базы данных, OLE-объект и пр. Значение, затем, будет сохранено в заданный файл. При наличии ошибки при сохранении в файл, будет вызвано исключение. Содержимое файла будет представлять собой ANSI строку, которая содержит только знаки с кодами больше 31 и меньше 127, строку можно позже снова превратить в значение (см. функцию ObjectFromFile), однако, если в нем были ссылки на объекты базы данных, декодирование должно происходить в пределах той же самой базы данных, в которой происходило кодирование.

Синтаксис

ObjectToFile(<Значение>,<Имя файла (STRING)>)

Аргументы

• <Значение> - Кодируемое значение. На данный момент принимаются следующие типы объектов: пустое значение, числа, даты, строки, списки, древовидные объекты, тексты, буферы, таблицы, объекты базы данных. Объекты, содержащиеся внутри других объектов (к примеру, элементы списка) также будут включены в результат. Неподдерживаемые объекты будут кодированы как пустые значения.
• <Имя файла (STRING)> - Имя файла (серверное или локальное) в который будет записан результат кодирования.

Примеры

aList:=List.Create(1,2,3);
//Кодируем список в файл
ObjectToFile(aList,"Temp\Тестовый файл.txt");

//Декодируем файл в новый список
bList:=ObjectFromFile("Temp\Тестовый файл.txt");
If _And(aList.Size()=bList.Size(),aList.Get(3)=bList.Get(3)) Then
  Message("Проверка прошла успешно!");
EndIf;

//В лог будет выведено: "Проверка прошла успешно!"