Debian Codegraph @

texmf-dist/source/latex/tabular2/tabular2.dtx

raw
1 % ^^A ================================== 元注释 ==================================
2 % \iffalse meta-comment
3 %
4 % 文件:tabular2.dtx
5 %
6 % 版权 (C) 2023-2026 By Ms_yam
7 %
8 % 它可以在 LaTeX 项目公共许可(LPPL)1.3c 及之后的任意版本(随你的意见)下分发或修改。
9 % 这个许可的最新版本在如下文件中:
10 %
11 % https://www.latex-project.org/lppl.txt
12 %
13 % 本文件的 LPPL 维护状态为 "maintained"。
14 %
15 % 本文件的当前维护者是 Ms_yam。
16 %
17 % \fi
18 %
19 % ^^A ================================== 安装信息 ==================================
20 % \iffalse
21 %<*install>
22 \begingroup
23 \input docstrip.tex
24 \keepsilent
25 \askforoverwritefalse
26
27 \preamble
28 \endpreamble
29
30 \postamble
31 \endpostamble
32
33 \generate{
34 \file{tabular2.ins} {\from{\jobname.dtx}{install}}
35 \file{tabular2.sty} {\from{\jobname.dtx}{package}}
36 \let\MetaPrefix\relax
37 \def\MetaPrefix{}
38 \nopreamble\nopostamble
39 \file{README.md} {\from{\jobname.dtx}{readme}}
40 }
41
42 \ifx\documentclass\@undefined
43 \endbatchfile
44 \fi
45
46 \endgroup
47 %</install>
48 % \fi
49 %
50 % ^^A ================================== 文档驱动 ==================================
51 % \iffalse
52 %<*driver>
53 \documentclass[show-notes]{l3doc}
54 \usepackage{tabular2}
55
56 % ^^A 添加中文支持及设置超级链接
57 \usepackage[UTF8,heading]{ctex}
58 \hypersetup{
59 colorlinks,
60 linkcolor=blue,
61 % hyperindex,
62 pdfstartview=FitH,
63 plainpages=false,
64 % backref,
65 }
66
67 \usepackage{enumitem}
68 \setlist{noitemsep,topsep=0pt,parsep=0pt,partopsep=0pt}
69
70
71 % ^^A 引用待办包
72 \usepackage[nothing]{todo}
73
74
75 % ^^A 汉化 l3doc 的部分定义
76 \DeclareDocumentEnvironment { texnote } { }
77 {
78 \endgraf
79 \vspace{0.5em} % ^^A 3mm => 0.5em
80 \small\textbf{\TeX{} 黑客笔记:} % ^^A \TeX~hackers~note:
81 }
82 { \vspace{0.5em} } % ^^A 3mm => 0.5em
83
84 \ExplSyntaxOn
85 \NewDocumentCommand {\ttt} { m }
86 { \texttt{\tl_to_str:n{#1}} }
87 \ExplSyntaxOff
88
89 % ^^A 索引排除
90 \DoNotIndex{ \+, \-, \., \\, \ , ., .., \c, \d, \s, \A, \Z }
91 \DoNotIndex{ \begin, \end, \par, \newline,
92 \baselineskip, \noindent, \rule, \textwidth, \textheight,
93 \hsize, \hspace, \parindent, \vfill, \vskip,
94 \centering, \raggedleft, \raggedright,
95 \thefootnote, \footnote, \footnotemark, \footnotetext
96 }
97 \DoNotIndex{ \NeedsTeXFormat, \RequirePackage, \ProvidesExplPackage, \ProcessKeyOptions,
98 \NewDocumentCommand, \NewDocumentEnvironment, \ExplSyntaxOff, \IfBooleanF, \IfNoValueTF
99 }
100 \DoNotIndex{ \group_begin:, \group_end: }
101 \DoNotIndex{ \cs_new:Nn, \cs_new:Npn, \cs_set:Nn, \cs_set_eq:NN, \cs_set_eq:Nc, \cs_gset_eq:NN, \cs_if_free:NT, \cs_if_exist:NTF, \cs_if_exist:cF, \cs_generate_variant:Nn, \exp_args:Ne, \use:N, \use:c }
102 \DoNotIndex{ \prg_new_conditional:Nnn, \prg_generate_conditional_variant:Nnn, \prg_replicate:nn, \prg_return_true:, \prg_return_false: }
103 \DoNotIndex{ \msg_new:nnn, \msg_set:nnn, \msg_error:nnn, \msg_error:nnV }
104 \DoNotIndex{ \bool_new:N, \bool_new:c, \bool_gset_eq:NN, \bool_gset_eq:Nc, \bool_gset_eq:cN, \bool_set_eq:NN,
105 \bool_gset_true:N, \bool_gset_false:N, \bool_set_true:N, \bool_set_false:N,
106 \bool_if:NT, \bool_if:NF, \bool_if:NTF, \bool_if:cTF, \bool_if:nTF, \bool_show:N, \bool_log:N, \bool_until_do:nn, \c_true_bool
107 }
108 \DoNotIndex{ \tl_new:N, \tl_const:Nn, \tl_clear:N, \tl_set_eq:NN, \tl_set:Nn, \tl_set:NV, \tl_set:Ne, \tl_set:No,
109 \tl_if_empty:NT, \tl_if_empty:NF, \tl_if_empty:NTF, \tl_if_empty:nT, \tl_if_empty:nF, \tl_if_empty:nTF,
110 \tl_if_eq:NnTF, \tl_if_eq:VnT, \tl_if_in:NnT,
111 \tl_put_left:Nn, \tl_put_left:NV,
112 \tl_put_right:Nn, \tl_put_right:NV, \tl_replace_all:Nnn, \tl_to_str:N, \tl_to_str:n
113 }
114 \DoNotIndex{ \str_new:N, \str_const:Nn, \str_const:Ne, \str_clear:N, \str_set:Ne, \str_put_right:Nn,
115 \str_if_empty:nTF, \str_if_eq:nnT, \str_if_eq:VnT, \str_if_eq:VVT, \str_if_eq:nnTF, \str_if_eq:VnTF, \str_if_in:NnF, \str_if_in:nnTF,
116 \str_case:Vn, \str_case:nnF, \str_case:VnF, \str_case:NnF, \str_case:NnTF, \str_case_e:nnF, \str_map_inline:nn
117 }
118 \DoNotIndex{ \char_generate:nn }
119 \DoNotIndex{ \regex_const:Nn, \regex_extract_all:NnN, \regex_extract_all:NnNF, \regex_extract_all:nnNF, \regex_match:nnTF }
120 \DoNotIndex{ \int_new:N, \int_new:c, \int_gset_eq:NN, \int_gset_eq:Nc, \int_gset_eq:cN, \int_set_eq:NN, \int_set_eq:Nc,
121 \int_zero:N, \int_gzero:N, \int_incr:N, \int_gincr:N, \int_add:Nn, \int_add:cn, \int_gset:Nn, \int_gset:cn, \int_set:Nn,
122 \int_if_zero:nTF, \int_if_zero:nT, \int_if_zero:nF,
123 \int_case:nn, \int_compare:nNnT, \int_compare:nNnF, \int_compare:nNnTF,
124 \int_step_inline:nn, \int_step_inline:nnn, \int_step_inline:nnnn, \int_max:nn, \int_use:N, \int_to_Alph:n,
125 \int_use:N, \int_use:c, \int_show:N, \int_log:N
126 }
127 \DoNotIndex{ \dim_new:N, \dim_const:Nn, \dim_zero:N, \dim_set_eq:NN,
128 \dim_gset:Nn, \dim_set:Nn, \dim_add:Nn, \dim_sub:Nn, \dim_max:nn, \dim_eval:n,
129 \dim_compare:nNnT, \dim_compare:nNnTF, \dim_use:N
130 }
131 \DoNotIndex{ \seq_new:N, \seq_new:c, \seq_gset_eq:Nc, \seq_gset_eq:cN, \seq_set_eq:NN,
132 \seq_gclear:N, \seq_clear:N, \seq_set_split:Nnn, \seq_set_split:NVn, \seq_set_split:NnV, \seq_set_split:NVV,
133 \seq_if_empty_p:N, \seq_if_empty:NT, \seq_if_empty:NTF, \seq_count:N,
134 \seq_gput_left:Nn, \seq_gput_left:NV, \seq_gput_right:Nn, \seq_gput_right:Ne, \seq_gput_right:NV,
135 \seq_gpop_left:NN, \seq_pop_left:NN, \seq_pop_left:NNT, \seq_pop_left:NNTF, \seq_put_right:Nn, \seq_put_right:NV,
136 \seq_gset_item:Nnn, \seq_gset_item:Nne, \seq_gset_item:NnV, \seq_set_item:Nnn,
137 \seq_get_left:NN, \seq_get_right:NN, \seq_item:Nn,
138 \seq_map_function:NN, \seq_map_inline:Nn, \seq_show:N, \seq_log:N,
139 \c_empty_seq
140 }
141 \DoNotIndex{ \prop_new:N, \prop_new:c, \prop_const_from_keyval:Nn, \prop_gset_eq:Nc, \prop_gset_eq:cN,
142 \prop_gclear:N, \prop_clear:N, \prop_gset_eq:NN, \prop_if_empty:NTF, \prop_if_in:NVTF,
143 \prop_gput:Nnn, \prop_gput:Nne, \prop_gput:Nen, \prop_gput:NVn, \prop_gput:NVe, \prop_gput:NnV, \prop_gput:NeV,
144 \prop_put:Nnn, \prop_put:NnV, \prop_put:Nen,
145 \prop_put_if_new:Nnn, \prop_gput_if_new:NnV,
146 \prop_gpop:NnN, \prop_gpop:NeN, \prop_gpop:NnNT,
147 \prop_get:NnN, \prop_get:NVN, \prop_get:NnNF, \prop_get:NnNTF, \prop_get:NVNTF, \prop_get:NnNT,
148 \prop_if_in:NnT, \prop_if_in:NnTF,
149 \prop_map_inline:Nn, \prop_map_inline:cn, \prop_map_inline:nn, \prop_show:N, \prop_log:N
150 }
151 \DoNotIndex{ \scan_new:N }
152 \DoNotIndex{ \clist_new:N, \clist_if_in:nVTF, \clist_item:Nn, \clist_item:nn, \clist_item:Vn, \clist_map_inline:nn }
153 \DoNotIndex{ \keys_define:nn, \keys_set:nn, \l_keys_choice_tl }
154 \DoNotIndex{ \box_new:N, \box_ht:N, \box_dp:N, \box_set_dp:Nn, \box_wd:N, \box_use:N,
155 \hbox:n, \hbox_set:Nn, \vbox_set:Nn, \vbox_set_top:Nn, \vbox_set_to_ht:Nnn, \box_set_ht:Nn
156 }
157 \DoNotIndex{ \color_stroke:n, \color_stroke:e }
158 \DoNotIndex{ \draw_begin:, \draw_end:, \draw_box_use:N, \draw_box_use:Nn,
159 \draw_linewidth:n, \draw_set_linewidth:n, \draw_set_linewidth:e, \draw_set_linewidth:V,
160 \draw_dash_pattern:nn, \draw_set_dash_pattern:nn, \draw_set_dash_pattern:en, \draw_set_dash_pattern:Vn,
161 \draw_path_moveto:n, \draw_path_lineto:n, \draw_path_rectangle:nn, \draw_path_use_clear:n
162 }
163
164 \begin{document}
165 \DocInput{\jobname.dtx}
166 \end{document}
167 %</driver>
168 % \fi
169 %
170 % ^^A ================================ RADME ME ================================
171 % \iffalse
172 %<*readme> ^^A README
173
174 # 基本说明 Description
175
176 本宏包是一个实验性的表格排版解决方案。它采用一套全新的表格输入输出接口,
177 使得输入输出的方式多样化且更加可读。代码层上采用 expl3 语法,完全摆脱了对传
178 统的底层表格命令的依赖。
179
180 This package is an experimental solution for table typesetting.
181 It features a completely new set of input and output interfaces for tables,
182 which diversifies the methods of input and output and enhances readability.
183 At the code level, it is written using the expl3 syntax, completely eliminating
184 its reliance on traditional low-level table commands.
185
186
187 # 许可 License
188
189 版权 Copyright (C) 2023-2025 By Ms_yam
190
191
192 本宏包可以在 LaTeX 项目公共许可(LPPL)1.3c 及之后的任意版本(随你的意见)下分发或修改。
193 这个许可的最新版本在如下文件中:
194
195 https://www.latex-project.org/lppl.txt
196
197 It may be distributed and/or modified under the conditions of the
198 LaTeX Project Public License (LPPL), either version 1.3c of this
199 license or (at your option) any later version. The latest version
200 of this license is in the file
201
202 https://www.latex-project.org/lppl.txt
203
204
205 本文件的 LPPL 维护状态为 "maintained"。
206
207 This file has LPPL maintenance status "maintained".
208
209 本文件的当前维护者是 Ms_yam。
210
211 The current maintainer of this file is Ms_yam.
212
213 本宏包由以下文件组成:
214 tabular2.dtx(源代码)、
215 tabular2.ins、
216 tabular2.sty、
217 tabular2.pdf、
218 tabular2-sample.tex(源代码)、
219 tabular2-sample.pdf 和
220 README.md (本文件)。
221
222 This package consists of
223 the source file tabular2.dtx,
224 the install file tabular2.ins,
225 the drived files tabular2.sty,
226 tabular2.pdf,
227 the sample files tabular2-sample.tex,
228 tabular2-sample.pdf and
229 README.md(this file).
230
231 # 编译 Compilation
232
233 本宏包设计为单文件包,你可以直接使用以下命令编译:
234
235 This package is designed as a single-file package and can be
236 compiled directly with the following commands:
237
238 ```sh
239 # 提取宏包文件
240 xetex tabular2.dtx
241
242 # 使用 XeLaTeX 编译文档
243 xelatex tabular2.dtx
244 makeindex -s gglo.ist -o tabular2.gls tabular2.glo
245 makeindex -s gind.ist -o tabular2.ind tabular2.idx
246 xelatex tabular2.dtx
247 xelatex tabular2.dtx
248 ```
249
250 示例代码则直接编译(两次)即可:
251
252 The sample code is compiled directly (twice):
253
254 ```sh
255 xelatex tabular2-sample.tex
256 xelatex tabular2-sample.tex
257 ```
258
259 # 备注 Remark
260
261 * 目前属于开发阶段,变更比较频繁,部分文档暂不提供英文版,敬请谅解;
262 * 英文版本描述由 AI 翻译,如有差异,请以中文版本为准。
263
264 * It is currently in the development stage, the change is frequent,
265 some documents will not be provided in the English version, please understand.
266 * The English version description is translated by AI. In case of
267 any discrepancies, please refer to the Chinese version as the standard.
268
269 %</readme>
270 % \fi
271 %
272 % ^^A ================================== 文档内容 ==================================
273 %
274 % \changes{v0.1}{2025-08-09}{内部测试}
275 % \changes{v0.2}{2025-08-09}{初版发行}
276 % \changes{v0.3}{2025-09-03}{添加独立的行列名设置功能}
277 % \changes{v0.3}{2025-09-03}{添加按行或按列输入功能}
278 % \changes{v0.3}{2025-09-03}{添加对无表头的表格的支持}
279 % \changes{v0.3}{2025-09-03}{修复表格保存、恢复、查看命令}
280 % \changes{v0.3}{2025-09-03}{整理优化内部接口}
281 % \changes{v0.4}{2026-03-11}{调整宏包组织结构及规范命名}
282 % \changes{v0.4}{2026-03-11}{修改表头的数据结构并大幅重构内部函数}
283 %
284 % \title{^^A
285 % tabular2\thanks{原本计划叫 \pkg{xtable}/\pkg{xtabular},但与其它宏冲突;^^A
286 % 后受 R 的 \pkg{ggplot2} 的启发,用于表示这是一个全新的 tabular。} : ^^A
287 % 一个实验性的表格排版方案^^A
288 % }
289 %
290 % \author{Ms\_yam ~(\href{mailto:[email protected]}{Ms\[email protected]})^^A
291 % }
292 % \date{\zhdigits*{2026}年\zhnumber{03}月\zhnumber{16}日}
293 %
294 % \maketitle
295 %
296 % ^^A ---------------------------------- 文档部分 ----------------------------------
297 %
298 % \begin{documentation}
299 %
300 % \begin{abstract}
301 % 本宏包是一个实验性的表格排版解决方案。
302 % 它采用一套全新的表格输入输出接口,使得输入输出的方式多样化且更加可读。
303 % 代码层上采用 \pkg{expl3} 语法 |+| 盒子 |+| \pkg{l3draw}
304 % \footnote{此宏包当前仍被官方标注为“实验性”宏包,因此本宏包存在未及时响应 \pkg{l3draw} 宏包变更而带来异常的风险。} 绘图,
305 % 完全摆脱了对传统的底层表格命令的依赖
306 % \footnote{但仍然使用了部分底层命令,如 \ttt{\hsize} 等。如有更好的 \pkg{expl3} 实现方法,欢迎指正。}。
307 %
308 % \end{abstract}
309 %
310 % {\small\tableofcontents}
311 %
312 %
313 % \done \todo[Debug] { 修复由于测量单元格自然尺寸导致的脚注命令重复计数的问题 }
314 %
315 % \section{用户文档}
316 %
317 % 与传统表格不同,本模块将表格的数据录入与渲染输出彻底分开,前者用于设置表格数据(内容及内容样式)
318 % \footnote{原计划只涉及内容, 但由于宽高与对齐影响单元格大小,所以把这两部分放在前面。如有更好的意见,欢迎指点。},
319 % 后者确认渲染条件(边框、颜色等)。
320 %
321 % 为方便定位,本宏包为表格提供两种定位方式:数字坐标与行列名。
322 % 数字坐标从 $1$ 开始计数(不含表头 |Header|\footnote{在设计上,表头的坐标为 $0$,且行列表头(如果有)的默认内容为行列名。});
323 % 行列名则可由用户指定的
324 % \footnote{当行列名为纯数字时,定位按数字坐标直接处理。即使第 $1$ 列的列名为 $3$,$3$ 也始终指向第 $3$ 列。},
325 % 但不能是以下名称之一:|header|、|title|、|first|、|last|。
326 %
327 % 本宏包直接支持脚注命令 \cs{footnote} 与 \cs{footnotemark} ,但不建议混合使用这两个命令
328 % \footnote{前者是通过使用 \cs{footnotemark} + \cs{footnotetext} 命令实现的,混合使用有乱序风险。}。
329 %
330 %
331 % \subsection{数据输入}
332 %
333 % \subsubsection{录入环境}
334 %
335 % \begin{function}{xtable}
336 % \begin{syntax}
337 % \ttt{\begin}\{xtable\} \oarg{选项}
338 % ~~嵌套的环境与命令...
339 % \ttt{\end}\{xtable\}
340 % \end{syntax}
341 % 一个表格输入环境,它本身不能直接输入,也不会渲染输出表格。
342 % 它会先初始化一个空表,然后执行嵌套的数据输入环境与命令,
343 % 最后做一些必要的计算。
344 % \begin{texnote}
345 % 所有表格数据,必须通过嵌套在本环境中的环境与命令来输入。
346 % \end{texnote}
347 % \end{function}
348 % \todo[方向]{ 思考应当支持什么选项 }
349 %
350 % \subsubsection{行列名设置}
351 %
352 % \done\todo[功能] { 添加独立的行列名设置功能 }
353 %
354 % 本宏包可以单独设置表格的行名与列名,以便设计表格的结构及方便后续需要坐标的命令与环境定位。
355 %
356 % \begin{function}{\excelcolname}
357 % \begin{syntax}
358 % \cs{excelcolname} \oarg{n}
359 % \end{syntax}
360 % 将前 \meta{n} 列的列名设置为 $A$、$B$、\dots (类似 Excel 列名),默认 \meta{n} = $26$。
361 % 本命令不会影响表格的大小。
362 % \end{function}
363 %
364 %
365 % \begin{function}{\rowname, \colname}
366 % \begin{syntax}
367 % \cs{rowname} (\meta{i}) \oarg{分隔符} \Arg{名称列表}
368 % \cs{colname} (\meta{i}) \oarg{分隔符} \Arg{名称列表}
369 % \end{syntax}
370 % 从第 \meta{i} 行/列开始依次设置行名/列名。其中,名称由 \meta{名称列表} 指定,后者使用 \meta{分隔符} 分隔。
371 % 默认 \meta{i} = $1$,\meta{分隔符} = “$,$”。本命令会调整表格大小,使其可容纳 \meta{名称列表} 中的全部的行名/列名。
372 % \end{function}
373 %
374 %
375 % \subsubsection{内容录入}
376 %
377 % \begin{function}{data}
378 % \begin{syntax}
379 % \ttt{\begin}\{data\} \oarg{选项}
380 % ~~A,~B,~C |\\|\\
381 % ~~1,~2,~3...
382 % \ttt{\end}\{data\}
383 % \end{syntax}
384 % 表格内容录入环境。
385 % \begin{texnote}
386 % 本宏包只定义了其在 \ttt{xtable} 环境中的作用,对环境外不作干涉。【下同】
387 % \end{texnote}
388 % \end{function}
389 %
390 % 标准输入以 “|\\|” 为行分隔符
391 % \footnote{在标准输入中,如果单元格里也有换行,请使用 \ttt{\newline}。},
392 % 以指定的分隔符(默认为 “|,|”)为列分隔符,不做任何其它特殊处理。
393 % 这种输入方式简单易解码,处理速度快,因此推荐作为主要输入方式。
394 %
395 %
396 % 以下是一个类似之前的表格输入方式的示例:\label{标准输入}
397 %
398 % \begin{minipage}{0.6\textwidth}
399 % \begin{verbatim}
400 %
401 % \begin{xtable}
402 % % loc 用于指定基准位置,sep 用于指定分隔符
403 % \begin{data}[loc={2,1}, sep={&}]
404 % Name & Sex & Age\\
405 % John & man & 20
406 % \end{data}
407 % \end{xtable}
408 %
409 % \end{verbatim}
410 % \end{minipage}
411 % \begin{minipage}{0.29\textwidth}
412 % \begin{xtable}
413 % \begin{data}[loc={2,1}, sep={&}]
414 % Name & Sex & Age\\
415 % John & man & 20
416 % \end{data}
417 % \end{xtable}
418 % \rendertable
419 % \end{minipage}
420 %
421 %
422 % CSV 作为最传统的输入方式,本宏包也添加了支持\footnote{标准输入其实就是
423 % 一个特殊的 CSV 格式,但因其不需要考虑特殊字符,处理效率显著强于后者。}。
424 % 由于 \TeX 读取普通显示字符时,换行符会被忽略,因此在输入时也使用 “|\\|” 作为换行。
425 % \todo[功能]{ 处理 CSV 格式中的特殊字符 }
426 %
427 % 此外,本宏包还有限地支持 JSON 数据源,其中最主要的限制就是不允许嵌套。
428 % 以下是一个 JSON 的输入示例。\label{JSON 格式} \todo[功能]{ 处理 JSON 格式中的特殊字符 }
429 %
430 % \begin{minipage} {0.6\textwidth}
431 % \begin{verbatim}
432 %
433 % \begin{xtable}
434 % % format 用于指定输入的格式,也可以直接使用 json 选项
435 % \begin{data}[format=json]
436 % [
437 % {
438 % "Name": "张三",
439 % "Age": 30,
440 % "City": "北京"
441 % },
442 % {
443 % "Name": "李四",
444 % "Age": 25,
445 % "City": "上海"
446 % }
447 % ]
448 % \end{data}
449 % \end{xtable}
450 % \end{verbatim}
451 % \end{minipage}
452 % \begin{minipage} {0.29\textwidth}
453 % \begin{xtable}
454 % \begin{data}[json]
455 % [
456 % {
457 % "Name": "张三",
458 % "Age": 30,
459 % "City": "北京"
460 % },
461 % {
462 % "Name": "李四",
463 % "Age": 25,
464 % "City": "上海"
465 % }
466 % ]
467 % \end{data}
468 % \end{xtable}
469 % \rendertable
470 % \end{minipage}
471 %
472 %
473 %
474 % \begin{function}{\file}
475 % \begin{syntax}
476 % \cs{file} \oarg{选项} \Arg{文件名}
477 % \end{syntax}
478 % 导入数据文件,规则与 \ttt{data} 类似。【此功能尚未实现】
479 % \begin{texnote}
480 % 文件中的换行符无需处理,其他待确认。
481 % \end{texnote}
482 % \end{function}
483 % \todo[功能]{ 实现文件导入及细节描述 }
484 %
485 %
486 % \begin{function}{\row, \col, \cell}
487 % \begin{syntax}
488 % \cs{row} (\meta{行坐标},\meta{列坐标}) \oarg{分隔符} \Arg{内容}
489 % \cs{col} (\meta{行坐标},\meta{列坐标}) \oarg{分隔符} \Arg{内容}
490 % \cs{cell}(\meta{行坐标},\meta{列坐标}) \Arg{内容}
491 % \end{syntax}
492 % 按行/列/单元格的方式设定表格的内容。
493 % 对于行与列,若坐标缺省,则自动在末尾新增行或列;若只提供一个维度,则另一个维度自动补充为 $1$。
494 % \begin{texnote}
495 % \meta{行坐标}、\meta{列坐标} 坐标支持数据坐标或行名/列名,若行名/列名不存在,则自动添加到行尾/列尾。【下同】
496 % \end{texnote}
497 % \end{function}
498 % \done\todo[功能]{ 添加按行/列输入的命令\ttt{\row}、\ttt{\col} }
499 %
500 %
501 %
502 % \begin{function}{\savetable, \loadtable}
503 % \begin{syntax}
504 % \cs{savetable} \Arg{名称}
505 % \cs{loadtable} \Arg{名称}
506 % \end{syntax}
507 % 将当前的表格数据保存到指定 \meta{名称} 中,
508 % 或加载之前保存的名为 \meta{名称} 的表
509 % \footnote{它会替代当前表的全部内容,所以应当在输入其它数据之前加载。}。
510 % \end{function}
511 %
512 % \subsubsection{格式设置}
513 %
514 % \begin{function}{\rowheight, \colwidth}
515 % \begin{syntax}
516 % \cs{rowheight}\oarg{全局样式} \Arg{样式列表}
517 % \cs{colwidth} \oarg{全局样式} \oarg{总宽度} \Arg{样式列表}
518 % \end{syntax}
519 % 设置表格的行高与列宽样式,样式支持 |auto|、|same|、|fill|(仅列宽)、
520 % |samefill|(仅列宽) 及指定数值。
521 % \meta{样式列表} 若干个 \meta{[坐标=]样式} 组成,并以逗号分隔。
522 %
523 % 如果省略坐标,则坐标为 “前一个坐标 |+1|”。如果是 \meta{样式列表} 第 $1$ 个,
524 % 则默认为 |header|(有 |Header|) 或 $1$ (没有 |Header|)。
525 % \begin{texnote}
526 % 样式 |auto| 表示自然尺寸;|same| 则表示同组所有行/列的值相同
527 % \footnote{同时兼容所有行/列的自然尺寸,即同组自然尺寸的最大值。};
528 % |fill| 则会根据总宽度来补偿,即为 “自然尺寸+补偿值”
529 % \footnote{补偿值的目的是用于保证总宽度,即为控制总宽度,需要使用缩放这些列的宽度。};
530 % |samefill| 等于 |same|\footnote{但与纯 $same$ 不同组,即它们的宽度是另外一个值。} + |fill|。
531 % 所有 |fill| 的补偿值是一样的。样式支持缩写为首字母。
532 % \end{texnote}
533 % \end{function}
534 %
535 %
536 % \begin{function}{\rowalign, \colalign}
537 % \begin{syntax}
538 % \cs{rowalign} \oarg{全局样式} \Arg{样式列表}
539 % \cs{colalign} \oarg{全局样式} \Arg{样式列表}
540 % \end{syntax}
541 % 设置表格的行与列对齐方式;行对齐(垂直对齐)样式支持 |t|、|m|、|b|,
542 % 列对齐(水平对齐)样式支持 |l|、|c|、|r|。设置方式与 \cs{rowheight} 类似。
543 % \begin{texnote}
544 % 当 \meta{样式列表} 不含索引时,可以省略逗号,即类似 “|llcrl|” 一样输入。
545 % \end{texnote}
546 % \end{function}
547 %
548 %
549 % \subsubsection{合并单元格}
550 %
551 %
552 % \done \todo[功能]{ 添加合并单元格功能 }
553 %
554 % \begin{function}{\mergecell}
555 % \begin{syntax}
556 % \cs{mergecell} \oarg{数据角标} \Arg{对角坐标1} \Arg{对角坐标2} \oarg{行列对齐方式}
557 % \end{syntax}
558 % 合并 \meta{对角坐标1} 与 \meta{对角坐标2} 之间的单元格。
559 % 合并的后的单元格内容可以采用这个区域中的任何一个角的单元格内容;
560 % \meta{数据角标} 用来指定实际使用哪个角,默认为 $ul$。
561 % 合单单元格的对齐方式可由 \meta{行列对齐方式} 定义义,默认为 |mc|。
562 % \begin{texnote}
563 % 计算单元格排版尺寸时,会跳过合并单元格,即合并单元格的尺寸由其所在的行与列决定。
564 % 默认常规单元格的对齐方式由其所在的行与列中指定,无法专门指定。
565 % 如果确实需要单独指定,可以本命令合并一个 $1*1$ 的单元格,再指定该合并单元格的对齐方式。
566 % \end{texnote}
567 % \end{function}
568 %
569 %
570 % \subsection{渲染输出}
571 %
572 % \begin{function}{\printtable}
573 % \begin{syntax}
574 % \cs{printtable}[*] \oarg{缩进量}
575 % \end{syntax}
576 % 逐行打印表格,输出的表格不带格式(如边框与背景色),但会处理基本的对齐。
577 % \begin{texnote}
578 % 逐行输出,每行是一个水平盒子,因此可以正常分页。
579 % 另外,此命令是本宏包中渲染表格最快的命令。
580 % \end{texnote}
581 % \end{function}
582 %
583 %
584 % 以下章节 \ref{JSON 格式} 中的 JSON 输入示例的输出效果:(缩进量为 |4em|)\\
585 % \printtable[4em]
586 %
587 % 由于使用了水平盒子 |+ \\|,其副作用是在嵌套环境中可能报错 “There's no line here to end.”。
588 % 要在类似环境中使用本命令输出表格,请使用星号版本,区别在于它不会输出 |\\|。
589 %
590 % \begin{verbatim}
591 % \begin{table}[!htp]
592 % \centering
593 % \caption{嵌套的 \cs{printtable}}
594 % \parbox[t]{\textwidth}{\printtable*}
595 % \label{tab:嵌套的printtable}
596 % \end{table}
597 % \end{verbatim}
598 % 以上示例展示如何在表格浮动体中使用 \cs{printtable},其效果如表 \ref{tab:嵌套的printtable}。
599 %
600 % \begin{table}[!htp]
601 % \centering
602 % \caption{嵌套的 \cs{printtable}}
603 % \parbox[t]{\textwidth}{\printtable*}
604 % \label{tab:嵌套的printtable}
605 % \end{table}
606 %
607 %
608 % \begin{function}{\rendertable, \hrule, \vrule}
609 % \begin{syntax}
610 % \cs{rendertable} [booktabs, rule=\Arg{中间的线}]
611 % \cs{rendertable} [grid, rule =
612 % ~~\{
613 % ~~~~\cs{hrule} \oarg{默认值} \Arg{边框列表}
614 % ~~~~\cs{vrule} \oarg{默认值} \Arg{边框列表}
615 % ~~\} ]
616 % \end{syntax}
617 % 按预定义的渲染方式渲染表格。功能开发中,目前参数支持有限。\done \todo[优化]{ 更新边框命令及说明 }
618 % 前面介绍输入时显示的表格就是使用本命令(无参数)渲染的。
619 % \begin{texnote}
620 % 在渲染逻辑上,它是通过 \pkg{l3draw} 绘制的,即它是一个整体。
621 % 可以直接嵌套在其它环境中(如表 \ref{tab:rendertable[booktabs]}、
622 % 表 \ref{tab:rendertable[grid]}),但它不会分页。
623 % \end{texnote}
624 % \end{function}
625 %
626 % \begin{xtable}
627 % \begin{data}[loc={2,1},sep={&}]
628 % Name & Sex & Age\\
629 % John & man & 18\\
630 % Leon & man & 20\\
631 % Lily & woman & 21
632 % \end{data}
633 % \cell(1,Sex){man\\woman\\unknown}
634 % \cell(1,3){18\~{}25}
635 % \colwidth[a]{a}
636 % \rowalign[m]{}
637 % \colalign{l,c,r}
638 % \end{xtable}
639 %
640 %
641 % \begin{table}[!htp]
642 % \begin{minipage}{0.45\textwidth}
643 % \centering
644 % \caption{\cs{rendertable}\texttt{[booktabs]}}
645 % \rendertable[booktabs]
646 % \label{tab:rendertable[booktabs]}
647 % \end{minipage}
648 % \begin{minipage}{0.45\textwidth}
649 % \centering
650 % \caption{\cs{rendertable}\texttt{[grid]}}
651 % \rendertable[grid, rule =
652 % {
653 % \hrule{0.7pt,midrule,3=dash,bottomrule}
654 % \vrule{0.7pt,2=dotted}
655 % }]
656 % \label{tab:rendertable[grid]}
657 % \end{minipage}
658 % \end{table}
659 %
660 % \subsection{选项参数}
661 %
662 % \subsubsection{宏包选项}
663 %
664 %
665 % \begin{function}{xtable/package/en}
666 % \begin{syntax}
667 % en
668 % \end{syntax}
669 % 使用英文错误消息。
670 % \end{function}
671 %
672 % \begin{function}{xtable/package/cellsep}
673 % \begin{syntax}
674 % cellsep = {0.5em}
675 % \end{syntax}
676 % 设置表格的单元格之间的间距。
677 % \end{function}
678 %
679 %
680 % \begin{function}{xtable/package/margin}
681 % \begin{syntax}
682 % margin = \{0.4em, 0.6ex\}
683 % \end{syntax}
684 % 设置表格的单元格的边距。
685 % \end{function}
686 %
687 %
688 % \begin{function}{xtable/package/vspace}
689 % \begin{syntax}
690 % vspace = \{0.5ex, 0ex\}
691 % \end{syntax}
692 % 设置表格的上下边距。暂时只有顶边距生效。\todo[优化]{更新 vspace 的实现与说明}
693 % \end{function}
694 %
695 %
696 % \begin{function}{xtable/package/minwidth, xtable/package/lineskip}
697 % \begin{syntax}
698 % minwidth = {1.5em}, lineskip = {3ex}
699 % \end{syntax}
700 % 设置单元格的最小宽度及行基线间距。
701 % \end{function}
702 %
703 %
704 % \subsubsection{设置命令}
705 %
706 % \begin{function}{\rulepatternset}
707 % \begin{syntax}
708 % \cs{rulepatternset} \Arg{名称} \Arg{定义}
709 % \end{syntax}
710 % 将指定 \meta{名称} 的线型映射到指定 \meta{定义}。
711 % 线型定义的方式由一系列长度值组成,即 |{线, 空, ...}|。
712 % \end{function}
713 %
714 % \begin{function}{\rulewdset}
715 % \begin{syntax}
716 % \cs{rulewdset} \Arg{名称} \Arg{尺寸}
717 % \end{syntax}
718 % 将指定 \meta{名称} 的线宽映射到指定 \meta{尺寸}。
719 % \end{function}
720 %
721 % \begin{function}{\rulestyleset}
722 % \begin{syntax}
723 % \cs{rulestyleset} \Arg{名称} \Arg{线型} \Arg{线宽} \Arg{颜色}
724 % \end{syntax}
725 % 将指定 \meta{名称} 的线样式映射到指定 \meta{线型}、\meta{线宽} 及 \meta{颜色}。
726 % \meta{线型}、\meta{线宽} 可以是已定义的名称或字面值。
727 % \end{function}
728 %
729 % \subsection{调试}
730 %
731 % 本小节的命令主要用于输出一些表格的内部状态数据,以供调试使用。
732 %
733 % \begin{function}{\showtable}
734 % \begin{syntax}
735 % \cs{showtable}
736 % \end{syntax}
737 % 以文本形式显示当前表格的数据。效果如下:
738 % \end{function}
739 %
740 % \showtable
741 %
742 % \begin{function}{\logtable}
743 % \begin{syntax}
744 % \cs{logtable}
745 % \end{syntax}
746 % 在日志中显示表格的核心数据。
747 % \end{function}
748 %
749 %
750 % \section{关键逻辑}
751 %
752 % \subsection{单元格大小}
753 %
754 % \subsubsection{间距}
755 %
756 % 对于无边框打印表格,列间距由 |cellsep| 设置,表格四周无空隙。
757 % 行间距由 \LaTeX 自行按普通行处理。
758 %
759 % 对于有边框的渲染表格,单元格的边距由 |margin| 确认。
760 % 相当于行列间有 $2$ 倍的边距),表格四周有单倍的边距。
761 %
762 % \subsubsection{宽度}
763 %
764 % 宽度的计算步骤如下:
765 % \begin{enumerate}
766 % \item 计算所有列的自然宽度(该列中所有单元格的自然宽度的最大值);
767 % \item 将固定宽度的列的宽度设置为指定值;
768 % \item 将 |same| 与 |samefill| 的宽度设置为同组最大值;
769 % \item 计算当前总宽度与目标总宽度的差异,计算补偿值;
770 % \item 将所有 |fill| 与 |samefill| 的列宽度加上补偿值。
771 % \end{enumerate}
772 %
773 % 注:列宽度不包含边距,但总宽度有计算。
774 %
775 %
776 % \subsubsection{高度}
777 %
778 % 高度的计算步骤如下:
779 % \begin{enumerate}
780 % \item 计算所有单元格的首行填充值(用于平衡居中对齐时的基线问题);
781 % \item 计算所有行的自然高度与深度(该行中所有单元格的自然高度与浓度的最大值);
782 % \item 将固定高度的列的高度设置为(指定值-深度);
783 % \item 将 |same| 的高度与深度设置为同组最大值。
784 % \end{enumerate}
785 %
786 % 图 \ref{fig:表格渲染逻辑} 展示了基本的计算逻辑。\\
787 %
788 % \begin{figure}[htp]
789 % \centering
790 % \ExplSyntaxOn
791 % \draw_begin:
792 % \draw_set_linewidth:n {1pt} ^^A 边框
793 % \draw_path_rectangle:nn {0,0} {2cm,1cm}
794 % \draw_path_rectangle:nn {2cm,0cm} {3cm,1cm}
795 % \draw_path_rectangle:nn {0cm,1cm} {2cm,1cm}
796 % \draw_path_rectangle:nn {2cm,1cm} {3cm,1cm}
797 % \draw_path_use_clear:n { stroke }
798 % \color_fill:n { black!40 } ^^A 最终尺寸
799 % \draw_path_rectangle:nn {0cm + 2pt, 0cm + 2pt} {2cm - 4pt, 1cm - 4pt}
800 % \draw_path_rectangle:nn {2cm + 2pt, 0cm + 2pt} {3cm - 4pt, 1cm - 4pt}
801 % \draw_path_rectangle:nn {0cm + 2pt, 1cm + 2pt} {2cm - 4pt, 1cm - 4pt}
802 % \draw_path_rectangle:nn {2cm + 2pt, 1cm + 2pt} {3cm - 4pt, 1cm - 4pt}
803 % \draw_path_use_clear:n { fill }
804 % \color_fill:n { yellow!80!black } ^^A 自然尺寸
805 % \draw_path_rectangle:nn {0cm + 5pt, 0cm + 3pt} {2cm - 10pt, 1cm - 6pt}
806 % \draw_path_rectangle:nn {2cm + 5pt, 0cm + 3pt} {3cm - 10pt, 1cm - 6pt}
807 % \draw_path_rectangle:nn {0cm + 5pt, 1cm + 3pt} {2cm - 10pt, 1cm - 6pt}
808 % \draw_path_rectangle:nn {2cm + 5pt, 1cm + 3pt} {3cm - 10pt, 1cm - 6pt}
809 % \draw_path_use_clear:n { fill }
810 % \color_fill:n { green!50!black } ^^A 实际内容
811 % \draw_path_rectangle:nn {0cm + 10pt, 0cm + 6pt} {2cm - 20pt, 1cm - 12pt}
812 % \draw_path_rectangle:nn {2cm + 2pt, 0cm + 7pt} {3cm - 40pt, 1cm - 14pt}
813 % \draw_path_rectangle:nn {0cm + 15pt, 1cm + 11pt} {2cm - 30pt, 1cm - 13pt}
814 % \draw_path_rectangle:nn {2cm + 2pt, 1cm + 6pt} {3cm - 60pt, 1cm - 8pt}
815 % \draw_path_use_clear:n { fill }
816 % \color_select:n {black} ^^A 对齐方式
817 % \hbox_set:Nn \l_tmpa_box {居中对齐}
818 % \draw_box_use:Nn \l_tmpa_box
819 % {1cm - (\box_wd:N \l_tmpa_box)/2, 2.2cm}
820 % \hbox_set:Nn \l_tmpa_box {左对齐}
821 % \draw_box_use:Nn \l_tmpa_box
822 % {3.5cm - (\box_wd:N \l_tmpa_box)/2, 2.2cm}
823 % \hbox_set:Nn \l_tmpa_box {上下居中}
824 % \draw_box_use:Nn \l_tmpa_box
825 % {-0.4 - \box_wd:N \l_tmpa_box, 0.5cm - (\box_ht:N \l_tmpa_box)/2}
826 % \hbox_set:Nn \l_tmpa_box {顶对齐}
827 % \draw_box_use:Nn \l_tmpa_box
828 % {-0.4 - \box_wd:N \l_tmpa_box, 1.5cm - (\box_ht:N \l_tmpa_box)/2}
829 % \vbox_set:Nn \l_tmpa_box ^^A 图例
830 % {
831 % \hbox:n
832 % {
833 % \draw_begin:
834 % \draw_set_linewidth:n {1pt}
835 % \draw_path_rectangle:nn {0,0} {0.5cm-1pt, 0.3cm-1pt}
836 % \draw_path_use_clear:n { stroke }
837 % \draw_end:
838 % \ 线宽与间隙(白色)
839 % }
840 % \hbox:n
841 % { \color_fill:n { black!40 } \rule{0.5cm}{0.3cm}~最终尺寸}
842 % \hbox:n
843 % { \color_fill:n { yellow!80!black } \rule{0.5cm}{0.3cm}~自然尺寸 }
844 % \hbox:n
845 % { \color_fill:n { green!50!black } \rule{0.5cm}{0.3cm}~实际内容 }
846 % }
847 % \draw_box_use:Nn \l_tmpa_box {5.5cm, 0cm}
848 % \draw_end:
849 % \ExplSyntaxOff
850 % \caption{表格渲染逻辑} \label{fig:表格渲染逻辑}
851 % \end{figure}
852 %
853 %
854 %
855 % \end{documentation}
856 %
857 %
858 % ^^A ---------------------------------- 实现部分 ----------------------------------
859 %
860 % \newpage
861 %
862 % \begin{implementation}
863 %
864 % \section{基础定义}
865 %
866 % 本宏包的开发测试环境使用的 \LaTeX2e 的版本为 <2023-11-01> ,
867 % L3 编程层的版本为 <2024-02-20>。
868 % \footnote{同时使用以下环境验证与打包:\LaTeX2e 的版本为 <2025-11-01> ,
869 % L3 编程层的版本为 <2026-01-19>。}
870 %
871 % 本节实现本宏包的初始化及选项定义,并定义一些公共的变量与函数。
872 % 它们完全不依赖表格的设置,只为表格的实现提供功能。
873 %
874 % \begin{macrocode}
875 %<*package>
876 %<@@=xtable>
877 \NeedsTeXFormat{LaTeX2e}[2023-11-01]
878 \ProvidesExplPackage{tabular2}{2026-03-16}{0.4}
879 {A new table implementation base on expl3}
880 \RequirePackage{l3draw}[2024-02-20]
881 % \end{macrocode}
882 %
883 % \subsection{通用变体}
884 %
885 % 定义一些必要的系统函数的变体。
886 % \begin{macrocode}
887 \cs_generate_variant:Nn \msg_error:nnn { nnV }
888 \cs_generate_variant:Nn \str_const:Nn { Ne }
889 \cs_generate_variant:Nn \clist_item:nn { Vn }
890 \cs_generate_variant:Nn \seq_set_split:Nnn { NVn, NVV }
891 \cs_generate_variant:Nn \seq_set_item:Nnn { NnV, Nne }
892 \cs_generate_variant:Nn \seq_gset_item:Nnn { NnV, Nne }
893 \cs_generate_variant:Nn \prop_gput:Nnn { Nne, Nen, Nee, NeV, NVe, NVV }
894 \cs_generate_variant:Nn \prop_gpop:NnN { NeN }
895 \cs_generate_variant:Nn \color_stroke:n { e }
896 \cs_generate_variant:Nn \regex_extract_all:NnN { NVN }
897 % \end{macrocode}
898 %
899 %
900 % \subsection{\pkg{l3draw} 函数}
901 %
902 % 在 2025-06-30 发布的新版 \pkg{l3draw} 中,将部分设置函数的函数名添加了 |set| 部分。
903 % 但考虑到部分用户可能并未升级到此版本,故增加此部分以兼容旧版本。
904 % \begin{macrocode}
905 \cs_if_free:NT \draw_set_linewidth:n
906 { \cs_gset_eq:NN \draw_set_linewidth:n \draw_linewidth:n }
907 \cs_if_free:NT \draw_set_dash_pattern:nn
908 { \cs_gset_eq:NN \draw_set_dash_pattern:nn \draw_dash_pattern:nn }
909 % \end{macrocode}
910 %
911 % 定义 \pkg{l3draw} 函数的变体。
912 % \begin{macrocode}
913 \cs_generate_variant:Nn \draw_set_linewidth:n { V, e }
914 \cs_generate_variant:Nn \draw_set_dash_pattern:nn { Vn, en }
915 % \end{macrocode}
916 %
917 %
918 % \subsection{消息定义}
919 %
920 % 本小节定义一些常见的错误消息。
921 %
922 % \begin{macrocode}
923 \msg_new:nnn {xtable} {unknown_row_name} {未知的行名称:<#1>}
924 \msg_new:nnn {xtable} {unknown_col_name} {未知的列名称:<#1>}
925 \msg_new:nnn {xtable} {unknown_input} {未知的输入:<#1>}
926 \msg_new:nnn {xtable} {unknown_format} {未知的格式:<#1>}
927 \msg_new:nnn {xtable} {unknown_cell} {未知的单元格数据 @<#1>}
928 \msg_new:nnn {xtable} {merged_cell} {已经合并的单元格 @<#1>}
929 \msg_new:nnn {xtable} {unmerged_cell} {未合并的单元格 @<#1>}
930 \msg_new:nnn {xtable} {outside_xtable} {<#1> 应当在 xtable 环境中使用}
931 \msg_new:nnn {xtable} {outside_render} {<#1> 应当在 \rendertable 命令中使用}
932 \msg_new:nnn {xtable} {unsaved_table} {未保存的表:<#1>}
933 % \end{macrocode}
934 %
935 % 添加英文支持。
936 % \begin{macrocode}
937 \cs_new:Nn \@@_en_msg_support:
938 {
939 \msg_set:nnn {xtable} {unknown_row_name} {Unknown row name: <##1>}
940 \msg_set:nnn {xtable} {unknown_col_name} {Unknown column name: <##1>}
941 \msg_set:nnn {xtable} {unknown_input} {Unknown input: <##1>}
942 \msg_set:nnn {xtable} {unknown_format} {Unknown format: <##1>}
943 \msg_set:nnn {xtable} {unknown_cell} {Unknown cell data @<##1>}
944 \msg_set:nnn {xtable} {merged_cell} {Already merged cell @<##1>}
945 \msg_set:nnn {xtable} {unmerged_cell} {Unmerged cell @<##1>}
946 \msg_set:nnn {xtable} {outside_xtable} {<##1> should be used inside xtable environment}
947 \msg_set:nnn {xtable} {outside_render} {<##1> should be used inside \rendertable command}
948 \msg_set:nnn {xtable} {unsaved_table} {Unsaved table: <##1>}
949 }
950 % \end{macrocode}
951 %
952 %
953 % \subsection{宏包选项}
954 %
955 % 本小节定义宏包的选项及对应的变量。
956 % 选项是唯一修改这些变量的地方。
957 %
958 % \begin{variable}{\g_@@_cell_sep_dim, \g_@@_row_margin_dim, \g_@@_col_margin_dim}
959 % 行列间距与边距。
960 % \begin{macrocode}
961 \dim_new:N \g_@@_cell_sep_dim % 单元格间的水平间距(用于打印表格)
962 \dim_new:N \g_@@_row_margin_dim % 行边距与列边路(用于渲染表格)
963 \dim_new:N \g_@@_col_margin_dim
964 % \end{macrocode}
965 % \end{variable}
966 %
967 % \begin{variable}{\g_@@_above_space_dim, \g_@@_below_space_dim,
968 % \g_@@_cell_wd_min_dim, \g_@@_cell_lineskip_dim}
969 % 表格上下边空、单元格最小宽度及单元格内行间距。
970 % \begin{macrocode}
971 \dim_new:N \g_@@_above_space_dim % 表格上下边空
972 \dim_new:N \g_@@_below_space_dim
973 \dim_new:N \g_@@_cell_wd_min_dim % 单元格的最小宽度
974 \dim_new:N \g_@@_cell_lineskip_dim % 多行单元格的行距
975 % \end{macrocode}
976 % \end{variable}
977 %
978 %
979 % \begin{variable}{xtable/package}
980 % 定义宏包选项。
981 % \begin{macrocode}
982 \keys_define:nn { xtable / package }
983 {
984 en .code:n = { \@@_en_msg_support: },
985 cellsep .dim_gset:N = \g_@@_cell_sep_dim,
986 cellsep .initial:n = { 0.5em },
987 margin .code:n =
988 {
989 \dim_gset:Nn \g_@@_row_margin_dim { \clist_item:nn {#1} {2} }
990 \dim_gset:Nn \g_@@_col_margin_dim { \clist_item:nn {#1} {1} }
991 },
992 margin .initial:n = { 0.4em, 0.6ex },
993 vspace .code:n =
994 {
995 \dim_gset:Nn \g_@@_above_space_dim { \clist_item:nn {#1} {1} }
996 \dim_gset:Nn \g_@@_below_space_dim { \clist_item:nn {#1} {2} }
997 },
998 vspace .initial:n = { 0.5ex, -1ex },
999 minwidth .dim_gset:N = \g_@@_cell_wd_min_dim,
1000 minwidth .initial:n = { 1.5em },
1001 lineskip .dim_gset:N = \g_@@_cell_lineskip_dim,
1002 lineskip .initial:n = { 3ex }
1003 }
1004 \ProcessKeyOptions [ xtable / package ]
1005 % \end{macrocode}
1006 % \end{variable}
1007 %
1008 %
1009 %
1010 % \subsection{通用变量}
1011 %
1012 % 本小节定义一些通用的变量,供整个宏包中使用。
1013 %
1014 % \subsubsection{全局常量}
1015 %
1016 % \begin{variable}{\c_@@_space_str, \c_@@_escape_str, \c_@@_lbrace_str, \c_@@_rbrace_str}
1017 % 定义一些不易直接输入的字符常量。
1018 % \begin{macrocode}
1019 \str_const:Ne \c_@@_space_str { \char_generate:nn {32} {10} } % <space>
1020 \str_const:Ne \c_@@_escape_str { \char_generate:nn {92} {12} } % \
1021 \str_const:Ne \c_@@_lbrace_str { \char_generate:nn {123} {12} } % {
1022 \str_const:Ne \c_@@_rbrace_str { \char_generate:nn {125} {12} } % }
1023 % \end{macrocode}
1024 % \end{variable}
1025 %
1026 %
1027 % \begin{variable}{\s_@@_mark}
1028 % 定义内部标记。
1029 % \begin{macrocode}
1030 \scan_new:N \s_@@_mark
1031 % \end{macrocode}
1032 % \end{variable}
1033 %
1034 %
1035 % \begin{variable}{\c_@@_std_ht_dim, \c_@@_std_dp_dim}
1036 % 单行文字的标准高度与深度。
1037 % \begin{macrocode}
1038 \dim_const:Nn \c_@@_std_ht_dim {1.91ex} % 约等于汉字的高度,字母高度{1.67ex}
1039 \dim_const:Nn \c_@@_std_dp_dim {0.48ex} % 约等于字母的深度
1040 % \end{macrocode}
1041 % \end{variable}
1042 %
1043 %
1044 % \begin{variable}{\c_@@_merge_loc_prop, \c_@@_merge_align_prop}
1045 % 合并单元格设置映射表。
1046 % \begin{macrocode}
1047 \prop_const_from_keyval:Nn \c_@@_merge_loc_prop
1048 {
1049 ul = ul, ur = ur, dl = dl, du = du,
1050 lu = ul, ru = ur, ld = dl, ud = du
1051 }
1052 \prop_const_from_keyval:Nn \c_@@_merge_align_prop
1053 {
1054 tl = {t, l}, tc = {t, c}, tr = {t, r},
1055 ml = {m, l}, mc = {m, c}, mr = {m, r},
1056 bl = {b, l}, bc = {b, c}, br = {b, r},
1057 lt = {t, l}, ct = {t, c}, rt = {t, r},
1058 lm = {m, l}, cm = {m, c}, rm = {m, r},
1059 lb = {b, l}, cb = {b, c}, rb = {b, r},
1060 l = {m, l}, c = {m, c}, r = {m, r},
1061 t = {t, c}, m = {m, c}, b = {b, c}
1062 }
1063 % \end{macrocode}
1064 % \end{variable}
1065 %
1066 %
1067 %
1068 %
1069 % \subsubsection{专用变量}
1070 %
1071 % 本小节定义一些专用的变量,以供缓存或函数之间传递特定的数据。
1072 % 使用这些变量的函数应当在文档中声明。
1073 %
1074 %
1075 % \begin{variable}{\l_@@_row_loc_int, \l_@@_col_loc_int}
1076 % 用于存储(行/列的)数字坐标信息。
1077 % \begin{macrocode}
1078 \int_new:N \l_@@_row_loc_int
1079 \int_new:N \l_@@_col_loc_int
1080 % \end{macrocode}
1081 % \end{variable}
1082 %
1083 %
1084 % \begin{variable}{\l_@@_is_box_bool, \l_@@_data_tl}
1085 % 用于存储单元格内容及状态的变量。
1086 % \begin{macrocode}
1087 \bool_new:N \l_@@_is_box_bool
1088 \tl_new:N \l_@@_data_tl
1089 % \end{macrocode}
1090 % \end{variable}
1091 %
1092 %
1093 % \begin{variable}{\l_@@_style_tl, \l_@@_row_align_tl, \l_@@_col_align_tl}
1094 % 用于存储通用样式与对齐样式专用的凭据表。
1095 % \begin{macrocode}
1096 \tl_new:N \l_@@_style_tl
1097 \tl_new:N \l_@@_row_align_tl
1098 \tl_new:N \l_@@_col_align_tl
1099 % \end{macrocode}
1100 % \end{variable}
1101 %
1102 %
1103 % \begin{variable}{\l_@@_merge_id_tl, \l_@@_merge_seq}
1104 % 用于存储合并单元格索引的凭据表和内容的序列。
1105 % \begin{macrocode}
1106 \tl_new:N \l_@@_merge_id_tl
1107 \seq_new:N \l_@@_merge_seq
1108 % \end{macrocode}
1109 % \end{variable}
1110 %
1111 %
1112 % \begin{variable}{\l_@@_wd_dim, \l_@@_ht_dim, \l_@@_dp_dim, \l_@@_ufill_dim, \l_@@_dfill_dim}
1113 % 用于存储宽高深等尺寸信息。
1114 % \begin{macrocode}
1115 \dim_new:N \l_@@_wd_dim
1116 \dim_new:N \l_@@_ht_dim
1117 \dim_new:N \l_@@_dp_dim
1118 \dim_new:N \l_@@_ufill_dim
1119 \dim_new:N \l_@@_dfill_dim
1120 % \end{macrocode}
1121 % \end{variable}
1122 %
1123 %
1124 %
1125 %
1126 % \subsubsection{缓存变量}
1127 %
1128 % 本小节定义一些缓存的变量,以供函数内保存数据,但不应用于函数间传递数据。
1129 % 使用这些变量的函数应当在文档中声明。
1130 %
1131 % \begin{variable}{\l_@@_cachea_int, \l_@@_cacheb_int}
1132 % 用于缓存整数。
1133 % \begin{macrocode}
1134 \int_new:N \l_@@_cachea_int
1135 \int_new:N \l_@@_cacheb_int
1136 % \end{macrocode}
1137 % \end{variable}
1138 %
1139 %
1140 % \begin{variable}{\l_@@_cachea_dim, \l_@@_cacheb_dim}
1141 % 用于缓存尺寸信息。
1142 % \begin{macrocode}
1143 \dim_new:N \l_@@_cachea_dim
1144 \dim_new:N \l_@@_cacheb_dim
1145 % \end{macrocode}
1146 % \end{variable}
1147 %
1148 %
1149 % \begin{variable}{\l_@@_cachea_tl, \l_@@_cacheb_tl}
1150 % 用于缓存的凭据表。
1151 % \begin{macrocode}
1152 \tl_new:N \l_@@_cachea_tl
1153 \tl_new:N \l_@@_cacheb_tl
1154 % \end{macrocode}
1155 % \end{variable}
1156 %
1157 %
1158 % \begin{variable}{\l_@@_cachea_seq, \l_@@_cacheb_seq}
1159 % 用于缓存的属性表。
1160 % \begin{macrocode}
1161 \seq_new:N \l_@@_cachea_seq
1162 \seq_new:N \l_@@_cacheb_seq
1163 % \end{macrocode}
1164 % \end{variable}
1165 %
1166 %
1167 % \subsubsection{临时变量}
1168 %
1169 % 本小节定义一些临时变量\footnote{不使用系统提供的临时变量,以防止和其它宏包冲突。},
1170 % 以供函数内部使用\footnote{不应当使用这些变量在函数之间传递数据。}。
1171 % 可以随意使用这些变量而无需当在文档中声明
1172 % \footnote{应当假定调用任何函数都会修改这些变量的值。}。
1173 %
1174 % \begin{variable}{\l_@@_tmpa_int, \l_@@_tmpb_int}
1175 % 整数变量。
1176 % \begin{macrocode}
1177 \int_new:N \l_@@_tmpa_int
1178 \int_new:N \l_@@_tmpb_int
1179 % \end{macrocode}
1180 % \end{variable}
1181 %
1182 %
1183 % \begin{variable}{\l_@@_tmpa_dim, \l_@@_tmpb_dim}
1184 % 长度变量。
1185 % \begin{macrocode}
1186 \dim_new:N \l_@@_tmpa_dim
1187 \dim_new:N \l_@@_tmpb_dim
1188 % \end{macrocode}
1189 % \end{variable}
1190 %
1191 %
1192 % \begin{variable}{\l_@@_tmpa_tl, \l_@@_tmpb_tl, \l_@@_tmpa_str, \l_@@_tmpb_str}
1193 % 凭据表与字符串。
1194 % \begin{macrocode}
1195 \tl_new:N \l_@@_tmpa_tl
1196 \tl_new:N \l_@@_tmpb_tl
1197 \str_new:N \l_@@_tmpa_str
1198 \str_new:N \l_@@_tmpb_str
1199 % \end{macrocode}
1200 % \end{variable}
1201 %
1202 %
1203 % \begin{variable}{\l_@@_tmpa_seq, \l_@@_tmpb_seq, \l_@@_tmpa_prop, \l_@@_tmpb_prop}
1204 % 序列与属性表。
1205 % \begin{macrocode}
1206 \seq_new:N \l_@@_tmpa_seq
1207 \seq_new:N \l_@@_tmpb_seq
1208 \prop_new:N \l_@@_tmpa_prop
1209 \prop_new:N \l_@@_tmpb_prop
1210 % \end{macrocode}
1211 % \end{variable}
1212 %
1213 %
1214 % \begin{variable}{\l_@@_tmpa_box, \l_@@_tmpb_box}
1215 % 盒子对象。
1216 % \begin{macrocode}
1217 \box_new:N \l_@@_tmpa_box
1218 \box_new:N \l_@@_tmpb_box
1219 % \end{macrocode}
1220 % \end{variable}
1221 %
1222 % \subsection{通用函数}
1223 %
1224 % 本小节定义一些通用的函数,供整个宏包中使用。
1225 % 本小节只对外提供功能,不提供变量,也依赖外部变量。
1226 %
1227 % \subsubsection{常规设置}
1228 %
1229 % \begin{macro}{\@@_init_seq:Nnn, \@@_ginit_seq:Nnn}
1230 % 初始化序列 |#1|,使其元素个数为 |#2|,且元素内容均为 |#3|。
1231 % \begin{macrocode}
1232 \cs_new:Nn \@@_init_seq:Nnn
1233 {
1234 \seq_clear:N #1
1235 \prg_replicate:nn {#2} { \seq_put_right:Nn #1 {#3} }
1236 }
1237 \cs_new:Nn \@@_ginit_seq:Nnn
1238 {
1239 \seq_gclear:N #1
1240 \prg_replicate:nn {#2} { \seq_gput_right:Nn #1 {#3} }
1241 }
1242 \cs_generate_variant:Nn \@@_init_seq:Nnn {Nne}
1243 % \end{macrocode}
1244 % \end{macro}
1245 %
1246 %
1247 %
1248 % \begin{macro}{\@@_int_set_max:Nn, \@@_int_gset_max:Nn}
1249 % 将变量(|#1|)的值与指定值(|#2|)中的最大值赋值给变量。
1250 % \begin{macrocode}
1251 \cs_new:Nn \@@_int_set_max:Nn
1252 { \int_set:Nn #1 { \int_max:nn {#1} {#2} } }
1253 \cs_new:Nn \@@_int_gset_max:Nn
1254 { \int_gset:Nn #1 { \int_max:nn {#1} {#2} } }
1255 \cs_generate_variant:Nn \@@_int_gset_max:Nn {cn}
1256 % \end{macrocode}
1257 % \end{macro}
1258 %
1259 %
1260 % \begin{macro}{\@@_dim_set_max:NN, \@@_dim_set_max:Nn}
1261 % 将变量(|#1|)的值与指定值(|#2|)中的最大值赋值给变量。
1262 % \begin{macrocode}
1263 \cs_new:Nn \@@_dim_set_max:NN
1264 { \dim_set:Nn #1 { \dim_max:nn {#1} {#2} } }
1265 \cs_new:Nn \@@_dim_set_max:Nn
1266 { \dim_set:Nn #1 { \dim_max:nn {#1} {#2} } }
1267 % \end{macrocode}
1268 % \end{macro}
1269 %
1270 %
1271 % \subsubsection{脚注函数}
1272 %
1273 % \changes{v0.4}{2026-03-11}{添加对脚注的支持}
1274 %
1275 % \begin{variable}{\g_@@_footnote_prop}
1276 % 表格脚注支持专用变量。
1277 % \begin{macrocode}
1278 \prop_new:N \g_@@_footnote_prop
1279 % \end{macrocode}
1280 % \end{variable}
1281 %
1282 %
1283 % \begin{macro}{\@@_origin_footnote:, \@@_origin_footnotemark:}
1284 % 备份系统脚注函数。
1285 % \begin{macrocode}
1286 \cs_gset_eq:NN \@@_origin_footnote: \footnote
1287 \cs_gset_eq:NN \@@_origin_footnotemark: \footnotemark
1288 % \end{macrocode}
1289 % \end{macro}
1290 %
1291 %
1292 % \begin{macro}{\@@_footnote:, \@@_footnotemark:}
1293 % 只保留占位符的脚注函数。
1294 % \begin{macrocode}
1295 \NewDocumentCommand \@@_footnote: { O{} m }
1296 { \@@_origin_footnotemark:[99] }
1297 \NewDocumentCommand \@@_footnotemark: { O{} }
1298 { \@@_origin_footnotemark:[99] }
1299 % \end{macrocode}
1300 % \end{macro}
1301 %
1302 % \begin{macro}{\@@_footnote_support:, \@@_footnote_print:}
1303 % 脚注标签与内容拆分实现的脚注函数。
1304 % \begin{macrocode}
1305 \NewDocumentCommand \@@_footnote_support: { o m }
1306 {
1307 \IfNoValueTF {#1}
1308 {
1309 \@@_origin_footnotemark:
1310 \prop_gput:Nen \g_@@_footnote_prop {\thefootnote} {#2}
1311 }
1312 {
1313 \@@_origin_footnotemark:[#1]
1314 \prop_gput:Nnn \g_@@_footnote_prop {#1} {#2}
1315 }
1316 }
1317 \cs_new:Nn \@@_footnote_print:
1318 {
1319 \prop_map_inline:Nn \g_@@_footnote_prop
1320 { \footnotetext[##1] {##2} }
1321 }
1322 % \end{macrocode}
1323 % \end{macro}
1324 %
1325 %
1326 %
1327 % \begin{macro}{\@@_disable_sys_func:, \@@_support_sys_func:, \@@_restore_sys_func:}
1328 % 切换脚注函数。
1329 % \begin{macrocode}
1330 \cs_new:Nn \@@_disable_sys_func:
1331 {
1332 \prop_gclear:N \g_@@_footnote_prop
1333 \cs_set_eq:NN \footnote \@@_footnote:
1334 \cs_set_eq:NN \footnotemark \@@_footnotemark:
1335 }
1336 \cs_new:Nn \@@_support_sys_func:
1337 {
1338 \prop_gclear:N \g_@@_footnote_prop
1339 \cs_set_eq:NN \footnote \@@_footnote_support:
1340 }
1341 \cs_new:Nn \@@_restore_sys_func:
1342 {
1343 \@@_footnote_print:
1344 \cs_set_eq:NN \footnote \@@_origin_footnote:
1345 \cs_set_eq:NN \footnotemark \@@_origin_footnotemark:
1346 }
1347 % \end{macrocode}
1348 % \end{macro}
1349 %
1350 %
1351 % \subsubsection{临时函数}
1352 %
1353 % \begin{macro}{\@@_tmpa_cs:, \@@_tmpb_cs:}
1354 % 两个临时函数,用于临时保存函数的定义。
1355 % \begin{macrocode}
1356 \cs_new:Nn \@@_tmpa_cs: {}
1357 \cs_new:Nn \@@_tmpb_cs: {}
1358 % \end{macrocode}
1359 % \end{macro}
1360 %
1361 %
1362 % \subsection{边框线样式}
1363 %
1364 % 本小节提供边框线的设置及应用功能。样式是全局设置,可以在表格渲染中应用样式。
1365 % 本小节函数不依赖外部变量,外面的函数也不应当修改本小节的变量。
1366 %
1367 %
1368 % \subsubsection{专用变量}
1369 %
1370 % \begin{variable}{\g_@@_rule_pattern_prop, \g_@@_rule_wd_prop, \g_@@_rule_style_prop}
1371 % 用于全局存储表格线型、线宽与样式。
1372 % 样式的值为\{线型, 线宽, 颜色\}(分隔符为 \cs{s_@@_mark})。
1373 % \begin{macrocode}
1374 \prop_new:N \g_@@_rule_pattern_prop
1375 \prop_new:N \g_@@_rule_wd_prop
1376 \prop_new:N \g_@@_rule_style_prop
1377 % \end{macrocode}
1378 % \end{variable}
1379 %
1380 %
1381 % \begin{variable}{\l_@@_rule_pattern_tl, \l_@@_rule_wd_tl, \l_@@_rule_color_tl, \l_@@_rule_dim,
1382 % \l_@@_rule_style_tl, \l_@@_rule_style_seq}
1383 % 用于临时存储表格线型、线宽与样式。
1384 % \begin{macrocode}
1385 \tl_new:N \l_@@_rule_pattern_tl
1386 \tl_new:N \l_@@_rule_wd_tl
1387 \tl_new:N \l_@@_rule_color_tl
1388 \tl_new:N \l_@@_rule_style_tl
1389 \dim_new:N \l_@@_rule_dim
1390 \seq_new:N \l_@@_rule_style_seq
1391 % \end{macrocode}
1392 % \end{variable}
1393 %
1394 %
1395 % \subsubsection{样式设置}
1396 %
1397 % \begin{macro}{\rulepatternset, \rulewdset, \rulestyleset}
1398 % 设置边框线的线宽、线型与样式。
1399 % \begin{macrocode}
1400 \NewDocumentCommand {\rulepatternset} { m m }
1401 { \prop_gput:Nnn \g_@@_rule_pattern_prop {#1} {#2} }
1402 \NewDocumentCommand {\rulewdset} { m m }
1403 { \prop_gput:Nnn \g_@@_rule_wd_prop {#1} {#2} }
1404 \NewDocumentCommand {\rulestyleset} { m m m m }
1405 {
1406 \prop_get:NnNF \g_@@_rule_pattern_prop {#2} \l_@@_rule_pattern_tl
1407 { \tl_set:Nn \l_@@_rule_pattern_tl {#2} }
1408 \prop_get:NnNF \g_@@_rule_wd_prop {#3} \l_@@_rule_wd_tl
1409 { \tl_set:Nn \l_@@_rule_wd_tl {#3} }
1410 \prop_gput:Nne \g_@@_rule_style_prop {#1}
1411 { \l_@@_rule_pattern_tl \s_@@_mark \l_@@_rule_wd_tl \s_@@_mark #4}
1412 }
1413 \rulepatternset {soild} {}
1414 \rulepatternset {dotted}{0.6em, 0.15em}
1415 \rulepatternset {dash} {0.6em, 0.15em, 0.05em, 0.15em}
1416 \rulewdset {normal} {1pt}
1417 \rulewdset {thick} {1.5pt}
1418 \rulewdset {thin} {0.75pt}
1419 \rulewdset {toprule} {0.08em}
1420 \rulewdset {midrule} {0.05em}
1421 \rulewdset {cmidrule} {0.03em}
1422 \rulewdset {bottomrule} {0.08em}
1423 \rulestyleset {normal} {soild} {normal} {black}
1424 \rulestyleset {dotted} {dotted} {normal} {black}
1425 \rulestyleset {dash} {dash} {normal} {black}
1426 \rulestyleset {bold} {soild} {thick} {black}
1427 % \end{macrocode}
1428 % \end{macro}
1429 %
1430 %
1431 % \subsubsection{应用样式}
1432 %
1433 % \begin{macro}{\@@_set_rule_pattern:n, \@@_set_rule_wd:n, \@@_set_rule_style:n}
1434 % 设置当前线型、线宽及样式。
1435 % \begin{macrocode}
1436 \cs_new:Nn \@@_set_rule_pattern:n
1437 {
1438 \prop_get:NnNTF \g_@@_rule_pattern_prop {#1} \l_@@_rule_pattern_tl
1439 { \draw_set_dash_pattern:Vn \l_@@_rule_pattern_tl {0pt} }
1440 { \draw_set_dash_pattern:nn {#1} {0pt} }
1441 }
1442 \cs_new:Nn \@@_set_rule_wd:n
1443 {
1444 \prop_get:NnNTF \g_@@_rule_wd_prop {#1} \l_@@_rule_wd_tl
1445 { \draw_set_linewidth:V \l_@@_rule_wd_tl }
1446 { \draw_set_linewidth:n {#1} }
1447 }
1448 \cs_new:Nn \@@_set_rule_style:n
1449 {
1450 \prop_get:NnNTF \g_@@_rule_style_prop {#1} \l_@@_rule_style_tl
1451 {
1452 \seq_set_split:NnV \l_@@_rule_style_seq
1453 {\s_@@_mark} \l_@@_rule_style_tl
1454 \draw_set_dash_pattern:en { \seq_item:Nn \l_@@_rule_style_seq {1} } {0pt}
1455 \draw_set_linewidth:e { \seq_item:Nn \l_@@_rule_style_seq {2} }
1456 \color_stroke:e { \seq_item:Nn \l_@@_rule_style_seq {3} }
1457 } {
1458 \@@_set_rule_pattern:n {soild}
1459 \@@_set_rule_wd:n {#1}
1460 \color_stroke:e {black}
1461 }
1462 }
1463 \cs_generate_variant:Nn \@@_set_rule_style:n {V}
1464 % \end{macrocode}
1465 % \end{macro}
1466 %
1467 %
1468 % \begin{macro}{\@@_parse_rule_style:n}
1469 % 解析边框线样式,并将结果分别保存在 \cs{l_@@_rule_pattern_tl}、
1470 % \cs{l_@@_rule_wd_tl} 与 \cs{l_@@_rule_color_tl} 中。
1471 % \begin{macrocode}
1472 \cs_new:Nn \@@_parse_rule_style:n
1473 {
1474 \prop_get:NnNTF \g_@@_rule_style_prop {#1} \l_@@_rule_style_tl
1475 {
1476 \seq_set_split:NnV \l_@@_rule_style_seq
1477 {\s_@@_mark} \l_@@_rule_style_tl
1478 \tl_set:Ne \l_@@_rule_pattern_tl { \seq_item:Nn \l_@@_tmpa_seq {1} }
1479 \tl_set:Ne \l_@@_rule_wd_tl { \seq_item:Nn \l_@@_tmpa_seq {2} }
1480 \tl_set:Ne \l_@@_rule_color_tl { \seq_item:Nn \l_@@_tmpa_seq {3} }
1481 \dim_set:Nn \l_@@_rule_dim { \l_@@_rule_wd_tl }
1482 }
1483 {
1484 \prop_get:NnNF \g_@@_rule_wd_prop {#1} \l_@@_rule_wd_tl
1485 { \tl_set:Nn \l_@@_rule_wd_tl {#1} }
1486 \dim_set:Nn \l_@@_rule_dim { \l_@@_rule_wd_tl }
1487 \tl_if_empty:NT \l_@@_rule_pattern_tl
1488 { \tl_set:Nn \l_@@_rule_pattern_tl { soild } }
1489 \tl_if_empty:NT \l_@@_rule_color_tl
1490 { \tl_set:Nn \l_@@_rule_color_tl { black } }
1491 }
1492 }
1493 \cs_generate_variant:Nn \@@_parse_rule_style:n {V}
1494 % \end{macrocode}
1495 % \end{macro}
1496 %
1497 %
1498 %
1499 % \section{表格核心}
1500 %
1501 % 本节定义了存储、设置及读取表格的位置、内容与格式的核心变量与函数。
1502 % 录入一个表格,应当先设置好内容,再设置格式,否则可能会报错。
1503 %
1504 % \subsection{核心存储}
1505 %
1506 % 本小节定义一些用于存储表格数据与格式的变量。
1507 % 在表格的内部存储中,统一使用数字坐标\footnote{数据从 $1$ 开始,行/列表头的坐标为 $0$。}为索引(键);
1508 % 行名与列名仅用于输入接口。
1509 %
1510 %
1511 % \subsubsection{行列属性}
1512 %
1513 % \begin{variable}{\g_@@_row_header_bool, \g_@@_col_header_bool}
1514 % 是否包含行列表头(|Header|)。
1515 % \begin{macrocode}
1516 \bool_new:N \g_@@_row_header_bool
1517 \bool_new:N \g_@@_col_header_bool
1518 % \end{macrocode}
1519 % \end{variable}
1520 %
1521 % \begin{variable}{\g_@@_row_count_int, \g_@@_col_count_int}
1522 % 最大行列数(不统计 |Header|)。
1523 % \begin{macrocode}
1524 \int_new:N \g_@@_row_count_int
1525 \int_new:N \g_@@_col_count_int
1526 % \end{macrocode}
1527 % \end{variable}
1528 %
1529 % \begin{variable}{\g_@@_row_name_prop, \g_@@_col_name_prop}
1530 % 存储行名与列名与其数字坐标的映射关系(|name -> number|)。
1531 % 唯二不使用数字坐标为索引的(集合)变量(包含 |Header|)。
1532 % \begin{macrocode}
1533 \prop_new:N \g_@@_row_name_prop
1534 \prop_new:N \g_@@_col_name_prop
1535 % \end{macrocode}
1536 % \end{variable}
1537 %
1538 %
1539 % \begin{variable}{\g_@@_row_align_seq, \g_@@_col_align_seq}
1540 % 行列的对齐方式(包含 |Header|)。
1541 % \begin{macrocode}
1542 \seq_new:N \g_@@_row_align_seq
1543 \seq_new:N \g_@@_col_align_seq
1544 % \end{macrocode}
1545 % \end{variable}
1546 %
1547 %
1548 % \begin{variable}{\g_@@_row_ht_style_seq, \g_@@_col_wd_style_seq}
1549 % 行高与列宽样式(包含 |Header|)。
1550 % \begin{macrocode}
1551 \seq_new:N \g_@@_row_ht_style_seq
1552 \seq_new:N \g_@@_col_wd_style_seq
1553 % \end{macrocode}
1554 % \end{variable}
1555 %
1556 %
1557 % \subsubsection{单元格内容}
1558 %
1559 %
1560 % \begin{variable}{\c_@@_cell_content_tl, \c_@@_cell_formula_tl, \c_@@_cell_box_tl}
1561 % 定义单元格的类型。
1562 % \begin{macrocode}
1563 \tl_const:Nn \c_@@_cell_content_tl {content}
1564 \tl_const:Nn \c_@@_cell_formula_tl {formula}
1565 \tl_const:Nn \c_@@_cell_box_tl {box}
1566 % \end{macrocode}
1567 % \end{variable}
1568 %
1569 %
1570 % \begin{variable}{\g_@@_cell_data_prop}
1571 % 定义存储的单元格内容的属性表(包含 |Header|)。\\
1572 % 单元格内容:|row,col| |->| |{type, content, formula}|(分隔符为 \cs{s_@@_mark})。
1573 % \begin{macrocode}
1574 \prop_new:N \g_@@_cell_data_prop
1575 % \end{macrocode}
1576 % \end{variable}
1577 %
1578 %
1579 % \subsubsection{合并单元格}
1580 %
1581 %
1582 % \begin{variable}{\g_@@_merge_info_seq, \g_@@_merge_align_seq, \g_@@_merge_ref_prop}
1583 % 合并单元格引用映射表、信息表及对齐样式表。\\
1584 % 引用映射表:|row,col| |->| |merge_id|(在信息表及样式表中的位置);\\
1585 % 信息表:|{start_row, start_col, end_row, end_col, mapping_cell}|;\\
1586 % 对齐样式表:|{row_align, col_aligin}|。
1587 % \begin{macrocode}
1588 \seq_new:N \g_@@_merge_info_seq
1589 \seq_new:N \g_@@_merge_align_seq
1590 \prop_new:N \g_@@_merge_ref_prop
1591 % \end{macrocode}
1592 % \end{variable}
1593 %
1594 %
1595 % \subsection{行列定位}
1596 %
1597 %
1598 % \subsubsection{行列名设置}
1599 %
1600 %
1601 % \begin{macro}{\@@_set_excel_col_names:n}
1602 % 设置 Excel 风格的列名,|#1| 为终止列数。
1603 % \begin{macrocode}
1604 \cs_new:Nn \@@_set_excel_col_names:n
1605 {
1606 \int_step_inline:nn {#1}
1607 {
1608 \prop_gput:Nen \g_@@_col_name_prop
1609 { \int_to_Alph:n {##1} } {##1}
1610 }
1611 }
1612 % \end{macrocode}
1613 % \end{macro}
1614 %
1615 % \begin{macro}{\@@_set_row_name:nN, \@@_set_col_name:nN}
1616 % 设置行名/列名: |#1| 为行名/列名,|#2| 为数字列坐标。
1617 % \begin{macrocode}
1618 \cs_new:Nn \@@_set_row_name:nN
1619 {
1620 \prop_gput:Nne \g_@@_row_name_prop {#1} {\int_use:N #2}
1621 \@@_int_gset_max:Nn \g_@@_row_count_int {#2}
1622 }
1623 \cs_new:Nn \@@_set_col_name:nN
1624 {
1625 \prop_gput:Nne \g_@@_col_name_prop {#1} {\int_use:N #2}
1626 \@@_int_gset_max:Nn \g_@@_col_count_int {#2}
1627 }
1628 \cs_generate_variant:Nn \@@_set_row_name:nN {VN}
1629 \cs_generate_variant:Nn \@@_set_col_name:nN {VN}
1630 % \end{macrocode}
1631 % \end{macro}
1632 %
1633 %
1634 %
1635 % \subsubsection{行列名解析}
1636 %
1637 %
1638 % \begin{macro}{\@@_get_line_loc:NnNF}
1639 % 返回指定行名、列名对应的数字坐标。
1640 % |#1|:名称属性表,|#2|:名称,|#3|:结果变量,|#4| 查找失败时动作。
1641 % \begin{macrocode}
1642 \prg_new_conditional:Nnn \@@_get_line_loc:NnN { T, F, TF }
1643 {
1644 \regex_match:nnTF {^-?[0-9]+$} {#2}
1645 { \int_set:Nn #3 {#2} \prg_return_true: }
1646 {
1647 \prop_get:NnNTF #1 {#2} \l_@@_tmpa_tl
1648 { \int_set:Nn #3 { \l_@@_tmpa_tl } \prg_return_true: }
1649 { \prg_return_false: }
1650 }
1651 }
1652 % \end{macrocode}
1653 % \end{macro}
1654 %
1655 %
1656 % \begin{macro}{\@@_parse_row_loc:n, \@@_parse_col_loc:n}
1657 % 解析坐标(支持数字和名称混合),如果解析失败则报错,|#1|:行名/列名。
1658 % 解析的坐标保存在 \cs{l_@@_row_loc_int} 或 \cs{l_@@_col_loc_int} 中。
1659 % \begin{macrocode}
1660 \cs_new:Nn \@@_parse_row_loc:n
1661 {
1662 \@@_get_line_loc:NnNF
1663 \g_@@_row_name_prop {#1} \l_@@_row_loc_int
1664 { \msg_error:nnn {xtable} {unknown_row_name} {#1} }
1665 }
1666 \cs_new:Nn \@@_parse_col_loc:n
1667 {
1668 \@@_get_line_loc:NnNF
1669 \g_@@_col_name_prop {#1} \l_@@_col_loc_int
1670 { \msg_error:nnn {xtable} {unknown_col_name} {#1} }
1671 }
1672 \cs_generate_variant:Nn \@@_parse_row_loc:n { e, V }
1673 \cs_generate_variant:Nn \@@_parse_col_loc:n { e, V }
1674 % \end{macrocode}
1675 % \end{macro}
1676 %
1677 %
1678 % \begin{macro}{\@@_parse_new_row_loc:n, \@@_parse_new_col_loc:n}
1679 % 解析坐标(支持数字和名称混合),如果解析失败则尝试建立映射,|#1|:行名/列名。
1680 % 坐标保存在 \cs{l_@@_row_loc_int} 或 \cs{l_@@_col_loc_int} 中。
1681 % \begin{macrocode}
1682 \cs_new:Nn \@@_parse_new_row_loc:n
1683 {
1684 \@@_get_line_loc:NnNF
1685 \g_@@_row_name_prop {#1} \l_@@_row_loc_int
1686 {
1687 \int_if_zero:nT { \l_@@_row_loc_int }
1688 { \int_set:Nn \l_@@_row_loc_int { \g_@@_row_count_int + 1 } }
1689 \@@_set_row_name:nN {#1} \l_@@_row_loc_int
1690 }
1691 }
1692 \cs_new:Nn \@@_parse_new_col_loc:n
1693 {
1694 \@@_get_line_loc:NnNF
1695 \g_@@_col_name_prop {#1} \l_@@_col_loc_int
1696 {
1697 \int_if_zero:nT { \l_@@_col_loc_int }
1698 { \int_set:Nn \l_@@_col_loc_int { \g_@@_col_count_int + 1 } }
1699 \@@_set_col_name:nN {#1} \l_@@_col_loc_int
1700 }
1701 }
1702 \cs_generate_variant:Nn \@@_parse_new_row_loc:n { e, V }
1703 \cs_generate_variant:Nn \@@_parse_new_col_loc:n { e, V }
1704 % \end{macrocode}
1705 % \end{macro}
1706 %
1707 %
1708 % \begin{macro}{\@@_parse_coord:n, \@@_parse_new_coord:n}
1709 % 解析坐标(支持数字和名称混合),|#1|:(行名, 列名)。
1710 % 解析的坐标保存在 \cs{l_@@_row_loc_int} 与 \cs{l_@@_col_loc_int} 中。
1711 % 两个版本的区别在于如果解析失败如何处理。
1712 % \begin{macrocode}
1713 \cs_new:Nn \@@_parse_coord:n
1714 {
1715 \@@_parse_row_loc:e { \clist_item:nn {#1} {1} }
1716 \@@_parse_col_loc:e { \clist_item:nn {#1} {2} }
1717 }
1718 \cs_new:Nn \@@_parse_new_coord:n
1719 {
1720 \@@_parse_new_row_loc:e { \clist_item:nn {#1} {1} }
1721 \@@_parse_new_col_loc:e { \clist_item:nn {#1} {2} }
1722 }
1723 % \end{macrocode}
1724 % \end{macro}
1725 %
1726 %
1727 % \subsection{内容处理}
1728 %
1729 %
1730 % \subsubsection{初始化与保存}
1731 %
1732 %
1733 % \begin{macro}{\@@_table_init:}
1734 % 将初始化为空表。
1735 % \begin{macrocode}
1736 \cs_new:Nn \@@_table_init:
1737 {
1738 \int_gzero:N \g_@@_row_count_int
1739 \int_gzero:N \g_@@_col_count_int
1740 \seq_gclear:N \g_@@_row_align_seq
1741 \seq_gclear:N \g_@@_col_align_seq
1742 \seq_gclear:N \g_@@_row_ht_style_seq
1743 \seq_gclear:N \g_@@_col_wd_style_seq
1744 \seq_gclear:N \g_@@_merge_info_seq
1745 \seq_gclear:N \g_@@_merge_align_seq
1746 \prop_gclear:N \g_@@_row_name_prop
1747 \prop_gclear:N \g_@@_col_name_prop
1748 \prop_gclear:N \g_@@_cell_data_prop
1749 \prop_gclear:N \g_@@_merge_ref_prop
1750 % \end{macrocode}
1751 % \begin{macrocode}
1752 \prop_gput:Nnn \g_@@_row_name_prop {header} {0}
1753 \prop_gput:Nnn \g_@@_col_name_prop {title} {0}
1754 \bool_gset_false:N \g_@@_row_header_bool
1755 \bool_gset_true:N \g_@@_col_header_bool
1756 }
1757 % \end{macrocode}
1758 % \end{macro}
1759 %
1760 %
1761 %
1762 % \begin{macro}{\@@_table_save:n}
1763 % 保存表格。 \done\todo[Debug] { 修复表格保存命令报错的 Bug }
1764 % \begin{macrocode}
1765 \cs_new:Nn \@@_table_save:n
1766 {
1767 \cs_if_exist:cF { g_@@_row_count_#1_int }
1768 {
1769 \bool_new:c { g_@@_row_header_#1_bool }
1770 \bool_new:c { g_@@_col_header_#1_bool }
1771 \int_new:c { g_@@_row_count_#1_int }
1772 \int_new:c { g_@@_col_count_#1_int }
1773 \seq_new:c { g_@@_row_align_#1_seq }
1774 \seq_new:c { g_@@_col_align_#1_seq }
1775 \seq_new:c { g_@@_row_ht_style_#1_seq }
1776 \seq_new:c { g_@@_col_wd_style_#1_seq }
1777 \seq_new:c { g_@@_merge_info_#1_seq }
1778 \seq_new:c { g_@@_merge_align_#1_seq }
1779 \prop_new:c { g_@@_row_name_#1_prop }
1780 \prop_new:c { g_@@_col_name_#1_prop }
1781 \prop_new:c { g_@@_cell_data_#1_prop }
1782 \prop_new:c { g_@@_merge_ref_#1_prop }
1783 }
1784 \bool_gset_eq:cN { g_@@_row_header_#1_bool } \g_@@_row_header_bool
1785 \bool_gset_eq:cN { g_@@_col_header_#1_bool } \g_@@_col_header_bool
1786 \int_gset_eq:cN { g_@@_row_count_#1_int } \g_@@_row_count_int
1787 \int_gset_eq:cN { g_@@_col_count_#1_int } \g_@@_col_count_int
1788 \seq_gset_eq:cN { g_@@_row_align_#1_seq } \g_@@_row_align_seq
1789 \seq_gset_eq:cN { g_@@_col_align_#1_seq } \g_@@_col_align_seq
1790 \seq_gset_eq:cN { g_@@_row_ht_style_#1_seq } \g_@@_row_ht_style_seq
1791 \seq_gset_eq:cN { g_@@_col_wd_style_#1_seq } \g_@@_col_wd_style_seq
1792 \seq_gset_eq:cN { g_@@_merge_info_#1_seq } \g_@@_merge_info_seq
1793 \seq_gset_eq:cN { g_@@_merge_align_#1_seq } \g_@@_merge_align_seq
1794 \prop_gset_eq:cN { g_@@_row_name_#1_prop } \g_@@_row_name_prop
1795 \prop_gset_eq:cN { g_@@_col_name_#1_prop } \g_@@_col_name_prop
1796 \prop_gset_eq:cN { g_@@_cell_data_#1_prop } \g_@@_cell_data_prop
1797 \prop_gset_eq:cN { g_@@_merge_ref_#1_prop } \g_@@_merge_ref_prop
1798 }
1799 % \end{macrocode}
1800 % \end{macro}
1801 %
1802 %
1803 % \begin{macro}{\@@_table_restore:n}
1804 % 恢复表格。
1805 % \begin{macrocode}
1806 \cs_new:Nn \@@_table_restore:n
1807 {
1808 \cs_if_exist:cF { g_@@_row_count_#1_int }
1809 { \msg_error:nnn {xtable} {unsaved_table} {#1} }
1810 \bool_gset_eq:Nc \g_@@_row_header_bool { g_@@_row_header_#1_bool }
1811 \bool_gset_eq:Nc \g_@@_col_header_bool { g_@@_col_header_#1_bool }
1812 \int_gset_eq:Nc \g_@@_row_count_int { g_@@_row_count_#1_int }
1813 \int_gset_eq:Nc \g_@@_col_count_int { g_@@_col_count_#1_int }
1814 \seq_gset_eq:Nc \g_@@_row_align_seq { g_@@_row_align_#1_seq }
1815 \seq_gset_eq:Nc \g_@@_col_align_seq { g_@@_col_align_#1_seq }
1816 \seq_gset_eq:Nc \g_@@_row_ht_style_seq { g_@@_row_ht_style_#1_seq }
1817 \seq_gset_eq:Nc \g_@@_col_wd_style_seq { g_@@_col_wd_style_#1_seq }
1818 \seq_gset_eq:Nc \g_@@_merge_info_seq { g_@@_merge_info_#1_seq }
1819 \seq_gset_eq:Nc \g_@@_merge_align_seq { g_@@_merge_align_#1_seq }
1820 \prop_gset_eq:Nc \g_@@_row_name_prop { g_@@_row_name_#1_prop }
1821 \prop_gset_eq:Nc \g_@@_col_name_prop { g_@@_col_name_#1_prop }
1822 \prop_gset_eq:Nc \g_@@_cell_data_prop { g_@@_cell_data_#1_prop }
1823 \prop_gset_eq:Nc \g_@@_merge_ref_prop { g_@@_merge_ref_#1_prop }
1824 }
1825 % \end{macrocode}
1826 % \end{macro}
1827 %
1828 %
1829 % \subsubsection{内容设置}
1830 %
1831 %
1832 % \begin{macro}{\@@_set_cell:nnnn}
1833 % 设置单元格数据。|#1| 数字坐标,|#2| 类型,|#3| 内容,|#4| 公式。
1834 % \begin{macrocode}
1835 \cs_new:Nn \@@_set_cell:nnnn
1836 {
1837 \prop_gput:Nnn \g_@@_cell_data_prop
1838 {#1} {#2 \s_@@_mark #3 \s_@@_mark #4}
1839 \@@_int_gset_max:Nn \g_@@_row_count_int { \clist_item:nn{#1}{1} }
1840 \@@_int_gset_max:Nn \g_@@_col_count_int { \clist_item:nn{#1}{2} }
1841 }
1842 \cs_generate_variant:Nn \@@_set_cell:nnnn { nVnn, eVnn }
1843 % \end{macrocode}
1844 % \end{macro}
1845 %
1846 %
1847 % \begin{macro}{\@@_set_cell:nn, \@@_set_cell_formula:nn, \@@_set_cell_box:nn}
1848 % 设置单元格内容。|#1| 数字坐标,|#2| 内容/公式/盒子。
1849 % 若内容为空,则直接清空。
1850 % \begin{macrocode}
1851 \cs_new:Nn \@@_set_cell:nn
1852 {
1853 \tl_if_empty:nTF {#2}
1854 { \prop_gpop:NeN \g_@@_cell_data_prop {#1} \l_@@_tmpa_tl }
1855 { \@@_set_cell:nVnn {#1} \c_@@_cell_content_tl {#2} {} }
1856 }
1857 \cs_new:Nn \@@_set_cell_formula:nn
1858 { \@@_set_cell:nVnn {#1} \c_@@_cell_formula_tl {} {#2} }
1859 \cs_new:Nn \@@_set_cell_box:nn
1860 { \@@_set_cell:nVnn {#1} \c_@@_cell_box_tl {#2} {} }
1861 \cs_generate_variant:Nn \@@_set_cell:nn { en, nV, eV }
1862 \cs_generate_variant:Nn \@@_set_cell_formula:nn { en }
1863 \cs_generate_variant:Nn \@@_set_cell_box:nn { en }
1864 % \end{macrocode}
1865 % \end{macro}
1866 %
1867 %
1868 % \begin{macro}{\@@_set_cell:NNn, \@@_set_cell_formula:NNn, \@@_set_cell_box:NNn}
1869 % 设置单元格内容。|#1#2| 数字坐标,|#3| 内容/公式/盒子。
1870 % 若内容为空,则直接清空。
1871 % \begin{macrocode}
1872 \cs_new:Nn \@@_set_cell:NNn
1873 { \@@_set_cell:en { \int_use:N #1, \int_use:N #2 } {#3} }
1874 \cs_new:Nn \@@_set_cell_formula:NNn
1875 { \@@_set_cell_formula:en { \int_use:N #1, \int_use:N #2 } {#3} }
1876 \cs_new:Nn \@@_set_cell_box:NNn
1877 { \@@_set_cell_box:en { \int_use:N #1, \int_use:N #2 } {#3} }
1878 \cs_generate_variant:Nn \@@_set_cell:NNn { NNV }
1879 \cs_generate_variant:Nn \@@_set_cell_formula:NNn { NNV }
1880 \cs_generate_variant:Nn \@@_set_cell_box:NNn { NNV }
1881 % \end{macrocode}
1882 % \end{macro}
1883 %
1884 %
1885 % \begin{macro}{\@@_set_cell:n, \@@_set_cell_formula:n, \@@_set_cell_box:n}
1886 % 设置单元格内容/公式/盒子。坐标使用 \cs{l_@@_row_loc_int} 与 \cs{l_@@_col_loc_int}。
1887 % \begin{macrocode}
1888 \cs_new:Nn \@@_set_cell:n
1889 {
1890 \@@_set_cell:NNn
1891 \l_@@_row_loc_int \l_@@_col_loc_int {#1}
1892 }
1893 % \end{macrocode}
1894 % \begin{macrocode}
1895 \cs_new:Nn \@@_set_cell_formula:n
1896 {
1897 \@@_set_cell_formula:NNn
1898 \l_@@_row_loc_int \l_@@_col_loc_int {#1}
1899 }
1900 % \end{macrocode}
1901 % \begin{macrocode}
1902 \cs_new:Nn \@@_set_cell_box:n
1903 {
1904 \@@_set_cell_box:NNn
1905 \l_@@_row_loc_int \l_@@_col_loc_int {#1}
1906 }
1907 % \end{macrocode}
1908 % \end{macro}
1909 %
1910 %
1911 % \subsubsection{内容查询}
1912 %
1913 % \begin{macro}{\@@_parse_cell:n}
1914 % 获取指定坐标的单元格的内容。
1915 % 结果保存在 \cs{l_@@_data_tl}(内容)与 \cs{l_@@_cell_is_box_bool}(是否盒子)中。
1916 % \begin{macrocode}
1917 \cs_new:Nn \@@_parse_cell:n
1918 {
1919 \bool_set_false:N \l_@@_is_box_bool
1920 \prop_get:NnNTF \g_@@_cell_data_prop {#1} \l_@@_tmpa_tl
1921 {
1922 \seq_set_split:NnV \l_@@_tmpa_seq {\s_@@_mark} \l_@@_tmpa_tl
1923 \tl_set:Ne \l_@@_tmpa_tl { \seq_item:Nn \l_@@_tmpa_seq {1} }
1924 \tl_set:Ne \l_@@_data_tl { \seq_item:Nn \l_@@_tmpa_seq {2} }
1925 \str_if_eq:VVT \l_@@_tmpa_tl \c_@@_cell_box_tl
1926 { \bool_set_true:N \l_@@_is_box_bool }
1927 }
1928 { \tl_clear:N \l_@@_data_tl } % 空单元格
1929 }
1930 \cs_generate_variant:Nn {\@@_parse_cell:n} {V, e}
1931 % \end{macrocode}
1932 % \end{macro}
1933 %
1934 %
1935 % \subsection{修改表格}
1936 %
1937 % \changes{v0.4}{2026-03-11}{添加修改表格的功能}
1938 %
1939 % \subsubsection{表格重组}
1940 %
1941 % \begin{macro}{\@@_table_restructure:nn}
1942 % 重新选择数据替换原数据表。
1943 % |#1|: 新的行/列逗号分隔列表,|#2|: 行还是列。
1944 % \begin{macrocode}
1945 \cs_new:Nn \@@_table_restructure:nn
1946 {
1947 \group_begin:
1948 \prop_clear:N \l_@@_tmpa_prop % new -> old
1949 \prop_clear:N \l_@@_tmpb_prop % old -> new
1950 \prop_clear:N \l_@@_cachea_prop % new name prop
1951 \prop_clear:N \l_@@_cacheb_prop % new data prop
1952 \seq_set_split:Nnn \l_@@_tmpa_seq {,} {#1} % new col list
1953 % \end{macrocode}
1954 % 确认映射表与新的行/列数。
1955 % \begin{macrocode}
1956 \int_gset:cn {g_@@_#2_count_int}
1957 { \seq_count:N \l_@@_tmpa_seq }
1958 \prop_gput:Nnn \l_@@_tmpa_prop {0} {0}
1959 \prop_gput:Nnn \l_@@_tmpb_prop {0} {0}
1960 \int_step_inline:nn { \seq_count:N \l_@@_tmpa_seq }
1961 {
1962 \tl_set:Ne \l_@@_tmpa_tl
1963 { \seq_item:Nn \l_@@_tmpa_seq {##1} }
1964 \prop_gput:NnV \l_@@_tmpa_prop {##1} \l_@@_tmpa_tl
1965 \prop_gput:NVn \l_@@_tmpb_prop \l_@@_tmpa_tl {##1}
1966 }
1967 % \end{macrocode}
1968 % 更新名称属性表。
1969 % \begin{macrocode}
1970 \prop_map_inline:cn { g_@@_#2_name_prop }
1971 {
1972 \prop_get:NnNTF \l_@@_tmpb_prop {##2} \l_@@_tmpa_tl
1973 { \prop_put:NnV \l_@@_cachea_prop {##1} \l_@@_tmpa_tl }
1974 {
1975 \int_compare:nNnT {##2} = {0}
1976 { \prop_put:Nnn \l_@@_cachea_prop {##1} {##2} }
1977 }
1978 }
1979 \prop_gset_eq:cN { g_@@_#2_name_prop } \l_@@_cachea_prop
1980 % \end{macrocode}
1981 % 更新实际数据。
1982 % \begin{macrocode}
1983 \str_if_eq:nnTF {#2} {row}
1984 { \cs_set_eq:NN \@@_tmpa_cs: \l_@@_tmpa_str }
1985 { \cs_set_eq:NN \@@_tmpa_cs: \l_@@_tmpb_str }
1986 \prop_map_inline:nn \g_@@_cell_data_prop
1987 {
1988 \str_set:Ne \l_@@_tmpa_str { \clist_item:nn {##1} {1} }
1989 \str_set:Ne \l_@@_tmpb_str { \clist_item:nn {##1} {2} }
1990 \prop_get:NnNT \l_@@_tmpb_prop \@@_tmpa_cs: \@@_tmpa_cs:
1991 {
1992 \prop_put:Nen \l_@@_cacheb_prop
1993 { \l_@@_tmpa_str, \l_@@_tmpb_str } {##2}
1994 }
1995 }
1996 \prop_gset_eq:NN \g_@@_cell_data_prop \l_@@_cacheb_prop
1997 \group_end:
1998 }
1999 % \end{macrocode}
2000 % \end{macro}
2001 %
2002 %
2003 % \subsubsection{移动表格}
2004 %
2005 % \begin{macro}{\@@_data_move:nnn}
2006 % 整行或整列移动单元格。
2007 % |#1|: 起始位置,|#2|: 移动数量,|#3|: 行还是列。
2008 % \begin{macrocode}
2009 \cs_new:Nn \@@_data_move:nnn
2010 {
2011 \prop_clear:N \l_@@_tmpa_seq % new data prop
2012 \str_if_eq:nnTF {#3} {row}
2013 {
2014 \cs_set_eq:NN \@@_tmpa_cs: \l_@@_tmpa_int % 临时行索引
2015 \cs_set_eq:NN \@@_tmpb_cs: \l_@@_row_count_int % 行数
2016 } {
2017 \cs_set_eq:NN \@@_tmpa_cs: \l_@@_tmpb_int % 临时列索引
2018 \cs_set_eq:NN \@@_tmpb_cs: \l_@@_col_count_int % 列数
2019 }
2020 % \end{macrocode}
2021 % 更新实际数据。
2022 % \begin{macrocode}
2023 \prop_map_inline:nn \g_@@_cell_data_prop
2024 {
2025 \int_set:Nn \l_@@_tmpa_int { \clist_item:nn {##1} {1} }
2026 \int_set:Nn \l_@@_tmpb_int { \clist_item:nn {##1} {2} }
2027 \int_compare:nNnTF {\@@_tmpa_cs:} < {#1}
2028 % 如果有数据,说明其它单元格移动到此位置
2029 { \prop_put_if_new:Nnn \l_@@_tmpa_seq {##1} {##2} }
2030 {
2031 \int_add:Nn \@@_tmpa_cs: {#2}
2032 \@@_int_gset_max:Nn \@@_tmpb_cs: { \@@_tmpa_cs: }
2033 \prop_put:Nen \l_@@_tmpa_seq
2034 { \int_use:N \l_@@_tmpa_int, \int_use:N \l_@@_tmpb_int } {##2}
2035 }
2036 }
2037 \prop_gset_eq:NN \g_@@_cell_data_prop \l_@@_tmpa_seq
2038 }
2039 % \end{macrocode}
2040 % \end{macro}
2041 %
2042 %
2043 % \subsubsection{移动单元格}
2044 %
2045 %
2046 % \begin{macro}{\@@_cell_move_by_row:nnn, \@@_cell_move_by_col:nnn}
2047 % 移动单元格。
2048 % |#1|: 起始行,|#2|: 起始列,|#3|: 移动数量。
2049 % \begin{macrocode}
2050 \cs_new:Nn \@@_cell_move_by_row:nnn
2051 {
2052 \int_compare:nNnTF {#3} < {0}
2053 { \int_step_inline:nnn {#1} {\g_@@_row_count_int} }
2054 { \int_step_inline:nnnn {\g_@@_row_count_int} {#1} {-1} }
2055 { % 此内容为映射函数的最后一个参数
2056 \prop_gpop:NnNT \g_@@_cell_data_prop {##1,#2} \l_@@_tmpa_tl
2057 {
2058 \int_set:Nn \l_@@_tmpa_int {##1 + #3}
2059 \prop_gput:NeV \g_@@_cell_data_prop
2060 { \int_use:N \l_@@_tmpa_int, #2 } \l_@@_tmpa_tl
2061 \@@_int_gset_max:Nn \l_@@_row_count_int { \l_@@_tmpa_int }
2062 }
2063 }
2064 }
2065 % \end{macrocode}
2066 % \begin{macrocode}
2067 \cs_new:Nn \@@_cell_move_by_col:nnn
2068 {
2069 \int_compare:nNnTF {#3} < {0}
2070 { \int_step_inline:nnn {#2} {\g_@@_col_count_int} }
2071 { \int_step_inline:nnnn {\g_@@_col_count_int} {#2} {-1} }
2072 { % 此内容为映射函数的最后一个参数
2073 \prop_gpop:NnNT \g_@@_cell_data_prop {#1,##1} \l_@@_tmpa_tl
2074 {
2075 \int_set:Nn \l_@@_tmpa_int {##1 + #3}
2076 \prop_gput:NeV \g_@@_cell_data_prop
2077 { #1, \int_use:N \l_@@_tmpa_int } \l_@@_tmpa_tl
2078 \@@_int_gset_max:Nn \l_@@_col_count_int { \l_@@_tmpa_int }
2079 }
2080 }
2081 }
2082 % \end{macrocode}
2083 % \end{macro}
2084 %
2085 %
2086 % \subsection{格式处理}
2087 %
2088 % \subsubsection{样式设置}
2089 %
2090 % \begin{macro}{\@@_set_line_style:NNNn}
2091 % 设置行/列样式。|#1|: 行样式名,|#2|: 样式内容,|#3|: 默认值,|#4|:行或列。
2092 % 本命令会修改变量 \cs{l_@@_cachea_int}、\cs{l_@@_row_loc_int} 及 \cs{l_@@_col_loc_int} 的值。
2093 % \begin{macrocode}
2094 \cs_new:Nn \@@_set_line_style:NNnn
2095 {
2096 \bool_if:cTF
2097 {
2098 \str_if_eq:nnTF {#4} {row}
2099 { g_@@_col_header_bool } { g_@@_row_header_bool }
2100 }
2101 { \int_set:Nn \l_@@_tmpa_int {0} }
2102 { \int_set:Nn \l_@@_tmpa_int {1} }
2103 \@@_int_gset_max:cn { g_@@_#4_count_int }
2104 { \seq_count:N #1 - 1 + \l_@@_tmpa_int }
2105 \@@_ginit_seq:Nnn #1 { \int_use:c { g_@@_#4_count_int } + 1 } {#3}
2106 \cs_set_eq:Nc \@@_tmpa_cs: { @@_parse_#4_loc:V }
2107 \seq_map_inline:Nn #2
2108 {
2109 \str_if_in:nnTF {##1} {=}
2110 {
2111 \seq_set_split:Nnn \l_@@_tmpa_seq {=} {##1}
2112 \seq_get_left:NN \l_@@_tmpa_seq \l_@@_tmpa_tl
2113 \seq_get_right:NN \l_@@_tmpa_seq \l_@@_tmpb_tl
2114 \@@_tmpa_cs: \l_@@_tmpa_tl
2115 \int_set_eq:Nc \l_@@_tmpa_int { l_@@_#4_loc_int }
2116 }
2117 { \tl_set:Nn \l_@@_tmpb_tl {##1} }
2118 \seq_gset_item:NnV #1
2119 {\l_@@_tmpa_int + 1} \l_@@_tmpb_tl
2120 \int_incr:N \l_@@_tmpa_int
2121 }
2122 }
2123 % \end{macrocode}
2124 % \end{macro}
2125 %
2126 %
2127 % \begin{macro}{\@@_set_row_align:Nn, \@@_set_col_align:Nn}
2128 % 设置行高样式。|#1|: 样式内容,|#2|: 默认值。
2129 % \begin{macrocode}
2130 \cs_new:Nn \@@_set_row_align:Nn
2131 { \@@_set_line_style:NNnn \g_@@_row_align_seq #1 {#2} {row} }
2132 \cs_new:Nn \@@_set_col_align:Nn
2133 { \@@_set_line_style:NNnn \g_@@_col_align_seq #1 {#2} {col} }
2134 % \end{macrocode}
2135 % \end{macro}
2136 %
2137 %
2138 %
2139 % \begin{macro}{\@@_set_row_ht_style:Nnn, \@@_set_col_wd_style:Nnn}
2140 % 设置行高的样式。|#1|: 样式内容,|#2|: 默认值,|#3|: 备用。
2141 % \begin{macrocode}
2142 \cs_new:Nn \@@_set_row_ht_style:Nnn
2143 {
2144 \@@_set_line_style:NNnn \g_@@_row_ht_style_seq #1 {#2} {row}
2145 \int_step_inline:nn
2146 { \seq_count:N \g_@@_row_ht_style_seq }
2147 {
2148 \tl_set:Ne \l_@@_tmpa_tl
2149 { \seq_item:Nn \g_@@_row_ht_style_seq {##1} }
2150 \tl_replace_all:Nnn \l_@@_tmpa_tl {auto} {a}
2151 \tl_replace_all:Nnn \l_@@_tmpa_tl {same} {s}
2152 \seq_gset_item:NnV \g_@@_row_ht_style_seq {##1} \l_@@_tmpa_tl
2153 }
2154 \seq_gput_right:Nn \g_@@_row_ht_style_seq {#3}
2155 }
2156 % \end{macrocode}
2157 % 设置列宽的样式。|#1|: 样式内容,|#2|: 默认值,|#3|: 总宽。
2158 % \begin{macrocode}
2159 \cs_new:Nn \@@_set_col_wd_style:Nnn
2160 {
2161 \@@_set_line_style:NNnn \g_@@_col_wd_style_seq #1 {#2} {col}
2162 \int_step_inline:nn
2163 { \seq_count:N \g_@@_col_wd_style_seq }
2164 {
2165 \tl_set:Ne \l_@@_tmpa_tl
2166 { \seq_item:Nn \g_@@_col_wd_style_seq {##1} }
2167 \tl_replace_all:Nnn \l_@@_tmpa_tl {auto} {a}
2168 \tl_replace_all:Nnn \l_@@_tmpa_tl {same} {s}
2169 \tl_replace_all:Nnn \l_@@_tmpa_tl {fill} {f}
2170 \seq_gset_item:NnV \g_@@_col_wd_style_seq {##1} \l_@@_tmpa_tl
2171 }
2172 \seq_gput_right:Nn \g_@@_col_wd_style_seq {#3}
2173 }
2174 % \end{macrocode}
2175 % \end{macro}
2176 %
2177 %
2178 % \begin{macro}{\@@_insure_style:}
2179 % 确保样式有设置好。
2180 % \begin{macrocode}
2181 \cs_new:Nn \@@_insure_style:
2182 {
2183 \seq_if_empty:NT \g_@@_row_align_seq
2184 { \@@_set_row_align:Nn \c_empty_seq {b} }
2185 \seq_if_empty:NT \g_@@_col_align_seq
2186 { \@@_set_col_align:Nn \c_empty_seq {c} }
2187 \seq_if_empty:NT \g_@@_row_ht_style_seq
2188 { \@@_set_row_ht_style:Nnn \c_empty_seq {a} {} }
2189 \seq_if_empty:NT \g_@@_col_wd_style_seq
2190 { \@@_set_col_wd_style:Nnn \c_empty_seq {a} {\textwidth} }
2191 }
2192 % \end{macrocode}
2193 % \end{macro}
2194 %
2195 %
2196 %
2197 % \subsubsection{样式查询}
2198 %
2199 %
2200 % \begin{macro}{\@@_parse_row_align:n, \@@_parse_col_align:n}
2201 % 解析行列的对齐样式。|#1|: 数字坐标,结果保存在
2202 % \cs{l_@@_row_align_tl} 与 \cs{l_@@_col_align_tl} 中。
2203 % \begin{macrocode}
2204 \cs_new:Nn \@@_parse_row_align:n
2205 {
2206 \tl_set:Ne \l_@@_row_align_tl
2207 { \seq_item:Nn \g_@@_row_align_seq {#1 + 1} }
2208 }
2209 \cs_new:Nn \@@_parse_col_align:n
2210 {
2211 \tl_set:Ne \l_@@_col_align_tl
2212 { \seq_item:Nn \g_@@_col_align_seq {#1 + 1} }
2213 }
2214 % \end{macrocode}
2215 % \end{macro}
2216 %
2217 %
2218 % \begin{macro}{\@@_parse_row_ht_style:n, \@@_parse_col_wd_style:n}
2219 % 解析行高/列宽的样式。|#1|: 数字坐标,结果保存在 \cs{l_@@_style_tl} 中。
2220 % \begin{macrocode}
2221 \cs_new:Nn \@@_parse_row_ht_style:n
2222 {
2223 \tl_set:Ne \l_@@_style_tl
2224 { \seq_item:Nn \g_@@_row_ht_style_seq {#1 + 1} }
2225 }
2226 \cs_new:Nn \@@_parse_col_wd_style:n
2227 {
2228 \tl_set:Ne \l_@@_style_tl
2229 { \seq_item:Nn \g_@@_col_wd_style_seq {#1 + 1} }
2230 }
2231 % \end{macrocode}
2232 % \end{macro}
2233 %
2234 %
2235 % \subsection{合并单元格}
2236 %
2237 % \changes{v0.4}{2026-03-11}{添加对合并单元格的支持}
2238 %
2239 % \subsubsection{合并设置}
2240 %
2241 %
2242 % \begin{macro}{\@@_check_merge_range:nnnn}
2243 % 检查指定区域内的所有单元格是否都未被合并。
2244 % |#1|: 起始行, |#2|: 起始列, |#3|: 结束行, |#4|: 结束列。
2245 % 如果有合并,则报错。
2246 % \begin{macrocode}
2247 \cs_new:Nn \@@_check_merge_range:nnnn
2248 {
2249 \int_step_inline:nnn {#1} {#3}
2250 {
2251 \int_step_inline:nnn {#2} {#4}
2252 {
2253 \prop_if_in:NnT \g_@@_merge_ref_prop {##1,####1}
2254 { \msg_error:nnn {xtable} {merged_cell} {##1,####1} }
2255 }
2256 }
2257 }
2258 % \end{macrocode}
2259 % \end{macro}
2260 %
2261 %
2262 % \begin{macro}{\@@_set_merge_cell:nnnnn}
2263 % 合并单元格。
2264 % |#1|: 起始行, |#2|: 起始列, |#3|: 结束行, |#4|: 结束列, |#5|: 合并后取哪个单元格的内容。
2265 % \begin{macrocode}
2266 \cs_new:Nn \@@_set_merge_cell:nnnnn
2267 {
2268 \@@_check_merge_range:nnnn {#1} {#2} {#3} {#4}
2269 \int_set:Nn \l_@@_tmpa_int
2270 { \seq_count:N \g_@@_merge_info_seq + 1 }
2271 \prop_get:NnNF \c_@@_merge_align_prop {#5} \l_@@_tmpa_tl
2272 { \tl_set:Nn \l_@@_tmpa_tl {} }
2273 \seq_gput_right:Ne \g_@@_merge_info_seq
2274 {
2275 #1 \s_@@_mark #2 \s_@@_mark
2276 #3 \s_@@_mark #4 \s_@@_mark
2277 \str_case:VnF \l_@@_tmpa_tl
2278 {
2279 {ul} { #1, #2 }
2280 {ur} { #3, #2 }
2281 {dl} { #1, #4 }
2282 {dr} { #3, #4 }
2283 }
2284 { #1, #2 }
2285 }
2286 \int_step_inline:nnn {#1} {#3}
2287 {
2288 \int_step_inline:nnn {#2} {#4}
2289 {
2290 \prop_gput:Nne \g_@@_merge_ref_prop
2291 {##1,####1} { \int_use:N \l_@@_tmpa_int }
2292 }
2293 }
2294 }
2295 \cs_generate_variant:Nn \@@_set_merge_cell:nnnnn { VVVVn }
2296 % \end{macrocode}
2297 % \end{macro}
2298 %
2299 %
2300 % \begin{macro}{\@@_set_merge_align:n}
2301 % 指定当前合并单元格的对齐格式。
2302 % \begin{macrocode}
2303 \cs_new:Nn \@@_set_merge_align:n
2304 {
2305 \int_set:Nn \l_@@_tmpa_int
2306 { \seq_count:N \g_@@_merge_align_seq + 1 }
2307 \int_set:Nn \l_@@_tmpb_int
2308 { \seq_count:N \g_@@_merge_info_seq - 1 }
2309 \int_step_inline:nnn { \l_@@_tmpa_int } { \l_@@_tmpb_int }
2310 { \seq_gput_right:Nn \g_@@_merge_align_seq {m, c} }
2311 \prop_get:NnNF \c_@@_merge_align_prop {#1} \l_@@_tmpa_tl
2312 { \tl_set:Nn \l_@@_tmpa_tl {m, c} }
2313 \seq_gput_right:NV \g_@@_merge_align_seq \l_@@_tmpa_tl
2314 }
2315 % \end{macrocode}
2316 % \end{macro}
2317 %
2318 %
2319 %
2320 % \subsubsection{合并查询}
2321 %
2322 %
2323 % \begin{macro}{\@@_merge_if:n}
2324 % 确认指定单元格是否已合并。|#1|: 数字坐标。
2325 % \begin{macrocode}
2326 \prg_new_conditional:Nnn \@@_merge_if:n { p, T, F, TF }
2327 {
2328 \prop_if_in:NnTF \g_@@_merge_ref_prop {#1}
2329 { \prg_return_true: } { \prg_return_false: }
2330 }
2331 % \end{macrocode}
2332 % \end{macro}
2333 %
2334 %
2335 % \begin{macro}{\@@_parse_merge_count:}
2336 % 解析当前合并单元格数量,结果直接留在输入流中。
2337 % \begin{macrocode}
2338 \cs_new:Nn \@@_parse_merge_count:
2339 { \seq_count:N \g_@@_merge_info_seq }
2340 % \end{macrocode}
2341 % \end{macro}
2342 %
2343 %
2344 %
2345 % \begin{macro}{\@@_parse_merge_id:n}
2346 % 解析指定坐标所处的合并单元格的索引。修改变量 \cs{l_@@_merge_id_tl}。
2347 % \begin{macrocode}
2348 \cs_new:Nn \@@_parse_merge_id:n
2349 {
2350 \prop_get:NnNF \g_@@_merge_ref_prop {#1} \l_@@_merge_id_tl
2351 { \msg_error:nnn {xtable} {unmerged_cell} {#1} }
2352 }
2353 % \end{macrocode}
2354 % \end{macro}
2355 %
2356 %
2357 % \begin{macro}{\@@_parse_merge:n}
2358 % 解析指定索引的合并单元格的内容。
2359 % 修改变量 \cs{l_@@_merge_seq}、\cs{l_@@_data_tl} 及 \cs{l_@@_is_box_bool}。
2360 % \begin{macrocode}
2361 \cs_new:Nn \@@_parse_merge:n
2362 {
2363 \tl_set:Ne \l_@@_tmpa_tl
2364 { \seq_item:Nn \g_@@_merge_info_seq {#1} }
2365 \seq_set_split:NnV \l_@@_merge_seq {\s_@@_mark} \l_@@_tmpa_tl
2366 \@@_parse_cell:e { \seq_item:Nn \l_@@_merge_seq {5} }
2367 }
2368 \cs_generate_variant:Nn \@@_parse_merge:n { V }
2369 % \end{macrocode}
2370 % \end{macro}
2371 %
2372 %
2373 % \begin{macro}{\@@_parse_merge_align:n}
2374 % 解析指定索引的合并单元格的内容。
2375 % \cs{l_@@_row_align_tl} 与 \cs{l_@@_col_align_tl} 中。
2376 % \begin{macrocode}
2377 \cs_new:Nn \@@_parse_merge_align:n
2378 {
2379 \tl_set:Ne \l_@@_tmpa_tl
2380 { \seq_item:Nn \g_@@_merge_align_seq {#1} }
2381 \tl_set:Ne \l_@@_row_align_tl
2382 { \clist_item:Vn \l_@@_tmpa_tl {1} }
2383 \tl_set:Ne \l_@@_col_align_tl
2384 { \clist_item:Vn \l_@@_tmpa_tl {2} }
2385 }
2386 % \end{macrocode}
2387 % \end{macro}
2388 %
2389 %
2390 % \subsection{表头填充}
2391 %
2392 % \begin{macro}{\@@_header_fill:}
2393 % 当表格的表头为空时,尝试用行列名替代。
2394 % \begin{macrocode}
2395 \cs_new:Nn \@@_header_fill:
2396 {
2397 \prop_clear:N \l_@@_tmpa_prop
2398 \prop_map_inline:Nn \g_@@_row_name_prop
2399 { \prop_put:Nnn \l_@@_tmpa_prop {##2, 0} {##1} }
2400 \prop_map_inline:Nn \g_@@_col_name_prop
2401 { \prop_put:Nnn \l_@@_tmpa_prop {0, ##2} {##1} }
2402 \prop_map_inline:Nn \l_@@_tmpa_prop
2403 {
2404 \tl_set:Nn \l_@@_tmpa_tl { \s_@@_mark ##2 \s_@@_mark }
2405 \tl_put_left:NV \l_@@_tmpa_tl \c_@@_cell_content_tl
2406 \prop_gput_if_new:NnV \g_@@_cell_data_prop {##1} \l_@@_tmpa_tl
2407 }
2408 \int_step_inline:nn { \g_@@_row_count_int }
2409 {
2410 \tl_set:No \l_@@_tmpa_tl
2411 {\c_@@_cell_content_tl \s_@@_mark ##1 \s_@@_mark }
2412 \prop_gput_if_new:NnV \g_@@_cell_data_prop {##1, 0} \l_@@_tmpa_tl
2413 }
2414 }
2415 % \end{macrocode}
2416 % \end{macro}
2417 %
2418 %
2419 % \subsection{调试}
2420 %
2421 %
2422 % \begin{macro}{\showtable}
2423 % 显示表存储的内容,使用变量 \cs{l_@@_data_tl}。\todo[优化]{ 显示表格的更多内容信息 }
2424 % \begin{macrocode}
2425 \NewDocumentCommand \showtable {}
2426 {
2427 % \end{macrocode}
2428 % 输出列标题。
2429 % \begin{macrocode}
2430 \prop_if_empty:NTF \g_@@_cell_data_prop
2431 {当前表格内容为空。}
2432 {当前表格内容如下:}
2433 % \end{macrocode}
2434 % 输出内容。
2435 % \begin{macrocode}
2436 \int_step_inline:nnn {0} { \g_@@_row_count_int }
2437 {
2438 \\<##1>~
2439 \int_step_inline:nnn {0} { \g_@@_col_count_int }
2440 {
2441 \@@_parse_cell:n {##1, ####1}
2442 ,~\l_@@_data_tl
2443 }
2444 ;
2445 }
2446 }
2447 % \end{macrocode}
2448 % \end{macro}
2449 %
2450 %
2451 %
2452 % \begin{macro}{\logtable}
2453 % 在日志中显示表格的核心数据。\done\todo[Debug] { 修复 \cs{logtable} 实际调用成 show 函数的 Bug }
2454 % \begin{macrocode}
2455 \NewDocumentCommand \logtable {}
2456 {
2457 \int_log:N \g_@@_row_count_int
2458 \int_log:N \g_@@_col_count_int
2459 \seq_log:N \g_@@_row_align_seq
2460 \seq_log:N \g_@@_col_align_seq
2461 \seq_log:N \g_@@_row_ht_style_seq
2462 \seq_log:N \g_@@_col_wd_style_seq
2463 \seq_log:N \g_@@_merge_info_seq
2464 \seq_log:N \g_@@_merge_align_seq
2465 \prop_log:N \g_@@_row_name_prop
2466 \prop_log:N \g_@@_col_name_prop
2467 \prop_log:N \g_@@_cell_data_prop
2468 \prop_log:N \g_@@_merge_ref_prop
2469 \bool_log:N \g_@@_row_header_bool
2470 \bool_log:N \g_@@_col_header_bool
2471 }
2472 % \end{macrocode}
2473 % \end{macro}
2474 %
2475 %
2476 % \section{输入接口}
2477 %
2478 % 本节作为数据输入的对外接口,负责将表格内容从用户层转到存储层,但不涉及渲染相关计算.
2479 %
2480 % \subsection{变量与选项}
2481 %
2482 %
2483 % \subsubsection{正则常量}
2484 %
2485 %
2486 % \begin{variable} {\c_@@_csv_row_regex, \c_@@_csv_cell_regex}
2487 % 用于解析 CSV 中的行的正则表达式。
2488 % 其中单元格表达式每个匹配生成三个项目,它们分别是所有匹配,常规字段值,引号字段值。
2489 % \begin{macrocode}
2490 \regex_const:Nn \c_@@_csv_row_regex
2491 { (?:(?:[^"\c{\\}]+|"(?:""|[^"])+")+?)(?:\c{\\}) }
2492 \regex_const:Nn \c_@@_csv_cell_regex
2493 { (?:([^"\c{\\},]*)|"((?:""|[^"])+)")(?:,|\c{\\}) }
2494 % \end{macrocode}
2495 % \end{variable}
2496 %
2497 %
2498 % \begin{variable} {\c_@@_json_cell_regex}
2499 % 用于解析 JSON 中的属性值的正则表达式。
2500 % 每个匹配生成四个项目,它们分别是所有匹配,名称,非字符值(数值或真假),字符值。
2501 % \begin{macrocode}
2502 \regex_const:Nn \c_@@_json_cell_regex
2503 {
2504 "((?:[^"\\]|\\.)+)"
2505 \s*:\s*
2506 (?:
2507 ([\+\-]?(?:\d*\.)?\d+|true|false) |
2508 "((?:[^"\\]|\\.)+)"
2509 )
2510 \s*[,]?
2511 }
2512 % \end{macrocode}
2513 % \end{variable}
2514 %
2515 %
2516 % \begin{variable} {\c_@@_row_ht_regex, \c_@@_col_wd_regex}
2517 % 用于判定某项内容是否为行高样式/列宽样式。
2518 % \begin{macrocode}
2519 \regex_const:Nn \c_@@_row_ht_regex
2520 {
2521 \A(?:.*=)?(?:
2522 (auto|same|a|s)|
2523 ([0-9.]+(?:pt|ex|em|mm|cm|in|cc|dd|pc))
2524 )\Z
2525 }
2526 \regex_const:Nn \c_@@_col_wd_regex
2527 {
2528 \A(?:.*=)?(?:
2529 (auto|same|fill|samefill|a|s|f|sf)|
2530 ([0-9.]+(?:pt|ex|em|mm|cm|in|cc|dd|pc))
2531 )\Z
2532 }
2533 % \end{macrocode}
2534 % \end{variable}
2535 %
2536 %
2537 %
2538 % \subsubsection{状态参数}
2539 %
2540 % \begin{variable} {\l_@@_input_bool}
2541 % 当前是否处于输入环境。
2542 % \begin{macrocode}
2543 \bool_new:N \l_@@_input_bool
2544 \bool_set_false:N \l_@@_input_bool
2545 % \end{macrocode}
2546 % \end{variable}
2547 %
2548 % \begin{macro}{\@@_check_input_env:n}
2549 % 检测是否处理输入环境。如果不是,则报错。
2550 % \begin{macrocode}
2551 \cs_new:Nn \@@_check_input_env:n
2552 {
2553 \bool_if:NF \l_@@_input_bool
2554 { \msg_error:nnn {xtable} {outside_xtable} {#1} }
2555 }
2556 % \end{macrocode}
2557 % \end{macro}
2558 %
2559 % \begin{variable} {\l_@@_parse_status_int, \l_@@_esc_status_bool, \l_@@_quote_status_bool}
2560 % 用于保存解析过程中的状态。
2561 % \begin{macrocode}
2562 \int_new:N \l_@@_parse_status_int
2563 \bool_new:N \l_@@_esc_status_bool
2564 \bool_new:N \l_@@_quote_status_bool
2565 % \end{macrocode}
2566 % \end{variable}
2567 %
2568 %
2569 % \subsubsection{局部变量}
2570 %
2571 % \begin{variable} {\l_@@_row_input_seq, \l_@@_cell_input_seq}
2572 % 用于保存原始的输入数据。
2573 % \begin{macrocode}
2574 \seq_new:N \l_@@_row_input_seq
2575 \seq_new:N \l_@@_cell_input_seq
2576 % \end{macrocode}
2577 % \end{variable}
2578 %
2579 %
2580 % \subsubsection{局部选项}
2581 %
2582 %
2583 % \begin{variable}{\l_@@_input_format_tl, \l_@@_input_sep_tl,
2584 % \l_@@_input_row_header_bool, \l_@@_input_col_header_bool}
2585 % 输入选项变量。
2586 % \begin{macrocode}
2587 \tl_new:N \l_@@_input_format_tl
2588 \tl_new:N \l_@@_input_sep_tl
2589 \bool_new:N \l_@@_input_row_header_bool
2590 \bool_new:N \l_@@_input_col_header_bool
2591 % \end{macrocode}
2592 % \end{variable}
2593 %
2594 %
2595 %
2596 % \begin{macro}{xtable/input}
2597 % 输入选项。
2598 % \begin{macrocode}
2599 \keys_define:nn { xtable / input }
2600 {
2601 format .choices:nn = { inner, csv, json }
2602 { \tl_set_eq:NN \l_@@_input_format_tl \l_keys_choice_tl },
2603 format .initial:n = {inner},
2604 csv .code:n = { \tl_set:Nn \l_@@_input_format_tl { csv } },
2605 json .code:n = { \tl_set:Nn \l_@@_input_format_tl { json } },
2606 title .bool_set:N = \l_@@_input_col_header_bool,
2607 header .bool_set:N = \l_@@_input_col_header_bool,
2608 header .initial:n = {true},
2609 rowheader .bool_set:N = \l_@@_input_row_header_bool,
2610 rowheader .initial:n = {false},
2611 sep .tl_set:N = \l_@@_input_sep_tl,
2612 sep .initial:n = {,},
2613 loc .code:n = { \@@_parse_coord:n {#1} },
2614 loc .initial:n = {1,1}
2615 }
2616 % \end{macrocode}
2617 % \end{macro}
2618 %
2619 %
2620 % \subsection{数据解析}
2621 %
2622 % \subsubsection{标准格式}
2623 %
2624 %
2625 % \begin{macro}{\@@_parse_input:n}
2626 % 解析标准输入的表格数据(|#1|),并将其添加到指定位置。
2627 % 起始行由 \cs{l_@@_row_loc_int} 指定;起始列由 \cs{l_@@_col_loc_int} 指定。
2628 % \begin{macrocode}
2629 \cs_new:Nn \@@_parse_input:n
2630 {
2631 % \end{macrocode}
2632 % 准备阶段。
2633 % \begin{macrocode}
2634 \seq_set_split:Nnn \l_@@_row_input_seq {\\} {#1}
2635 \cs_set:Nn \@@_tmpa_cs: % 更新单元格序列
2636 {
2637 \tl_replace_all:Nnn \l_@@_tmpa_tl {\newline} {\\}
2638 \seq_set_split:NVV \l_@@_cell_input_seq
2639 \l_@@_input_sep_tl \l_@@_tmpa_tl
2640 }
2641 \cs_set:Nn \@@_tmpb_cs: % 填充一行数据
2642 {
2643 \int_set_eq:NN \l_@@_tmpb_int \l_@@_col_loc_int
2644 \seq_map_inline:Nn \l_@@_cell_input_seq
2645 {
2646 \@@_set_cell:NNn \l_@@_tmpa_int \l_@@_tmpb_int {####1}
2647 \int_incr:N \l_@@_tmpb_int
2648 }
2649 }
2650 % \end{macrocode}
2651 % 处理标题行。
2652 % \begin{macrocode}
2653 \bool_if:NT \l_@@_input_col_header_bool
2654 {
2655 \int_zero:N \l_@@_tmpa_int
2656 \seq_pop_left:NN \l_@@_row_input_seq \l_@@_tmpa_tl
2657 \@@_tmpa_cs:
2658 \bool_if:NT \l_@@_input_row_header_bool
2659 {
2660 \seq_pop_left:NNT \l_@@_cell_input_seq \l_@@_tmpb_tl
2661 { \@@_set_cell:nV {0, 0} \l_@@_tmpb_tl }
2662 }
2663 \@@_tmpb_cs:
2664 \int_set_eq:NN \l_@@_tmpb_int \l_@@_col_loc_int
2665 \seq_map_inline:Nn \l_@@_cell_input_seq
2666 {
2667 \@@_set_col_name:nN {##1} \l_@@_tmpb_int
2668 \int_incr:N \l_@@_tmpb_int
2669 }
2670 }
2671 % \end{macrocode}
2672 % 处理正常数据行。
2673 % \begin{macrocode}
2674 \int_set_eq:NN \l_@@_tmpa_int \l_@@_row_loc_int
2675 \seq_map_inline:Nn \l_@@_row_input_seq
2676 {
2677 \tl_set:Nn \l_@@_tmpa_tl {##1}
2678 \@@_tmpa_cs:
2679 \bool_if:NT \l_@@_input_row_header_bool
2680 {
2681 \seq_pop_left:NNT \l_@@_cell_input_seq \l_@@_tmpb_tl
2682 { \@@_set_cell:eV {\l_@@_tmpa_int, 0} \l_@@_tmpb_tl }
2683 }
2684 \@@_tmpb_cs:
2685 \int_incr:N \l_@@_tmpa_int
2686 }
2687 }
2688 % \end{macrocode}
2689 % \end{macro}
2690 %
2691 %
2692 % \subsubsection{CSV 数据}
2693 %
2694 %
2695 % 解析 CSV 数据使用的思路是,先用正则表达式解析出行,再用正则表达式解析每个字段。
2696 %
2697 % \done\todo[Debug] { 修复 CSV 正则表达式与代码不匹配的Bug }
2698 %
2699 % \begin{macro}{\@@_parse_csv:n}
2700 % 解析 CSV 数据(|#1|),并将其添加到指定位置。
2701 % 起始行由 \cs{l_@@_row_loc_int} 指定;起始列由 \cs{l_@@_col_loc_int} 指定。
2702 % \begin{macrocode}
2703 \cs_new:Nn \@@_parse_csv:n
2704 {
2705 \seq_clear:N \l_@@_row_input_seq
2706 \regex_extract_all:NnN
2707 \c_@@_csv_row_regex {#1\\} \l_@@_row_input_seq
2708 \int_set_eq:NN \l_@@_tmpa_int \l_@@_row_loc_int
2709 \seq_map_inline:Nn \l_@@_row_input_seq
2710 {
2711 \int_set_eq:NN \l_@@_tmpb_int \l_@@_col_loc_int
2712 \seq_clear:N \l_@@_tmpa_seq
2713 \seq_clear:N \l_@@_cell_input_seq
2714 \regex_extract_all:NnN
2715 \c_@@_csv_cell_regex {##1} \l_@@_tmpa_seq
2716 \int_step_inline:nnnn {2} {3} {\seq_count:N \l_@@_tmpa_seq}
2717 {
2718 \tl_set:Ne \l_@@_tmpa_tl
2719 { \seq_item:Nn \l_@@_tmpa_seq {####1} }
2720 \tl_set:Ne \l_@@_tmpb_tl
2721 { \seq_item:Nn \l_@@_tmpa_seq {####1+1} }
2722 \tl_put_right:NV \l_@@_tmpa_tl \l_@@_tmpb_tl
2723 \seq_put_right:NV \l_@@_cell_input_seq \l_@@_tmpa_tl
2724 }
2725 \bool_if:NTF \l_@@_input_col_header_bool
2726 { % 填充表头(设置列名)
2727 \seq_map_inline:Nn \l_@@_cell_input_seq
2728 {
2729 \@@_set_col_name:nN {####1} \l_@@_tmpb_int
2730 \int_incr:N \l_@@_tmpb_int
2731 }
2732 \bool_set_false:N \l_@@_input_col_header_bool
2733 }
2734 { % 填充数据
2735 \seq_map_inline:Nn \l_@@_cell_input_seq
2736 {
2737 \@@_set_cell:NNn \l_@@_tmpa_int \l_@@_tmpb_int {####1}
2738 \int_incr:N \l_@@_tmpb_int
2739 }
2740 \int_incr:N \l_@@_tmpa_int
2741 }
2742 }
2743 }
2744 % \end{macrocode}
2745 % \end{macro}
2746 %
2747 %
2748 %
2749 % \subsubsection{JSON 数据}
2750 %
2751 % 本宏包解析 JSON 数据的思路:先将行依次解析到一个中转序列(逐字符处理)
2752 % 再依次解析每一行数据(正则表达式)。
2753 %
2754 % 逐字符解析完整 JSON ,并将解析状态分为:初始模式、行间模式、行内模式。
2755 % 整个解析过程都在这三个状态中切换。
2756 %
2757 % \begin{macro}{\@@_parse_json_auxa:n}
2758 % 拆分行时用到的辅助函数,处理初始模式。
2759 % 当前字符(|#1|)为 |[|,则表示数据开始,切换到行间模式;
2760 % 当前字符为 |{|,则表示一行数据开始,直接切换到行内模式。
2761 % \begin{macrocode}
2762 \cs_new:Nn \@@_parse_json_auxa:n
2763 {
2764 \str_case_e:nnF {#1}
2765 {
2766 {\c_@@_space_str} {} % 空白,跳过
2767 {[} % 数组开始
2768 { \int_set:Nn \l_@@_parse_status_int {1} }
2769 {\c_@@_lbrace_str} % 行开始
2770 {
2771 \int_set:Nn \l_@@_parse_status_int {2}
2772 \str_clear:N \l_@@_tmpa_str
2773 }
2774 }
2775 { \msg_error:nnn {xtable} {unknown_input} {#1} }
2776 }
2777 % \end{macrocode}
2778 % \end{macro}
2779 %
2780 % \begin{macro}{\@@_parse_json_auxb:n}
2781 % 拆分行时用到的辅助函数,处理行间模式。
2782 % 当前字符(|#1|)为 |]|,则表示数据结束,切换回初始模式;
2783 % 当前字符为 |{|,则表示一行数据开始,切换到行内模式。
2784 % 忽略逗号与空白。
2785 % \begin{macrocode}
2786 \cs_new:Nn \@@_parse_json_auxb:n
2787 {
2788 \str_case_e:nnF {#1}
2789 {
2790 {\c_@@_space_str} {} % 空白,跳过
2791 {,} {} % 行分隔,跳过
2792 {]} % 数组结束
2793 { \int_set:Nn \l_@@_parse_status_int {0} }
2794 {\c_@@_lbrace_str} % 行开始
2795 {
2796 \int_set:Nn \l_@@_parse_status_int {2}
2797 \str_clear:N \l_@@_tmpa_str
2798 }
2799 }
2800 { \msg_error:nnn {xtable} {unknown_input} {#1} }
2801 }
2802 % \end{macrocode}
2803 % \end{macro}
2804 % \begin{macro}{\@@_parse_json_auxc:n}
2805 % 拆分行时用到的辅助函数,处理行内模式。|#1| 为当前字符。
2806 % 行内模式又有两个子状态:转义态与引用态。
2807 % 如果当前状态为转义态,则恢复为非转义态;否则,可以用 |\| 切换为转义态。
2808 % 如果当前状态为引用态(且非转义态),则可用 |"| 切换为非引用态;
2809 % 否则,可以使用 |"| 切换为引用态,或使用 |}| 结束当前行,并进入行间模式。
2810 % \begin{macrocode}
2811 \cs_new:Nn \@@_parse_json_auxc:n
2812 {
2813 \bool_if:NTF \l_@@_esc_status_bool % 转义状态
2814 { \bool_set_false:N \l_@@_esc_status_bool }
2815 {
2816 \str_if_eq:VnTF \c_@@_escape_str {#1} % 即将转义
2817 { \bool_set_true:N \l_@@_esc_status_bool }
2818 {
2819 \bool_if:NTF \l_@@_quote_status_bool % 引用状态
2820 {
2821 \str_if_eq:nnT {"} {#1} % 结束引用
2822 { \bool_set_false:N \l_@@_quote_status_bool }
2823 }
2824 {
2825 \str_if_eq:nnTF {"} {#1} % 即将引用
2826 { \bool_set_true:N \l_@@_quote_status_bool }
2827 {
2828 \str_if_eq:VnT \c_@@_rbrace_str {#1} % 行结束
2829 {
2830 \int_set:Nn \l_@@_parse_status_int {1}
2831 \seq_put_right:NV \l_@@_row_input_seq \l_@@_tmpa_str
2832 }
2833 }
2834 }
2835 }
2836 }
2837 \str_put_right:Nn \l_@@_tmpa_str {#1}
2838 }
2839 % \end{macrocode}
2840 % \end{macro}
2841 %
2842 %
2843 % \begin{macro}{\@@_parse_json_row:n}
2844 % 解析 JSON 中的单行数据(|#1|),并将其添加表中。
2845 % 使用 \cs{l_@@_row_loc_int} 与 \cs{l_@@_col_loc_int} 来传递下一位置的坐标。
2846 % 使用缓存变量 \cs{l_@@_cachea_tl} 与 \cs{l_@@_cacheb_tl}。
2847 % \begin{macrocode}
2848 \cs_new:Nn \@@_parse_json_row:n
2849 {
2850 \regex_extract_all:NnN
2851 \c_@@_json_cell_regex {#1} \l_@@_cell_input_seq
2852 \bool_until_do:nn
2853 { \seq_if_empty_p:N \l_@@_cell_input_seq }
2854 {
2855 \seq_pop_left:NN \l_@@_cell_input_seq \l_@@_tmpa_tl % 丢弃
2856 \seq_pop_left:NN \l_@@_cell_input_seq \l_@@_cachea_tl
2857 \seq_pop_left:NN \l_@@_cell_input_seq \l_@@_tmpa_tl
2858 \seq_pop_left:NN \l_@@_cell_input_seq \l_@@_tmpb_tl
2859 \tl_if_empty:NTF \l_@@_tmpa_tl
2860 { \tl_set_eq:NN \l_@@_cacheb_tl \l_@@_tmpb_tl }
2861 { \tl_set_eq:NN \l_@@_cacheb_tl \l_@@_tmpa_tl }
2862 \int_set_eq:NN \l_@@_cachea_int \l_@@_col_loc_int
2863 \@@_parse_new_col_loc:V \l_@@_cachea_tl
2864 \int_set_eq:NN \l_@@_tmpa_int \l_@@_col_loc_int
2865 \int_compare:nNnTF {\l_@@_cachea_int} = {\l_@@_col_loc_int}
2866 { \int_incr:N \l_@@_col_loc_int }
2867 { \int_set_eq:NN \l_@@_col_loc_int \l_@@_cachea_int }
2868 \@@_set_cell:NNV
2869 \l_@@_row_loc_int \l_@@_tmpa_int \l_@@_cacheb_tl
2870 }
2871 \int_incr:N \l_@@_row_loc_int
2872 }
2873 % \end{macrocode}
2874 % \end{macro}
2875 %
2876 %
2877 % \begin{macro}{\@@_parse_json:n}
2878 % 解析 JSON 数据(|#1|),并将其添加到指定位置。
2879 % 起始行由 \cs{l_@@_row_loc_int} 指定;列位置则由列名指定。
2880 % 如果列名不存在,先依次将列名映射到指定位置(\cs{l_@@_col_loc_int} )及其后。
2881 % \begin{macrocode}
2882 \cs_new:Nn \@@_parse_json:n
2883 {
2884 \int_zero:N \l_@@_parse_status_int
2885 \bool_set_false:N \l_@@_esc_status_bool
2886 \bool_set_false:N \l_@@_quote_status_bool
2887 \str_clear:N \l_@@_tmpa_str
2888 \seq_clear:N \l_@@_row_input_seq
2889 \str_map_inline:nn {#1} % 解析 JSON 中的行
2890 {
2891 \int_case:nn
2892 { \l_@@_parse_status_int }
2893 {
2894 {0} { \@@_parse_json_auxa:n {##1} } % 开始
2895 {1} { \@@_parse_json_auxb:n {##1} } % 行间状态
2896 {2} { \@@_parse_json_auxc:n {##1} } % 行内状态
2897 }
2898 }
2899 \seq_map_function:NN \l_@@_row_input_seq \@@_parse_json_row:n
2900 }
2901 % \end{macrocode}
2902 % \end{macro}
2903 %
2904 % \subsection{数据录入}
2905 %
2906 %
2907 % \begin{macro}{\loadtable, \savetable}
2908 % 保存与加载表格。
2909 % \begin{macrocode}
2910 \NewDocumentCommand {\loadtable} { m }
2911 {
2912 \@@_check_input_env:n {\loadtable}
2913 \@@_table_restore:n {#1}
2914 }
2915 \NewDocumentCommand {\savetable} { m }
2916 {
2917 \@@_check_input_env:n {\savetable}
2918 \@@_table_save:n {#1}
2919 }
2920 % \end{macrocode}
2921 % \end{macro}
2922 %
2923 % \begin{macro}{\excelcolname}
2924 % 设置 Excel 风格列名。
2925 % \begin{macrocode}
2926 \NewDocumentCommand {\excelcolname} { O{26} }
2927 {
2928 \@@_check_input_env:n {\excelcolname}
2929 \@@_set_excel_col_names:n {#1}
2930 }
2931 % \end{macrocode}
2932 % \end{macro}
2933 %
2934 %
2935 %
2936 % \begin{macro}{\@@_line_name:Nnnn, \rowname, \colname}
2937 % 设置行名与列名。
2938 % \begin{macrocode}
2939 \cs_new:Nn \@@_line_name:Nnnn
2940 {
2941 \int_set:Nn \l_@@_tmpa_int {#2}
2942 \seq_set_split:Nnn \l_@@_cell_input_seq {#3} {#4}
2943 \seq_map_inline:Nn \l_@@_cell_input_seq
2944 {
2945 #1 {##1} \l_@@_tmpa_int
2946 \int_incr:N \l_@@_tmpa_int
2947 }
2948 }
2949 % \end{macrocode}
2950 % |#1| 位置,|#2| 分隔符,|#3| 名称列表。
2951 % \begin{macrocode}
2952 \NewDocumentCommand {\rowname} { D(){1} O{,} m }
2953 {
2954 \@@_check_input_env:n {\rowname}
2955 \@@_line_name:Nnnn \@@_set_row_name:nN {#1} {#2} {#3}
2956 }
2957 \NewDocumentCommand {\colname} { D(){1} O{,} m }
2958 {
2959 \@@_check_input_env:n {\colname}
2960 \@@_line_name:Nnnn \@@_set_col_name:nN {#1} {#2} {#3}
2961 }
2962 % \end{macrocode}
2963 % \end{macro}
2964 %
2965 %
2966 % \begin{macro}{\@@_line:nnnn, \@@_row:nnn, \@@_col:nnn}
2967 % 设置某一行/列数据。使用变量 \cs{l_@@_row_loc_int} 与 \cs{l_@@_col_loc_int}。
2968 % \begin{macrocode}
2969 \cs_new:Nn \@@_line:nnnn
2970 {
2971 % \end{macrocode}
2972 % 解析位置。
2973 % \begin{macrocode}
2974 \int_set:Nn \l_@@_row_loc_int {1}
2975 \int_set:Nn \l_@@_col_loc_int {1}
2976 \str_if_empty:nTF {#1}
2977 {
2978 \int_set_eq:Nc \l_@@_tmpa_int { g_@@_#4_count_int }
2979 \int_add:cn { l_@@_#4_loc_int } { \l_@@_tmpa_int }
2980 }
2981 {
2982 \str_if_in:nnTF {#1} {,}
2983 { \@@_parse_new_coord:n {#1} }
2984 { \use:c { @@_parse_new_#4_loc:n } {#1} }
2985 }
2986 % \end{macrocode}
2987 % 遍历添加数据。
2988 % \begin{macrocode}
2989 \str_if_eq:nnTF {#4} {row}
2990 { \cs_set_eq:NN \@@_tmpa_cs: \l_@@_col_loc_int }
2991 { \cs_set_eq:NN \@@_tmpa_cs: \l_@@_row_loc_int }
2992 \seq_set_split:Nnn \l_@@_cell_input_seq {#2} {#3}
2993 \seq_map_inline:Nn \l_@@_cell_input_seq
2994 {
2995 \@@_set_cell:n {##1}
2996 \int_incr:N \@@_tmpa_cs:
2997 }
2998 }
2999 % \end{macrocode}
3000 % 定义内部名称。|#1| 位置,|#2| 分隔符,|#3| 名称列表。
3001 % \begin{macrocode}
3002 \NewDocumentCommand {\@@_row:nnn} { D(){} O{,} m }
3003 { \@@_line:nnnn {#1} {#2} {#3} {row} }
3004 \NewDocumentCommand {\@@_col:nnn} { D(){} O{,} m }
3005 { \@@_line:nnnn {#1} {#2} {#3} {col} }
3006 % \end{macrocode}
3007 % \end{macro}
3008 %
3009 %
3010 % \begin{macro}{\@@_cell:nn}
3011 % 用于输入单元格的数据。使用变量 \cs{l_@@_row_loc_int} 与 \cs{l_@@_col_loc_int}。
3012 % \begin{macrocode}
3013 \NewDocumentCommand {\@@_cell:nn} { r() m }
3014 {
3015 \int_zero:N \l_@@_row_loc_int
3016 \int_zero:N \l_@@_col_loc_int
3017 \@@_parse_new_coord:n {#1}
3018 \@@_set_cell:n {#2}
3019 }
3020 % \end{macrocode}
3021 % \end{macro}
3022 %
3023 %
3024 % \begin{environment}{@@_data:}
3025 % 用于输入表格内容的环境。
3026 % \begin{macrocode}
3027 \NewDocumentEnvironment{@@_data:}{O{} +b}
3028 {
3029 \keys_set:nn { xtable/input } {#1}
3030 \str_case:VnF \l_@@_input_format_tl
3031 {
3032 {inner} { \@@_parse_input:n {#2} }
3033 {csv} { \@@_parse_csv:n {#2} }
3034 {json} { \@@_parse_json:n {#2} }
3035 }
3036 { \msg_error:nnV {xtable} {unknown_format} \l_@@_input_format_tl }
3037 }
3038 {}
3039 % \end{macrocode}
3040 % \end{environment}
3041 %
3042 % \begin{macro}{., ..,\row, \col, \cell}
3043 % \begin{environment}{xtable, data}
3044 % 用于输入表格的环境。
3045 % \begin{macrocode}
3046 \NewDocumentEnvironment{xtable}{ O{} }
3047 {
3048 \@@_table_init:
3049 \keys_set:nn { xtable/input } {#1}
3050 \bool_gset_eq:NN
3051 \g_@@_row_header_bool \l_@@_input_row_header_bool
3052 \bool_gset_eq:NN
3053 \g_@@_col_header_bool \l_@@_input_col_header_bool
3054 \cs_set_eq:NN \data \@@_data:
3055 \cs_set_eq:NN \enddata \end_@@_data:
3056 \cs_set_eq:NN \row \@@_row:nnn
3057 \cs_set_eq:NN \col \@@_col:nnn
3058 \cs_set_eq:NN \cell \@@_cell:nn
3059 \bool_set_true:N \l_@@_input_bool
3060 }
3061 {
3062 \bool_set_false:N \l_@@_input_bool
3063 \@@_insure_style:
3064 \@@_header_fill:
3065 }
3066 % \end{macrocode}
3067 % \end{environment}
3068 % \end{macro}
3069 %
3070 % \subsection{格式设置}
3071 %
3072 %
3073 % \begin{macro}{\@@_line_align:nnnn, \rowalign, \colalign}
3074 % 设置行与列的对齐方式。|#1| 默认值,|#2| 格式列表,|#3| 正则表达式,|#4| 行/列。
3075 % \begin{macrocode}
3076 \cs_new:Nn \@@_line_align:nnnn
3077 {
3078 \regex_extract_all:nnNF {#3} {#1#2} \l_@@_tmpa_seq
3079 { \msg_error:nnn {xtable} {unknown_format} {[#1],{#2}} }
3080 \str_if_in:nnTF {#2} {=}
3081 { \seq_set_split:Nnn \l_@@_cell_input_seq {,} {#2} }
3082 {
3083 \tl_set:Nn \l_@@_tmpa_tl {#2}
3084 \tl_replace_all:Nnn \l_@@_tmpa_tl {,} {}
3085 \seq_set_split:NnV \l_@@_cell_input_seq {} \l_@@_tmpa_tl
3086 }
3087 \use:c { @@_set_#4_align:Nn } \l_@@_cell_input_seq {#1}
3088 }
3089 % \end{macrocode}
3090 % \begin{macrocode}
3091 \NewDocumentCommand {\rowalign} { O{b} m }
3092 {
3093 \@@_check_input_env:n {\rowalign}
3094 \@@_line_align:nnnn {#1} {#2} {^(?:(?:.*=)?[tmb],?)*$} {row}
3095 }
3096 \NewDocumentCommand {\colalign} { O{c} m }
3097 {
3098 \@@_check_input_env:n {\colalign}
3099 \@@_line_align:nnnn {#1} {#2} {^(?:(?:.*=)?[lcr],?)*$} {col}
3100 }
3101 % \end{macrocode}
3102 % \end{macro}
3103 %
3104 %
3105 % \begin{macro}{\@@_line_size:nnnn, \rowheight, \colwidth}
3106 % 设置行高与列宽。|#1| 默认值,|#2| 总尺寸,|#3| 格式列表,|#4| 行高/列宽。
3107 % \begin{macrocode}
3108 \cs_new:Nn \@@_line_size:nnnn
3109 {
3110 \seq_clear:N \l_@@_cell_input_seq
3111 \seq_set_split:Nnn \l_@@_cell_input_seq {,} {#3}
3112 \cs_set_eq:Nc \@@_tmpa_cs: { c_@@_#4_regex }
3113 \regex_extract_all:NnNF
3114 \@@_tmpa_cs: {#1} \l_@@_tmpa_seq
3115 { \msg_error:nnn {xtable} {unknown_format} {#1} }
3116 \seq_map_inline:Nn \l_@@_cell_input_seq
3117 {
3118 \regex_extract_all:NnNF
3119 \@@_tmpa_cs: {##1} \l_@@_tmpa_seq
3120 { \msg_error:nnn {xtable} {unknown_format} {##1} }
3121 }
3122 \use:c { @@_set_#4_style:Nnn } \l_@@_cell_input_seq {#1} {#2}
3123 }
3124 % \end{macrocode}
3125 % \begin{macrocode}
3126 \NewDocumentCommand {\rowheight} { O{auto} O{\textheight} m }
3127 {
3128 \@@_check_input_env:n {\rowheight}
3129 \@@_line_size:nnnn {#1} {#2} {#3} { row_ht }
3130 }
3131 \NewDocumentCommand {\colwidth} { O{auto} O{\textwidth} m }
3132 {
3133 \@@_check_input_env:n {\colwidth}
3134 \@@_line_size:nnnn {#1} {#2} {#3} { col_wd }
3135 }
3136 % \end{macrocode}
3137 % \end{macro}
3138 %
3139 %
3140 % \subsection{合并单元格}
3141 %
3142 % \begin{macro}{\mergecell}
3143 % 合并单元格。
3144 % \begin{macrocode}
3145 \NewDocumentCommand {\mergecell} { O{ul} r() r() O{mc} }
3146 {
3147 \@@_check_input_env:n {\mergecell}
3148 \cs_new:Npn \@@_tmapa_cs: ##1##2
3149 {
3150 \int_set_eq:NN \l_@@_tmpa_int ##1
3151 \int_set_eq:NN ##1 ##2
3152 \int_set_eq:NN ##2 \l_@@_tmpa_int
3153 }
3154 % \end{macrocode}
3155 % \begin{macrocode}
3156 \@@_check_input_env:n {\mergecell}
3157 \@@_parse_coord:n {#3}
3158 \int_set_eq:NN \l_@@_cachea_int \l_@@_row_loc_int
3159 \int_set_eq:NN \l_@@_cacheb_int \l_@@_col_loc_int
3160 \@@_parse_coord:n {#2}
3161 \int_compare:nNnT {\l_@@_row_loc_int} > {\l_@@_cachea_int}
3162 { \@@_tmapa_cs: \l_@@_row_loc_int \l_@@_cachea_int }
3163 \int_compare:nNnT {\l_@@_col_loc_int} > {\l_@@_cacheb_int}
3164 { \@@_tmapa_cs: \l_@@_col_loc_int \l_@@_cacheb_int }
3165 \@@_set_merge_cell:VVVVn \l_@@_row_loc_int \l_@@_col_loc_int
3166 \l_@@_cachea_int \l_@@_cacheb_int {#1}
3167 \@@_set_merge_align:n {#4}
3168 }
3169 % \end{macrocode}
3170 % \end{macro}
3171 %
3172 %
3173 % \section{中间计算}
3174 %
3175 % 本节内容为渲染输出准备,它计算一些表格相关的数据 。
3176 %
3177 %
3178 % \subsection{中间变量}
3179 %
3180 %
3181 % \begin{variable}{\g_@@_row_sep_seq, \g_@@_col_sep_seq}
3182 % 用于存储间隙信息(包含 |Header|),在渲染前需要首先刷新此变量的值。
3183 % \begin{macrocode}
3184 \seq_new:N \g_@@_row_sep_seq
3185 \seq_new:N \g_@@_col_sep_seq
3186 % \end{macrocode}
3187 % \end{variable}
3188 %
3189 %
3190 % \begin{variable}{\g_@@_row_ht_seq, \g_@@_row_dp_seq, \g_@@_col_wd_seq}
3191 % 用于行/列的存储高、深及宽信息(包含|Header|),在渲染前需要刷新此变量的值。
3192 % 如果列宽有使用填充样式,则需要刷新列间隙后再刷新列宽。
3193 % \begin{macrocode}
3194 \seq_new:N \g_@@_row_ht_seq
3195 \seq_new:N \g_@@_row_dp_seq
3196 \seq_new:N \g_@@_col_wd_seq
3197 % \end{macrocode}
3198 % \end{variable}
3199 %
3200 %
3201 % \begin{variable}{\g_@@_cell_ht_prop, \g_@@_cell_ufill_prop, \g_@@_cell_dfill_prop}
3202 % 单元格填充值(补偿首行字高及未行字深)及填充后高度
3203 % \footnote{此高度可能比行高要小,因为行高是该行中所有单元格高度中最大的值。},在渲染前需要刷新此变量的值。
3204 % \begin{macrocode}
3205 \prop_new:N \g_@@_cell_ht_prop
3206 \prop_new:N \g_@@_cell_ufill_prop
3207 \prop_new:N \g_@@_cell_dfill_prop
3208 % \end{macrocode}
3209 % \end{variable}
3210 %
3211 %
3212 % \begin{variable}{\g_@@_merge_wd_seq, \g_@@_merge_ht_seq, \g_@@_merge_dp_seq}
3213 % 合并单元格的净宽、净高、净深及上下填充值,在渲染前需要刷新此变量的值。
3214 % \begin{macrocode}
3215 \seq_new:N \g_@@_merge_wd_seq
3216 \seq_new:N \g_@@_merge_ht_seq
3217 \seq_new:N \g_@@_merge_dp_seq
3218 \seq_new:N \g_@@_merge_ufill_seq
3219 \seq_new:N \g_@@_merge_dfill_seq
3220 % \end{macrocode}
3221 % \end{variable}
3222 %
3223 %
3224 %
3225 %
3226 % \begin{variable}{\g_@@_merge_range_wd_seq, \g_@@_merge_range_ht_seq, \g_@@_merge_range_dp_seq}
3227 % 合并单元格的排版尺寸,在渲染前需要刷新此变量的值。
3228 % \begin{macrocode}
3229 \seq_new:N \g_@@_merge_range_wd_seq
3230 \seq_new:N \g_@@_merge_range_ht_seq
3231 \seq_new:N \g_@@_merge_range_dp_seq
3232 % \end{macrocode}
3233 % \end{variable}
3234 %
3235 %
3236 % \begin{variable}{\g_@@_row_loc_seq, \g_@@_col_loc_seq}
3237 % 用于存储表格的行列坐标(图形坐标)信息(包含 |Header|)。
3238 % 需要在渲染条件确认后再刷新。
3239 % \begin{macrocode}
3240 \seq_new:N \g_@@_row_loc_seq
3241 \seq_new:N \g_@@_col_loc_seq
3242 % \end{macrocode}
3243 % \end{variable}
3244 %
3245 %
3246 % \subsection{行列尺寸}
3247 %
3248 %
3249 % \subsubsection{边距设置}
3250 %
3251 %
3252 % \begin{macro}{\@@_set_row_sep:nn, \@@_set_col_sep:nn}
3253 % 设置列边距(内容到内容的距离)。|#1|:最左边与最右边的边距,|#2|:中间的边距。
3254 % \begin{macrocode}
3255 \cs_new:Nn \@@_set_row_sep:nn
3256 {
3257 \seq_gclear:N \g_@@_row_sep_seq
3258 \prg_replicate:nn {\g_@@_row_count_int}
3259 { \seq_gput_right:Nn \g_@@_row_sep_seq {#2} }
3260 \seq_gput_left:Nn \g_@@_row_sep_seq {#1}
3261 \seq_gput_right:Nn \g_@@_row_sep_seq {#1}
3262 \bool_if:NF \g_@@_col_header_bool
3263 {
3264 \seq_gset_item:Nnn \g_@@_row_sep_seq {1} { 0pt }
3265 \seq_gset_item:Nnn \g_@@_row_sep_seq {2} { #1 }
3266 }
3267 }
3268 \cs_new:Nn \@@_set_col_sep:nn
3269 {
3270 \seq_gclear:N \g_@@_col_sep_seq
3271 \prg_replicate:nn {\g_@@_col_count_int}
3272 { \seq_gput_right:Nn \g_@@_col_sep_seq {#2} }
3273 \seq_gput_left:Nn \g_@@_col_sep_seq {#1}
3274 \seq_gput_right:Nn \g_@@_col_sep_seq {#1}
3275 \bool_if:NF \g_@@_row_header_bool
3276 {
3277 \seq_gset_item:Nnn \g_@@_col_sep_seq {1} { 0pt }
3278 \seq_gset_item:Nnn \g_@@_col_sep_seq {2} { #1 }
3279 }
3280 }
3281 \cs_generate_variant:Nn \@@_set_row_sep:nn { ne, en, ee }
3282 \cs_generate_variant:Nn \@@_set_col_sep:nn { ne, en, ee }
3283 % \end{macrocode}
3284 % \end{macro}
3285 %
3286 %
3287 % \subsubsection{宽度计算}
3288 %
3289 %
3290 % \begin{macro}{\@@_measure_cell_wd:n}
3291 % 测量单元格内容(|#1|)的自然宽度,结果保存在 \cs{l_@@_wd_dim} 中。
3292 % 顺便会更新首行的高度补偿\footnote{高度与 \cs{c_@@_std_ht_dim} 的差距值(为正),如果高度更大,则为零。}
3293 % 与未行的深度补偿\footnote{深度与 \cs{c_@@_std_dp_dim} 的差距值(为正),如果深度度更大,则为零。},
3294 % 结果保存在 \cs{l_@@_ufill_dim} \cs{l_@@_dfill_dim} 中。
3295 % \begin{macrocode}
3296 \cs_new:Nn \@@_measure_cell_wd:n
3297 {
3298 \dim_zero:N \l_@@_ufill_dim
3299 \dim_zero:N \l_@@_dfill_dim
3300 \dim_set_eq:NN \l_@@_wd_dim \g_@@_cell_wd_min_dim
3301 \tl_if_empty:nF {#1}
3302 {
3303 \bool_set_true:N \l_@@_tmpa_bool % top line mark
3304 \seq_set_split:Nnn \l_@@_tmpa_seq {\\} {#1}
3305 \seq_map_inline:Nn \l_@@_tmpa_seq % each line
3306 {
3307 \hbox_set:Nn \l_@@_tmpa_box {##1}
3308 \@@_dim_set_max:Nn \l_@@_wd_dim
3309 { \box_wd:N \l_@@_tmpa_box }
3310 \bool_if:NT \l_@@_tmpa_bool
3311 {
3312 \@@_dim_set_max:Nn \l_@@_ufill_dim
3313 { \c_@@_std_ht_dim - \box_ht:N \l_@@_tmpa_box }
3314 \bool_set_false:N \l_@@_tmpa_bool
3315 }
3316 \dim_zero:N \l_@@_dfill_dim % clear above line
3317 \@@_dim_set_max:Nn \l_@@_dfill_dim
3318 { \c_@@_std_dp_dim - \box_dp:N \l_@@_tmpa_box }
3319 }
3320 }
3321 }
3322 \cs_generate_variant:Nn \@@_measure_cell_wd:n { V, e }
3323 % \end{macrocode}
3324 % \end{macro}
3325 %
3326 % \begin{macro}{\@@_measure_cell_box_wd:n}
3327 % 测量单元格盒子(|#1|)的宽度,结果保存在 \cs{l_@@_wd_dim} 中。
3328 % 同样会会更新首行的高度补偿与未行的深度补偿,
3329 % 结果保存在 \cs{l_@@_ufill_dim} \cs{l_@@_dfill_dim} 中。
3330 % \begin{macrocode}
3331 \cs_new:Nn \@@_measure_cell_box_wd:n
3332 {
3333 \dim_zero:N \l_@@_ufill_dim
3334 \dim_zero:N \l_@@_dfill_dim
3335 \dim_set_eq:NN \l_@@_wd_dim \g_@@_cell_wd_min_dim
3336 \tl_if_empty:nF {#1}
3337 {
3338 \hbox_set:Nn \l_@@_tmpa_box {#1}
3339 \@@_dim_set_max:Nn \l_@@_wd_dim
3340 { \box_wd:N \l_@@_tmpa_box }
3341 \@@_dim_set_max:Nn \l_@@_ufill_dim
3342 { \c_@@_std_ht_dim - \box_ht:N \l_@@_tmpa_box }
3343 \@@_dim_set_max:Nn \l_@@_dfill_dim
3344 { \c_@@_std_dp_dim - \box_dp:N \l_@@_tmpa_box }
3345 }
3346 }
3347 \cs_generate_variant:Nn \@@_measure_cell_box_wd:n { V, e }
3348 % \end{macrocode}
3349 % \end{macro}
3350 %
3351 %
3352 % \begin{macro}{\@@_measure_col_wd:n}
3353 % 测量表格的列(|#1|)的宽度,结果保存在 \cs{l_@@_wd_dim} 中;
3354 % 同时会记录填充值(使用变量 \cs{l_@@_ufill_dim} 和 \cs{l_@@_dfill_dim} 中转)。
3355 % 本函数会使用 \cs{l_@@_data_tl} 变量。
3356 % \footnote{本函数需要确认 \cs{l_@@_tmpa_dim} 不会被调用的函数修改。}
3357 % \begin{macrocode}
3358 \cs_new:Nn \@@_measure_col_wd:n
3359 {
3360 \dim_zero:N \l_@@_tmpa_dim % max width
3361 \bool_if:NTF \g_@@_col_header_bool
3362 { \int_set:Nn \l_@@_tmpa_int {0} }
3363 { \int_set:Nn \l_@@_tmpa_int {1} }
3364 \int_step_inline:nnn {\l_@@_tmpa_int} {\g_@@_row_count_int}
3365 {
3366 \@@_merge_if:nF {##1, #1}
3367 {
3368 \@@_parse_cell:n {##1, #1}
3369 \bool_if:NTF \l_@@_is_box_bool
3370 { \@@_measure_cell_box_wd:V \l_@@_data_tl }
3371 { \@@_measure_cell_wd:V \l_@@_data_tl }
3372 \@@_dim_set_max:NN \l_@@_tmpa_dim \l_@@_wd_dim
3373 \prop_gput:Nne \g_@@_cell_ufill_prop
3374 {##1,#1} {\dim_use:N \l_@@_ufill_dim}
3375 \prop_gput:Nne \g_@@_cell_dfill_prop
3376 {##1,#1} {\dim_use:N \l_@@_dfill_dim}
3377 }
3378 }
3379 \dim_set_eq:NN \l_@@_wd_dim \l_@@_tmpa_dim
3380 }
3381 % \end{macrocode}
3382 % \end{macro}
3383 %
3384 %
3385 % \begin{macro}{\@@_calc_col_wd:}
3386 % 计算表格各列的宽度,如果有需要调整的列宽,必须刷新出列边距,否则计算会失真。
3387 % 本命令会大量修改通用变量的值,调用时需要注意。
3388 % \done\todo[Debug] { 修复宽度样式为填充时长宽计算异常的 Bug }
3389 % \begin{macrocode}
3390 \cs_new:Nn \@@_calc_col_wd:
3391 {
3392 % \end{macrocode}
3393 % 初始化。
3394 % \begin{macrocode}
3395 \dim_zero:N \l_@@_cachea_dim % 相同宽度的列的最大列宽
3396 \dim_zero:N \l_@@_cacheb_dim % 相同宽度且填充的列的最大列宽
3397 \seq_clear:N \l_@@_cachea_seq % 相同宽度的列的索引序列
3398 \seq_clear:N \l_@@_cacheb_seq % 相同宽度且填充的列列的索引序列
3399 \seq_gclear:N \g_@@_col_wd_seq % 列宽序列
3400 \prop_gclear:N \g_@@_cell_ufill_prop
3401 \prop_gclear:N \g_@@_cell_dfill_prop
3402 % \end{macrocode}
3403 % 自然宽度循环,并统计相同宽度的列的索引及最大宽度。
3404 % \begin{macrocode}
3405 \@@_disable_sys_func:
3406 \bool_if:NTF \g_@@_row_header_bool
3407 { \int_step_inline:nnn { 0 } { \g_@@_col_count_int } }
3408 {
3409 \seq_gput_right:Nn \g_@@_col_wd_seq { 0pt }
3410 \int_step_inline:nnn { 1 } { \g_@@_col_count_int }
3411 }
3412 { % \int_step_inline:nnn 的参数三
3413 \@@_measure_col_wd:n {##1}
3414 \@@_parse_col_wd_style:n {##1}
3415 \clist_if_in:nVTF {a,s,f,sf} \l_@@_style_tl
3416 {
3417 \seq_gput_right:Ne \g_@@_col_wd_seq
3418 { \dim_use:N \l_@@_wd_dim }
3419 \tl_if_eq:VnT \l_@@_style_tl {s}
3420 {
3421 \seq_put_right:Nn \l_@@_cachea_seq {##1}
3422 \@@_dim_set_max:NN \l_@@_cachea_dim \l_@@_wd_dim
3423 }
3424 \tl_if_eq:VnT \l_@@_style_tl {sf}
3425 {
3426 \seq_put_right:Nn \l_@@_cacheb_seq {##1}
3427 \@@_dim_set_max:NN \l_@@_cacheb_dim \l_@@_wd_dim
3428 }
3429 }
3430 { \seq_gput_right:NV \g_@@_col_wd_seq \l_@@_style_tl }
3431 }
3432 \@@_restore_sys_func:
3433 % \end{macrocode}
3434 % 相同宽度循环:根据索引直接使用最大宽度替换。
3435 % \begin{macrocode}
3436 \seq_map_inline:Nn \l_@@_cachea_seq
3437 {
3438 \seq_gset_item:Nne \g_@@_col_wd_seq
3439 {##1+1} { \dim_use:N \l_@@_cachea_dim }
3440 }
3441 \seq_map_inline:Nn \l_@@_cacheb_seq
3442 {
3443 \seq_gset_item:Nne \g_@@_col_wd_seq
3444 {##1+1} { \dim_use:N \l_@@_cacheb_dim }
3445 }
3446 % \end{macrocode}
3447 % 填充循环。可填充长度 |=| 总宽 |-| 单元格间距 |-| 单元格所需宽度。
3448 % \begin{macrocode}
3449 \int_zero:N \l_@@_cachea_int % 填充列的个数
3450 \seq_clear:N \l_@@_cachea_seq % 填充列的索引序列
3451 \dim_set:Nn \l_@@_wd_dim
3452 { \seq_item:Nn \g_@@_col_wd_style_seq {-1} }
3453 \seq_map_inline:Nn \g_@@_col_sep_seq
3454 { \dim_sub:Nn \l_@@_wd_dim {##1} }
3455 \int_step_inline:nnn { 0 } { \g_@@_col_count_int }
3456 {
3457 \dim_sub:Nn \l_@@_wd_dim
3458 { \seq_item:Nn \g_@@_col_wd_seq {##1+1} }
3459 \@@_parse_col_wd_style:n {##1}
3460 \tl_if_in:NnT \l_@@_style_tl {f}
3461 {
3462 \int_incr:N \l_@@_cachea_int
3463 \seq_put_right:Nn \l_@@_cachea_seq {##1}
3464 }
3465 }
3466 \int_if_zero:nF { \l_@@_cachea_int }
3467 {
3468 \dim_set:Nn \l_@@_cachea_dim
3469 { \l_@@_wd_dim / \l_@@_cachea_int }
3470 }
3471 \seq_map_inline:Nn \l_@@_cachea_seq
3472 {
3473 \dim_sub:Nn \l_@@_wd_dim
3474 { \seq_item:Nn \g_@@_col_wd_seq {##1+1} }
3475 \dim_add:Nn \l_@@_wd_dim { \l_@@_cachea_dim }
3476 \seq_gset_item:Nne \g_@@_col_wd_seq
3477 {##1+1} { \dim_use:N \l_@@_wd_dim }
3478 }
3479 }
3480 % \end{macrocode}
3481 % \end{macro}
3482 %
3483 %
3484 % \subsubsection{高度计算}
3485 %
3486 %
3487 %
3488 % \begin{macro}{\@@_measure_cell_ht:nnn}
3489 % 测量单元格内容在限制宽度内的高度尺寸。|#1|: 垂直对齐方式,|#2|: 宽度,|#3| 内容;
3490 % 变量 \cs{l_@@_ufill_dim} 和 \cs{l_@@_dfill_dim} 用于传递需要垂直填充的值。
3491 % 结果保存在 \cs{l_@@_ht_dim} 和 \cs{l_@@_dp_dim} 中。
3492 % \begin{macrocode}
3493 \cs_new:Nn \@@_measure_cell_ht:nnn
3494 {
3495 \dim_set_eq:NN \l_@@_ht_dim \c_@@_std_ht_dim
3496 \dim_set_eq:NN \l_@@_dp_dim \c_@@_std_dp_dim
3497 \tl_if_empty:nF {#3}
3498 {
3499 \str_if_eq:nnTF {#1} {t}
3500 { \vbox_set_top:Nn } { \vbox_set:Nn }
3501 \l_@@_tmpa_box
3502 {
3503 \baselineskip=\g_@@_cell_lineskip_dim
3504 \hsize=#2 \parindent=0pt \noindent #3
3505 }
3506 \@@_dim_set_max:Nn \l_@@_ht_dim
3507 { \box_ht:N \l_@@_tmpa_box + \l_@@_ufill_dim }
3508 \@@_dim_set_max:Nn \l_@@_dp_dim
3509 { \box_dp:N \l_@@_tmpa_box + \l_@@_dfill_dim }
3510 }
3511 }
3512 \cs_generate_variant:Nn \@@_measure_cell_ht:nnn { VeV }
3513 % \end{macrocode}
3514 % \end{macro}
3515 %
3516 %
3517 % \begin{macro}{\@@_measure_row_ht:n}
3518 % 测量表格的行(|#1|)的高度,结果保存在 \cs{l_@@_ht_dim} 与 \cs{l_@@_dp_dim} 中,
3519 % 同时会缓存高度数据备用。
3520 % 本函数会修改变量 \cs{l_@@_ufill_dim}、 \cs{l_@@_dfill_dim} 和 \cs{l_@@_row_align_tl} 的值。
3521 % \footnote{本函数需要确认 \cs{l_@@_tmpa_dim} 与 \cs{l_@@_tmpb_dim} 不会被调用的函数修改。}
3522 % \begin{macrocode}
3523 \cs_new:Nn \@@_measure_row_ht:n
3524 {
3525 \dim_zero:N \l_@@_tmpa_dim
3526 \dim_zero:N \l_@@_tmpb_dim
3527 \@@_parse_row_align:n {#1}
3528 \bool_if:NTF \g_@@_row_header_bool
3529 { \int_set:Nn \l_@@_tmpa_int {0} }
3530 { \int_set:Nn \l_@@_tmpa_int {1} }
3531 \int_step_inline:nnn { \l_@@_tmpa_int } { \g_@@_col_count_int }
3532 {
3533 \@@_merge_if:nF {#1, ##1}
3534 {
3535 \@@_parse_cell:n {#1, ##1}
3536 \@@_parse_cell_fill:n {#1, ##1}
3537 \@@_measure_cell_ht:VeV \l_@@_row_align_tl
3538 { \seq_item:Nn \g_@@_col_wd_seq { ##1 + 1 } }
3539 \l_@@_data_tl
3540 \prop_gput:Nne \g_@@_cell_ht_prop {#1,##1}
3541 { \dim_use:N \l_@@_ht_dim }
3542 \@@_dim_set_max:NN \l_@@_tmpa_dim \l_@@_ht_dim
3543 \@@_dim_set_max:NN \l_@@_tmpb_dim \l_@@_dp_dim
3544 }
3545 }
3546 \dim_set_eq:NN \l_@@_ht_dim \l_@@_tmpa_dim
3547 \dim_set_eq:NN \l_@@_dp_dim \l_@@_tmpb_dim
3548 }
3549 % \end{macrocode}
3550 % \end{macro}
3551 %
3552 %
3553
3554
3555 % \begin{macro}{\@@_calc_row_ht:}
3556 % 计算表格各行的高度。本命令会大量修改通用变量的值,调用时需要注意。
3557 % \done\todo[Debug]{ 修复多行顶对齐时,相同行高居中对齐失效的 Bug }
3558 % \begin{macrocode}
3559 \cs_new:Nn \@@_calc_row_ht:
3560 {
3561 \dim_zero:N \l_@@_cachea_dim
3562 \dim_zero:N \l_@@_cacheb_dim
3563 \seq_clear:N \l_@@_cachea_seq
3564 \seq_gclear:N \g_@@_row_ht_seq
3565 \seq_gclear:N \g_@@_row_dp_seq
3566 \prop_gclear:N \g_@@_cell_ht_prop
3567 % \end{macrocode}
3568 % 自然高度循环,并统计相同高度的列的索引及最大高度。
3569 % \begin{macrocode}
3570 \@@_disable_sys_func:
3571 \bool_if:NTF \g_@@_col_header_bool
3572 { \int_step_inline:nnn { 0 } { \g_@@_row_count_int } }
3573 {
3574 \seq_gput_right:Nn \g_@@_row_ht_seq { 0pt }
3575 \seq_gput_right:Nn \g_@@_row_dp_seq { 0pt }
3576 \int_step_inline:nnn { 1 } { \g_@@_row_count_int }
3577 }
3578 { % \int_step_inline:nnn 的参数三
3579 \@@_measure_row_ht:n {##1}
3580 \@@_parse_row_ht_style:n {##1}
3581 \clist_if_in:nVTF {a,s} \l_@@_style_tl
3582 {
3583 \seq_gput_right:Ne \g_@@_row_ht_seq
3584 { \dim_use:N \l_@@_ht_dim }
3585 \seq_gput_right:Ne \g_@@_row_dp_seq
3586 { \dim_use:N \l_@@_dp_dim }
3587 \tl_if_eq:VnT \l_@@_style_tl {s}
3588 {
3589 \seq_put_right:Nn \l_@@_cachea_seq {##1}
3590 \@@_dim_set_max:NN \l_@@_cachea_dim \l_@@_ht_dim
3591 \@@_dim_set_max:NN \l_@@_cacheb_dim \l_@@_dp_dim
3592 }
3593 }
3594 {
3595 \seq_gput_right:Ne \g_@@_row_ht_seq
3596 { \dim_eval:n { \l_@@_style_tl - \l_@@_dp_dim } }
3597 \seq_gput_right:Ne \g_@@_row_dp_seq
3598 { \dim_use:N \l_@@_dp_dim }
3599 }
3600 }
3601 \@@_restore_sys_func:
3602 % \end{macrocode}
3603 % 相同高度循环:根据索引直接使用最大高度替换。
3604 % \begin{macrocode}
3605 \seq_map_inline:Nn \l_@@_cachea_seq
3606 {
3607 \@@_parse_row_align:n {##1}
3608 \str_if_eq:VnTF \l_@@_row_align_tl {t}
3609 {
3610 \dim_set:Nn \l_@@_ht_dim
3611 { \seq_item:Nn \g_@@_row_ht_seq {##1+1} }
3612 \dim_set:Nn \l_@@_dp_dim
3613 { \l_@@_cachea_dim + \l_@@_cacheb_dim - \l_@@_ht_dim }
3614 \seq_gset_item:Nne \g_@@_row_dp_seq
3615 {##1+1} { \dim_use:N \l_@@_dp_dim }
3616 }
3617 {
3618 \dim_set:Nn \l_@@_dp_dim
3619 { \seq_item:Nn \g_@@_row_dp_seq {##1+1} }
3620 \dim_set:Nn \l_@@_ht_dim
3621 { \l_@@_cachea_dim + \l_@@_cacheb_dim - \l_@@_dp_dim }
3622 \seq_gset_item:Nne \g_@@_row_ht_seq
3623 {##1+1} { \dim_use:N \l_@@_ht_dim }
3624 }
3625 }
3626 }
3627 % \end{macrocode}
3628 % \end{macro}
3629 %
3630 %
3631 % \subsubsection{查询尺寸}
3632 %
3633 % \begin{macro}{\@@_parse_cell_size:n}
3634 % 查询单元格的排版尺寸。|#1| 为数字坐标。
3635 % 结果保存在 \cs{l_@@_wd_dim}、\cs{l_@@_ht_dim} 及 \cs{l_@@_dp_dim} 中。
3636 % \begin{macrocode}
3637 \cs_new:Nn \@@_parse_cell_size:n
3638 {
3639 \int_set:Nn \l_@@_tmpa_int { \clist_item:nn {#1} {1} + 1 }
3640 \int_set:Nn \l_@@_tmpb_int { \clist_item:nn {#1} {2} + 1 }
3641 \dim_set:Nn \l_@@_wd_dim
3642 { \seq_item:Nn \g_@@_col_wd_seq { \l_@@_tmpb_int } }
3643 \dim_set:Nn \l_@@_ht_dim
3644 { \seq_item:Nn \g_@@_row_ht_seq { \l_@@_tmpa_int } }
3645 \dim_set:Nn \l_@@_dp_dim
3646 { \seq_item:Nn \g_@@_row_dp_seq { \l_@@_tmpa_int } }
3647 }
3648 % \end{macrocode}
3649 % \end{macro}
3650 %
3651 % \begin{macro}{\@@_parse_cell_fill:n}
3652 % 查询单元格的首行高度与深度填充值。|#1| 为数字坐标。
3653 % 结果保存在 \cs{l_@@_ufill_dim} 与 \cs{l_@@_dfill_dim} 中。
3654 % \begin{macrocode}
3655 \cs_new:Nn \@@_parse_cell_fill:n
3656 {
3657 \prop_get:NnNF \g_@@_cell_ufill_prop {#1} \l_@@_tmpa_tl
3658 { \tl_set:Nn \l_@@_tmpa_tl {0pt} }
3659 \prop_get:NnNF \g_@@_cell_dfill_prop {#1} \l_@@_tmpb_tl
3660 { \tl_set:Nn \l_@@_tmpb_tl {0pt} }
3661 \dim_set:Nn \l_@@_ufill_dim {\l_@@_tmpa_tl}
3662 \dim_set:Nn \l_@@_dfill_dim {\l_@@_tmpb_tl}
3663 }
3664 % \end{macrocode}
3665 % \end{macro}
3666 %
3667 %
3668 % \begin{macro}{\@@_parse_cell_ht:n}
3669 % 查询单元格的实际高度。|#1| 为数字坐标。
3670 % 结果保存在 \cs{l_@@_ht_dim} 中。
3671 % \begin{macrocode}
3672 \cs_new:Nn \@@_parse_cell_ht:n
3673 {
3674 \prop_get:NnN \g_@@_cell_ht_prop {#1} \l_@@_tmpa_tl
3675 \dim_set:Nn \l_@@_ht_dim {\l_@@_tmpa_tl}
3676 }
3677 % \end{macrocode}
3678 % \end{macro}
3679 %
3680 %
3681 % \subsection{合并单元格}
3682 %
3683 % \subsubsection{尺寸计算}
3684 %
3685 % \begin{macro}{\@@_measure_merge_size:}
3686 % 查询单元格的实际高度。
3687 % 使用单元格格内容及高宽深及填充值等变量 。
3688 % \begin{macrocode}
3689 \cs_new:Nn \@@_measure_merge_size:
3690 {
3691 \seq_gclear:N \g_@@_merge_wd_seq
3692 \seq_gclear:N \g_@@_merge_ht_seq
3693 \seq_gclear:N \g_@@_merge_dp_seq
3694 \seq_gclear:N \g_@@_merge_dfill_seq
3695 \seq_gclear:N \g_@@_merge_ufill_seq
3696 \int_step_inline:nn
3697 { \@@_parse_merge_count: }
3698 {
3699 \@@_parse_merge:n {##1}
3700 % 计算宽度
3701 \bool_if:NTF \l_@@_is_box_bool
3702 { \@@_measure_cell_box_wd:V \l_@@_data_tl }
3703 { \@@_measure_cell_wd:V \l_@@_data_tl }
3704 \seq_gput_right:Ne \g_@@_merge_wd_seq
3705 { \dim_use:N \l_@@_wd_dim }
3706 \seq_gput_right:Ne \g_@@_merge_dfill_seq
3707 { \dim_use:N \l_@@_dfill_dim }
3708 \seq_gput_right:Ne \g_@@_merge_ufill_seq
3709 { \dim_use:N \l_@@_ufill_dim }
3710 % 计算高度
3711 \@@_parse_merge_align:n {##1}
3712 \@@_measure_cell_ht:VeV \l_@@_row_align_tl
3713 { \dim_use:N \l_@@_wd_dim }
3714 \l_@@_data_tl
3715 \seq_gput_right:Ne \g_@@_merge_ht_seq
3716 { \dim_use:N \l_@@_ht_dim }
3717 \seq_gput_right:Ne \g_@@_merge_dp_seq
3718 { \dim_use:N \l_@@_dp_dim }
3719 }
3720 }
3721 % \end{macrocode}
3722 % \end{macro}
3723 %
3724 %
3725 % \begin{macro}{\@@_calc_merge_size:}
3726 % 计算单元格的排版尺寸。
3727 % 使用单元格格内容及高宽深及填充值等变量 。
3728 % \begin{macrocode}
3729 \cs_new:Nn \@@_calc_merge_size:
3730 {
3731 \seq_gclear:N \g_@@_merge_range_wd_seq
3732 \seq_gclear:N \g_@@_merge_range_ht_seq
3733 \seq_gclear:N \g_@@_merge_range_dp_seq
3734 \@@_disable_sys_func:
3735 \@@_measure_merge_size:
3736 \@@_restore_sys_func:
3737 \int_step_inline:nn
3738 { \@@_parse_merge_count: }
3739 {
3740 \@@_parse_merge:n {##1}
3741 \@@_parse_merge_align:n {##1}
3742 % \end{macrocode}
3743 % 计算宽度。
3744 % \begin{macrocode}
3745 \int_zero:N \l_@@_tmpa_int
3746 \int_step_inline:nnn
3747 { \seq_item:Nn \l_@@_merge_seq {2} }
3748 { \seq_item:Nn \l_@@_merge_seq {4} }
3749 {
3750 \dim_add:Nn \l_@@_wd_dim
3751 { \seq_item:Nn \g_@@_col_sep_seq { ####1 + 1 } }
3752 \int_if_zero:nT { \l_@@_tmpa_int }
3753 { % 置后清零,以排除第一列左边的间隙
3754 \dim_zero:N \l_@@_wd_dim
3755 \int_incr:N \l_@@_tmpa_int
3756 }
3757 \dim_add:Nn \l_@@_wd_dim
3758 { \seq_item:Nn \g_@@_col_wd_seq { ####1 + 1 } }
3759 }
3760 \seq_gput_right:Ne \g_@@_merge_range_wd_seq
3761 { \dim_use:N \l_@@_wd_dim }
3762 % \end{macrocode}
3763 % 计算高度与深度。
3764 % \begin{macrocode}
3765 \int_zero:N \l_@@_tmpa_int
3766 \int_step_inline:nnn
3767 { \seq_item:Nn \l_@@_merge_seq {1} }
3768 { \seq_item:Nn \l_@@_merge_seq {3} }
3769 {
3770 \dim_add:Nn \l_@@_tmpa_dim
3771 { \seq_item:Nn \g_@@_row_sep_seq { ####1 + 1 } }
3772 \int_if_zero:nT { \l_@@_tmpa_int }
3773 { % 置后清零,以排除第一行上边的间隙
3774 \dim_zero:N \l_@@_tmpa_dim
3775 \int_incr:N \l_@@_tmpa_int
3776 \dim_set:Nn \l_@@_ht_dim % 首行
3777 { \seq_item:Nn \g_@@_row_ht_seq { ####1 + 1 } }
3778 }
3779 \dim_set:Nn \l_@@_dp_dim % 未列
3780 { \seq_item:Nn \g_@@_row_dp_seq { ####1 + 1 } }
3781 \dim_add:Nn \l_@@_tmpa_dim
3782 { \seq_item:Nn \g_@@_row_ht_seq { ####1 + 1 } }
3783 \dim_add:Nn \l_@@_tmpa_dim
3784 { \seq_item:Nn \g_@@_row_dp_seq { ####1 + 1 } }
3785 }
3786 \str_if_eq:VnTF \l_@@_row_align_tl {t}
3787 {
3788 \seq_gput_right:Ne \g_@@_merge_range_ht_seq
3789 { \dim_use:N \l_@@_ht_dim }
3790 \seq_gput_right:Ne \g_@@_merge_range_dp_seq
3791 { \dim_eval:n { \l_@@_tmpa_dim - \l_@@_ht_dim } }
3792 } {
3793 \seq_gput_right:Ne \g_@@_merge_range_dp_seq
3794 { \dim_use:N \l_@@_dp_dim }
3795 \seq_gput_right:Ne \g_@@_merge_range_ht_seq
3796 { \dim_eval:n { \l_@@_tmpa_dim - \l_@@_dp_dim } }
3797 }
3798 }
3799 }
3800 % \end{macrocode}
3801 % \end{macro}
3802 %
3803 %
3804 %
3805 % \subsubsection{尺寸查询}
3806 %
3807 %
3808 % \begin{macro}{\@@_parse_merge_size:n}
3809 % 查询合并单元格的排版尺寸,|#1| 为索引。
3810 % 结果保存在 \cs{l_@@_wd_dim}、 \cs{l_@@_ht_dim} 与 \cs{l_@@_dp_dim} 中。
3811 % \begin{macrocode}
3812 \cs_new:Nn \@@_parse_merge_size:n
3813 {
3814 \dim_set:Nn \l_@@_wd_dim
3815 { \seq_item:Nn \g_@@_merge_range_wd_seq {#1} }
3816 \dim_set:Nn \l_@@_ht_dim
3817 { \seq_item:Nn \g_@@_merge_range_ht_seq {#1} }
3818 \dim_set:Nn \l_@@_dp_dim
3819 { \seq_item:Nn \g_@@_merge_range_dp_seq {#1} }
3820 }
3821 % \end{macrocode}
3822 % \end{macro}
3823 %
3824 %
3825 % \begin{macro}{\@@_parse_merge_fill:n}
3826 % 查询单元格的首行高度与深度填充值,|#1| 为索引。
3827 % 结果保存在 \cs{l_@@_ufill_dim} 与 \cs{l_@@_dfill_dim} 中。
3828 % \begin{macrocode}
3829 \cs_new:Nn \@@_parse_merge_fill:n
3830 {
3831 \dim_set:Nn \l_@@_dfill_dim
3832 { \seq_item:Nn \g_@@_merge_dfill_seq {#1} }
3833 \dim_set:Nn \l_@@_ufill_dim
3834 { \seq_item:Nn \g_@@_merge_ufill_seq {#1} }
3835 }
3836 % \end{macrocode}
3837 % \end{macro}
3838 %
3839 %
3840 % \begin{macro}{\@@_parse_merge_ht:n}
3841 % 查询单元格的首行高度与深度填充值,|#1| 为索引。
3842 % 结果保存在 \cs{l_@@_ht_dim} 中。
3843 % \begin{macrocode}
3844 \cs_new:Nn \@@_parse_merge_ht:n
3845 {
3846 \dim_set:Nn \l_@@_ht_dim
3847 { \seq_item:Nn \g_@@_merge_ht_seq {#1} }
3848 }
3849 % \end{macrocode}
3850 % \end{macro}
3851 %
3852 %
3853 % \subsection{计算坐标}
3854 %
3855 % \begin{macro}{\@@_calc_coord:}
3856 % 计算表格的(边框线所处位置的)实际输出坐标,其受有无 |Header| 的影响。
3857 % 本命令使用 \cs{l_@@_wd_dim} 与 \cs{l_@@_ht_dim} 变量。
3858 % \begin{macrocode}
3859 \cs_new:Nn \@@_calc_coord:
3860 {
3861 \dim_zero:N \l_@@_wd_dim
3862 \seq_gclear:N \g_@@_col_loc_seq
3863 \seq_gput_right:NV \g_@@_col_loc_seq \l_@@_wd_dim
3864 \bool_if:NTF \g_@@_row_header_bool
3865 { \int_set:Nn \l_@@_tmpa_int {0} }
3866 {
3867 \int_set:Nn \l_@@_tmpa_int {1}
3868 \seq_gput_right:NV \g_@@_col_loc_seq \l_@@_wd_dim
3869 }
3870 \dim_add:Nn \l_@@_wd_dim
3871 { ( \seq_item:Nn \g_@@_col_sep_seq { \l_@@_tmpa_int + 1 } ) / 2 }
3872 \int_step_inline:nnn
3873 { \l_@@_tmpa_int } { \g_@@_col_count_int }
3874 {
3875 \dim_add:Nn \l_@@_wd_dim
3876 { ( \seq_item:Nn \g_@@_col_sep_seq { ##1 + 1 } ) / 2 }
3877 \dim_add:Nn \l_@@_wd_dim
3878 { \seq_item:Nn \g_@@_col_wd_seq { ##1 + 1 } }
3879 \dim_add:Nn \l_@@_wd_dim
3880 { ( \seq_item:Nn \g_@@_col_sep_seq { ##1 + 2 } ) / 2 }
3881 \seq_gput_right:NV \g_@@_col_loc_seq \l_@@_wd_dim
3882 }
3883 \dim_add:Nn \l_@@_wd_dim
3884 { ( \seq_item:Nn \g_@@_col_sep_seq {-1} ) / 2 }
3885 \seq_gset_item:NnV \g_@@_col_loc_seq {-1} \l_@@_wd_dim
3886 % \end{macrocode}
3887 % 为方便计算,$Y$ 坐标采用负坐标。
3888 % \begin{macrocode}
3889 \dim_zero:N \l_@@_ht_dim
3890 \seq_gclear:N \g_@@_row_loc_seq
3891 \seq_gput_right:NV \g_@@_row_loc_seq \l_@@_ht_dim
3892 \bool_if:NTF \g_@@_col_header_bool
3893 { \int_set:Nn \l_@@_tmpa_int {0} }
3894 {
3895 \int_set:Nn \l_@@_tmpa_int {1}
3896 \seq_gput_right:NV \g_@@_row_loc_seq \l_@@_ht_dim
3897 }
3898 \dim_sub:Nn \l_@@_ht_dim
3899 { ( \seq_item:Nn \g_@@_row_sep_seq { \l_@@_tmpa_int + 1 } ) / 2 }
3900 \int_step_inline:nnn
3901 { \l_@@_tmpa_int } { \g_@@_row_count_int }
3902 {
3903 \dim_sub:Nn \l_@@_ht_dim
3904 { ( \seq_item:Nn \g_@@_row_sep_seq { ##1+1 } ) / 2 }
3905 \dim_sub:Nn \l_@@_ht_dim
3906 { \seq_item:Nn \g_@@_row_ht_seq { ##1+1 } }
3907 \dim_sub:Nn \l_@@_ht_dim
3908 { \seq_item:Nn \g_@@_row_dp_seq { ##1+1 } }
3909 \dim_sub:Nn \l_@@_ht_dim
3910 { ( \seq_item:Nn \g_@@_row_sep_seq { ##1+2 } ) / 2 }
3911 \seq_gput_right:NV \g_@@_row_loc_seq \l_@@_ht_dim
3912 }
3913 \dim_sub:Nn \l_@@_ht_dim
3914 { (\seq_item:Nn \g_@@_row_sep_seq {-1})/2 }
3915 \seq_gset_item:NnV \g_@@_row_loc_seq {-1} \l_@@_ht_dim
3916 }
3917 % \end{macrocode}
3918 % \end{macro}
3919 %
3920 %
3921 % \section{渲染输出}
3922 %
3923 %
3924 % \subsection{通用内容}
3925 %
3926 % \subsubsection{局部变量}
3927 %
3928 %
3929 %
3930 % \begin{variable}{\l_@@_x_dim, \l_@@_y_dim}
3931 % 用于存储绘图坐标信息。
3932 % \begin{macrocode}
3933 \dim_new:N \l_@@_x_dim
3934 \dim_new:N \l_@@_y_dim
3935 % \end{macrocode}
3936 % \end{variable}
3937 %
3938 %
3939 % \begin{variable}{\l_@@_offset_x_dim, \l_@@_offset_y_dim}
3940 % 两个偏移值变量。
3941 % \begin{macrocode}
3942 \dim_new:N \l_@@_offset_x_dim
3943 \dim_new:N \l_@@_offset_y_dim
3944 % \end{macrocode}
3945 % \end{variable}
3946 %
3947 %
3948 % \begin{variable}{\l_@@_expand_start_dim, \l_@@_expand_end_dim}
3949 % 两个扩展值变量。
3950 % \begin{macrocode}
3951 \dim_new:N \l_@@_expand_start_dim
3952 \dim_new:N \l_@@_expand_end_dim
3953 % \end{macrocode}
3954 % \end{variable}
3955 %
3956 %
3957 %
3958 % \begin{variable}{\g_@@_row_rule_seq, \g_@@_col_rule_seq}
3959 % 用于存储行列边框线。需要考虑是否有 |Header|。
3960 % \begin{macrocode}
3961 \seq_new:N \g_@@_row_rule_seq
3962 \seq_new:N \g_@@_col_rule_seq
3963 % \end{macrocode}
3964 % \end{variable}
3965 %
3966 %
3967 %
3968 % \begin{variable}{\l_@@_style_seq}
3969 % 用于存储样式序列。
3970 % \begin{macrocode}
3971 \seq_new:N \l_@@_style_seq
3972 % \end{macrocode}
3973 % \end{variable}
3974 %
3975 %
3976 % \begin{variable}{\l_@@_cell_box}
3977 % 用于存储单元格内容的盒子。
3978 % \begin{macrocode}
3979 \box_new:N \l_@@_cell_box
3980 % \end{macrocode}
3981 % \end{variable}
3982 %
3983 %
3984 %
3985 %
3986 % \subsubsection{渲染函数}
3987 %
3988 % \begin{macro}{\@@_draw_hrule:n}
3989 % 绘制表格指定的水平线。使用 \cs{l_@@_expand_start_dim} 与
3990 % \cs{l_@@_expand_end_dim} 扩展边界。
3991 % \begin{macrocode}
3992 \cs_new:Nn \@@_draw_hrule:n
3993 {
3994 \draw_path_moveto:n
3995 {
3996 \seq_item:Nn \g_@@_col_loc_seq {1} - \l_@@_expand_start_dim,
3997 \seq_item:Nn \g_@@_row_loc_seq {#1}
3998 }
3999 \draw_path_lineto:n
4000 {
4001 \seq_item:Nn \g_@@_col_loc_seq {-1} + \l_@@_expand_end_dim,
4002 \seq_item:Nn \g_@@_row_loc_seq {#1}
4003 }
4004 }
4005 % \end{macrocode}
4006 % \end{macro}
4007 %
4008 %
4009 % \begin{macro}{\@@_draw_vrule:n}
4010 % 绘制表格指定的垂直线。使用 \cs{l_@@_expand_start_dim} 与
4011 % \cs{l_@@_expand_end_dim} 扩展边界。
4012 % \begin{macrocode}
4013 \cs_new:Nn \@@_draw_vrule:n
4014 {
4015 \draw_path_moveto:n
4016 {
4017 \seq_item:Nn \g_@@_col_loc_seq {#1},
4018 \seq_item:Nn \g_@@_row_loc_seq {1} + \l_@@_expand_start_dim
4019 }
4020 \draw_path_lineto:n
4021 {
4022 \seq_item:Nn \g_@@_col_loc_seq {#1},
4023 \seq_item:Nn \g_@@_row_loc_seq {-1} - \l_@@_expand_end_dim
4024 }
4025 }
4026 % \end{macrocode}
4027 % \end{macro}
4028 %
4029 %
4030 % \subsection{打印表格}
4031 %
4032 % \begin{macro}{\@@_print_data:nnn}
4033 % 使用垂直盒子打印输出指定数据。|#1|: 垂直对齐方式, |#2|: 水平对齐方式,|#3|: 内容。
4034 % 使用变量 \cs{l_@@_wd_dim}、\cs{l_@@_ht_dim} 和\cs{l_@@_dp_dim} 的值。
4035 % \begin{macrocode}
4036 \cs_new:Nn \@@_print_data:nnn
4037 {
4038 \str_if_in:nnTF {tmb} {#1}
4039 { \tl_set:Nn \l_@@_tmpb_tl {#1} }
4040 { \tl_set:Nn \l_@@_tmpb_tl {b} }
4041 \str_case:nnF {#2}
4042 {
4043 {l} { \tl_set:Nn \l_@@_tmpa_tl {\raggedright} }
4044 {c} { \tl_set:Nn \l_@@_tmpa_tl {\centering} }
4045 {r} { \tl_set:Nn \l_@@_tmpa_tl {\raggedleft} }
4046 }
4047 { \tl_set:Nn \l_@@_tmpa_tl {} }
4048 \tl_if_empty:nT {#3}
4049 { \tl_put_right:Nn \l_@@_tmpa_tl {\rule{1pt}{0pt}} }
4050 \str_case:Vn \l_@@_tmpb_tl
4051 {
4052 {t}
4053 {
4054 \vbox_set_top:Nn \l_@@_tmpa_box
4055 {
4056 \baselineskip=\g_@@_cell_lineskip_dim
4057 \hsize=\l_@@_wd_dim \parindent=0pt
4058 \l_@@_tmpa_tl #3 \vfill \par
4059 }
4060 }
4061 % \end{macrocode}
4062 % 如果是居中对齐,则额外使用 \cs{l_@@_cachea_dim} 与 \cs{l_@@_ufill_dim}
4063 % 传递单元格高度及填充量。
4064 % \begin{macrocode}
4065 {m}
4066 {
4067 \dim_set:Nn \l_@@_tmpa_dim
4068 { (\l_@@_ht_dim - \l_@@_cachea_dim)/2 + \l_@@_ufill_dim }
4069 \vbox_set_to_ht:Nnn \l_@@_tmpa_box {\l_@@_ht_dim}
4070 {
4071 \baselineskip=\g_@@_cell_lineskip_dim
4072 \hsize=\l_@@_wd_dim \parindent=0pt
4073 \vskip \l_@@_tmpa_dim
4074 \l_@@_tmpa_tl #3 \vfill \par
4075 }
4076 }
4077 {b}
4078 {
4079 \dim_set:Nn \l_@@_tmpa_dim
4080 { \l_@@_ht_dim - \l_@@_cachea_dim + \l_@@_ufill_dim }
4081 \vbox_set:Nn \l_@@_tmpa_box
4082 {
4083 \baselineskip=\g_@@_cell_lineskip_dim
4084 \hsize=\l_@@_wd_dim \parindent=0pt
4085 \vskip \l_@@_tmpa_dim
4086 \l_@@_tmpa_tl #3 \par
4087 }
4088 }
4089 }
4090 \dim_compare:nNnT {\box_dp:N \l_@@_tmpa_box} < {\l_@@_dp_dim}
4091 { \box_set_dp:Nn \l_@@_tmpa_box {\l_@@_dp_dim} }
4092 \box_use:N \l_@@_tmpa_box
4093 }
4094 \cs_generate_variant:Nn \@@_print_data:nnn {VVV}
4095 % \end{macrocode}
4096 % \end{macro}
4097 %
4098 %
4099 % \begin{macro}{\@@_print_merge_data:nn}
4100 % 打印合并单元格,修改变量 \cs{l_@@_merge_seq}。
4101 % \begin{macrocode}
4102 \cs_new:Nn \@@_print_merge_data:nn
4103 {
4104 \@@_parse_merge_id:n {#1, #2}
4105 \@@_parse_merge:V \l_@@_merge_id_tl
4106 \tl_set:Ne \l_@@_tmpa_tl
4107 { \seq_item:Nn \l_@@_merge_seq {2} }
4108 \str_if_eq:VnT \l_@@_tmpa_tl {#2}
4109 { % 只有合并单元格的第一列输出
4110 \@@_parse_merge_size:n { \l_@@_merge_id_tl }
4111 \@@_parse_merge_fill:n { \l_@@_merge_id_tl }
4112 \tl_set:Ne \l_@@_tmpa_tl
4113 { \seq_item:Nn \l_@@_merge_seq {1} }
4114 \str_if_eq:VnTF \l_@@_tmpa_tl {#1}
4115 { % 如果是首行,则完整输出
4116 \vbox_set_top:Nn \l_@@_tmpa_box
4117 {
4118 \baselineskip=\g_@@_cell_lineskip_dim
4119 \hsize=\l_@@_wd_dim \parindent=0pt
4120 \centering \l_@@_data_tl \vfill \par
4121 }
4122 \@@_parse_cell_size:n {#1, #2}
4123 \box_set_ht:Nn \l_@@_tmpa_box { \l_@@_ht_dim - \l_@@_dfill_dim }
4124 \box_set_dp:Nn \l_@@_tmpa_box { \l_@@_dp_dim }
4125 \box_use:N \l_@@_tmpa_box
4126 }
4127 { % 如果是非首行,则只输出占位符
4128 \exp_args:Ne \rule { \dim_use:N \l_@@_wd_dim } { 0pt }
4129 }
4130 \hspace{\g_@@_cell_sep_dim}
4131 }
4132 }
4133 % \end{macrocode}
4134 % \end{macro}
4135 %
4136 %
4137 % \begin{macro}{\printtable}
4138 % 打印表格。
4139 % \begin{macrocode}
4140 \NewDocumentCommand \printtable { s O{0em} }
4141 {
4142 \@@_set_row_sep:ne {0pt} { \dim_use:N \g_@@_cell_sep_dim }
4143 \@@_set_col_sep:ne {0pt} { \dim_use:N \g_@@_cell_sep_dim }
4144 \@@_calc_col_wd: \@@_calc_row_ht:
4145 \@@_calc_merge_size:
4146 \bool_if:NTF \g_@@_col_header_bool
4147 { \int_set:Nn \l_@@_cachea_int {0} }
4148 { \int_set:Nn \l_@@_cachea_int {1} }
4149 \bool_if:NTF \g_@@_row_header_bool
4150 { \int_set:Nn \l_@@_cacheb_int {0} }
4151 { \int_set:Nn \l_@@_cacheb_int {1} }
4152 \int_step_inline:nnn { \l_@@_cachea_int } { \g_@@_row_count_int }
4153 {
4154 \@@_support_sys_func:
4155 \hbox:n
4156 {
4157 \dim_zero:N \l_@@_tmpa_dim
4158 \hspace{#2}
4159 \int_step_inline:nnn { \l_@@_cacheb_int } {\g_@@_col_count_int}
4160 {
4161 \@@_merge_if:nTF {##1, ####1}
4162 { \@@_print_merge_data:nn {##1} {####1} }
4163 {
4164 \@@_parse_cell:n {##1, ####1}
4165 \@@_parse_cell_fill:n {##1, ####1}
4166 \@@_parse_cell_ht:n {##1, ####1}
4167 \dim_set_eq:NN \l_@@_cachea_dim \l_@@_ht_dim
4168 \@@_parse_cell_size:n {##1, ####1}
4169 \@@_parse_row_align:n {##1}
4170 \@@_parse_col_align:n {####1}
4171 \@@_print_data:VVV
4172 \l_@@_row_align_tl \l_@@_col_align_tl \l_@@_data_tl
4173 \hspace{\g_@@_cell_sep_dim}
4174 }
4175 }
4176 }
4177 \IfBooleanF {#1}
4178 { \int_compare:nNnT {##1} < {\g_@@_row_count_int} {\\} }
4179 \@@_restore_sys_func:
4180 }
4181 }
4182 % \end{macrocode}
4183 % \end{macro}
4184 %
4185 %
4186 % \subsection{渲染表格}
4187 %
4188 %
4189 % \subsubsection{渲染内容}
4190 %
4191 %
4192 % \begin{macro}{\@@_render_data:nnn}
4193 % 使用垂直盒子渲染指定数据。|#1|: 垂直对齐方式, |#2|: 水平对齐方式,|#3|: 内容。
4194 % 使用变量 \cs{l_@@_wd_dim},渲染好的盒子存储在 \cs{l_@@_cell_box} 中。
4195 % \begin{macrocode}
4196 \cs_new:Nn \@@_render_data:nnn
4197 {
4198 \str_case:nnF{#2}
4199 {
4200 {l} { \tl_set:Nn \l_@@_tmpa_tl { \raggedright } }
4201 {c} { \tl_set:Nn \l_@@_tmpa_tl { \centering } }
4202 {r} { \tl_set:Nn \l_@@_tmpa_tl { \raggedleft } }
4203 }
4204 { \tl_set:Nn \l_@@_tmpa_tl {} }
4205 \tl_if_empty:nTF {#3}
4206 { \tl_set:Nn \l_@@_tmpb_tl { \rule{1pt}{0pt} } }
4207 { \tl_set:Nn \l_@@_tmpb_tl {#3} }
4208 \str_if_eq:nnTF {#1} {t}
4209 { \vbox_set_top:Nn } { \vbox_set:Nn }
4210 \l_@@_cell_box
4211 {
4212 \baselineskip=3ex \hsize=\l_@@_wd_dim \parindent=0pt
4213 \l_@@_tmpa_tl \l_@@_tmpb_tl \par
4214 }
4215 }
4216 \cs_generate_variant:Nn \@@_render_data:nnn {VVV}
4217 % \end{macrocode}
4218 % \end{macro}
4219 %
4220 %
4221 % \begin{macro}{\@@_draw_cell:nn}
4222 % 绘制指定单元格,|#1#2| 为数字坐标;如果指定单元格已合并,则绘制空内容。
4223 % 使用 \cs{l_@@_x_dim} 与 \cs{l_@@_y_dim} 的坐标信息。
4224 % \begin{macrocode}
4225 \cs_new:Nn \@@_draw_cell:nn
4226 {
4227 \@@_parse_cell_fill:n {#1, #2}
4228 \@@_parse_cell_size:n {#1, #2}
4229 \@@_parse_row_align:n {#1}
4230 \@@_parse_col_align:n {#2}
4231 \@@_merge_if:nTF {#1, #2}
4232 {
4233 \bool_set_false:N \l_@@_is_box_bool
4234 \tl_set:Nn \l_@@_data_tl {}
4235 }
4236 { \@@_parse_cell:n {#1, #2} }
4237 \@@_render_data:VVV % 获取包含渲染内容的盒子
4238 \l_@@_row_align_tl \l_@@_col_align_tl \l_@@_data_tl
4239 \tl_if_eq:NnTF \l_@@_row_align_tl {m}
4240 {
4241 \dim_set:Nn \l_@@_tmpb_dim
4242 { \box_ht:N \l_@@_cell_box + \l_@@_ufill_dim }
4243 \dim_set:Nn \l_@@_tmpa_dim
4244 { \l_@@_y_dim - \l_@@_tmpb_dim }
4245 \dim_sub:Nn \l_@@_tmpa_dim
4246 { (\l_@@_ht_dim - \l_@@_tmpb_dim) / 2 }
4247 }
4248 {
4249 \dim_set:Nn \l_@@_tmpa_dim
4250 { \l_@@_y_dim - \l_@@_ht_dim }
4251 }
4252 \draw_box_use:Nn \l_@@_cell_box
4253 { \l_@@_x_dim, \l_@@_tmpa_dim }
4254 }
4255 % \end{macrocode}
4256 % \end{macro}
4257 %
4258 %
4259 % \begin{macro}{\@@_draw_merge:n}
4260 % 绘制指定单元格,|#1#2| 为数字坐标;如果指定单元格已合并,则绘制空内容。
4261 % 使用 \cs{l_@@_x_dim} 与 \cs{l_@@_y_dim} 的坐标信息。
4262 % \begin{macrocode}
4263 \cs_new:Nn \@@_draw_merge:n
4264 {
4265 \@@_parse_merge:n {#1}
4266 \int_set:Nn \l_@@_tmpa_int
4267 { \seq_item:Nn \l_@@_merge_seq {1} }
4268 \int_set:Nn \l_@@_tmpb_int
4269 { \seq_item:Nn \l_@@_merge_seq {2} }
4270 \dim_set:Nn \l_@@_y_dim
4271 { \seq_item:Nn \g_@@_row_loc_seq { \l_@@_tmpa_int + 1 } }
4272 \dim_set:Nn \l_@@_x_dim
4273 { \seq_item:Nn \g_@@_col_loc_seq { \l_@@_tmpb_int + 1 } }
4274 \dim_add:Nn \l_@@_x_dim
4275 { \seq_item:Nn \g_@@_col_sep_seq { \l_@@_tmpb_int + 1 } / 2 }
4276 \dim_sub:Nn \l_@@_y_dim { \c_@@_std_dp_dim / 3 }
4277 \dim_sub:Nn \l_@@_y_dim
4278 { \seq_item:Nn \g_@@_row_sep_seq { \l_@@_tmpa_int + 1 } / 2 }
4279 \@@_parse_merge_size:n {#1}
4280 \@@_parse_merge_fill:n {#1}
4281 \@@_parse_merge_ht:n {#1}
4282 \@@_parse_merge_align:n {#1}
4283 \@@_render_data:VVV % 获取包含渲染内容的盒子
4284 \l_@@_row_align_tl \l_@@_col_align_tl \l_@@_data_tl
4285 \tl_if_eq:NnTF \l_@@_row_align_tl {m}
4286 {
4287 \dim_set:Nn \l_@@_tmpb_dim
4288 { \box_ht:N \l_@@_cell_box + \l_@@_ufill_dim }
4289 \dim_set:Nn \l_@@_tmpa_dim
4290 { \l_@@_y_dim - \l_@@_tmpb_dim }
4291 \dim_sub:Nn \l_@@_tmpa_dim
4292 { (\l_@@_ht_dim - \l_@@_tmpb_dim) / 2 }
4293 }
4294 {
4295 \dim_set:Nn \l_@@_tmpa_dim
4296 { \l_@@_y_dim - \l_@@_ht_dim }
4297 }
4298 \draw_box_use:Nn \l_@@_cell_box
4299 { \l_@@_x_dim, \l_@@_tmpa_dim }
4300 }
4301 % \end{macrocode}
4302 % \end{macro}
4303 %
4304 %
4305 % \begin{macro}{\@@_draw_cells:}
4306 % 绘制所有单元格,使用 \cs{l_@@_x_dim} 与 \cs{l_@@_y_dim} 的存储内容的左上角坐标信息。
4307 % \begin{macrocode}
4308 \cs_new:Nn \@@_draw_cells:
4309 {
4310 \dim_set:Nn \l_@@_y_dim { -\c_@@_std_dp_dim / 3 } % 补偿
4311 \bool_if:NTF \g_@@_col_header_bool
4312 { \int_set:Nn \l_@@_tmpa_int {0} }
4313 { \int_set:Nn \l_@@_tmpa_int {1} }
4314 \int_step_inline:nnn {\l_@@_tmpa_int} {\g_@@_row_count_int}
4315 {
4316 \dim_sub:Nn \l_@@_y_dim
4317 { \seq_item:Nn \g_@@_row_sep_seq {##1+1} }
4318 \dim_zero:N \l_@@_x_dim
4319 \bool_if:NTF \g_@@_row_header_bool
4320 { \int_set:Nn \l_@@_tmpb_int {0} }
4321 { \int_set:Nn \l_@@_tmpb_int {1} }
4322 \int_step_inline:nnn { \l_@@_tmpb_int } { \g_@@_col_count_int }
4323 {
4324 \dim_add:Nn \l_@@_x_dim
4325 { \seq_item:Nn \g_@@_col_sep_seq {####1 + 1} }
4326 \@@_draw_cell:nn {##1} {####1}
4327 \dim_add:Nn \l_@@_x_dim { \l_@@_wd_dim }
4328 }
4329 \dim_sub:Nn \l_@@_y_dim
4330 { \l_@@_ht_dim + \l_@@_dp_dim }
4331 }
4332 \int_step_inline:nn { \@@_parse_merge_count: }
4333 { \@@_draw_merge:n {##1} }
4334 }
4335 % \end{macrocode}
4336 % \end{macro}
4337 %
4338 %
4339 % \subsubsection{渲染边框-三线表}
4340 %
4341 % \done\todo[功能]{ 处理无表头时的渲染情况 }
4342 % \todo[功能]{ 三线表标题自动合并 }
4343 % \begin{macro}{\@@_draw_booktabs:n}
4344 % 绘制三线表的边框线。
4345 % \begin{macrocode}
4346 \cs_new:Nn \@@_draw_booktabs:n
4347 {
4348 \dim_zero:N \l_@@_expand_start_dim
4349 \dim_zero:N \l_@@_expand_end_dim
4350 \@@_set_rule_style:n {toprule}
4351 \@@_draw_hrule:n {1}
4352 \draw_path_use_clear:n { stroke }
4353 \bool_if:NT \g_@@_col_header_bool
4354 {
4355 \@@_set_rule_style:n {midrule}
4356 \@@_draw_hrule:n {2}
4357 \draw_path_use_clear:n { stroke }
4358 }
4359 \@@_set_rule_style:n {bottomrule}
4360 \@@_draw_hrule:n {-1}
4361 \draw_path_use_clear:n { stroke }
4362 \@@_set_rule_style:n {cmidrule}
4363 \clist_map_inline:nn {#1}
4364 { \@@_draw_hrule:n {##1+2} }
4365 \draw_path_use_clear:n { stroke }
4366 }
4367 \cs_generate_variant:Nn \@@_draw_booktabs:n { V }
4368 % \end{macrocode}
4369 % \end{macro}
4370 %
4371 %
4372 % \subsubsection{渲染边框-网格线}
4373 %
4374 %
4375 % \begin{macro}{\@@_row_rule:nn}
4376 % 设置网格线风格的行网格线。|#1| 为默认值,|#2| 为线列表。
4377 % \begin{macrocode}
4378 \NewDocumentCommand {\@@_row_rule:nn} { O{} m }
4379 {
4380 \tl_set:Nn \l_@@_style_tl {#1}
4381 \tl_if_empty:nTF {#2}
4382 { \seq_clear:N \l_@@_style_seq }
4383 {
4384 \seq_set_split:Nnn \l_@@_style_seq {,} {#2}
4385 \seq_get_left:NN \l_@@_style_seq \l_@@_tmpa_tl
4386 \str_if_in:NnF \l_@@_tmpa_tl {=}
4387 { \seq_pop_left:NN \l_@@_style_seq \l_@@_style_tl }
4388 }
4389 \@@_set_line_style:NNnn \g_@@_row_rule_seq
4390 \l_@@_style_seq {#1} {row}
4391 \bool_if:NF \g_@@_col_header_bool
4392 { \seq_gpop_left:NN \g_@@_row_rule_seq \l_@@_tmpa_tl }
4393 \seq_gput_left:NV \g_@@_row_rule_seq \l_@@_style_tl
4394 }
4395 % \end{macrocode}
4396 % \end{macro}
4397 %
4398 %
4399 % \begin{macro}{\@@_col_rule:nn}
4400 % 设置网格线风格的列网格线。|#1| 为默认值,|#2| 为线列表。
4401 % \begin{macrocode}
4402 \NewDocumentCommand {\@@_col_rule:nn} { O{} m }
4403 {
4404 \tl_set:Nn \l_@@_style_tl {#1}
4405 \tl_if_empty:nTF {#2}
4406 { \seq_clear:N \l_@@_style_seq }
4407 {
4408 \seq_set_split:Nnn \l_@@_style_seq {,} {#2}
4409 \seq_get_left:NN \l_@@_style_seq \l_@@_tmpa_tl
4410 \str_if_in:NnF \l_@@_tmpa_tl {=}
4411 { \seq_pop_left:NN \l_@@_style_seq \l_@@_style_tl }
4412 }
4413 \@@_set_line_style:NNnn \g_@@_col_rule_seq
4414 \l_@@_style_seq {#1} {col}
4415 \seq_gput_left:NV \g_@@_col_rule_seq \l_@@_style_tl
4416 }
4417 % \end{macrocode}
4418 % \end{macro}
4419 %
4420 % \begin{macro}{\@@_calc_grid_expand:N}
4421 % 计算网格线的扩展长度\footnote{用于平衡线宽造成的转角过渡问题。}。
4422 % \begin{macrocode}
4423 \cs_new:Nn \@@_calc_grid_expand:N
4424 {
4425 \seq_if_empty:NTF #1
4426 { \seq_set_split:Nnn \l_@@_tmpa_seq {,} {0pt} }
4427 { \seq_set_eq:NN \l_@@_tmpa_seq #1 }
4428 \seq_get_left:NN \l_@@_tmpa_seq \l_@@_style_tl
4429 \tl_if_empty:NTF \l_@@_style_tl
4430 { \dim_zero:N \l_@@_expand_start_dim }
4431 {
4432 \@@_parse_rule_style:V \l_@@_style_tl
4433 \dim_set:Nn \l_@@_expand_start_dim
4434 { \l_@@_rule_dim/2 }
4435 }
4436 \seq_get_right:NN \l_@@_tmpa_seq \l_@@_style_tl
4437 \tl_if_empty:NTF \l_@@_style_tl
4438 { \dim_zero:N \l_@@_expand_end_dim }
4439 {
4440 \@@_parse_rule_style:V \l_@@_style_tl
4441 \dim_set:Nn \l_@@_expand_end_dim
4442 { \l_@@_rule_dim/2 }
4443 }
4444 }
4445 % \end{macrocode}
4446 % \end{macro}
4447 %
4448 %
4449 % \begin{macro}{\@@_draw_grid:n}
4450 % 绘制网格线型表格。
4451 % \begin{macrocode}
4452 \cs_new:Nn \@@_draw_grid:n
4453 {
4454 \group_begin:
4455 \cs_set_eq:NN \hrule \@@_row_rule:nn
4456 \cs_set_eq:NN \vrule \@@_col_rule:nn
4457 #1
4458 \group_end:
4459 \@@_calc_grid_expand:N \g_@@_row_rule_seq
4460 \int_step_inline:nn { \seq_count:N \g_@@_col_loc_seq }
4461 {
4462 \tl_set:Ne \l_@@_style_tl
4463 { \seq_item:Nn \g_@@_col_rule_seq {##1} }
4464 \tl_if_empty:NF \l_@@_style_tl
4465 {
4466 \@@_set_rule_style:V \l_@@_style_tl
4467 \@@_draw_vrule:n {##1}
4468 \draw_path_use_clear:n { stroke }
4469 }
4470 }
4471 \@@_calc_grid_expand:N \g_@@_col_rule_seq
4472 \int_step_inline:nn {\seq_count:N \g_@@_row_loc_seq}
4473 {
4474 \tl_set:Ne \l_@@_style_tl
4475 { \seq_item:Nn \g_@@_row_rule_seq {##1} }
4476 \tl_if_empty:NF \l_@@_style_tl
4477 {
4478 \@@_set_rule_style:V \l_@@_style_tl
4479 \@@_draw_hrule:n {##1}
4480 \draw_path_use_clear:n { stroke }
4481 }
4482 }
4483 }
4484 \cs_generate_variant:Nn \@@_draw_grid:n { V }
4485 % \end{macrocode}
4486 % \end{macro}
4487 %
4488 %
4489 % \subsubsection{渲染边框-全边框}
4490 %
4491 % \todo[优化]{ 提供内外边框的设置接口 }
4492 % \done \todo[优化]{ 适应合并单元格的框架 }
4493 % \begin{macro}{\@@_draw_cell_rule:nn}
4494 % 绘制指定单元格边框。
4495 % \begin{macrocode}
4496 \cs_new:Nn \@@_draw_cell_rule:nn
4497 {
4498 \dim_set:Nn \l_@@_x_dim
4499 { \seq_item:Nn \g_@@_col_loc_seq {#2+1} }
4500 \dim_set:Nn \l_@@_tmpa_dim
4501 { \seq_item:Nn \g_@@_col_loc_seq {#2+2} }
4502 \dim_set:Nn \l_@@_y_dim
4503 { \seq_item:Nn \g_@@_row_loc_seq {#1+2} }
4504 \dim_set:Nn \l_@@_tmpb_dim
4505 { \seq_item:Nn \g_@@_row_loc_seq {#1+1} }
4506 \dim_sub:Nn \l_@@_tmpa_dim { \l_@@_x_dim }
4507 \dim_sub:Nn \l_@@_tmpb_dim { \l_@@_y_dim }
4508 \draw_path_rectangle:nn
4509 { \l_@@_x_dim, \l_@@_y_dim }
4510 { \l_@@_tmpa_dim, \l_@@_tmpb_dim }
4511 \draw_path_use_clear:n { draw }
4512 }
4513 % \end{macrocode}
4514 % \end{macro}
4515 %
4516 %
4517 % \begin{macro}{\@@_draw_merge_rule:n}
4518 % 绘制指定单元格边框。
4519 % \begin{macrocode}
4520 \cs_new:Nn \@@_draw_merge_rule:n
4521 {
4522 \@@_parse_merge:n {#1}
4523 \dim_set:Nn \l_@@_x_dim
4524 {
4525 \seq_item:Nn \g_@@_col_loc_seq
4526 { \seq_item:Nn \l_@@_merge_seq {2} + 1 }
4527 }
4528 \dim_set:Nn \l_@@_tmpa_dim
4529 {
4530 \seq_item:Nn \g_@@_col_loc_seq
4531 { \seq_item:Nn \l_@@_merge_seq {4} + 2 }
4532 }
4533 \dim_set:Nn \l_@@_y_dim
4534 {
4535 \seq_item:Nn \g_@@_row_loc_seq
4536 { \seq_item:Nn \l_@@_merge_seq {3} + 2 }
4537 }
4538 \dim_set:Nn \l_@@_tmpb_dim
4539 {
4540 \seq_item:Nn \g_@@_row_loc_seq
4541 { \seq_item:Nn \l_@@_merge_seq {1} + 1 }
4542 }
4543 \dim_sub:Nn \l_@@_tmpa_dim { \l_@@_x_dim }
4544 \dim_sub:Nn \l_@@_tmpb_dim { \l_@@_y_dim }
4545 \draw_path_rectangle:nn
4546 { \l_@@_x_dim, \l_@@_y_dim }
4547 { \l_@@_tmpa_dim, \l_@@_tmpb_dim }
4548 \draw_path_use_clear:n { draw }
4549 }
4550 % \end{macrocode}
4551 % \end{macro}
4552 %
4553 %
4554 %
4555 % \begin{macro}{\@@_draw_cell_rule:}
4556 % 绘制单元格边框。
4557 % \begin{macrocode}
4558 \cs_new:Nn \@@_draw_cell_rules:
4559 {
4560 \int_step_inline:nnn
4561 { \bool_if:NTF \g_@@_col_header_bool {0} {1} }
4562 { \g_@@_row_count_int }
4563 {
4564 \int_step_inline:nnn
4565 { \bool_if:NTF \g_@@_row_header_bool {0} {1} }
4566 { \g_@@_col_count_int }
4567 {
4568 \@@_merge_if:nF {##1, ####1}
4569 { \@@_draw_cell_rule:nn {##1} {####1} }
4570 }
4571 }
4572 \int_step_inline:nn { \@@_parse_merge_count: }
4573 { \@@_draw_merge_rule:n {##1} }
4574 }
4575 % \end{macrocode}
4576 % \end{macro}
4577 %
4578 %
4579 % \subsubsection{渲染选项}
4580 %
4581 % \changes{v0.4}{2026-03-11}{将渲染函数的参数改为键值接口}
4582 %
4583 % \begin{variable}{\l_@@_render_multicol_bool, \l_@@_render_longtable_bool,
4584 % \l_@@_render_format_tl, \l_@@_render_rule_tl}
4585 % 输入选项变量。
4586 % \begin{macrocode}
4587 \bool_new:N \l_@@_render_multicol_bool
4588 \bool_new:N \l_@@_render_longtable_bool
4589 \tl_new:N \l_@@_render_format_tl
4590 \tl_new:N \l_@@_render_rule_tl
4591 % \end{macrocode}
4592 % \end{variable}
4593 %
4594 %
4595 % \begin{macro}{xtable/render}
4596 % 渲染选项。
4597 % \begin{macrocode}
4598 \keys_define:nn { xtable / render }
4599 {
4600 format .choices:nn = { border, grid, booktabs, custom }
4601 { \tl_set_eq:NN \l_@@_render_format_tl \l_keys_choice_tl },
4602 format .initial:n = {border},
4603 booktabs .code:n = { \tl_set:Nn \l_@@_render_format_tl { booktabs } },
4604 grid .code:n = { \tl_set:Nn \l_@@_render_format_tl { grid } },
4605 border .code:n = { \tl_set:Nn \l_@@_render_format_tl { border } },
4606 custom .code:n = { \tl_set:Nn \l_@@_render_format_tl { custom } },
4607 multicol .bool_set:N = \l_@@_render_multicol_bool,
4608 multicol .default:n = {true},
4609 multicol .initial:n = {false},
4610 longtable .bool_set:N = \l_@@_render_longtable_bool,
4611 longtable .default:n = {true},
4612 longtable .initial:n = {false},
4613 rule .tl_set:N = \l_@@_render_rule_tl,
4614 rule .initial:n = {}
4615 }
4616 % \end{macrocode}
4617 % \end{macro}
4618 %
4619 %
4620 %
4621 % \begin{macro}{xtable/render}
4622 % 清空渲染选项。
4623 % \begin{macrocode}
4624 \cs_new:Nn \@@_clear_render_options:
4625 {
4626 \tl_clear:N \l_@@_render_rule_tl
4627 \bool_set_false:N \l_@@_render_multicol_bool
4628 \bool_set_false:N \l_@@_render_longtable_bool
4629 }
4630 % \end{macrocode}
4631 % \end{macro}
4632 %
4633 %
4634 % \subsubsection{渲染表格}
4635 %
4636 % \todo[功能]{ 添加并排输出功能 }
4637 %
4638 % \begin{macro}{\@@_set_table_sep:n}
4639 % 设置表格边框序列。
4640 % \begin{macrocode}
4641 \cs_new:Nn \@@_set_table_sep:n
4642 {
4643 \@@_set_row_sep:ee
4644 { \dim_use:N \g_@@_row_margin_dim }
4645 { \dim_eval:n { \g_@@_row_margin_dim * 2 } }
4646 \@@_set_col_sep:ee
4647 {
4648 \bool_if:nTF {#1}
4649 { \dim_use:N \g_@@_col_margin_dim }
4650 { 0pt }
4651 }
4652 { \dim_eval:n { \g_@@_col_margin_dim * 2 } }
4653 }
4654 % \end{macrocode}
4655 % \end{macro}
4656 %
4657 %
4658 % \begin{macro}{\@@_rendertable_pre:, \@@_rendertable_post:}
4659 % 渲染表格的准备函数与善后的函数。
4660 % 其中,准备函数由 \cs{rendertable} 直接调用,而善后函数则由所有绘制表格的函数调用。
4661 % \begin{macrocode}
4662 \cs_new:Nn \@@_rendertable_pre:
4663 {
4664 \@@_set_table_sep:n {\c_true_bool}
4665 \@@_calc_col_wd:
4666 \@@_calc_row_ht:
4667 \@@_calc_merge_size:
4668 \@@_calc_coord:
4669 \draw_begin:
4670 \vbox_set_to_ht:Nnn \l_@@_tmpa_box
4671 {\g_@@_above_space_dim} {}
4672 \draw_box_use:N \l_@@_tmpa_box
4673 }
4674 \cs_new:Nn \@@_rendertable_post:
4675 {
4676 \@@_support_sys_func:
4677 \@@_draw_cells:
4678 \draw_end:
4679 \@@_restore_sys_func:
4680 \@@_clear_render_options:
4681 }
4682 % \end{macrocode}
4683 % \end{macro}
4684 %
4685 %
4686 % \begin{macro}{\rendertable}
4687 % 绘制表格。
4688 % \begin{macrocode}
4689 \NewDocumentCommand \rendertable { O{} }
4690 {
4691 \keys_set:nn { xtable/render } {#1}
4692 \@@_rendertable_pre:
4693 \str_case:NnF \l_@@_render_format_tl
4694 {
4695 {booktabs} { \@@_draw_booktabs:V \l_@@_render_rule_tl }
4696 {grid} { \@@_draw_grid:V \l_@@_render_rule_tl }
4697 }
4698 { \@@_draw_cell_rules: }
4699 \@@_rendertable_post:
4700 }
4701 % \end{macrocode}
4702 % \end{macro}
4703 %
4704 %
4705 % \begin{macrocode}
4706 %</package>
4707 % \end{macrocode}
4708 %
4709 %
4710 % \end{implementation}
4711 %
4712 % \todo[Debug]{ 查找 Package multicol: Error saving partial page. 的原因 }
4713 % \onecolumn
4714 %
4715 % \PrintChanges
4716 % \PrintIndex
4717 % \todos
4718 %
4719 \endinput