Next: Tools, Previous: Accessors, Up: Parsing Helper Functions [Index]
Setter functions allow modification of elements by side effect.
The elements and objects of an AST may be modified freely.
Even though structures obtained with local parsers are mutable, it is good practice to consider
them immutable. Destructively changing properties relative to buffer positions is likely to break
the caching mechanism running in the background. If you need to slightly alter an element obtained
using these functions, first copy it, using org-element-copy
, before modifying it by side effect.