0

Функция ЗначениеВСтрокуВнутр()

Возвращает представление значения любого типа в строковом внутреннем системном виде

Синтаксис

Функция ЗначениеВСтрокуВнутр() имеет следующий синтаксис:

строка ЗначениеВСтрокуВнутр(Объект)

А также альтернативный англоязычный синтаксис:

string ValueToStringInternal(Object)

Параметры

Описание параметров функции ЗначениеВСтрокуВнутр():

Имя параметра Тип Описание
Объект Произвольный значение примитивного или агрегатного типа данных, которое необходимо преобразовать. Также можно указывать значения типа СписокЗначений и ТаблицаЗначений
Жирным шрифтом выделены обязательные параметры

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

Тип: Строка
Строковое внутреннее системное представление значения

Описание

Функция ЗначениеВСтрокуВнутр() преобразует значение произвольного типа в строковый внутренний системный вид:

//Число:
ЗначениеВСтрокуВнутр(1)
//Результат:
//    {"N","0","0","0","0","0","1"}

//Строка:
ЗначениеВСтрокуВнутр("2")
//Результат:
//    {"S","0","0","0","0","0","2"} 

//Дата:
ЗначениеВСтрокуВнутр('01.01.2021')
//Результат:
//    {"D","0","0","0","0","0","20210101"}

//Список значений
сз = СоздатьОбъект("СписокЗначений");
сз.ДобавитьЗначение(1);
сз.ДобавитьЗначение("2");
Сообщить(ЗначениеВСтрокуВнутр(сз));
//Результат:
//    {"VL",{{{"N","0","0","0","0","0","1"},""},{{"S","0","0","0","0","0","2"},""}}}

//Таблица значений:
тз = СоздатьОбъект("ТаблицаЗначений");
тз.НоваяКолонка("Код", "Число", 10);
тз.НоваяКолонка("Наименование", "Строка", 100);
Сообщить(ЗначениеВСтрокуВнутр(тз));
//Результат:
//    {"VT","1",{"0",{{"","0","0","0","","2"},{"Код","Код","1","0","0",{"N","10","0","0","0","0"},"","2",{}},
//    {"Наименование","Наименование","1","0","1",{"S","100","0","0","0","0"},"","0",{}}}}}

//Ссылка на справочник:
Сообщить(ЗначениеВСтрокуВнутр(СсылкаСпр));
//Результат:
//    {"B","0","0","12","0","0","         2   "}

//Ссылка на документ:
Сообщить(ЗначениеВСтрокуВнутр(СсылкаДок));
//Результат:
//    {"O","0","0","74","0","0","        58   "}

Как видите, в состав системного представления значения включаются следующие легко узнаваемые составные части:

  • тип объекта
  • внутренний идентификатор для объектов агрегатного типа
  • внутренний код объекта

Полученное строковое значение годится только для использования в рамках одной информационной базы (например, для хранения нескольких значений расшифровки в ячейках отчетов). Для обратного преобразования используется функция ЗначениеИзСтрокиВнутр().

Пример использования

Пример кода с использованием функции ЗначениеВСтрокуВнутр():

СсылкаСтр = ЗначениеВСтрокуВнутр(Ссылка);
//
//...
//
Объект = ЗначениеИзСтрокиВнутр(СсылкаСтр);
Если Объект.Выбран() = 1 Тогда
    Сообщить(Объект);
КонецЕсли;

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *