Differences

This shows you the differences between two versions of the page.

--- en:toolworks:docs:apparatus:naming-conventions [2022/04/30 19:11] – vladius
+++ en:toolworks:docs:apparatus:naming-conventions [2022/05/13 13:07] (current) – vladius
@@ Line 6: / Line 6: @@
 Those are usually featured across both C++ and BP workflows.
-**Get** – get some property value or an item directly. If the get is non-trivial (indirect with a searching involved), also asserts the result is actually available (non-null).
+===== Terms =====
-**Find** – something like "get", but doesn't assert if the needed item is missing after the search.
+**Get** – acquire some property value (or an item) in a direct manner, without performing any sophisticated time-consuming searches or calculations.
-**Obtain** – gets an item, if it already exists. Creates and returns a new one otherwise.
+**Find** – performs a ceratin (possibly time-consuming) search procedure of any indirection in order to get the necessary entity. The resulting status (or a referal type) would usually explicitly denote the search failure, i.e. the absense of the needed element.
+**Obtain** – tries to get an existing item (possibly for some state, specified by the arguments), and if it's missing creates a new one and returns it.
+**Calc** – performs a certain (possibly time-consuming) calculation in order to provide the needed result.
+**At** – get an element at a certain indexed position. A corresponding method thereby would usually accept an integral argument.
+**Make** – construct a certain entity in a useful (utility) fashing, returning it as a result. The resulting object is usually allocated in an automatic (scope) memory.
+**Collect** – add up to the existing elements within the container, instead of emptying it beforehand.