Function: org-get-category

org-get-category is a byte-compiled function defined in org.el.gz.

Signature

(org-get-category &optional POS FORCE-REFRESH)

Documentation

Get the category applying to position POS.

Source Code

;; Defined in /usr/src/emacs/lisp/org/org.el.gz
(defun org-get-category (&optional pos force-refresh)
  "Get the category applying to position POS."
  (save-match-data
    (when force-refresh (org-refresh-category-properties))
    (let ((pos (or pos (point))))
      (if (org-element--cache-active-p)
          ;; Sync cache.
          (org-with-point-at (org-element-property :begin (org-element-at-point pos))
            (or (org-entry-get-with-inheritance "CATEGORY")
                "???"))
        (or (get-text-property pos 'org-category)
            (progn
              (org-refresh-category-properties)
              (get-text-property pos 'org-category)))))))