Function: ibut:get

ibut:get is a byte-compiled function defined in hbut.el.

Signature

(ibut:get &optional LBL-KEY BUFFER KEY-SRC)

Documentation

Return implicit Hyperbole button symbol given by LBL-KEY and BUFFER.

KEY-SRC is given when retrieving global buttons and is the full source pathname.

Return a symbol which references the button.

All arguments are optional. When none are given, return a symbol for the button or button label that point is within or nil. BUFFER defaults to the current buffer. If both BUFFER and KEY-SRC are given, BUFFER is used as the button source location.

Return nil if no matching button is found.

Source Code

;; Defined in ~/.emacs.d/elpa/hyperbole-20260822.1645/hbut.el
(defun    ibut:get (&optional lbl-key buffer key-src)
  "Return implicit Hyperbole button symbol given by LBL-KEY and BUFFER.
KEY-SRC is given when retrieving global buttons and is the full source
pathname.

Return a symbol which references the button.

All arguments are optional.  When none are given, return a symbol for the
button or button label that point is within or nil.  BUFFER defaults to the
current buffer.  If both BUFFER and KEY-SRC are given, BUFFER is used as the
button source location.

Return nil if no matching button is found."
  (hattr:clear 'hbut:current)
  ;; Build and return button symbol with button properties
  (save-excursion
    (unless lbl-key
      (setq lbl-key (ibut:label-p nil nil nil nil t)))
    (hbut:funcall (lambda (lbl-key _buffer _key-src)
		    (goto-char (point-min))
		    (when (ibut:next-occurrence lbl-key)
		      (ibut:at-p)))
		  lbl-key buffer key-src)))