数组填充
<h1>数组填充</h1>
<h2>功能描述</h2>
<p>填充数组到指定长度,支持默认值和自定义填充逻辑。</p>
<h2>输入参数</h2>
<ul>
<li><strong>数组</strong>:<code>&quot;A|B|C&quot;</code>(分隔符分隔的字符串)
- 描述:需要填充的原始数组,以分隔符分隔的字符串形式传入。
- 必填:是
- 默认值:无</li>
<li><strong>目标长度</strong>:<code>5</code>
- 描述:填充后的目标数组长度,必须为正整数。
- 必填:是
- 默认值:无</li>
<li><strong>填充值</strong>(可选):<code>&quot;X&quot;</code>(默认)
- 描述:用于填充数组的默认值。
- 必填:否
- 默认值:空字符串</li>
<li><strong>分隔符</strong>(可选):<code>&quot;|&quot;</code>(默认)
- 描述:用于分割数组字符串的分隔符。
- 必填:否
- 默认值:<code>&quot;|&quot;</code></li>
</ul>
<h2>输出结果</h2>
<ul>
<li><strong>填充后的数组</strong>:<code>&quot;A|B|C|X|X&quot;</code>
- 描述:填充完成后的数组字符串。</li>
<li><strong>原始数组</strong>:<code>&quot;A|B|C&quot;</code>
- 描述:填充前的原始数组字符串。</li>
<li><strong>数组长度</strong>:<code>5</code>
- 描述:填充后的数组长度。</li>
</ul>
<h2>日志记录</h2>
<ul>
<li>
<p><strong>输入参数日志</strong>:
数组: A|B|C
分隔符: |
目标长度: 5
填充值: X</p>
</li>
<li>
<p><strong>验证失败日志</strong>:
- 如果数组为空:<code>数组不能为空</code>
- 如果目标长度非正整数:<code>目标长度必须是正整数</code></p>
</li>
<li>
<p><strong>无需填充日志</strong>:
- 如果当前长度 >= 目标长度:<code>数组已满足目标长度,无需填充</code></p>
</li>
<li>
<p><strong>填充成功日志</strong>:
- 填充后的数组:<code>A|B|C|X|X</code>
- 填充前数组长度:<code>3</code>
- 填充后数组长度:<code>5</code></p>
</li>
<li><strong>错误日志</strong>:
- 如果填充过程中发生错误:<code>填充数组失败: {错误信息}</code></li>
</ul>
<h2>不同场景下的输出</h2>
<h3>场景 1:</h3>
<ul>
<li><strong>输入参数</strong>:
- 数组=<code>&quot;1|2&quot;</code>
- 目标长度=<code>4</code>
- 填充值=<code>&quot;0&quot;</code>
- 分隔符=<code>&quot;|&quot;</code></li>
<li><strong>输出结果</strong>:
- 填充后的数组=<code>&quot;1|2|0|0&quot;</code>
- 原始数组=<code>&quot;1|2&quot;</code>
- 数组长度=<code>4</code></li>
<li><strong>日志输出</strong>:
- 输入参数:
数组: 1|2
目标长度: 4
填充值: 0
分隔符: |
- 输出结果:
填充后的数组: 1|2|0|0
原始数组: 1|2
数组长度: 4</li>
</ul>
<h3>场景 2:</h3>
<ul>
<li><strong>输入参数</strong>:
- 数组=<code>&quot;X|Y&quot;</code>
- 目标长度=<code>3</code>
- 填充值=<code>&quot;Z&quot;</code>
- 分隔符=<code>&quot;|&quot;</code></li>
<li><strong>输出结果</strong>:
- 填充后的数组=<code>&quot;X|Y|Z&quot;</code>
- 原始数组=<code>&quot;X|Y&quot;</code>
- 数组长度=<code>3</code></li>
<li><strong>日志输出</strong>:
- 输入参数:
数组: X|Y
目标长度: 3
填充值: Z
分隔符: |
- 输出结果:
填充后的数组: X|Y|Z
原始数组: X|Y
数组长度: 3</li>
</ul>
<h3>场景 3:</h3>
<ul>
<li><strong>输入参数</strong>:
- 数组=<code>&quot;A|B|C|D&quot;</code>
- 目标长度=<code>4</code>
- 填充值=<code>&quot;X&quot;</code>
- 分隔符=<code>&quot;|&quot;</code></li>
<li><strong>输出结果</strong>:
- 填充后的数组=<code>&quot;A|B|C|D&quot;</code>
- 原始数组=<code>&quot;A|B|C|D&quot;</code>
- 数组长度=<code>4</code></li>
<li><strong>日志输出</strong>:
- 输入参数:
数组: A|B|C|D
目标长度: 4
填充值: X
分隔符: |
- 输出结果:
填充后的数组: A|B|C|D
原始数组: A|B|C|D
数组长度: 4
- 日志:数组已满足目标长度,无需填充</li>
</ul>
<h3>场景 4:</h3>
<ul>
<li><strong>输入参数</strong>:
- 数组=<code>&quot;&quot;</code>
- 目标长度=<code>3</code>
- 填充值=<code>&quot;X&quot;</code>
- 分隔符=<code>&quot;|&quot;</code></li>
<li><strong>输出结果</strong>:
- 填充后的数组=<code>&quot;X|X|X&quot;</code>
- 原始数组=<code>&quot;&quot;</code>
- 数组长度=<code>3</code></li>
<li><strong>日志输出</strong>:
- 输入参数:
数组:
目标长度: 3
填充值: X
分隔符: |
- 输出结果:
填充后的数组: X|X|X
原始数组:
数组长度: 3</li>
</ul>