CTAN update: datatool

Nicola Talbot submitted an update to the

                datatool

package.

Version: 3.0 2025-03-03
License: lppl1.3

Summary description: Tools to load and manipulate data

Announcement text:
--------------------------------------------------------------------------------

Major rewrite. Rollback to v2.32 available if there are any issues.

Key features:

 - new 'math' package options: math=lua and math=l3fp. If not specified, the
   defaults are now math=lua for LuaLaTeX and math=l3fp otherwise.
   The older options are still supported, but the newer ones are better
   and support scientific notation.

 - parsed formatted numbers and currency have their values embedded within
   the control sequence variable for easy access without having to reparse.
   Note that this affects expansion, which may cause a difference from v2.32.

For example:

\DTLparse\result{\$12,345.67}
Original text: \result.
Data type: \DTLgetDataTypeName{\DTLdatumtype{\result}}.
Numeric value: \DTLdatumvalue{\result}.
Currency symbol: \DTLdatumcurrency{\result}.

In this case, \result will only expand as far as the original text.
To fully expand use \DTLusedatum{\result}.

  - For databases that contain numeric values that will be used in calculations
    (including plotting), use \DTLsetup{store-datum} (before creating the
    database) to embed the numeric information within the database entries.
    This should improve build time but may impair fast data lookup of unique strings.

  - New multi-purpose \DTLaction command with key=value interface that may
    be used instead of the alternative commands with long names.

  - New sort functions that internally use \seq_sort:Nn for faster sorting.
    The old sort commands still work but the newer ones are more efficient.

    Note: the glossaries package uses the datatool-base sorting commands
    for \printnoidxglossary. If you are using that command you may notice a
    difference. Make sure you have at least glossaries v4.56 to take
    advantage of the improved sorting and new localisation support.

  - Localisation support has been added for orthography (alphabet order for
    word sorting) and for numeric parsing (currency symbols, number group
    separator and decimal character).

    Support for numeric parsing and currency is supplied by datatool-regions
    which needs to be installed separately.

    Support for orthography is supplied by the applicable language module,
    which needs to be installed separately. Currently only datatool-english
    is available.

For example (assuming datatool v3.0, datatool-regions and datatool-english
are all installed):

\documentclass{article}

\usepackage{fontspec}
\setromanfont{Noto Serif}

\usepackage[locales={en-BE,ang-Latn}]{datatool-base}

\newcommand{\wordlist}{ýþung, eásteweard, áǽðan,
 Œthelwald, þorn, æsċ, eaþ-fynde, ðæt,
 Æðelþryð, aardvark, zebra, ƿēana, Oswine}

\begin{document}
Currency: \DTLdecimaltocurrency{1234.56}{\result}\result.

\DTLenLocaleHook
\DTLsortwordlist{\wordlist}{\DTLsortletterhandler}
Sorted list: \DTLformatlist{\wordlist}.

\DTLangLatnLocaleHook
\DTLsortwordlist{\wordlist}{\DTLsortletterhandler}
Sorted list: \DTLformatlist{\wordlist}.

\DTLresetRegion
\DTLresetLanguage
Currency: \DTLdecimaltocurrency{1234.56}{\result}\result.

\DTLsortwordlist{\wordlist}{\DTLsortletterhandler}
Sorted list: \DTLformatlist{\wordlist}.
\end{document}

The result is:
Currency: 1.234,56€.
Sorted list: aardvark, Æðelþryð, æsċ, áǽðan, ðæt, eásteweard,
eaþ-fynde, Œthelwald, Oswine, þorn, ƿēana, ýþung and zebra.
Sorted list: aardvark, áǽðan, eásteweard, eaþ-fynde, Œthelwald,
Oswine, ýþung, zebra, ƿēana, ðæt, æsċ, Æðelþryð ⁊ þorn.
Currency: ¤1,234.56.
Sorted list: aardvark, eaþ-fynde, eásteweard, Oswine, zebra, áǽðan,
æsċ, Æðelþryð, ðæt, ýþung, þorn, Œthelwald & ƿēana.

--------------------------------------------------------------------------------

This package is located at
   https://mirrors.ctan.org/macros/latex/contrib/datatool

More information is at
   https://www.ctan.org/pkg/datatool


--------------------------------------------------------------------------------

   Thanks for the upload.

     For the CTAN Team
    Manfred Lotz


CTAN is run entirely by volunteers and supported by TeX user groups.
Please join a user group or donate to one, see https://ctan.org/lugs .