forked from mirrors/org-mode
lisp/org-element-ast.el: Add a comment why no `org-element-properties'
This commit is contained in:
parent
bd9dc32178
commit
4ad7ae2520
|
@ -682,6 +682,12 @@ Return nil."
|
||||||
(org-element-properties-resolve node (eq 'force undefer)))
|
(org-element-properties-resolve node (eq 'force undefer)))
|
||||||
(org-element--properties-mapc fun node))
|
(org-element--properties-mapc fun node))
|
||||||
|
|
||||||
|
;; There is purposely no function like `org-element-properties' that
|
||||||
|
;; returns a list of properties. Such function would tempt the users
|
||||||
|
;; to (1) run it, creating a whole new list; (2) filter over that list
|
||||||
|
;; - the process requiring a lot of extra consing, adding a load onto
|
||||||
|
;; Emacs GC, memory used, and slowing things up as creating new lists
|
||||||
|
;; is not free for CPU.
|
||||||
(defsubst org-element-properties-map (fun node &optional undefer)
|
(defsubst org-element-properties-map (fun node &optional undefer)
|
||||||
"Apply FUN for each property of NODE and return a list of the results.
|
"Apply FUN for each property of NODE and return a list of the results.
|
||||||
FUN will be called with three arguments: property name, property
|
FUN will be called with three arguments: property name, property
|
||||||
|
|
Loading…
Reference in New Issue