update doc/*/scripting/builtins/libentities.md

2025-11-25 18:28:39 +03:00
parent d450bd3564
commit 145a7b6273
2 changed files with 17 additions and 0 deletions
@@ -35,6 +35,14 @@ entities.def_index(name: str) -> int

 -- Возвращает число доступных определений сущностей
 entities.defs_count() -> int
+```
+
+> [!NOTE]
+> Следующие функции для получения получения нескольких сущностей возвращают таблицы с целочисленными ключами (uid).
+> Для итерации нужно использовать pairs, для подсчёта размера таблицы - table.count_pairs.
+> Использование ipairs даст некорректные результаты, так как возвращаемая таблица не является массивом.
+
+```lua

 -- Возвращает таблицу всех загруженных сущностей
 entities.get_all() -> table