summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--luatexbase-mcb.dtx37
1 files changed, 36 insertions, 1 deletions
diff --git a/luatexbase-mcb.dtx b/luatexbase-mcb.dtx
index d9fb995..0c1f687 100644
--- a/luatexbase-mcb.dtx
+++ b/luatexbase-mcb.dtx
@@ -862,7 +862,7 @@ luatexbase.create_callback = create_callback
% \end{macrocode}
%
% This function calls a callback. It can only call a callback created by
-% the \texttt{create} function.
+% the |create_callback| function.
%
% \begin{macrocode}
function call_callback(name, ...)
@@ -890,6 +890,41 @@ end
luatexbase.call_callback = call_callback
% \end{macrocode}
%
+% |is_active_callback| checks the activation state of a given
+% callback function. It is passed the description of the function
+% and the name of the callback it was registered under.
+%
+% The function raises an error if passed an invalid callback name
+% or if the name or the description is missing.
+% The return value is |true| iff the callback function is
+% registered, |false| otherwise.
+%
+% \begin{macrocode}
+--- string -> string -> bool
+luatexbase.is_active_callback = function (name, description)
+ if not name then
+ err ("unable to check for callback:\nno proper name passed")
+ return false
+ elseif not callbacktypes [name] then
+ err ("unable to check for callback %q:\nis not a valid callback", name)
+ return false
+ elseif not description then
+ err ("unable to check for callback %q:\nno description given", name)
+ return false
+ end
+ local lst = callbacklist [name]
+ if not lst then --- callback inactive, no functions registered
+ return false
+ end
+ for _, v in next, lst do
+ if v.description == description then --- success
+ return true
+ end
+ end
+ return false
+end
+% \end{macrocode}
+%
% That's all folks!
%
% \begin{macrocode}