К основному содержанию
A1sCode
Быстрый старт
Стандарты A1sCode · EN-канон и RU-эргономика

Нейминг и алиасы API

Как давать удобные русские алиасы, не меняя поведения и публичного API.

единый контракт2 примера кодаBSL / 1С

Принципы

  • Канон (EN): ToXML/FromXML, ToJSON/FromJSON — стабильные для внешних интеграций.
  • RU-алиасы (формат-явные): ВXML/ИзXML, ВJSON/ИзJSON — ergonomic sugar.
  • Всегда вызывать с квалификацией модуля: A1sX.ВXML(...), A1sJ.ВJSON(...).
  • Алиасы не расширяют контракт: они тонкие обёртки над каноном.

Шаблоны

XML

XMLнаведите на цветной токен, чтобы увидеть его рольSTANDARD
// Алиасы
Function ВXML(V, Show = Ложь) Export
  Return ToXML(V, Show);
EndFunction
Function ИзXML(Text) Export
  Return FromXML(Text);
EndFunction

JSON

JSONнаведите на цветной токен, чтобы увидеть его рольSTANDARD
// Алиасы
Function ВJSON(V, NoSpaces = Истина, Show = Ложь) Export
  Return ToJSON(V, NoSpaces, Show);
EndFunction
Function ИзJSON(Text) Export
  Return FromJSON(Text);
EndFunction

Анти-примеры

  • ✖ Общие имена без квалификатора модуля в месте вызова (ВСтроку(…)), когда используются разные форматы.
  • ✖ Алиас меняет поведение (логирование, валидации) — это уже не алиас.
  • ✖ Скрытые побочные эффекты в алиасе.

Совместимость

Каноничные EN-имена считаются «публичным API» для интеграций. RU-алиасы — удобство для разработчиков. Стабильность гарантирутеся для обеих форм, но при конфликте документация опирается на EN-канон.