[latex3-commits] [latex3/latex3] main: Add `\c_empty_str` (closes #1361) (02572c6a5)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/02572c6a53c287f81da67ae367a39c6418820d1d

>---------------------------------------------------------------

commit 02572c6a53c287f81da67ae367a39c6418820d1d
Author: Yukai Chou <muzimuzhi at gmail.com>
Date:   Thu Dec 7 18:37:33 2023 +0800

    Add `\c_empty_str` (closes #1361)


>---------------------------------------------------------------

02572c6a53c287f81da67ae367a39c6418820d1d
 l3kernel/CHANGELOG.md |  3 +++
 l3kernel/l3str.dtx    | 11 +++++++++++
 2 files changed, 14 insertions(+)

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
index 21453f725..81d96239a 100644
--- a/l3kernel/CHANGELOG.md
+++ b/l3kernel/CHANGELOG.md
@@ -7,6 +7,9 @@ this project uses date-based 'snapshot' version identifiers.
 
 ## [Unreleased]
 
+### Added
+- `\c_empty_str` (issue \#1361)
+
 ### Fixed
 - Return `str` (not `tl`) in `\bool_to_str:N` and `\bool_to_str:n` (issue \#1331)
 - Catcode of space from `\str_set_convert:Nnnn` (issue \#1344)
diff --git a/l3kernel/l3str.dtx b/l3kernel/l3str.dtx
index 9d838ec71..f168800ee 100644
--- a/l3kernel/l3str.dtx
+++ b/l3kernel/l3str.dtx
@@ -839,6 +839,10 @@
 %   code $12$.
 % \end{variable}
 %
+% \begin{variable}[added = 2023-12-07]{\c_empty_str}
+%   Constant that is always empty.
+% \end{variable}
+%
 % \section{Scratch strings}
 %
 % \begin{variable}{\l_tmpa_str, \l_tmpb_str}
@@ -2168,6 +2172,13 @@
 %    \end{macrocode}
 % \end{variable}
 %
+% \begin{variable}{\c_empty_str}
+%   An empty string is simply an empty token list.
+%    \begin{macrocode}
+\cs_new_eq:NN \c_empty_str \c_empty_tl
+%    \end{macrocode}
+% \end{variable}
+%
 % \begin{variable}{\l_tmpa_str, \l_tmpb_str, \g_tmpa_str, \g_tmpb_str}
 %   Scratch strings.
 %    \begin{macrocode}