Auto-overlays are just normal Emacs overlays, so any of the standard Emacs functions can be used to search for overlays and retrieve overlay properties. The auto-overlays package provides some additional functions.
(auto-overlays-at-point @optionalpoint prop-test inactive
(function property) (function property value) (function (property1 property2 ...) (value1 value2 ...))
where function is a function, property is an overlay property name (a symbol), and value can be any value or lisp expression. For each overlay, first the values corresponding to the property names are retrieved from the overlay and any values that are lisp expressions are evaluated. Then function is called with the property values followed by the other values as its arguments. The test is satisfied if the result is non-nil, otherwise it fails. Tests are evaluated in order, but only up to the first failure. Only overlays that satisfy all property tests are returned.
All auto-overlays are given a non-nil
auto-overlay property, so
to restrict the list to auto-overlays, prop-test should include
the following property test:
For efficiency reasons, the auto-overlays package sometimes leaves
overlays hanging around in the buffer even when they should have been
deleted. These are marked with a non-nil
inactive property. By
default, auto-overlays-at-point ignores these. A non-nil
inactive will override this, causing inactive overlays to be
included in the returned list (assuming they pass all property tests).
@optionalprop-test within inactive
(auto-overlay-highest-priority-at-point @optionalpoint prop-test
priorityproperty (see Overlay Properties). If two overlays have the same priority, the innermost one takes precedence (i.e. the one that begins later in the buffer, or if they begin at the same point the one that ends earlier; if two overlays have the same priority and extend over the same region, there is no way to predict which will be returned).