Next: , Previous: , Up: Parsing Helper Functions   [Index]


18.3.2 Setters

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.