Function: org-element-extract-element

org-element-extract-element is a byte-compiled function defined in org-element.el.gz.

Signature

(org-element-extract-element ELEMENT)

Documentation

Extract ELEMENT from parse tree.

Remove element from the parse tree by side-effect, and return it with its :parent property stripped out.

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-element.el.gz
(defun org-element-extract-element (element)
  "Extract ELEMENT from parse tree.
Remove element from the parse tree by side-effect, and return it
with its `:parent' property stripped out."
  (let ((parent (org-element-property :parent element))
	(secondary (org-element-secondary-p element)))
    (if secondary
        (org-element-put-property
	 parent secondary
	 (delq element (org-element-property secondary parent)))
      (apply #'org-element-set-contents
	     parent
	     (delq element (org-element-contents parent))))
    ;; Return ELEMENT with its :parent removed.
    (org-element-put-property element :parent nil)))