Различия

Показаны различия между двумя версиями страницы.

--- ru:toolworks:docs:apparatus:naming-conventions [2021/09/01 18:18] – создано + переведено. Требует проверки. jispar
+++ ru:toolworks:docs:apparatus:naming-conventions [2022/06/08 18:49] (текущий) – Немного поправил (убрал недопонятые моменты) jispar
@@ Строка 1: / Строка 1: @@
 ====== Именные соглашения ======
-Существует несколько обозначений, которые используются во фреймворке и о которых каждый пользователь должен быть осведомлён.
+Существует несколько обозначений, которые используются во фреймворке. Вы должны быть осведомлены о них, поскольку они обозначают определённую семантику поведения.
-Есть особенности в работе как с C++ так и с Blueprints:
+Есть особенности в работе как с C++, так и с Blueprints.
-**Get** – получить напрямую значение свойства или элемент. Если функция не тривиальна (косвенно выполняет поиск), то она выполнит assert в случае, когда результат не доступен (искомые данные равны null).
+===== Термины =====
-**Find** – что-то наподобие "get", но не вызовет assert, если искомый элемент не найден во время поиска.
+**Get** – получить некоторое значение свойства (или item-а) напрямую, без выполнения каких-либо трудоемких поисков или вычислений.
-**Obtain** – возвращает элемент, если он уже существует. Иначе создаёт и возвращает созданный элемент.
+**Find** – выполняет определенную (возможно, отнимающую много времени) процедуру поиска, чтобы получить необходимый объект. Результирующий статус обычно явно обозначает неудачу поиска, т.е. отсутствие нужного элемента.
+**Obtain** – пытается получить и выдать существующий объект, и если объект не найден, создаёт его и возвращает.
+**Calc** – выполняет определённые (возможно, отнимающие много времени) вычисления для того, чтобы обеспечить необходимый результат.
+**At** – получить элемент по определённой позиции (индексу). Соответствующий метод обычно принимает интегральный тип аргумента
+**Make** – сконструировать новый объект удобным способом, возвратив его в качестве результата.
+**Collect** - добавить к существующим элементам внутри контейнера, без предварительной очистки.