% This LaTeX document was generated using the LaTeX backend of PlDoc,
% The SWI-Prolog documentation system



\section{library(prolog_jiti): Just In Time Indexing (JITI) utilities}

\label{sec:prologjiti}

\begin{tags}
    \tag{To be done}
Use \predref{print_message}{2} and dynamically figure out the column width.
\end{tags}

This module provides utilities to examine just-in-time indexes created
by the system and can help diagnosing space and performance issues.\vspace{0.7cm}

\begin{description}
    \predicate[det]{jiti_list}{0}{}
\nodescription
    \predicate[det]{jiti_list}{1}{:Spec}
List the JITI (Just In Time Indexes) of selected predicates. The
predicate \predref{jiti_list}{0} list all just-in-time indexed predicates. The
predicate \predref{jiti_list}{1} takes one of the patterns below. All parts
except for Name can be variables. The last pattern takes an
arbitrary number of arguments.

\begin{shortlist}
    \item Module:Head
    \item Module:Name/Arity
    \item Module:Name
\end{shortlist}

The columns use the following notation:

\begin{itemize}
    \item The \textit{Indexed} column describes the \verb$argument(s)$ indexed:

\begin{itemize}
    \item A plain integer refers to a 1-based argument number
    \item \textit{A+B} is a multi-argument index on the arguments \textit{A} and \textit{B}.
    \item \textit{A/B} is a deep-index on sub-argument \textit{B} of argument \textit{A}.
\end{itemize}

    \item The \textit{Buckets} specifies the number of buckets of the hash table
    \item The \textit{Speedup} specifies the selectivity of the index
    \item The \textit{Flags} describes additional properties, currently:

\begin{itemize}
    \item \verb$L$ denotes that the index contains multiple compound
terms with the same name/arity that may be used to create
deep indexes. The deep indexes themselves are created
as just-in-time indexes.
\end{itemize}
\end{itemize}
\end{description}