ObjectToString

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

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

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

Синтаксис

ObjectToString(<Значение>):<Значение, закодированное в строку (ANSI STRING)>

Аргументы

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

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

Возвращает ANSI строку, результат кодирования.

Примеры

aList:=List.Create(1,2,3);
//Кодируем список в строку
аСтр:=ObjectToString(aList);

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

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