You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juneau.apache.org by gi...@apache.org on 2025/12/02 03:50:47 UTC
(juneau) branch asf-staging updated: Deploy documentation staging from a1c14752c1fdeeeff427d0d991d986885b4d895b a1c14752c1fdeeeff427d0d991d986885b4d895b
This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/juneau.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new da6bc98aed Deploy documentation staging from a1c14752c1fdeeeff427d0d991d986885b4d895b a1c14752c1fdeeeff427d0d991d986885b4d895b
da6bc98aed is described below
commit da6bc98aed83aba9d6e139e51cb11c7a463d04e6
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Tue Dec 2 03:50:41 2025 +0000
Deploy documentation staging from a1c14752c1fdeeeff427d0d991d986885b4d895b a1c14752c1fdeeeff427d0d991d986885b4d895b
---
.../apache/juneau/commons/utils/StringUtils.html | 16813 ++++++++++---------
1 file changed, 8410 insertions(+), 8403 deletions(-)
diff --git a/site/xref/org/apache/juneau/commons/utils/StringUtils.html b/site/xref/org/apache/juneau/commons/utils/StringUtils.html
index 01f3974419..fee3fe67de 100644
--- a/site/xref/org/apache/juneau/commons/utils/StringUtils.html
+++ b/site/xref/org/apache/juneau/commons/utils/StringUtils.html
@@ -51,8472 +51,8479 @@
<a class="jxr_linenumber" name="L43" href="#L43">43</a> <strong class="jxr_keyword">import</strong> java.util.zip.*;
<a class="jxr_linenumber" name="L44" href="#L44">44</a>
<a class="jxr_linenumber" name="L45" href="#L45">45</a> <strong class="jxr_keyword">import</strong> org.apache.juneau.commons.collections.*;
-<a class="jxr_linenumber" name="L46" href="#L46">46</a> <strong class="jxr_keyword">import</strong> org.apache.juneau.commons.function.*;
-<a class="jxr_linenumber" name="L47" href="#L47">47</a> <strong class="jxr_keyword">import</strong> org.apache.juneau.commons.reflect.*;
-<a class="jxr_linenumber" name="L48" href="#L48">48</a>
-<a class="jxr_linenumber" name="L49" href="#L49">49</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L50" href="#L50">50</a> <em class="jxr_javadoccomment"> * Reusable string utility methods.</em>
-<a class="jxr_linenumber" name="L51" href="#L51">51</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L52" href="#L52">52</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">class</strong> <a name="StringUtils" href="../../../../../org/apache/juneau/commons/utils/StringUtils.html#StringUtils">StringUtils</a> {
-<a class="jxr_linenumber" name="L53" href="#L53">53</a>
-<a class="jxr_linenumber" name="L54" href="#L54">54</a> <em class="jxr_javadoccomment">/** Characters considered common separators (comma/semicolon/colon/pipe/tab). */</em>
-<a class="jxr_linenumber" name="L55" href="#L55">55</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> COMMON_SEPARATORS = AsciiSet.of(<span class="jxr_string">",;:|\t"</span>);
-<a class="jxr_linenumber" name="L56" href="#L56">56</a>
-<a class="jxr_linenumber" name="L57" href="#L57">57</a> <em class="jxr_javadoccomment">/** Windows-style carriage-return/line-feed sequence. */</em>
-<a class="jxr_linenumber" name="L58" href="#L58">58</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String CRLF = <span class="jxr_string">"\r\n"</span>;
-<a class="jxr_linenumber" name="L59" href="#L59">59</a>
-<a class="jxr_linenumber" name="L60" href="#L60">60</a> <em class="jxr_javadoccomment">/** Digits 0-9 represented as an {@link AsciiSet}. */</em>
-<a class="jxr_linenumber" name="L61" href="#L61">61</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> DECIMAL_CHARS = AsciiSet.of(<span class="jxr_string">"0123456789"</span>);
-<a class="jxr_linenumber" name="L62" href="#L62">62</a>
-<a class="jxr_linenumber" name="L63" href="#L63">63</a> <em class="jxr_javadoccomment">/** Zero-length string constant. */</em>
-<a class="jxr_linenumber" name="L64" href="#L64">64</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String EMPTY = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L65" href="#L65">65</a>
-<a class="jxr_linenumber" name="L66" href="#L66">66</a> <em class="jxr_javadoccomment">/** Characters allowed at the beginning of a numeric literal. */</em>
-<a class="jxr_linenumber" name="L67" href="#L67">67</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> FIRST_NUMBER_CHARS = AsciiSet.of(<span class="jxr_string">"+-.#0123456789"</span>);
-<a class="jxr_linenumber" name="L68" href="#L68">68</a>
-<a class="jxr_linenumber" name="L69" href="#L69">69</a> <em class="jxr_javadoccomment">/** Hexadecimal digit characters. */</em>
-<a class="jxr_linenumber" name="L70" href="#L70">70</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> HEXADECIMAL_CHARS = AsciiSet.of(<span class="jxr_string">"0123456789abcdefABCDEF"</span>);
-<a class="jxr_linenumber" name="L71" href="#L71">71</a>
-<a class="jxr_linenumber" name="L72" href="#L72">72</a> <em class="jxr_javadoccomment">/** Characters allowed in HTTP headers (including quoted strings and comments). */</em>
-<a class="jxr_linenumber" name="L73" href="#L73">73</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> HTTP_HEADER_CHARS = AsciiSet.create().chars(<span class="jxr_string">"\t -"</span>).ranges(<span class="jxr_string">"!-["</span>,<span class="jxr_string">"]-}"</span>).build();
-<a class="jxr_linenumber" name="L74" href="#L74">74</a>
-<a class="jxr_linenumber" name="L75" href="#L75">75</a> <em class="jxr_javadoccomment">/** Characters escaped when parsing key/value pairs. */</em>
-<a class="jxr_linenumber" name="L76" href="#L76">76</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> MAP_ESCAPE_SET = AsciiSet.of(<span class="jxr_string">",=\\"</span>);
-<a class="jxr_linenumber" name="L77" href="#L77">77</a>
-<a class="jxr_linenumber" name="L78" href="#L78">78</a> <em class="jxr_javadoccomment">/** Unix-style newline character. */</em>
-<a class="jxr_linenumber" name="L79" href="#L79">79</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String NEWLINE = <span class="jxr_string">"\n"</span>;
-<a class="jxr_linenumber" name="L80" href="#L80">80</a>
-<a class="jxr_linenumber" name="L81" href="#L81">81</a> <em class="jxr_javadoccomment">/** Predicate that filters out {@code null} and empty strings. */</em>
-<a class="jxr_linenumber" name="L82" href="#L82">82</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Predicate<String> NOT_EMPTY = Utils::isNotEmpty;
-<a class="jxr_linenumber" name="L83" href="#L83">83</a>
-<a class="jxr_linenumber" name="L84" href="#L84">84</a> <em class="jxr_javadoccomment">/** Characters that can appear anywhere in a numeric literal. */</em>
-<a class="jxr_linenumber" name="L85" href="#L85">85</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> NUMBER_CHARS = AsciiSet.of(<span class="jxr_string">"-xX.+-#pP0123456789abcdefABCDEF"</span>);
-<a class="jxr_linenumber" name="L86" href="#L86">86</a>
-<a class="jxr_linenumber" name="L87" href="#L87">87</a> <em class="jxr_javadoccomment">/** Octal digit characters. */</em>
-<a class="jxr_linenumber" name="L88" href="#L88">88</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> OCTAL_CHARS = AsciiSet.of(<span class="jxr_string">"01234567"</span>);
-<a class="jxr_linenumber" name="L89" href="#L89">89</a>
-<a class="jxr_linenumber" name="L90" href="#L90">90</a> <em class="jxr_javadoccomment">/** Characters escaped when parsing quoted strings. */</em>
-<a class="jxr_linenumber" name="L91" href="#L91">91</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> QUOTE_ESCAPE_SET = AsciiSet.of(<span class="jxr_string">"\"'\\"</span>);
-<a class="jxr_linenumber" name="L92" href="#L92">92</a>
-<a class="jxr_linenumber" name="L93" href="#L93">93</a> <em class="jxr_javadoccomment">/** Single-space character constant. */</em>
-<a class="jxr_linenumber" name="L94" href="#L94">94</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String SPACE = <span class="jxr_string">" "</span>;
-<a class="jxr_linenumber" name="L95" href="#L95">95</a>
-<a class="jxr_linenumber" name="L96" href="#L96">96</a> <em class="jxr_javadoccomment">/** Horizontal tab character constant. */</em>
-<a class="jxr_linenumber" name="L97" href="#L97">97</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String TAB = <span class="jxr_string">"\t"</span>;
-<a class="jxr_linenumber" name="L98" href="#L98">98</a>
-<a class="jxr_linenumber" name="L99" href="#L99">99</a> <em class="jxr_javadoccomment">/** Characters considered part of a URI when encoding paths. */</em>
-<a class="jxr_linenumber" name="L100" href="#L100">100</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> URI_CHARS = AsciiSet.create().chars(<span class="jxr_string">"?#+%;/:@&=+$,-_.!~*'()"</span>).range('0', '9').range('A', 'Z').range('a', 'z').build();
-<a class="jxr_linenumber" name="L101" href="#L101">101</a>
-<a class="jxr_linenumber" name="L102" href="#L102">102</a> <em class="jxr_javadoccomment">/** Characters that may appear unescaped in path segments when URL-encoding. */</em>
-<a class="jxr_linenumber" name="L103" href="#L103">103</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> URL_ENCODE_PATHINFO_VALIDCHARS = AsciiSet.create().ranges(<span class="jxr_string">"a-z"</span>, <span class="jxr_string">"A-Z"</span>, <span class="jxr_string">"0-9"</span>).chars(<span class [...]
-<a class="jxr_linenumber" name="L104" href="#L104">104</a>
-<a class="jxr_linenumber" name="L105" href="#L105">105</a> <em class="jxr_javadoccomment">/** Characters that never require URL encoding per RFC 3986. */</em>
-<a class="jxr_linenumber" name="L106" href="#L106">106</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> URL_UNENCODED_CHARS = AsciiSet.create().ranges(<span class="jxr_string">"a-z"</span>, <span class="jxr_string">"A-Z"</span>, <span class="jxr_string">"0-9"</span>).chars(<span class="jxr_strin [...]
-<a class="jxr_linenumber" name="L107" href="#L107">107</a>
-<a class="jxr_linenumber" name="L108" href="#L108">108</a> <em class="jxr_javadoccomment">/** Extended set of characters that are typically safe to leave unencoded. */</em>
-<a class="jxr_linenumber" name="L109" href="#L109">109</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> URL_UNENCODED_LAX_CHARS = URL_UNENCODED_CHARS.copy().chars(<span class="jxr_string">":@$,"</span>).chars(<span class="jxr_string">"{}|\\^[]`"</span>).build();
-<a class="jxr_linenumber" name="L110" href="#L110">110</a>
-<a class="jxr_linenumber" name="L111" href="#L111">111</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L112" href="#L112">112</a> <em class="jxr_javadoccomment"> * All standard whitespace characters (space, tab, newline, carriage return, form feed, vertical tab).</em>
-<a class="jxr_linenumber" name="L113" href="#L113">113</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L114" href="#L114">114</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> WHITESPACE_CHARS = AsciiSet.of(<span class="jxr_string">" \t\n\r\f\u000B"</span>);
-<a class="jxr_linenumber" name="L115" href="#L115">115</a>
-<a class="jxr_linenumber" name="L116" href="#L116">116</a> <em class="jxr_comment">// Maps 6-bit nibbles to BASE64 characters.</em>
-<a class="jxr_linenumber" name="L117" href="#L117">117</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">char</strong>[] BASE64M1 = <span class="jxr_string">"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"</span>.toCharArray();
-<a class="jxr_linenumber" name="L118" href="#L118">118</a>
-<a class="jxr_linenumber" name="L119" href="#L119">119</a> <em class="jxr_comment">// Maps BASE64 characters to 6-bit nibbles.</em>
-<a class="jxr_linenumber" name="L120" href="#L120">120</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> byte[] BASE64M2 = <strong class="jxr_keyword">new</strong> byte[128];
-<a class="jxr_linenumber" name="L121" href="#L121">121</a>
-<a class="jxr_linenumber" name="L122" href="#L122">122</a> <strong class="jxr_keyword">static</strong> {
-<a class="jxr_linenumber" name="L123" href="#L123">123</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < 64; i++)
-<a class="jxr_linenumber" name="L124" href="#L124">124</a> BASE64M2[BASE64M1[i]] = (byte)i;
-<a class="jxr_linenumber" name="L125" href="#L125">125</a> }
-<a class="jxr_linenumber" name="L126" href="#L126">126</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Random RANDOM = <strong class="jxr_keyword">new</strong> Random();
-<a class="jxr_linenumber" name="L127" href="#L127">127</a>
-<a class="jxr_linenumber" name="L128" href="#L128">128</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Pattern FP_REGEX = Pattern.compile(
-<a class="jxr_linenumber" name="L129" href="#L129">129</a> <span class="jxr_string">"[+-]?(NaN|Infinity|((((\\p{Digit}+)(\\.)?((\\p{Digit}+)?)([eE][+-]?(\\p{Digit}+))?)|(\\.((\\p{Digit}+))([eE][+-]?(\\p{Digit}+))?)|(((0[xX](\\p{XDigit}+)(\\.)?)|(0[xX](\\p{XDigit}+)?(\\.)(\\p{XDigit}+)))[pP][+-]?(\\p{Digit}+)))[fFdD]?))[\\x00-\\x20]*"</span> <em class="jxr_comment">// [...]
-<a class="jxr_linenumber" name="L130" href="#L130">130</a> );
-<a class="jxr_linenumber" name="L131" href="#L131">131</a>
-<a class="jxr_linenumber" name="L132" href="#L132">132</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Map<Character,AsciiSet> ESCAPE_SETS = <strong class="jxr_keyword">new</strong> ConcurrentHashMap<>();
-<a class="jxr_linenumber" name="L133" href="#L133">133</a>
-<a class="jxr_linenumber" name="L134" href="#L134">134</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">char</strong>[] HEX_ARRAY = <span class="jxr_string">"0123456789ABCDEF"</span>.toCharArray();
-<a class="jxr_linenumber" name="L135" href="#L135">135</a>
-<a class="jxr_linenumber" name="L136" href="#L136">136</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> List<Readifier> READIFIERS = loadReadifiers();
-<a class="jxr_linenumber" name="L137" href="#L137">137</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Cache<Class,Function<Object,String>> READIFIER_CACHE = Cache.<Class,Function<Object,String>>create().build();
-<a class="jxr_linenumber" name="L138" href="#L138">138</a>
-<a class="jxr_linenumber" name="L139" href="#L139">139</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">char</strong>[] HEX = <span class="jxr_string">"0123456789ABCDEF"</span>.toCharArray();
-<a class="jxr_linenumber" name="L140" href="#L140">140</a>
-<a class="jxr_linenumber" name="L141" href="#L141">141</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L142" href="#L142">142</a> <em class="jxr_javadoccomment"> * Abbreviates a string using ellipses if it exceeds the specified length.</em>
-<a class="jxr_linenumber" name="L143" href="#L143">143</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L144" href="#L144">144</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L145" href="#L145">145</a> <em class="jxr_javadoccomment"> * If the string is longer than the specified length, it is truncated and <js>"..."</js> is appended.</em>
-<a class="jxr_linenumber" name="L146" href="#L146">146</a> <em class="jxr_javadoccomment"> * The total length of the result will be exactly <c>length</c> characters (including the ellipses).</em>
-<a class="jxr_linenumber" name="L147" href="#L147">147</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L148" href="#L148">148</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L149" href="#L149">149</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk>, shorter than or equal to <c>length</c>, or has length 3 or less,</em>
-<a class="jxr_linenumber" name="L150" href="#L150">150</a> <em class="jxr_javadoccomment"> * the original string is returned unchanged.</em>
-<a class="jxr_linenumber" name="L151" href="#L151">151</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L152" href="#L152">152</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L153" href="#L153">153</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L154" href="#L154">154</a> <em class="jxr_javadoccomment"> * abbreviate(<js>"Hello World"</js>, 8); <jc>// "Hello..."</jc></em>
-<a class="jxr_linenumber" name="L155" href="#L155">155</a> <em class="jxr_javadoccomment"> * abbreviate(<js>"Hello World"</js>, 20); <jc>// "Hello World" (no change)</jc></em>
-<a class="jxr_linenumber" name="L156" href="#L156">156</a> <em class="jxr_javadoccomment"> * abbreviate(<js>"Hi"</js>, 5); <jc>// "Hi" (too short to abbreviate)</jc></em>
-<a class="jxr_linenumber" name="L157" href="#L157">157</a> <em class="jxr_javadoccomment"> * abbreviate(<jk>null</jk>, 10); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L158" href="#L158">158</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L159" href="#L159">159</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L160" href="#L160">160</a> <em class="jxr_javadoccomment"> * @param in The input string. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L161" href="#L161">161</a> <em class="jxr_javadoccomment"> * @param length The maximum length of the resulting string (must be at least 4 for abbreviation to occur).</em>
-<a class="jxr_linenumber" name="L162" href="#L162">162</a> <em class="jxr_javadoccomment"> * @return The abbreviated string with ellipses, or the original string if no abbreviation is needed.</em>
-<a class="jxr_linenumber" name="L163" href="#L163">163</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L164" href="#L164">164</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String abbreviate(String in, <strong class="jxr_keyword">int</strong> length) {
-<a class="jxr_linenumber" name="L165" href="#L165">165</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong> || in.length() <= length || in.length() <= 3)
-<a class="jxr_linenumber" name="L166" href="#L166">166</a> <strong class="jxr_keyword">return</strong> in;
-<a class="jxr_linenumber" name="L167" href="#L167">167</a> <strong class="jxr_keyword">return</strong> in.substring(0, length - 3) + <span class="jxr_string">"..."</span>;
-<a class="jxr_linenumber" name="L168" href="#L168">168</a> }
-<a class="jxr_linenumber" name="L169" href="#L169">169</a>
-<a class="jxr_linenumber" name="L170" href="#L170">170</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L171" href="#L171">171</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder, creating a new one if null.</em>
-<a class="jxr_linenumber" name="L172" href="#L172">172</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L173" href="#L173">173</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to, or <jk>null</jk> to create a new one.</em>
-<a class="jxr_linenumber" name="L174" href="#L174">174</a> <em class="jxr_javadoccomment"> * @param in The string to append.</em>
-<a class="jxr_linenumber" name="L175" href="#L175">175</a> <em class="jxr_javadoccomment"> * @return The StringBuilder with the string appended.</em>
-<a class="jxr_linenumber" name="L176" href="#L176">176</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L177" href="#L177">177</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder append(StringBuilder sb, String in) {
-<a class="jxr_linenumber" name="L178" href="#L178">178</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L179" href="#L179">179</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> StringBuilder(in);
-<a class="jxr_linenumber" name="L180" href="#L180">180</a> sb.append(in);
-<a class="jxr_linenumber" name="L181" href="#L181">181</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L182" href="#L182">182</a> }
-<a class="jxr_linenumber" name="L183" href="#L183">183</a>
-<a class="jxr_linenumber" name="L184" href="#L184">184</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L185" href="#L185">185</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder if the string is not blank.</em>
-<a class="jxr_linenumber" name="L186" href="#L186">186</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L187" href="#L187">187</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L188" href="#L188">188</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L189" href="#L189">189</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk>, empty, or contains only whitespace, nothing is appended.</em>
-<a class="jxr_linenumber" name="L190" href="#L190">190</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
-<a class="jxr_linenumber" name="L191" href="#L191">191</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L192" href="#L192">192</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L193" href="#L193">193</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L194" href="#L194">194</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
-<a class="jxr_linenumber" name="L195" href="#L195">195</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>"hello"</js>); <jc>// Appends "hello"</jc></em>
-<a class="jxr_linenumber" name="L196" href="#L196">196</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>" "</js>); <jc>// Does nothing</jc></em>
-<a class="jxr_linenumber" name="L197" href="#L197">197</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <jk>null</jk>); <jc>// Does nothing</jc></em>
-<a class="jxr_linenumber" name="L198" href="#L198">198</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>"world"</js>); <jc>// Appends "world"</jc></em>
-<a class="jxr_linenumber" name="L199" href="#L199">199</a> <em class="jxr_javadoccomment"> * <jc>// Result: "helloworld"</jc></em>
-<a class="jxr_linenumber" name="L200" href="#L200">200</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L201" href="#L201">201</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
-<a class="jxr_linenumber" name="L202" href="#L202">202</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendIfNotBlank(<jk>null</jk>, <js>"test"</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
-<a class="jxr_linenumber" name="L203" href="#L203">203</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendIfNotBlank(<jk>null</jk>, <js>" "</js>); <jc>// Returns null (no append occurred)</jc></em>
-<a class="jxr_linenumber" name="L204" href="#L204">204</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L205" href="#L205">205</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L206" href="#L206">206</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L207" href="#L207">207</a> <em class="jxr_javadoccomment"> * @param str The string to append if not blank. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L208" href="#L208">208</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
-<a class="jxr_linenumber" name="L209" href="#L209">209</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L210" href="#L210">210</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendIfNotBlank(StringBuilder sb, String str) {
-<a class="jxr_linenumber" name="L211" href="#L211">211</a> <strong class="jxr_keyword">if</strong> (isNotBlank(str)) {
-<a class="jxr_linenumber" name="L212" href="#L212">212</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L213" href="#L213">213</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L214" href="#L214">214</a> sb.append(str);
-<a class="jxr_linenumber" name="L215" href="#L215">215</a> }
-<a class="jxr_linenumber" name="L216" href="#L216">216</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L217" href="#L217">217</a> }
-<a class="jxr_linenumber" name="L218" href="#L218">218</a>
-<a class="jxr_linenumber" name="L219" href="#L219">219</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L220" href="#L220">220</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder if the string is not empty.</em>
-<a class="jxr_linenumber" name="L221" href="#L221">221</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L222" href="#L222">222</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L223" href="#L223">223</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L224" href="#L224">224</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk> or empty, nothing is appended.</em>
-<a class="jxr_linenumber" name="L225" href="#L225">225</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
-<a class="jxr_linenumber" name="L226" href="#L226">226</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L227" href="#L227">227</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L228" href="#L228">228</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L229" href="#L229">229</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
-<a class="jxr_linenumber" name="L230" href="#L230">230</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>"hello"</js>); <jc>// Appends "hello"</jc></em>
-<a class="jxr_linenumber" name="L231" href="#L231">231</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>""</js>); <jc>// Does nothing</jc></em>
-<a class="jxr_linenumber" name="L232" href="#L232">232</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <jk>null</jk>); <jc>// Does nothing</jc></em>
-<a class="jxr_linenumber" name="L233" href="#L233">233</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>"world"</js>); <jc>// Appends "world"</jc></em>
-<a class="jxr_linenumber" name="L234" href="#L234">234</a> <em class="jxr_javadoccomment"> * <jc>// Result: "helloworld"</jc></em>
-<a class="jxr_linenumber" name="L235" href="#L235">235</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L236" href="#L236">236</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
-<a class="jxr_linenumber" name="L237" href="#L237">237</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendIfNotEmpty(<jk>null</jk>, <js>"test"</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
-<a class="jxr_linenumber" name="L238" href="#L238">238</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendIfNotEmpty(<jk>null</jk>, <jk>null</jk>); <jc>// Returns null (no append occurred)</jc></em>
-<a class="jxr_linenumber" name="L239" href="#L239">239</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L240" href="#L240">240</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L241" href="#L241">241</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L242" href="#L242">242</a> <em class="jxr_javadoccomment"> * @param str The string to append if not empty. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L243" href="#L243">243</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
-<a class="jxr_linenumber" name="L244" href="#L244">244</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L245" href="#L245">245</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendIfNotEmpty(StringBuilder sb, String str) {
-<a class="jxr_linenumber" name="L246" href="#L246">246</a> <strong class="jxr_keyword">if</strong> (isNotEmpty(str)) {
-<a class="jxr_linenumber" name="L247" href="#L247">247</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L248" href="#L248">248</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L249" href="#L249">249</a> sb.append(str);
-<a class="jxr_linenumber" name="L250" href="#L250">250</a> }
-<a class="jxr_linenumber" name="L251" href="#L251">251</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L252" href="#L252">252</a> }
-<a class="jxr_linenumber" name="L253" href="#L253">253</a>
-<a class="jxr_linenumber" name="L254" href="#L254">254</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L255" href="#L255">255</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder with a separator, only adding the separator if the StringBuilder is not empty.</em>
-<a class="jxr_linenumber" name="L256" href="#L256">256</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L257" href="#L257">257</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L258" href="#L258">258</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
-<a class="jxr_linenumber" name="L259" href="#L259">259</a> <em class="jxr_javadoccomment"> * If the StringBuilder is empty, only the string is appended (no separator).</em>
-<a class="jxr_linenumber" name="L260" href="#L260">260</a> <em class="jxr_javadoccomment"> * If the StringBuilder is not empty, the separator is appended first, then the string.</em>
-<a class="jxr_linenumber" name="L261" href="#L261">261</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
+<a class="jxr_linenumber" name="L46" href="#L46">46</a> <strong class="jxr_keyword">import</strong> org.apache.juneau.commons.reflect.*;
+<a class="jxr_linenumber" name="L47" href="#L47">47</a>
+<a class="jxr_linenumber" name="L48" href="#L48">48</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L49" href="#L49">49</a> <em class="jxr_javadoccomment"> * Reusable string utility methods.</em>
+<a class="jxr_linenumber" name="L50" href="#L50">50</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L51" href="#L51">51</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">class</strong> <a name="StringUtils" href="../../../../../org/apache/juneau/commons/utils/StringUtils.html#StringUtils">StringUtils</a> {
+<a class="jxr_linenumber" name="L52" href="#L52">52</a>
+<a class="jxr_linenumber" name="L53" href="#L53">53</a> <em class="jxr_javadoccomment">/** Characters considered common separators (comma/semicolon/colon/pipe/tab). */</em>
+<a class="jxr_linenumber" name="L54" href="#L54">54</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> COMMON_SEPARATORS = AsciiSet.of(<span class="jxr_string">",;:|\t"</span>);
+<a class="jxr_linenumber" name="L55" href="#L55">55</a>
+<a class="jxr_linenumber" name="L56" href="#L56">56</a> <em class="jxr_javadoccomment">/** Windows-style carriage-return/line-feed sequence. */</em>
+<a class="jxr_linenumber" name="L57" href="#L57">57</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String CRLF = <span class="jxr_string">"\r\n"</span>;
+<a class="jxr_linenumber" name="L58" href="#L58">58</a>
+<a class="jxr_linenumber" name="L59" href="#L59">59</a> <em class="jxr_javadoccomment">/** Digits 0-9 represented as an {@link AsciiSet}. */</em>
+<a class="jxr_linenumber" name="L60" href="#L60">60</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> DECIMAL_CHARS = AsciiSet.of(<span class="jxr_string">"0123456789"</span>);
+<a class="jxr_linenumber" name="L61" href="#L61">61</a>
+<a class="jxr_linenumber" name="L62" href="#L62">62</a> <em class="jxr_javadoccomment">/** Zero-length string constant. */</em>
+<a class="jxr_linenumber" name="L63" href="#L63">63</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String EMPTY = <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L64" href="#L64">64</a>
+<a class="jxr_linenumber" name="L65" href="#L65">65</a> <em class="jxr_javadoccomment">/** Characters allowed at the beginning of a numeric literal. */</em>
+<a class="jxr_linenumber" name="L66" href="#L66">66</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> FIRST_NUMBER_CHARS = AsciiSet.of(<span class="jxr_string">"+-.#0123456789"</span>);
+<a class="jxr_linenumber" name="L67" href="#L67">67</a>
+<a class="jxr_linenumber" name="L68" href="#L68">68</a> <em class="jxr_javadoccomment">/** Hexadecimal digit characters. */</em>
+<a class="jxr_linenumber" name="L69" href="#L69">69</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> HEXADECIMAL_CHARS = AsciiSet.of(<span class="jxr_string">"0123456789abcdefABCDEF"</span>);
+<a class="jxr_linenumber" name="L70" href="#L70">70</a>
+<a class="jxr_linenumber" name="L71" href="#L71">71</a> <em class="jxr_javadoccomment">/** Characters allowed in HTTP headers (including quoted strings and comments). */</em>
+<a class="jxr_linenumber" name="L72" href="#L72">72</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> HTTP_HEADER_CHARS = AsciiSet.create().chars(<span class="jxr_string">"\t -"</span>).ranges(<span class="jxr_string">"!-["</span>,<span class="jxr_string">"]-}"</span>).build();
+<a class="jxr_linenumber" name="L73" href="#L73">73</a>
+<a class="jxr_linenumber" name="L74" href="#L74">74</a> <em class="jxr_javadoccomment">/** Characters escaped when parsing key/value pairs. */</em>
+<a class="jxr_linenumber" name="L75" href="#L75">75</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> MAP_ESCAPE_SET = AsciiSet.of(<span class="jxr_string">",=\\"</span>);
+<a class="jxr_linenumber" name="L76" href="#L76">76</a>
+<a class="jxr_linenumber" name="L77" href="#L77">77</a> <em class="jxr_javadoccomment">/** Unix-style newline character. */</em>
+<a class="jxr_linenumber" name="L78" href="#L78">78</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String NEWLINE = <span class="jxr_string">"\n"</span>;
+<a class="jxr_linenumber" name="L79" href="#L79">79</a>
+<a class="jxr_linenumber" name="L80" href="#L80">80</a> <em class="jxr_javadoccomment">/** Predicate that filters out {@code null} and empty strings. */</em>
+<a class="jxr_linenumber" name="L81" href="#L81">81</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Predicate<String> NOT_EMPTY = Utils::isNotEmpty;
+<a class="jxr_linenumber" name="L82" href="#L82">82</a>
+<a class="jxr_linenumber" name="L83" href="#L83">83</a> <em class="jxr_javadoccomment">/** Characters that can appear anywhere in a numeric literal. */</em>
+<a class="jxr_linenumber" name="L84" href="#L84">84</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> NUMBER_CHARS = AsciiSet.of(<span class="jxr_string">"-xX.+-#pP0123456789abcdefABCDEF"</span>);
+<a class="jxr_linenumber" name="L85" href="#L85">85</a>
+<a class="jxr_linenumber" name="L86" href="#L86">86</a> <em class="jxr_javadoccomment">/** Octal digit characters. */</em>
+<a class="jxr_linenumber" name="L87" href="#L87">87</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> OCTAL_CHARS = AsciiSet.of(<span class="jxr_string">"01234567"</span>);
+<a class="jxr_linenumber" name="L88" href="#L88">88</a>
+<a class="jxr_linenumber" name="L89" href="#L89">89</a> <em class="jxr_javadoccomment">/** Characters escaped when parsing quoted strings. */</em>
+<a class="jxr_linenumber" name="L90" href="#L90">90</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> QUOTE_ESCAPE_SET = AsciiSet.of(<span class="jxr_string">"\"'\\"</span>);
+<a class="jxr_linenumber" name="L91" href="#L91">91</a>
+<a class="jxr_linenumber" name="L92" href="#L92">92</a> <em class="jxr_javadoccomment">/** Single-space character constant. */</em>
+<a class="jxr_linenumber" name="L93" href="#L93">93</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String SPACE = <span class="jxr_string">" "</span>;
+<a class="jxr_linenumber" name="L94" href="#L94">94</a>
+<a class="jxr_linenumber" name="L95" href="#L95">95</a> <em class="jxr_javadoccomment">/** Horizontal tab character constant. */</em>
+<a class="jxr_linenumber" name="L96" href="#L96">96</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> String TAB = <span class="jxr_string">"\t"</span>;
+<a class="jxr_linenumber" name="L97" href="#L97">97</a>
+<a class="jxr_linenumber" name="L98" href="#L98">98</a> <em class="jxr_javadoccomment">/** Characters considered part of a URI when encoding paths. */</em>
+<a class="jxr_linenumber" name="L99" href="#L99">99</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> URI_CHARS = AsciiSet.create().chars(<span class="jxr_string">"?#+%;/:@&=+$,-_.!~*'()"</span>).range('0', '9').range('A', 'Z').range('a', 'z').build();
+<a class="jxr_linenumber" name="L100" href="#L100">100</a>
+<a class="jxr_linenumber" name="L101" href="#L101">101</a> <em class="jxr_javadoccomment">/** Characters that may appear unescaped in path segments when URL-encoding. */</em>
+<a class="jxr_linenumber" name="L102" href="#L102">102</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> URL_ENCODE_PATHINFO_VALIDCHARS = AsciiSet.create().ranges(<span class="jxr_string">"a-z"</span>, <span class="jxr_string">"A-Z"</span>, <span class="jxr_string">"0-9"</span>).chars(<span class [...]
+<a class="jxr_linenumber" name="L103" href="#L103">103</a>
+<a class="jxr_linenumber" name="L104" href="#L104">104</a> <em class="jxr_javadoccomment">/** Characters that never require URL encoding per RFC 3986. */</em>
+<a class="jxr_linenumber" name="L105" href="#L105">105</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> URL_UNENCODED_CHARS = AsciiSet.create().ranges(<span class="jxr_string">"a-z"</span>, <span class="jxr_string">"A-Z"</span>, <span class="jxr_string">"0-9"</span>).chars(<span class="jxr_strin [...]
+<a class="jxr_linenumber" name="L106" href="#L106">106</a>
+<a class="jxr_linenumber" name="L107" href="#L107">107</a> <em class="jxr_javadoccomment">/** Extended set of characters that are typically safe to leave unencoded. */</em>
+<a class="jxr_linenumber" name="L108" href="#L108">108</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> URL_UNENCODED_LAX_CHARS = URL_UNENCODED_CHARS.copy().chars(<span class="jxr_string">":@$,"</span>).chars(<span class="jxr_string">"{}|\\^[]`"</span>).build();
+<a class="jxr_linenumber" name="L109" href="#L109">109</a>
+<a class="jxr_linenumber" name="L110" href="#L110">110</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L111" href="#L111">111</a> <em class="jxr_javadoccomment"> * All standard whitespace characters (space, tab, newline, carriage return, form feed, vertical tab).</em>
+<a class="jxr_linenumber" name="L112" href="#L112">112</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L113" href="#L113">113</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> WHITESPACE_CHARS = AsciiSet.of(<span class="jxr_string">" \t\n\r\f\u000B"</span>);
+<a class="jxr_linenumber" name="L114" href="#L114">114</a>
+<a class="jxr_linenumber" name="L115" href="#L115">115</a> <em class="jxr_comment">// Maps 6-bit nibbles to BASE64 characters.</em>
+<a class="jxr_linenumber" name="L116" href="#L116">116</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">char</strong>[] BASE64M1 = <span class="jxr_string">"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"</span>.toCharArray();
+<a class="jxr_linenumber" name="L117" href="#L117">117</a>
+<a class="jxr_linenumber" name="L118" href="#L118">118</a> <em class="jxr_comment">// Maps BASE64 characters to 6-bit nibbles.</em>
+<a class="jxr_linenumber" name="L119" href="#L119">119</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> byte[] BASE64M2 = <strong class="jxr_keyword">new</strong> byte[128];
+<a class="jxr_linenumber" name="L120" href="#L120">120</a>
+<a class="jxr_linenumber" name="L121" href="#L121">121</a> <strong class="jxr_keyword">static</strong> {
+<a class="jxr_linenumber" name="L122" href="#L122">122</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < 64; i++)
+<a class="jxr_linenumber" name="L123" href="#L123">123</a> BASE64M2[BASE64M1[i]] = (byte)i;
+<a class="jxr_linenumber" name="L124" href="#L124">124</a> }
+<a class="jxr_linenumber" name="L125" href="#L125">125</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Random RANDOM = <strong class="jxr_keyword">new</strong> Random();
+<a class="jxr_linenumber" name="L126" href="#L126">126</a>
+<a class="jxr_linenumber" name="L127" href="#L127">127</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L128" href="#L128">128</a> <em class="jxr_javadoccomment"> * Floating-point literal validation pattern used by {@link Double#valueOf(String)}.</em>
+<a class="jxr_linenumber" name="L129" href="#L129">129</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L130" href="#L130">130</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L131" href="#L131">131</a> <em class="jxr_javadoccomment"> * Matches decimal, hexadecimal, and scientific-notation literals, as well as {@code NaN} and {@code Infinity},</em>
+<a class="jxr_linenumber" name="L132" href="#L132">132</a> <em class="jxr_javadoccomment"> * with optional sign, exponent, and type suffixes. Copied from the JDK source to keep parsing logic consistent.</em>
+<a class="jxr_linenumber" name="L133" href="#L133">133</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L134" href="#L134">134</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Pattern FP_REGEX = Pattern.compile(
+<a class="jxr_linenumber" name="L135" href="#L135">135</a> <span class="jxr_string">"[+-]?(NaN|Infinity|((((\\p{Digit}+)(\\.)?((\\p{Digit}+)?)([eE][+-]?(\\p{Digit}+))?)|(\\.((\\p{Digit}+))([eE][+-]?(\\p{Digit}+))?)|(((0[xX](\\p{XDigit}+)(\\.)?)|(0[xX](\\p{XDigit}+)?(\\.)(\\p{XDigit}+)))[pP][+-]?(\\p{Digit}+)))[fFdD]?))[\\x00-\\x20]*"</span> <em class="jxr_comment">// [...]
+<a class="jxr_linenumber" name="L136" href="#L136">136</a> );
+<a class="jxr_linenumber" name="L137" href="#L137">137</a>
+<a class="jxr_linenumber" name="L138" href="#L138">138</a> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Map<Character,AsciiSet> ESCAPE_SETS = <strong class="jxr_keyword">new</strong> ConcurrentHashMap<>();
+<a class="jxr_linenumber" name="L139" href="#L139">139</a>
+<a class="jxr_linenumber" name="L140" href="#L140">140</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">char</strong>[] HEX_ARRAY = <span class="jxr_string">"0123456789ABCDEF"</span>.toCharArray();
+<a class="jxr_linenumber" name="L141" href="#L141">141</a>
+<a class="jxr_linenumber" name="L142" href="#L142">142</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> List<Readifier> READIFIERS = loadReadifiers();
+<a class="jxr_linenumber" name="L143" href="#L143">143</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> Cache<Class<?>,Function<Object,String>> READIFIER_CACHE = Cache.<Class<?>,Function<Object,String>>create().weak().build();
+<a class="jxr_linenumber" name="L144" href="#L144">144</a>
+<a class="jxr_linenumber" name="L145" href="#L145">145</a> <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">final</strong> <strong class="jxr_keyword">char</strong>[] HEX = <span class="jxr_string">"0123456789ABCDEF"</span>.toCharArray();
+<a class="jxr_linenumber" name="L146" href="#L146">146</a>
+<a class="jxr_linenumber" name="L147" href="#L147">147</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L148" href="#L148">148</a> <em class="jxr_javadoccomment"> * Abbreviates a string using ellipses if it exceeds the specified length.</em>
+<a class="jxr_linenumber" name="L149" href="#L149">149</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L150" href="#L150">150</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L151" href="#L151">151</a> <em class="jxr_javadoccomment"> * If the string is longer than the specified length, it is truncated and <js>"..."</js> is appended.</em>
+<a class="jxr_linenumber" name="L152" href="#L152">152</a> <em class="jxr_javadoccomment"> * The total length of the result will be exactly <c>length</c> characters (including the ellipses).</em>
+<a class="jxr_linenumber" name="L153" href="#L153">153</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L154" href="#L154">154</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L155" href="#L155">155</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk>, shorter than or equal to <c>length</c>, or has length 3 or less,</em>
+<a class="jxr_linenumber" name="L156" href="#L156">156</a> <em class="jxr_javadoccomment"> * the original string is returned unchanged.</em>
+<a class="jxr_linenumber" name="L157" href="#L157">157</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L158" href="#L158">158</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L159" href="#L159">159</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L160" href="#L160">160</a> <em class="jxr_javadoccomment"> * abbreviate(<js>"Hello World"</js>, 8); <jc>// "Hello..."</jc></em>
+<a class="jxr_linenumber" name="L161" href="#L161">161</a> <em class="jxr_javadoccomment"> * abbreviate(<js>"Hello World"</js>, 20); <jc>// "Hello World" (no change)</jc></em>
+<a class="jxr_linenumber" name="L162" href="#L162">162</a> <em class="jxr_javadoccomment"> * abbreviate(<js>"Hi"</js>, 5); <jc>// "Hi" (too short to abbreviate)</jc></em>
+<a class="jxr_linenumber" name="L163" href="#L163">163</a> <em class="jxr_javadoccomment"> * abbreviate(<jk>null</jk>, 10); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L164" href="#L164">164</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L165" href="#L165">165</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L166" href="#L166">166</a> <em class="jxr_javadoccomment"> * @param in The input string. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L167" href="#L167">167</a> <em class="jxr_javadoccomment"> * @param length The maximum length of the resulting string (must be at least 4 for abbreviation to occur).</em>
+<a class="jxr_linenumber" name="L168" href="#L168">168</a> <em class="jxr_javadoccomment"> * @return The abbreviated string with ellipses, or the original string if no abbreviation is needed.</em>
+<a class="jxr_linenumber" name="L169" href="#L169">169</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L170" href="#L170">170</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String abbreviate(String in, <strong class="jxr_keyword">int</strong> length) {
+<a class="jxr_linenumber" name="L171" href="#L171">171</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong> || in.length() <= length || in.length() <= 3)
+<a class="jxr_linenumber" name="L172" href="#L172">172</a> <strong class="jxr_keyword">return</strong> in;
+<a class="jxr_linenumber" name="L173" href="#L173">173</a> <strong class="jxr_keyword">return</strong> in.substring(0, length - 3) + <span class="jxr_string">"..."</span>;
+<a class="jxr_linenumber" name="L174" href="#L174">174</a> }
+<a class="jxr_linenumber" name="L175" href="#L175">175</a>
+<a class="jxr_linenumber" name="L176" href="#L176">176</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L177" href="#L177">177</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder, creating a new one if null.</em>
+<a class="jxr_linenumber" name="L178" href="#L178">178</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L179" href="#L179">179</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to, or <jk>null</jk> to create a new one.</em>
+<a class="jxr_linenumber" name="L180" href="#L180">180</a> <em class="jxr_javadoccomment"> * @param in The string to append.</em>
+<a class="jxr_linenumber" name="L181" href="#L181">181</a> <em class="jxr_javadoccomment"> * @return The StringBuilder with the string appended.</em>
+<a class="jxr_linenumber" name="L182" href="#L182">182</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L183" href="#L183">183</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder append(StringBuilder sb, String in) {
+<a class="jxr_linenumber" name="L184" href="#L184">184</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L185" href="#L185">185</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> StringBuilder(in);
+<a class="jxr_linenumber" name="L186" href="#L186">186</a> sb.append(in);
+<a class="jxr_linenumber" name="L187" href="#L187">187</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L188" href="#L188">188</a> }
+<a class="jxr_linenumber" name="L189" href="#L189">189</a>
+<a class="jxr_linenumber" name="L190" href="#L190">190</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L191" href="#L191">191</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder if the string is not blank.</em>
+<a class="jxr_linenumber" name="L192" href="#L192">192</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L193" href="#L193">193</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L194" href="#L194">194</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
+<a class="jxr_linenumber" name="L195" href="#L195">195</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk>, empty, or contains only whitespace, nothing is appended.</em>
+<a class="jxr_linenumber" name="L196" href="#L196">196</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
+<a class="jxr_linenumber" name="L197" href="#L197">197</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L198" href="#L198">198</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L199" href="#L199">199</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L200" href="#L200">200</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
+<a class="jxr_linenumber" name="L201" href="#L201">201</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>"hello"</js>); <jc>// Appends "hello"</jc></em>
+<a class="jxr_linenumber" name="L202" href="#L202">202</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>" "</js>); <jc>// Does nothing</jc></em>
+<a class="jxr_linenumber" name="L203" href="#L203">203</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <jk>null</jk>); <jc>// Does nothing</jc></em>
+<a class="jxr_linenumber" name="L204" href="#L204">204</a> <em class="jxr_javadoccomment"> * appendIfNotBlank(<jv>sb</jv>, <js>"world"</js>); <jc>// Appends "world"</jc></em>
+<a class="jxr_linenumber" name="L205" href="#L205">205</a> <em class="jxr_javadoccomment"> * <jc>// Result: "helloworld"</jc></em>
+<a class="jxr_linenumber" name="L206" href="#L206">206</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L207" href="#L207">207</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
+<a class="jxr_linenumber" name="L208" href="#L208">208</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendIfNotBlank(<jk>null</jk>, <js>"test"</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
+<a class="jxr_linenumber" name="L209" href="#L209">209</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendIfNotBlank(<jk>null</jk>, <js>" "</js>); <jc>// Returns null (no append occurred)</jc></em>
+<a class="jxr_linenumber" name="L210" href="#L210">210</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L211" href="#L211">211</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L212" href="#L212">212</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L213" href="#L213">213</a> <em class="jxr_javadoccomment"> * @param str The string to append if not blank. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L214" href="#L214">214</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
+<a class="jxr_linenumber" name="L215" href="#L215">215</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L216" href="#L216">216</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendIfNotBlank(StringBuilder sb, String str) {
+<a class="jxr_linenumber" name="L217" href="#L217">217</a> <strong class="jxr_keyword">if</strong> (isNotBlank(str)) {
+<a class="jxr_linenumber" name="L218" href="#L218">218</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L219" href="#L219">219</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L220" href="#L220">220</a> sb.append(str);
+<a class="jxr_linenumber" name="L221" href="#L221">221</a> }
+<a class="jxr_linenumber" name="L222" href="#L222">222</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L223" href="#L223">223</a> }
+<a class="jxr_linenumber" name="L224" href="#L224">224</a>
+<a class="jxr_linenumber" name="L225" href="#L225">225</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L226" href="#L226">226</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder if the string is not empty.</em>
+<a class="jxr_linenumber" name="L227" href="#L227">227</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L228" href="#L228">228</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L229" href="#L229">229</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
+<a class="jxr_linenumber" name="L230" href="#L230">230</a> <em class="jxr_javadoccomment"> * If the string is <jk>null</jk> or empty, nothing is appended.</em>
+<a class="jxr_linenumber" name="L231" href="#L231">231</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
+<a class="jxr_linenumber" name="L232" href="#L232">232</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L233" href="#L233">233</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L234" href="#L234">234</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L235" href="#L235">235</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
+<a class="jxr_linenumber" name="L236" href="#L236">236</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>"hello"</js>); <jc>// Appends "hello"</jc></em>
+<a class="jxr_linenumber" name="L237" href="#L237">237</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>""</js>); <jc>// Does nothing</jc></em>
+<a class="jxr_linenumber" name="L238" href="#L238">238</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <jk>null</jk>); <jc>// Does nothing</jc></em>
+<a class="jxr_linenumber" name="L239" href="#L239">239</a> <em class="jxr_javadoccomment"> * appendIfNotEmpty(<jv>sb</jv>, <js>"world"</js>); <jc>// Appends "world"</jc></em>
+<a class="jxr_linenumber" name="L240" href="#L240">240</a> <em class="jxr_javadoccomment"> * <jc>// Result: "helloworld"</jc></em>
+<a class="jxr_linenumber" name="L241" href="#L241">241</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L242" href="#L242">242</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
+<a class="jxr_linenumber" name="L243" href="#L243">243</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendIfNotEmpty(<jk>null</jk>, <js>"test"</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
+<a class="jxr_linenumber" name="L244" href="#L244">244</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendIfNotEmpty(<jk>null</jk>, <jk>null</jk>); <jc>// Returns null (no append occurred)</jc></em>
+<a class="jxr_linenumber" name="L245" href="#L245">245</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L246" href="#L246">246</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L247" href="#L247">247</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L248" href="#L248">248</a> <em class="jxr_javadoccomment"> * @param str The string to append if not empty. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L249" href="#L249">249</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
+<a class="jxr_linenumber" name="L250" href="#L250">250</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L251" href="#L251">251</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendIfNotEmpty(StringBuilder sb, String str) {
+<a class="jxr_linenumber" name="L252" href="#L252">252</a> <strong class="jxr_keyword">if</strong> (isNotEmpty(str)) {
+<a class="jxr_linenumber" name="L253" href="#L253">253</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L254" href="#L254">254</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L255" href="#L255">255</a> sb.append(str);
+<a class="jxr_linenumber" name="L256" href="#L256">256</a> }
+<a class="jxr_linenumber" name="L257" href="#L257">257</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L258" href="#L258">258</a> }
+<a class="jxr_linenumber" name="L259" href="#L259">259</a>
+<a class="jxr_linenumber" name="L260" href="#L260">260</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L261" href="#L261">261</a> <em class="jxr_javadoccomment"> * Appends a string to a StringBuilder with a separator, only adding the separator if the StringBuilder is not empty.</em>
<a class="jxr_linenumber" name="L262" href="#L262">262</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L263" href="#L263">263</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L264" href="#L264">264</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L265" href="#L265">265</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
-<a class="jxr_linenumber" name="L266" href="#L266">266</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"first"</js>, <js>", "</js>); <jc>// Appends "first"</jc></em>
-<a class="jxr_linenumber" name="L267" href="#L267">267</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"second"</js>, <js>", "</js>); <jc>// Appends ", second"</jc></em>
-<a class="jxr_linenumber" name="L268" href="#L268">268</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"third"</js>, <js>", "</js>); <jc>// Appends ", third"</jc></em>
-<a class="jxr_linenumber" name="L269" href="#L269">269</a> <em class="jxr_javadoccomment"> * <jc>// Result: "first, second, third"</jc></em>
-<a class="jxr_linenumber" name="L270" href="#L270">270</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L271" href="#L271">271</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
-<a class="jxr_linenumber" name="L272" href="#L272">272</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendWithSeparator(<jk>null</jk>, <js>"test"</js>, <js>", "</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
-<a class="jxr_linenumber" name="L273" href="#L273">273</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendWithSeparator(<jk>null</jk>, <jk>null</jk>, <js>", "</js>); <jc>// Returns null (no append occurred)</jc></em>
-<a class="jxr_linenumber" name="L274" href="#L274">274</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L275" href="#L275">275</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L276" href="#L276">276</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L277" href="#L277">277</a> <em class="jxr_javadoccomment"> * @param str The string to append. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L278" href="#L278">278</a> <em class="jxr_javadoccomment"> * @param separator The separator to add before the string if the StringBuilder is not empty. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L279" href="#L279">279</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
-<a class="jxr_linenumber" name="L280" href="#L280">280</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L281" href="#L281">281</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendWithSeparator(StringBuilder sb, String str, String separator) {
-<a class="jxr_linenumber" name="L282" href="#L282">282</a> <strong class="jxr_keyword">if</strong> (str != <strong class="jxr_keyword">null</strong>) {
-<a class="jxr_linenumber" name="L283" href="#L283">283</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L284" href="#L284">284</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L285" href="#L285">285</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (sb.length() > 0 && separator != <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L286" href="#L286">286</a> sb.append(separator);
-<a class="jxr_linenumber" name="L287" href="#L287">287</a> sb.append(str);
-<a class="jxr_linenumber" name="L288" href="#L288">288</a> }
-<a class="jxr_linenumber" name="L289" href="#L289">289</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L290" href="#L290">290</a> }
-<a class="jxr_linenumber" name="L291" href="#L291">291</a>
-<a class="jxr_linenumber" name="L292" href="#L292">292</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L293" href="#L293">293</a> <em class="jxr_javadoccomment"> * Adds the appropriate indefinite article ('a' or 'an') before a word.</em>
-<a class="jxr_linenumber" name="L294" href="#L294">294</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L295" href="#L295">295</a> <em class="jxr_javadoccomment"> * <p>Uses a simple vowel-based rule: 'an' if the word starts with a vowel, 'a' otherwise.</em>
-<a class="jxr_linenumber" name="L296" href="#L296">296</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L297" href="#L297">297</a> <em class="jxr_javadoccomment"> * @param subject The word to articlize.</em>
-<a class="jxr_linenumber" name="L298" href="#L298">298</a> <em class="jxr_javadoccomment"> * @return The word with 'a' or 'an' prepended.</em>
-<a class="jxr_linenumber" name="L299" href="#L299">299</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L300" href="#L300">300</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String articlized(String subject) {
-<a class="jxr_linenumber" name="L301" href="#L301">301</a> <strong class="jxr_keyword">var</strong> vowels = AsciiSet.of(<span class="jxr_string">"AEIOUaeiou"</span>);
-<a class="jxr_linenumber" name="L302" href="#L302">302</a> <strong class="jxr_keyword">return</strong> (vowels.contains(subject.charAt(0)) ? <span class="jxr_string">"an "</span> : <span class="jxr_string">"a "</span>) + subject;
-<a class="jxr_linenumber" name="L303" href="#L303">303</a> }
-<a class="jxr_linenumber" name="L304" href="#L304">304</a>
-<a class="jxr_linenumber" name="L305" href="#L305">305</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L306" href="#L306">306</a> <em class="jxr_javadoccomment"> * BASE64-decodes the specified string.</em>
-<a class="jxr_linenumber" name="L307" href="#L307">307</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L308" href="#L308">308</a> <em class="jxr_javadoccomment"> * @param in The BASE-64 encoded string.</em>
-<a class="jxr_linenumber" name="L309" href="#L309">309</a> <em class="jxr_javadoccomment"> * @return The decoded byte array, or null if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L310" href="#L310">310</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L311" href="#L311">311</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] base64Decode(String in) {
-<a class="jxr_linenumber" name="L312" href="#L312">312</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L313" href="#L313">313</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L314" href="#L314">314</a>
-<a class="jxr_linenumber" name="L315" href="#L315">315</a> <strong class="jxr_keyword">var</strong> bIn = in.getBytes(UTF8);
-<a class="jxr_linenumber" name="L316" href="#L316">316</a>
-<a class="jxr_linenumber" name="L317" href="#L317">317</a> assertArg(bIn.length % 4 == 0, <span class="jxr_string">"Invalid BASE64 string length. Must be multiple of 4."</span>);
-<a class="jxr_linenumber" name="L318" href="#L318">318</a>
-<a class="jxr_linenumber" name="L319" href="#L319">319</a> <em class="jxr_comment">// Strip out any trailing '=' filler characters.</em>
-<a class="jxr_linenumber" name="L320" href="#L320">320</a> <strong class="jxr_keyword">var</strong> inLength = bIn.length;
-<a class="jxr_linenumber" name="L321" href="#L321">321</a> <strong class="jxr_keyword">while</strong> (inLength > 0 && bIn[inLength - 1] == '=')
-<a class="jxr_linenumber" name="L322" href="#L322">322</a> inLength--;
-<a class="jxr_linenumber" name="L323" href="#L323">323</a>
-<a class="jxr_linenumber" name="L324" href="#L324">324</a> <strong class="jxr_keyword">var</strong> outLength = (inLength * 3) / 4;
-<a class="jxr_linenumber" name="L325" href="#L325">325</a> <strong class="jxr_keyword">var</strong> out = <strong class="jxr_keyword">new</strong> byte[outLength];
-<a class="jxr_linenumber" name="L326" href="#L326">326</a> <strong class="jxr_keyword">var</strong> iIn = 0;
-<a class="jxr_linenumber" name="L327" href="#L327">327</a> <strong class="jxr_keyword">var</strong> iOut = 0;
-<a class="jxr_linenumber" name="L328" href="#L328">328</a> <strong class="jxr_keyword">while</strong> (iIn < inLength) {
-<a class="jxr_linenumber" name="L329" href="#L329">329</a> <strong class="jxr_keyword">var</strong> i0 = bIn[iIn++];
-<a class="jxr_linenumber" name="L330" href="#L330">330</a> <strong class="jxr_keyword">var</strong> i1 = bIn[iIn++];
-<a class="jxr_linenumber" name="L331" href="#L331">331</a> <strong class="jxr_keyword">var</strong> i2 = iIn < inLength ? bIn[iIn++] : 'A';
-<a class="jxr_linenumber" name="L332" href="#L332">332</a> <strong class="jxr_keyword">var</strong> i3 = iIn < inLength ? bIn[iIn++] : 'A';
-<a class="jxr_linenumber" name="L333" href="#L333">333</a> <strong class="jxr_keyword">var</strong> b0 = BASE64M2[i0];
-<a class="jxr_linenumber" name="L334" href="#L334">334</a> <strong class="jxr_keyword">var</strong> b1 = BASE64M2[i1];
-<a class="jxr_linenumber" name="L335" href="#L335">335</a> <strong class="jxr_keyword">var</strong> b2 = BASE64M2[i2];
-<a class="jxr_linenumber" name="L336" href="#L336">336</a> <strong class="jxr_keyword">var</strong> b3 = BASE64M2[i3];
-<a class="jxr_linenumber" name="L337" href="#L337">337</a> <strong class="jxr_keyword">var</strong> o0 = (b0 << 2) | (b1 >>> 4);
-<a class="jxr_linenumber" name="L338" href="#L338">338</a> <strong class="jxr_keyword">var</strong> o1 = ((b1 & 0xf) << 4) | (b2 >>> 2);
-<a class="jxr_linenumber" name="L339" href="#L339">339</a> <strong class="jxr_keyword">var</strong> o2 = ((b2 & 3) << 6) | b3;
-<a class="jxr_linenumber" name="L340" href="#L340">340</a> out[iOut++] = (byte)o0;
-<a class="jxr_linenumber" name="L341" href="#L341">341</a> <strong class="jxr_keyword">if</strong> (iOut < outLength)
-<a class="jxr_linenumber" name="L342" href="#L342">342</a> out[iOut++] = (byte)o1;
-<a class="jxr_linenumber" name="L343" href="#L343">343</a> <strong class="jxr_keyword">if</strong> (iOut < outLength)
-<a class="jxr_linenumber" name="L344" href="#L344">344</a> out[iOut++] = (byte)o2;
-<a class="jxr_linenumber" name="L345" href="#L345">345</a> }
-<a class="jxr_linenumber" name="L346" href="#L346">346</a> <strong class="jxr_keyword">return</strong> out;
-<a class="jxr_linenumber" name="L347" href="#L347">347</a> }
-<a class="jxr_linenumber" name="L348" href="#L348">348</a>
-<a class="jxr_linenumber" name="L349" href="#L349">349</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L350" href="#L350">350</a> <em class="jxr_javadoccomment"> * Shortcut for calling <c>base64Decode(String)</c> and converting the result to a UTF-8 encoded string.</em>
-<a class="jxr_linenumber" name="L351" href="#L351">351</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L352" href="#L352">352</a> <em class="jxr_javadoccomment"> * @param in The BASE-64 encoded string to decode.</em>
-<a class="jxr_linenumber" name="L353" href="#L353">353</a> <em class="jxr_javadoccomment"> * @return The decoded string.</em>
-<a class="jxr_linenumber" name="L354" href="#L354">354</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L355" href="#L355">355</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String base64DecodeToString(String in) {
-<a class="jxr_linenumber" name="L356" href="#L356">356</a> <strong class="jxr_keyword">var</strong> b = base64Decode(in);
-<a class="jxr_linenumber" name="L357" href="#L357">357</a> <strong class="jxr_keyword">if</strong> (b == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L358" href="#L358">358</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L359" href="#L359">359</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String(b, UTF8);
-<a class="jxr_linenumber" name="L360" href="#L360">360</a> }
-<a class="jxr_linenumber" name="L361" href="#L361">361</a>
-<a class="jxr_linenumber" name="L362" href="#L362">362</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L363" href="#L363">363</a> <em class="jxr_javadoccomment"> * BASE64-encodes the specified byte array.</em>
-<a class="jxr_linenumber" name="L364" href="#L364">364</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L365" href="#L365">365</a> <em class="jxr_javadoccomment"> * @param in The input byte array to convert.</em>
-<a class="jxr_linenumber" name="L366" href="#L366">366</a> <em class="jxr_javadoccomment"> * @return The byte array converted to a BASE-64 encoded string.</em>
-<a class="jxr_linenumber" name="L367" href="#L367">367</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L368" href="#L368">368</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String base64Encode(byte[] in) {
-<a class="jxr_linenumber" name="L369" href="#L369">369</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L370" href="#L370">370</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L371" href="#L371">371</a> <strong class="jxr_keyword">var</strong> outLength = (in.length * 4 + 2) / 3; <em class="jxr_comment">// Output length without padding</em>
-<a class="jxr_linenumber" name="L372" href="#L372">372</a> <strong class="jxr_keyword">var</strong> out = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[((in.length + 2) / 3) * 4]; <em class="jxr_comment">// Length includes padding.</em>
-<a class="jxr_linenumber" name="L373" href="#L373">373</a> <strong class="jxr_keyword">var</strong> iIn = 0;
-<a class="jxr_linenumber" name="L374" href="#L374">374</a> <strong class="jxr_keyword">var</strong> iOut = 0;
-<a class="jxr_linenumber" name="L375" href="#L375">375</a> <strong class="jxr_keyword">while</strong> (iIn < in.length) {
-<a class="jxr_linenumber" name="L376" href="#L376">376</a> <strong class="jxr_keyword">var</strong> i0 = in[iIn++] & 0xff;
-<a class="jxr_linenumber" name="L377" href="#L377">377</a> <strong class="jxr_keyword">var</strong> i1 = iIn < in.length ? in[iIn++] & 0xff : 0;
-<a class="jxr_linenumber" name="L378" href="#L378">378</a> <strong class="jxr_keyword">var</strong> i2 = iIn < in.length ? in[iIn++] & 0xff : 0;
-<a class="jxr_linenumber" name="L379" href="#L379">379</a> <strong class="jxr_keyword">var</strong> o0 = i0 >>> 2;
-<a class="jxr_linenumber" name="L380" href="#L380">380</a> <strong class="jxr_keyword">var</strong> o1 = ((i0 & 3) << 4) | (i1 >>> 4);
-<a class="jxr_linenumber" name="L381" href="#L381">381</a> <strong class="jxr_keyword">var</strong> o2 = ((i1 & 0xf) << 2) | (i2 >>> 6);
-<a class="jxr_linenumber" name="L382" href="#L382">382</a> <strong class="jxr_keyword">var</strong> o3 = i2 & 0x3F;
-<a class="jxr_linenumber" name="L383" href="#L383">383</a> out[iOut++] = BASE64M1[o0];
-<a class="jxr_linenumber" name="L384" href="#L384">384</a> out[iOut++] = BASE64M1[o1];
-<a class="jxr_linenumber" name="L385" href="#L385">385</a> out[iOut] = iOut < outLength ? BASE64M1[o2] : '=';
-<a class="jxr_linenumber" name="L386" href="#L386">386</a> iOut++;
-<a class="jxr_linenumber" name="L387" href="#L387">387</a> out[iOut] = iOut < outLength ? BASE64M1[o3] : '=';
-<a class="jxr_linenumber" name="L388" href="#L388">388</a> iOut++;
-<a class="jxr_linenumber" name="L389" href="#L389">389</a> }
-<a class="jxr_linenumber" name="L390" href="#L390">390</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String(out);
-<a class="jxr_linenumber" name="L391" href="#L391">391</a> }
-<a class="jxr_linenumber" name="L392" href="#L392">392</a>
-<a class="jxr_linenumber" name="L393" href="#L393">393</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L394" href="#L394">394</a> <em class="jxr_javadoccomment"> * Shortcut for calling <code>base64Encode(in.getBytes(<js>"UTF-8"</js>))</code></em>
-<a class="jxr_linenumber" name="L395" href="#L395">395</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L396" href="#L396">396</a> <em class="jxr_javadoccomment"> * @param in The input string to convert.</em>
-<a class="jxr_linenumber" name="L397" href="#L397">397</a> <em class="jxr_javadoccomment"> * @return The string converted to BASE-64 encoding.</em>
-<a class="jxr_linenumber" name="L398" href="#L398">398</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L399" href="#L399">399</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String base64EncodeToString(String in) {
-<a class="jxr_linenumber" name="L400" href="#L400">400</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L401" href="#L401">401</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L402" href="#L402">402</a> <strong class="jxr_keyword">return</strong> base64Encode(in.getBytes(UTF8));
-<a class="jxr_linenumber" name="L403" href="#L403">403</a> }
-<a class="jxr_linenumber" name="L404" href="#L404">404</a>
-<a class="jxr_linenumber" name="L405" href="#L405">405</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L406" href="#L406">406</a> <em class="jxr_javadoccomment"> * Builds a string using a functional approach with a StringBuilder.</em>
-<a class="jxr_linenumber" name="L407" href="#L407">407</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L408" href="#L408">408</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L409" href="#L409">409</a> <em class="jxr_javadoccomment"> * Creates a new StringBuilder, applies the consumer to it, and returns the resulting string.</em>
-<a class="jxr_linenumber" name="L410" href="#L410">410</a> <em class="jxr_javadoccomment"> * This provides a functional way to build strings without manually managing the StringBuilder.</em>
-<a class="jxr_linenumber" name="L411" href="#L411">411</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L412" href="#L412">412</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L413" href="#L413">413</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L414" href="#L414">414</a> <em class="jxr_javadoccomment"> * String <jv>result</jv> = buildString(<jv>sb</jv> -&gt; {</em>
-<a class="jxr_linenumber" name="L415" href="#L415">415</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>"Hello"</js>);</em>
-<a class="jxr_linenumber" name="L416" href="#L416">416</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>" "</js>);</em>
-<a class="jxr_linenumber" name="L417" href="#L417">417</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>"World"</js>);</em>
-<a class="jxr_linenumber" name="L418" href="#L418">418</a> <em class="jxr_javadoccomment"> * });</em>
-<a class="jxr_linenumber" name="L419" href="#L419">419</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello World"</jc></em>
-<a class="jxr_linenumber" name="L420" href="#L420">420</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L421" href="#L421">421</a> <em class="jxr_javadoccomment"> * String <jv>joined</jv> = buildString(<jv>sb</jv> -&gt; {</em>
-<a class="jxr_linenumber" name="L422" href="#L422">422</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"a"</js>, <js>", "</js>);</em>
-<a class="jxr_linenumber" name="L423" href="#L423">423</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"b"</js>, <js>", "</js>);</em>
-<a class="jxr_linenumber" name="L424" href="#L424">424</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"c"</js>, <js>", "</js>);</em>
-<a class="jxr_linenumber" name="L425" href="#L425">425</a> <em class="jxr_javadoccomment"> * });</em>
-<a class="jxr_linenumber" name="L426" href="#L426">426</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "a, b, c"</jc></em>
-<a class="jxr_linenumber" name="L427" href="#L427">427</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L428" href="#L428">428</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L429" href="#L429">429</a> <em class="jxr_javadoccomment"> * @param builder The consumer that builds the string using the provided StringBuilder.</em>
-<a class="jxr_linenumber" name="L430" href="#L430">430</a> <em class="jxr_javadoccomment"> * @return The built string.</em>
-<a class="jxr_linenumber" name="L431" href="#L431">431</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>builder</c> is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L432" href="#L432">432</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L433" href="#L433">433</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String buildString(Consumer<StringBuilder> builder) {
-<a class="jxr_linenumber" name="L434" href="#L434">434</a> assertArgNotNull(<span class="jxr_string">"builder"</span>, builder);
-<a class="jxr_linenumber" name="L435" href="#L435">435</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L436" href="#L436">436</a> builder.accept(sb);
-<a class="jxr_linenumber" name="L437" href="#L437">437</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L438" href="#L438">438</a> }
-<a class="jxr_linenumber" name="L439" href="#L439">439</a>
-<a class="jxr_linenumber" name="L440" href="#L440">440</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L441" href="#L441">441</a> <em class="jxr_javadoccomment"> * Converts a string to camelCase format.</em>
-<a class="jxr_linenumber" name="L442" href="#L442">442</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L443" href="#L443">443</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L444" href="#L444">444</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
-<a class="jxr_linenumber" name="L445" href="#L445">445</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L446" href="#L446">446</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L447" href="#L447">447</a> <em class="jxr_javadoccomment"> * <li>Underscore-separated: "hello_world" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L448" href="#L448">448</a> <em class="jxr_javadoccomment"> * <li>Hyphen-separated: "hello-world" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L449" href="#L449">449</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L450" href="#L450">450</a> <em class="jxr_javadoccomment"> * <li>Already camelCase: "helloWorld" → "helloWorld"</li></em>
-<a class="jxr_linenumber" name="L451" href="#L451">451</a> <em class="jxr_javadoccomment"> * <li>Mixed case: "Hello_World-Test" → "helloWorldTest"</li></em>
-<a class="jxr_linenumber" name="L452" href="#L452">452</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L453" href="#L453">453</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L454" href="#L454">454</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L455" href="#L455">455</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L456" href="#L456">456</a> <em class="jxr_javadoccomment"> * camelCase(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L457" href="#L457">457</a> <em class="jxr_javadoccomment"> * camelCase(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L458" href="#L458">458</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello world"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L459" href="#L459">459</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello_world"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L460" href="#L460">460</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello-world"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L461" href="#L461">461</a> <em class="jxr_javadoccomment"> * camelCase(<js>"HelloWorld"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L462" href="#L462">462</a> <em class="jxr_javadoccomment"> * camelCase(<js>"helloWorld"</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L463" href="#L463">463</a> <em class="jxr_javadoccomment"> * camelCase(<js>" hello world "</js>); <jc>// "helloWorld"</jc></em>
-<a class="jxr_linenumber" name="L464" href="#L464">464</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L465" href="#L465">465</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L466" href="#L466">466</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
-<a class="jxr_linenumber" name="L467" href="#L467">467</a> <em class="jxr_javadoccomment"> * @return The camelCase string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L468" href="#L468">468</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L469" href="#L469">469</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String camelCase(String str) {
-<a class="jxr_linenumber" name="L470" href="#L470">470</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L471" href="#L471">471</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L472" href="#L472">472</a>
-<a class="jxr_linenumber" name="L473" href="#L473">473</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
-<a class="jxr_linenumber" name="L474" href="#L474">474</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
-<a class="jxr_linenumber" name="L475" href="#L475">475</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L476" href="#L476">476</a>
-<a class="jxr_linenumber" name="L477" href="#L477">477</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L478" href="#L478">478</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
-<a class="jxr_linenumber" name="L479" href="#L479">479</a> <strong class="jxr_keyword">var</strong> word = words.get(i);
-<a class="jxr_linenumber" name="L480" href="#L480">480</a> <strong class="jxr_keyword">if</strong> (i == 0) {
-<a class="jxr_linenumber" name="L481" href="#L481">481</a> result.append(uncapitalize(word));
-<a class="jxr_linenumber" name="L482" href="#L482">482</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L483" href="#L483">483</a> result.append(capitalize(word.toLowerCase()));
-<a class="jxr_linenumber" name="L484" href="#L484">484</a> }
-<a class="jxr_linenumber" name="L485" href="#L485">485</a> }
-<a class="jxr_linenumber" name="L486" href="#L486">486</a>
-<a class="jxr_linenumber" name="L487" href="#L487">487</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L488" href="#L488">488</a> }
-<a class="jxr_linenumber" name="L489" href="#L489">489</a>
-<a class="jxr_linenumber" name="L490" href="#L490">490</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L491" href="#L491">491</a> <em class="jxr_javadoccomment"> * Capitalizes the first character of a string.</em>
-<a class="jxr_linenumber" name="L492" href="#L492">492</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L493" href="#L493">493</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L494" href="#L494">494</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L495" href="#L495">495</a> <em class="jxr_javadoccomment"> * capitalize(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L496" href="#L496">496</a> <em class="jxr_javadoccomment"> * capitalize(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L497" href="#L497">497</a> <em class="jxr_javadoccomment"> * capitalize(<js>"hello"</js>); <jc>// "Hello"</jc></em>
-<a class="jxr_linenumber" name="L498" href="#L498">498</a> <em class="jxr_javadoccomment"> * capitalize(<js>"Hello"</js>); <jc>// "Hello"</jc></em>
-<a class="jxr_linenumber" name="L499" href="#L499">499</a> <em class="jxr_javadoccomment"> * capitalize(<js>"HELLO"</js>); <jc>// "HELLO"</jc></em>
-<a class="jxr_linenumber" name="L500" href="#L500">500</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L501" href="#L501">501</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L502" href="#L502">502</a> <em class="jxr_javadoccomment"> * @param str The string to capitalize.</em>
-<a class="jxr_linenumber" name="L503" href="#L503">503</a> <em class="jxr_javadoccomment"> * @return The string with the first character capitalized, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L504" href="#L504">504</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L505" href="#L505">505</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String capitalize(String str) {
-<a class="jxr_linenumber" name="L506" href="#L506">506</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L507" href="#L507">507</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L508" href="#L508">508</a> <strong class="jxr_keyword">return</strong> Character.toUpperCase(str.charAt(0)) + str.substring(1);
-<a class="jxr_linenumber" name="L509" href="#L509">509</a> }
-<a class="jxr_linenumber" name="L510" href="#L510">510</a>
-<a class="jxr_linenumber" name="L511" href="#L511">511</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L512" href="#L512">512</a> <em class="jxr_javadoccomment"> * Converts a comma-delimited string to a list.</em>
-<a class="jxr_linenumber" name="L513" href="#L513">513</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L514" href="#L514">514</a> <em class="jxr_javadoccomment"> * @param s The comma-delimited string.</em>
-<a class="jxr_linenumber" name="L515" href="#L515">515</a> <em class="jxr_javadoccomment"> * @return A new modifiable list. Never <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L516" href="#L516">516</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L517" href="#L517">517</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> cdlToList(String s) {
-<a class="jxr_linenumber" name="L518" href="#L518">518</a> <strong class="jxr_keyword">return</strong> split(s);
-<a class="jxr_linenumber" name="L519" href="#L519">519</a> }
-<a class="jxr_linenumber" name="L520" href="#L520">520</a>
-<a class="jxr_linenumber" name="L521" href="#L521">521</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L522" href="#L522">522</a> <em class="jxr_javadoccomment"> * Converts a comma-delimited string to a set.</em>
-<a class="jxr_linenumber" name="L523" href="#L523">523</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L524" href="#L524">524</a> <em class="jxr_javadoccomment"> * @param s The comma-delimited string.</em>
-<a class="jxr_linenumber" name="L525" href="#L525">525</a> <em class="jxr_javadoccomment"> * @return A new {@link LinkedHashSet}. Never <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L526" href="#L526">526</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L527" href="#L527">527</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> LinkedHashSet<String> cdlToSet(String s) {
-<a class="jxr_linenumber" name="L528" href="#L528">528</a> <strong class="jxr_keyword">return</strong> split(s).stream().collect(Collectors.toCollection(LinkedHashSet::<strong class="jxr_keyword">new</strong>));
-<a class="jxr_linenumber" name="L529" href="#L529">529</a> }
-<a class="jxr_linenumber" name="L530" href="#L530">530</a>
-<a class="jxr_linenumber" name="L531" href="#L531">531</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L532" href="#L532">532</a> <em class="jxr_javadoccomment"> * Returns the character at the specified index in the string without throwing exceptions.</em>
-<a class="jxr_linenumber" name="L533" href="#L533">533</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L534" href="#L534">534</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L535" href="#L535">535</a> <em class="jxr_javadoccomment"> * This is a null-safe and bounds-safe version of {@link String#charAt(int)}.</em>
-<a class="jxr_linenumber" name="L536" href="#L536">536</a> <em class="jxr_javadoccomment"> * Returns <c>0</c> (null character) if:</em>
-<a class="jxr_linenumber" name="L537" href="#L537">537</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L538" href="#L538">538</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L539" href="#L539">539</a> <em class="jxr_javadoccomment"> * <li>The index is negative</li></em>
-<a class="jxr_linenumber" name="L540" href="#L540">540</a> <em class="jxr_javadoccomment"> * <li>The index is greater than or equal to the string length</li></em>
-<a class="jxr_linenumber" name="L541" href="#L541">541</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L542" href="#L542">542</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L543" href="#L543">543</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L544" href="#L544">544</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L545" href="#L545">545</a> <em class="jxr_javadoccomment"> * charAt(<js>"Hello"</js>, 0); <jc>// 'H'</jc></em>
-<a class="jxr_linenumber" name="L546" href="#L546">546</a> <em class="jxr_javadoccomment"> * charAt(<js>"Hello"</js>, 4); <jc>// 'o'</jc></em>
-<a class="jxr_linenumber" name="L547" href="#L547">547</a> <em class="jxr_javadoccomment"> * charAt(<js>"Hello"</js>, 5); <jc>// 0 (out of bounds)</jc></em>
-<a class="jxr_linenumber" name="L548" href="#L548">548</a> <em class="jxr_javadoccomment"> * charAt(<js>"Hello"</js>, -1); <jc>// 0 (out of bounds)</jc></em>
-<a class="jxr_linenumber" name="L549" href="#L549">549</a> <em class="jxr_javadoccomment"> * charAt(<jk>null</jk>, 0); <jc>// 0 (null string)</jc></em>
-<a class="jxr_linenumber" name="L550" href="#L550">550</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L551" href="#L551">551</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L552" href="#L552">552</a> <em class="jxr_javadoccomment"> * @param s The string.</em>
-<a class="jxr_linenumber" name="L553" href="#L553">553</a> <em class="jxr_javadoccomment"> * @param i The index position.</em>
-<a class="jxr_linenumber" name="L554" href="#L554">554</a> <em class="jxr_javadoccomment"> * @return The character at the specified index, or <c>0</c> if the index is out-of-range or the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L555" href="#L555">555</a> <em class="jxr_javadoccomment"> * @see String#charAt(int)</em>
-<a class="jxr_linenumber" name="L556" href="#L556">556</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L557" href="#L557">557</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> charAt(String s, <strong class="jxr_keyword">int</strong> i) {
-<a class="jxr_linenumber" name="L558" href="#L558">558</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || i < 0 || i >= s.length())
-<a class="jxr_linenumber" name="L559" href="#L559">559</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L560" href="#L560">560</a> <strong class="jxr_keyword">return</strong> s.charAt(i);
-<a class="jxr_linenumber" name="L561" href="#L561">561</a> }
-<a class="jxr_linenumber" name="L562" href="#L562">562</a>
-<a class="jxr_linenumber" name="L563" href="#L563">563</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L564" href="#L564">564</a> <em class="jxr_javadoccomment"> * Cleans a string by removing control characters and normalizing whitespace.</em>
-<a class="jxr_linenumber" name="L565" href="#L565">565</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L566" href="#L566">566</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L567" href="#L567">567</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L568" href="#L568">568</a> <em class="jxr_javadoccomment"> * clean(<js>"hello\u0000\u0001world"</js>); <jc>// "hello world"</jc></em>
-<a class="jxr_linenumber" name="L569" href="#L569">569</a> <em class="jxr_javadoccomment"> * clean(<js>"hello \t\n world"</js>); <jc>// "hello world"</jc></em>
-<a class="jxr_linenumber" name="L570" href="#L570">570</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L263" href="#L263">263</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L264" href="#L264">264</a> <em class="jxr_javadoccomment"> * Returns the same StringBuilder instance for method chaining.</em>
+<a class="jxr_linenumber" name="L265" href="#L265">265</a> <em class="jxr_javadoccomment"> * If the StringBuilder is empty, only the string is appended (no separator).</em>
+<a class="jxr_linenumber" name="L266" href="#L266">266</a> <em class="jxr_javadoccomment"> * If the StringBuilder is not empty, the separator is appended first, then the string.</em>
+<a class="jxr_linenumber" name="L267" href="#L267">267</a> <em class="jxr_javadoccomment"> * If <c>sb</c> is <jk>null</jk> and an append is going to occur, a new StringBuilder is automatically created.</em>
+<a class="jxr_linenumber" name="L268" href="#L268">268</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L269" href="#L269">269</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L270" href="#L270">270</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L271" href="#L271">271</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb</jv> = <jk>new</jk> StringBuilder();</em>
+<a class="jxr_linenumber" name="L272" href="#L272">272</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"first"</js>, <js>", "</js>); <jc>// Appends "first"</jc></em>
+<a class="jxr_linenumber" name="L273" href="#L273">273</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"second"</js>, <js>", "</js>); <jc>// Appends ", second"</jc></em>
+<a class="jxr_linenumber" name="L274" href="#L274">274</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"third"</js>, <js>", "</js>); <jc>// Appends ", third"</jc></em>
+<a class="jxr_linenumber" name="L275" href="#L275">275</a> <em class="jxr_javadoccomment"> * <jc>// Result: "first, second, third"</jc></em>
+<a class="jxr_linenumber" name="L276" href="#L276">276</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L277" href="#L277">277</a> <em class="jxr_javadoccomment"> * <jc>// Auto-create StringBuilder if null and append occurs</jc></em>
+<a class="jxr_linenumber" name="L278" href="#L278">278</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb2</jv> = appendWithSeparator(<jk>null</jk>, <js>"test"</js>, <js>", "</js>); <jc>// Creates new StringBuilder with "test"</jc></em>
+<a class="jxr_linenumber" name="L279" href="#L279">279</a> <em class="jxr_javadoccomment"> * StringBuilder <jv>sb3</jv> = appendWithSeparator(<jk>null</jk>, <jk>null</jk>, <js>", "</js>); <jc>// Returns null (no append occurred)</jc></em>
+<a class="jxr_linenumber" name="L280" href="#L280">280</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L281" href="#L281">281</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L282" href="#L282">282</a> <em class="jxr_javadoccomment"> * @param sb The StringBuilder to append to. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L283" href="#L283">283</a> <em class="jxr_javadoccomment"> * @param str The string to append. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L284" href="#L284">284</a> <em class="jxr_javadoccomment"> * @param separator The separator to add before the string if the StringBuilder is not empty. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L285" href="#L285">285</a> <em class="jxr_javadoccomment"> * @return The same StringBuilder instance for method chaining, or a new StringBuilder if <c>sb</c> was <jk>null</jk> and an append occurred, or <jk>null</jk> if <c>sb</c> was <jk>null</jk> and no append occurred.</em>
+<a class="jxr_linenumber" name="L286" href="#L286">286</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L287" href="#L287">287</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder appendWithSeparator(StringBuilder sb, String str, String separator) {
+<a class="jxr_linenumber" name="L288" href="#L288">288</a> <strong class="jxr_keyword">if</strong> (str != <strong class="jxr_keyword">null</strong>) {
+<a class="jxr_linenumber" name="L289" href="#L289">289</a> <strong class="jxr_keyword">if</strong> (sb == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L290" href="#L290">290</a> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L291" href="#L291">291</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (sb.length() > 0 && separator != <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L292" href="#L292">292</a> sb.append(separator);
+<a class="jxr_linenumber" name="L293" href="#L293">293</a> sb.append(str);
+<a class="jxr_linenumber" name="L294" href="#L294">294</a> }
+<a class="jxr_linenumber" name="L295" href="#L295">295</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L296" href="#L296">296</a> }
+<a class="jxr_linenumber" name="L297" href="#L297">297</a>
+<a class="jxr_linenumber" name="L298" href="#L298">298</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L299" href="#L299">299</a> <em class="jxr_javadoccomment"> * Adds the appropriate indefinite article ('a' or 'an') before a word.</em>
+<a class="jxr_linenumber" name="L300" href="#L300">300</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L301" href="#L301">301</a> <em class="jxr_javadoccomment"> * <p>Uses a simple vowel-based rule: 'an' if the word starts with a vowel, 'a' otherwise.</em>
+<a class="jxr_linenumber" name="L302" href="#L302">302</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L303" href="#L303">303</a> <em class="jxr_javadoccomment"> * @param subject The word to articlize.</em>
+<a class="jxr_linenumber" name="L304" href="#L304">304</a> <em class="jxr_javadoccomment"> * @return The word with 'a' or 'an' prepended.</em>
+<a class="jxr_linenumber" name="L305" href="#L305">305</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L306" href="#L306">306</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String articlized(String subject) {
+<a class="jxr_linenumber" name="L307" href="#L307">307</a> <strong class="jxr_keyword">var</strong> vowels = AsciiSet.of(<span class="jxr_string">"AEIOUaeiou"</span>);
+<a class="jxr_linenumber" name="L308" href="#L308">308</a> <strong class="jxr_keyword">return</strong> (vowels.contains(subject.charAt(0)) ? <span class="jxr_string">"an "</span> : <span class="jxr_string">"a "</span>) + subject;
+<a class="jxr_linenumber" name="L309" href="#L309">309</a> }
+<a class="jxr_linenumber" name="L310" href="#L310">310</a>
+<a class="jxr_linenumber" name="L311" href="#L311">311</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L312" href="#L312">312</a> <em class="jxr_javadoccomment"> * BASE64-decodes the specified string.</em>
+<a class="jxr_linenumber" name="L313" href="#L313">313</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L314" href="#L314">314</a> <em class="jxr_javadoccomment"> * @param in The BASE-64 encoded string.</em>
+<a class="jxr_linenumber" name="L315" href="#L315">315</a> <em class="jxr_javadoccomment"> * @return The decoded byte array, or null if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L316" href="#L316">316</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L317" href="#L317">317</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] base64Decode(String in) {
+<a class="jxr_linenumber" name="L318" href="#L318">318</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L319" href="#L319">319</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L320" href="#L320">320</a>
+<a class="jxr_linenumber" name="L321" href="#L321">321</a> <strong class="jxr_keyword">var</strong> bIn = in.getBytes(UTF8);
+<a class="jxr_linenumber" name="L322" href="#L322">322</a>
+<a class="jxr_linenumber" name="L323" href="#L323">323</a> assertArg(bIn.length % 4 == 0, <span class="jxr_string">"Invalid BASE64 string length. Must be multiple of 4."</span>);
+<a class="jxr_linenumber" name="L324" href="#L324">324</a>
+<a class="jxr_linenumber" name="L325" href="#L325">325</a> <em class="jxr_comment">// Strip out any trailing '=' filler characters.</em>
+<a class="jxr_linenumber" name="L326" href="#L326">326</a> <strong class="jxr_keyword">var</strong> inLength = bIn.length;
+<a class="jxr_linenumber" name="L327" href="#L327">327</a> <strong class="jxr_keyword">while</strong> (inLength > 0 && bIn[inLength - 1] == '=')
+<a class="jxr_linenumber" name="L328" href="#L328">328</a> inLength--;
+<a class="jxr_linenumber" name="L329" href="#L329">329</a>
+<a class="jxr_linenumber" name="L330" href="#L330">330</a> <strong class="jxr_keyword">var</strong> outLength = (inLength * 3) / 4;
+<a class="jxr_linenumber" name="L331" href="#L331">331</a> <strong class="jxr_keyword">var</strong> out = <strong class="jxr_keyword">new</strong> byte[outLength];
+<a class="jxr_linenumber" name="L332" href="#L332">332</a> <strong class="jxr_keyword">var</strong> iIn = 0;
+<a class="jxr_linenumber" name="L333" href="#L333">333</a> <strong class="jxr_keyword">var</strong> iOut = 0;
+<a class="jxr_linenumber" name="L334" href="#L334">334</a> <strong class="jxr_keyword">while</strong> (iIn < inLength) {
+<a class="jxr_linenumber" name="L335" href="#L335">335</a> <strong class="jxr_keyword">var</strong> i0 = bIn[iIn++];
+<a class="jxr_linenumber" name="L336" href="#L336">336</a> <strong class="jxr_keyword">var</strong> i1 = bIn[iIn++];
+<a class="jxr_linenumber" name="L337" href="#L337">337</a> <strong class="jxr_keyword">var</strong> i2 = iIn < inLength ? bIn[iIn++] : 'A';
+<a class="jxr_linenumber" name="L338" href="#L338">338</a> <strong class="jxr_keyword">var</strong> i3 = iIn < inLength ? bIn[iIn++] : 'A';
+<a class="jxr_linenumber" name="L339" href="#L339">339</a> <strong class="jxr_keyword">var</strong> b0 = BASE64M2[i0];
+<a class="jxr_linenumber" name="L340" href="#L340">340</a> <strong class="jxr_keyword">var</strong> b1 = BASE64M2[i1];
+<a class="jxr_linenumber" name="L341" href="#L341">341</a> <strong class="jxr_keyword">var</strong> b2 = BASE64M2[i2];
+<a class="jxr_linenumber" name="L342" href="#L342">342</a> <strong class="jxr_keyword">var</strong> b3 = BASE64M2[i3];
+<a class="jxr_linenumber" name="L343" href="#L343">343</a> <strong class="jxr_keyword">var</strong> o0 = (b0 << 2) | (b1 >>> 4);
+<a class="jxr_linenumber" name="L344" href="#L344">344</a> <strong class="jxr_keyword">var</strong> o1 = ((b1 & 0xf) << 4) | (b2 >>> 2);
+<a class="jxr_linenumber" name="L345" href="#L345">345</a> <strong class="jxr_keyword">var</strong> o2 = ((b2 & 3) << 6) | b3;
+<a class="jxr_linenumber" name="L346" href="#L346">346</a> out[iOut++] = (byte)o0;
+<a class="jxr_linenumber" name="L347" href="#L347">347</a> <strong class="jxr_keyword">if</strong> (iOut < outLength)
+<a class="jxr_linenumber" name="L348" href="#L348">348</a> out[iOut++] = (byte)o1;
+<a class="jxr_linenumber" name="L349" href="#L349">349</a> <strong class="jxr_keyword">if</strong> (iOut < outLength)
+<a class="jxr_linenumber" name="L350" href="#L350">350</a> out[iOut++] = (byte)o2;
+<a class="jxr_linenumber" name="L351" href="#L351">351</a> }
+<a class="jxr_linenumber" name="L352" href="#L352">352</a> <strong class="jxr_keyword">return</strong> out;
+<a class="jxr_linenumber" name="L353" href="#L353">353</a> }
+<a class="jxr_linenumber" name="L354" href="#L354">354</a>
+<a class="jxr_linenumber" name="L355" href="#L355">355</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L356" href="#L356">356</a> <em class="jxr_javadoccomment"> * Shortcut for calling <c>base64Decode(String)</c> and converting the result to a UTF-8 encoded string.</em>
+<a class="jxr_linenumber" name="L357" href="#L357">357</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L358" href="#L358">358</a> <em class="jxr_javadoccomment"> * @param in The BASE-64 encoded string to decode.</em>
+<a class="jxr_linenumber" name="L359" href="#L359">359</a> <em class="jxr_javadoccomment"> * @return The decoded string.</em>
+<a class="jxr_linenumber" name="L360" href="#L360">360</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L361" href="#L361">361</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String base64DecodeToString(String in) {
+<a class="jxr_linenumber" name="L362" href="#L362">362</a> <strong class="jxr_keyword">var</strong> b = base64Decode(in);
+<a class="jxr_linenumber" name="L363" href="#L363">363</a> <strong class="jxr_keyword">if</strong> (b == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L364" href="#L364">364</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L365" href="#L365">365</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String(b, UTF8);
+<a class="jxr_linenumber" name="L366" href="#L366">366</a> }
+<a class="jxr_linenumber" name="L367" href="#L367">367</a>
+<a class="jxr_linenumber" name="L368" href="#L368">368</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L369" href="#L369">369</a> <em class="jxr_javadoccomment"> * BASE64-encodes the specified byte array.</em>
+<a class="jxr_linenumber" name="L370" href="#L370">370</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L371" href="#L371">371</a> <em class="jxr_javadoccomment"> * @param in The input byte array to convert.</em>
+<a class="jxr_linenumber" name="L372" href="#L372">372</a> <em class="jxr_javadoccomment"> * @return The byte array converted to a BASE-64 encoded string.</em>
+<a class="jxr_linenumber" name="L373" href="#L373">373</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L374" href="#L374">374</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String base64Encode(byte[] in) {
+<a class="jxr_linenumber" name="L375" href="#L375">375</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L376" href="#L376">376</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L377" href="#L377">377</a> <strong class="jxr_keyword">var</strong> outLength = (in.length * 4 + 2) / 3; <em class="jxr_comment">// Output length without padding</em>
+<a class="jxr_linenumber" name="L378" href="#L378">378</a> <strong class="jxr_keyword">var</strong> out = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">char</strong>[((in.length + 2) / 3) * 4]; <em class="jxr_comment">// Length includes padding.</em>
+<a class="jxr_linenumber" name="L379" href="#L379">379</a> <strong class="jxr_keyword">var</strong> iIn = 0;
+<a class="jxr_linenumber" name="L380" href="#L380">380</a> <strong class="jxr_keyword">var</strong> iOut = 0;
+<a class="jxr_linenumber" name="L381" href="#L381">381</a> <strong class="jxr_keyword">while</strong> (iIn < in.length) {
+<a class="jxr_linenumber" name="L382" href="#L382">382</a> <strong class="jxr_keyword">var</strong> i0 = in[iIn++] & 0xff;
+<a class="jxr_linenumber" name="L383" href="#L383">383</a> <strong class="jxr_keyword">var</strong> i1 = iIn < in.length ? in[iIn++] & 0xff : 0;
+<a class="jxr_linenumber" name="L384" href="#L384">384</a> <strong class="jxr_keyword">var</strong> i2 = iIn < in.length ? in[iIn++] & 0xff : 0;
+<a class="jxr_linenumber" name="L385" href="#L385">385</a> <strong class="jxr_keyword">var</strong> o0 = i0 >>> 2;
+<a class="jxr_linenumber" name="L386" href="#L386">386</a> <strong class="jxr_keyword">var</strong> o1 = ((i0 & 3) << 4) | (i1 >>> 4);
+<a class="jxr_linenumber" name="L387" href="#L387">387</a> <strong class="jxr_keyword">var</strong> o2 = ((i1 & 0xf) << 2) | (i2 >>> 6);
+<a class="jxr_linenumber" name="L388" href="#L388">388</a> <strong class="jxr_keyword">var</strong> o3 = i2 & 0x3F;
+<a class="jxr_linenumber" name="L389" href="#L389">389</a> out[iOut++] = BASE64M1[o0];
+<a class="jxr_linenumber" name="L390" href="#L390">390</a> out[iOut++] = BASE64M1[o1];
+<a class="jxr_linenumber" name="L391" href="#L391">391</a> out[iOut] = iOut < outLength ? BASE64M1[o2] : '=';
+<a class="jxr_linenumber" name="L392" href="#L392">392</a> iOut++;
+<a class="jxr_linenumber" name="L393" href="#L393">393</a> out[iOut] = iOut < outLength ? BASE64M1[o3] : '=';
+<a class="jxr_linenumber" name="L394" href="#L394">394</a> iOut++;
+<a class="jxr_linenumber" name="L395" href="#L395">395</a> }
+<a class="jxr_linenumber" name="L396" href="#L396">396</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String(out);
+<a class="jxr_linenumber" name="L397" href="#L397">397</a> }
+<a class="jxr_linenumber" name="L398" href="#L398">398</a>
+<a class="jxr_linenumber" name="L399" href="#L399">399</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L400" href="#L400">400</a> <em class="jxr_javadoccomment"> * Shortcut for calling <code>base64Encode(in.getBytes(<js>"UTF-8"</js>))</code></em>
+<a class="jxr_linenumber" name="L401" href="#L401">401</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L402" href="#L402">402</a> <em class="jxr_javadoccomment"> * @param in The input string to convert.</em>
+<a class="jxr_linenumber" name="L403" href="#L403">403</a> <em class="jxr_javadoccomment"> * @return The string converted to BASE-64 encoding.</em>
+<a class="jxr_linenumber" name="L404" href="#L404">404</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L405" href="#L405">405</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String base64EncodeToString(String in) {
+<a class="jxr_linenumber" name="L406" href="#L406">406</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L407" href="#L407">407</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L408" href="#L408">408</a> <strong class="jxr_keyword">return</strong> base64Encode(in.getBytes(UTF8));
+<a class="jxr_linenumber" name="L409" href="#L409">409</a> }
+<a class="jxr_linenumber" name="L410" href="#L410">410</a>
+<a class="jxr_linenumber" name="L411" href="#L411">411</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L412" href="#L412">412</a> <em class="jxr_javadoccomment"> * Builds a string using a functional approach with a StringBuilder.</em>
+<a class="jxr_linenumber" name="L413" href="#L413">413</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L414" href="#L414">414</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L415" href="#L415">415</a> <em class="jxr_javadoccomment"> * Creates a new StringBuilder, applies the consumer to it, and returns the resulting string.</em>
+<a class="jxr_linenumber" name="L416" href="#L416">416</a> <em class="jxr_javadoccomment"> * This provides a functional way to build strings without manually managing the StringBuilder.</em>
+<a class="jxr_linenumber" name="L417" href="#L417">417</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L418" href="#L418">418</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L419" href="#L419">419</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L420" href="#L420">420</a> <em class="jxr_javadoccomment"> * String <jv>result</jv> = buildString(<jv>sb</jv> -&gt; {</em>
+<a class="jxr_linenumber" name="L421" href="#L421">421</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>"Hello"</js>);</em>
+<a class="jxr_linenumber" name="L422" href="#L422">422</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>" "</js>);</em>
+<a class="jxr_linenumber" name="L423" href="#L423">423</a> <em class="jxr_javadoccomment"> * <jv>sb</jv>.append(<js>"World"</js>);</em>
+<a class="jxr_linenumber" name="L424" href="#L424">424</a> <em class="jxr_javadoccomment"> * });</em>
+<a class="jxr_linenumber" name="L425" href="#L425">425</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello World"</jc></em>
+<a class="jxr_linenumber" name="L426" href="#L426">426</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L427" href="#L427">427</a> <em class="jxr_javadoccomment"> * String <jv>joined</jv> = buildString(<jv>sb</jv> -&gt; {</em>
+<a class="jxr_linenumber" name="L428" href="#L428">428</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"a"</js>, <js>", "</js>);</em>
+<a class="jxr_linenumber" name="L429" href="#L429">429</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"b"</js>, <js>", "</js>);</em>
+<a class="jxr_linenumber" name="L430" href="#L430">430</a> <em class="jxr_javadoccomment"> * appendWithSeparator(<jv>sb</jv>, <js>"c"</js>, <js>", "</js>);</em>
+<a class="jxr_linenumber" name="L431" href="#L431">431</a> <em class="jxr_javadoccomment"> * });</em>
+<a class="jxr_linenumber" name="L432" href="#L432">432</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "a, b, c"</jc></em>
+<a class="jxr_linenumber" name="L433" href="#L433">433</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L434" href="#L434">434</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L435" href="#L435">435</a> <em class="jxr_javadoccomment"> * @param builder The consumer that builds the string using the provided StringBuilder.</em>
+<a class="jxr_linenumber" name="L436" href="#L436">436</a> <em class="jxr_javadoccomment"> * @return The built string.</em>
+<a class="jxr_linenumber" name="L437" href="#L437">437</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If <c>builder</c> is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L438" href="#L438">438</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L439" href="#L439">439</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String buildString(Consumer<StringBuilder> builder) {
+<a class="jxr_linenumber" name="L440" href="#L440">440</a> assertArgNotNull(<span class="jxr_string">"builder"</span>, builder);
+<a class="jxr_linenumber" name="L441" href="#L441">441</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L442" href="#L442">442</a> builder.accept(sb);
+<a class="jxr_linenumber" name="L443" href="#L443">443</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L444" href="#L444">444</a> }
+<a class="jxr_linenumber" name="L445" href="#L445">445</a>
+<a class="jxr_linenumber" name="L446" href="#L446">446</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L447" href="#L447">447</a> <em class="jxr_javadoccomment"> * Converts a string to camelCase format.</em>
+<a class="jxr_linenumber" name="L448" href="#L448">448</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L449" href="#L449">449</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L450" href="#L450">450</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
+<a class="jxr_linenumber" name="L451" href="#L451">451</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L452" href="#L452">452</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L453" href="#L453">453</a> <em class="jxr_javadoccomment"> * <li>Underscore-separated: "hello_world" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L454" href="#L454">454</a> <em class="jxr_javadoccomment"> * <li>Hyphen-separated: "hello-world" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L455" href="#L455">455</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L456" href="#L456">456</a> <em class="jxr_javadoccomment"> * <li>Already camelCase: "helloWorld" → "helloWorld"</li></em>
+<a class="jxr_linenumber" name="L457" href="#L457">457</a> <em class="jxr_javadoccomment"> * <li>Mixed case: "Hello_World-Test" → "helloWorldTest"</li></em>
+<a class="jxr_linenumber" name="L458" href="#L458">458</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L459" href="#L459">459</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L460" href="#L460">460</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L461" href="#L461">461</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L462" href="#L462">462</a> <em class="jxr_javadoccomment"> * camelCase(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L463" href="#L463">463</a> <em class="jxr_javadoccomment"> * camelCase(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L464" href="#L464">464</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello world"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L465" href="#L465">465</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello_world"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L466" href="#L466">466</a> <em class="jxr_javadoccomment"> * camelCase(<js>"hello-world"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L467" href="#L467">467</a> <em class="jxr_javadoccomment"> * camelCase(<js>"HelloWorld"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L468" href="#L468">468</a> <em class="jxr_javadoccomment"> * camelCase(<js>"helloWorld"</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L469" href="#L469">469</a> <em class="jxr_javadoccomment"> * camelCase(<js>" hello world "</js>); <jc>// "helloWorld"</jc></em>
+<a class="jxr_linenumber" name="L470" href="#L470">470</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L471" href="#L471">471</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L472" href="#L472">472</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
+<a class="jxr_linenumber" name="L473" href="#L473">473</a> <em class="jxr_javadoccomment"> * @return The camelCase string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L474" href="#L474">474</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L475" href="#L475">475</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String camelCase(String str) {
+<a class="jxr_linenumber" name="L476" href="#L476">476</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L477" href="#L477">477</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L478" href="#L478">478</a>
+<a class="jxr_linenumber" name="L479" href="#L479">479</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
+<a class="jxr_linenumber" name="L480" href="#L480">480</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
+<a class="jxr_linenumber" name="L481" href="#L481">481</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L482" href="#L482">482</a>
+<a class="jxr_linenumber" name="L483" href="#L483">483</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L484" href="#L484">484</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
+<a class="jxr_linenumber" name="L485" href="#L485">485</a> <strong class="jxr_keyword">var</strong> word = words.get(i);
+<a class="jxr_linenumber" name="L486" href="#L486">486</a> <strong class="jxr_keyword">if</strong> (i == 0) {
+<a class="jxr_linenumber" name="L487" href="#L487">487</a> result.append(uncapitalize(word));
+<a class="jxr_linenumber" name="L488" href="#L488">488</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L489" href="#L489">489</a> result.append(capitalize(word.toLowerCase()));
+<a class="jxr_linenumber" name="L490" href="#L490">490</a> }
+<a class="jxr_linenumber" name="L491" href="#L491">491</a> }
+<a class="jxr_linenumber" name="L492" href="#L492">492</a>
+<a class="jxr_linenumber" name="L493" href="#L493">493</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L494" href="#L494">494</a> }
+<a class="jxr_linenumber" name="L495" href="#L495">495</a>
+<a class="jxr_linenumber" name="L496" href="#L496">496</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L497" href="#L497">497</a> <em class="jxr_javadoccomment"> * Capitalizes the first character of a string.</em>
+<a class="jxr_linenumber" name="L498" href="#L498">498</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L499" href="#L499">499</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L500" href="#L500">500</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L501" href="#L501">501</a> <em class="jxr_javadoccomment"> * capitalize(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L502" href="#L502">502</a> <em class="jxr_javadoccomment"> * capitalize(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L503" href="#L503">503</a> <em class="jxr_javadoccomment"> * capitalize(<js>"hello"</js>); <jc>// "Hello"</jc></em>
+<a class="jxr_linenumber" name="L504" href="#L504">504</a> <em class="jxr_javadoccomment"> * capitalize(<js>"Hello"</js>); <jc>// "Hello"</jc></em>
+<a class="jxr_linenumber" name="L505" href="#L505">505</a> <em class="jxr_javadoccomment"> * capitalize(<js>"HELLO"</js>); <jc>// "HELLO"</jc></em>
+<a class="jxr_linenumber" name="L506" href="#L506">506</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L507" href="#L507">507</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L508" href="#L508">508</a> <em class="jxr_javadoccomment"> * @param str The string to capitalize.</em>
+<a class="jxr_linenumber" name="L509" href="#L509">509</a> <em class="jxr_javadoccomment"> * @return The string with the first character capitalized, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L510" href="#L510">510</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L511" href="#L511">511</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String capitalize(String str) {
+<a class="jxr_linenumber" name="L512" href="#L512">512</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L513" href="#L513">513</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L514" href="#L514">514</a> <strong class="jxr_keyword">return</strong> Character.toUpperCase(str.charAt(0)) + str.substring(1);
+<a class="jxr_linenumber" name="L515" href="#L515">515</a> }
+<a class="jxr_linenumber" name="L516" href="#L516">516</a>
+<a class="jxr_linenumber" name="L517" href="#L517">517</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L518" href="#L518">518</a> <em class="jxr_javadoccomment"> * Converts a comma-delimited string to a list.</em>
+<a class="jxr_linenumber" name="L519" href="#L519">519</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L520" href="#L520">520</a> <em class="jxr_javadoccomment"> * @param s The comma-delimited string.</em>
+<a class="jxr_linenumber" name="L521" href="#L521">521</a> <em class="jxr_javadoccomment"> * @return A new modifiable list. Never <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L522" href="#L522">522</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L523" href="#L523">523</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> cdlToList(String s) {
+<a class="jxr_linenumber" name="L524" href="#L524">524</a> <strong class="jxr_keyword">return</strong> split(s);
+<a class="jxr_linenumber" name="L525" href="#L525">525</a> }
+<a class="jxr_linenumber" name="L526" href="#L526">526</a>
+<a class="jxr_linenumber" name="L527" href="#L527">527</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L528" href="#L528">528</a> <em class="jxr_javadoccomment"> * Converts a comma-delimited string to a set.</em>
+<a class="jxr_linenumber" name="L529" href="#L529">529</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L530" href="#L530">530</a> <em class="jxr_javadoccomment"> * @param s The comma-delimited string.</em>
+<a class="jxr_linenumber" name="L531" href="#L531">531</a> <em class="jxr_javadoccomment"> * @return A new {@link LinkedHashSet}. Never <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L532" href="#L532">532</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L533" href="#L533">533</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> LinkedHashSet<String> cdlToSet(String s) {
+<a class="jxr_linenumber" name="L534" href="#L534">534</a> <strong class="jxr_keyword">return</strong> split(s).stream().collect(Collectors.toCollection(LinkedHashSet::<strong class="jxr_keyword">new</strong>));
+<a class="jxr_linenumber" name="L535" href="#L535">535</a> }
+<a class="jxr_linenumber" name="L536" href="#L536">536</a>
+<a class="jxr_linenumber" name="L537" href="#L537">537</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L538" href="#L538">538</a> <em class="jxr_javadoccomment"> * Returns the character at the specified index in the string without throwing exceptions.</em>
+<a class="jxr_linenumber" name="L539" href="#L539">539</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L540" href="#L540">540</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L541" href="#L541">541</a> <em class="jxr_javadoccomment"> * This is a null-safe and bounds-safe version of {@link String#charAt(int)}.</em>
+<a class="jxr_linenumber" name="L542" href="#L542">542</a> <em class="jxr_javadoccomment"> * Returns <c>0</c> (null character) if:</em>
+<a class="jxr_linenumber" name="L543" href="#L543">543</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L544" href="#L544">544</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L545" href="#L545">545</a> <em class="jxr_javadoccomment"> * <li>The index is negative</li></em>
+<a class="jxr_linenumber" name="L546" href="#L546">546</a> <em class="jxr_javadoccomment"> * <li>The index is greater than or equal to the string length</li></em>
+<a class="jxr_linenumber" name="L547" href="#L547">547</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L548" href="#L548">548</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L549" href="#L549">549</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L550" href="#L550">550</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L551" href="#L551">551</a> <em class="jxr_javadoccomment"> * charAt(<js>"Hello"</js>, 0); <jc>// 'H'</jc></em>
+<a class="jxr_linenumber" name="L552" href="#L552">552</a> <em class="jxr_javadoccomment"> * charAt(<js>"Hello"</js>, 4); <jc>// 'o'</jc></em>
+<a class="jxr_linenumber" name="L553" href="#L553">553</a> <em class="jxr_javadoccomment"> * charAt(<js>"Hello"</js>, 5); <jc>// 0 (out of bounds)</jc></em>
+<a class="jxr_linenumber" name="L554" href="#L554">554</a> <em class="jxr_javadoccomment"> * charAt(<js>"Hello"</js>, -1); <jc>// 0 (out of bounds)</jc></em>
+<a class="jxr_linenumber" name="L555" href="#L555">555</a> <em class="jxr_javadoccomment"> * charAt(<jk>null</jk>, 0); <jc>// 0 (null string)</jc></em>
+<a class="jxr_linenumber" name="L556" href="#L556">556</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L557" href="#L557">557</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L558" href="#L558">558</a> <em class="jxr_javadoccomment"> * @param s The string.</em>
+<a class="jxr_linenumber" name="L559" href="#L559">559</a> <em class="jxr_javadoccomment"> * @param i The index position.</em>
+<a class="jxr_linenumber" name="L560" href="#L560">560</a> <em class="jxr_javadoccomment"> * @return The character at the specified index, or <c>0</c> if the index is out-of-range or the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L561" href="#L561">561</a> <em class="jxr_javadoccomment"> * @see String#charAt(int)</em>
+<a class="jxr_linenumber" name="L562" href="#L562">562</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L563" href="#L563">563</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> charAt(String s, <strong class="jxr_keyword">int</strong> i) {
+<a class="jxr_linenumber" name="L564" href="#L564">564</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || i < 0 || i >= s.length())
+<a class="jxr_linenumber" name="L565" href="#L565">565</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L566" href="#L566">566</a> <strong class="jxr_keyword">return</strong> s.charAt(i);
+<a class="jxr_linenumber" name="L567" href="#L567">567</a> }
+<a class="jxr_linenumber" name="L568" href="#L568">568</a>
+<a class="jxr_linenumber" name="L569" href="#L569">569</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L570" href="#L570">570</a> <em class="jxr_javadoccomment"> * Cleans a string by removing control characters and normalizing whitespace.</em>
<a class="jxr_linenumber" name="L571" href="#L571">571</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L572" href="#L572">572</a> <em class="jxr_javadoccomment"> * @param str The string to clean.</em>
-<a class="jxr_linenumber" name="L573" href="#L573">573</a> <em class="jxr_javadoccomment"> * @return The cleaned string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L574" href="#L574">574</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L575" href="#L575">575</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String clean(String str) {
-<a class="jxr_linenumber" name="L576" href="#L576">576</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L577" href="#L577">577</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L578" href="#L578">578</a> str = removeControlChars(str);
-<a class="jxr_linenumber" name="L579" href="#L579">579</a> <strong class="jxr_keyword">return</strong> normalizeWhitespace(str);
-<a class="jxr_linenumber" name="L580" href="#L580">580</a> }
-<a class="jxr_linenumber" name="L581" href="#L581">581</a>
-<a class="jxr_linenumber" name="L582" href="#L582">582</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L583" href="#L583">583</a> <em class="jxr_javadoccomment"> * Compares two strings lexicographically, but gracefully handles <jk>null</jk> values.</em>
-<a class="jxr_linenumber" name="L584" href="#L584">584</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L585" href="#L585">585</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L586" href="#L586">586</a> <em class="jxr_javadoccomment"> * Null handling:</em>
-<a class="jxr_linenumber" name="L587" href="#L587">587</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L588" href="#L588">588</a> <em class="jxr_javadoccomment"> * <li>Both <jk>null</jk> → returns <c>0</c> (equal)</li></em>
-<a class="jxr_linenumber" name="L589" href="#L589">589</a> <em class="jxr_javadoccomment"> * <li>First <jk>null</jk> → returns {@link Integer#MIN_VALUE}</li></em>
-<a class="jxr_linenumber" name="L590" href="#L590">590</a> <em class="jxr_javadoccomment"> * <li>Second <jk>null</jk> → returns {@link Integer#MAX_VALUE}</li></em>
-<a class="jxr_linenumber" name="L591" href="#L591">591</a> <em class="jxr_javadoccomment"> * <li>Neither <jk>null</jk> → returns the same as {@link String#compareTo(String)}</li></em>
-<a class="jxr_linenumber" name="L592" href="#L592">592</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L593" href="#L593">593</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L594" href="#L594">594</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L595" href="#L595">595</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L596" href="#L596">596</a> <em class="jxr_javadoccomment"> * compare(<js>"apple"</js>, <js>"banana"</js>); <jc>// negative (apple &lt; banana)</jc></em>
-<a class="jxr_linenumber" name="L597" href="#L597">597</a> <em class="jxr_javadoccomment"> * compare(<js>"banana"</js>, <js>"apple"</js>); <jc>// positive (banana &gt; apple)</jc></em>
-<a class="jxr_linenumber" name="L598" href="#L598">598</a> <em class="jxr_javadoccomment"> * compare(<js>"apple"</js>, <js>"apple"</js>); <jc>// 0 (equal)</jc></em>
-<a class="jxr_linenumber" name="L599" href="#L599">599</a> <em class="jxr_javadoccomment"> * compare(<jk>null</jk>, <jk>null</jk>); <jc>// 0 (equal)</jc></em>
-<a class="jxr_linenumber" name="L600" href="#L600">600</a> <em class="jxr_javadoccomment"> * compare(<jk>null</jk>, <js>"apple"</js>); <jc>// Integer.MIN_VALUE</jc></em>
-<a class="jxr_linenumber" name="L601" href="#L601">601</a> <em class="jxr_javadoccomment"> * compare(<js>"apple"</js>, <jk>null</jk>); <jc>// Integer.MAX_VALUE</jc></em>
-<a class="jxr_linenumber" name="L602" href="#L602">602</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L603" href="#L603">603</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L604" href="#L604">604</a> <em class="jxr_javadoccomment"> * @param s1 The first string.</em>
-<a class="jxr_linenumber" name="L605" href="#L605">605</a> <em class="jxr_javadoccomment"> * @param s2 The second string.</em>
-<a class="jxr_linenumber" name="L606" href="#L606">606</a> <em class="jxr_javadoccomment"> * @return A negative integer, zero, or a positive integer as the first string is less than, equal to, or greater than the second.</em>
-<a class="jxr_linenumber" name="L607" href="#L607">607</a> <em class="jxr_javadoccomment"> * @see String#compareTo(String)</em>
-<a class="jxr_linenumber" name="L608" href="#L608">608</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L609" href="#L609">609</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> compare(String s1, String s2) {
-<a class="jxr_linenumber" name="L610" href="#L610">610</a> <strong class="jxr_keyword">if</strong> (s1 == <strong class="jxr_keyword">null</strong> && s2 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L611" href="#L611">611</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L612" href="#L612">612</a> <strong class="jxr_keyword">if</strong> (s1 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L613" href="#L613">613</a> <strong class="jxr_keyword">return</strong> Integer.MIN_VALUE;
-<a class="jxr_linenumber" name="L614" href="#L614">614</a> <strong class="jxr_keyword">if</strong> (s2 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L615" href="#L615">615</a> <strong class="jxr_keyword">return</strong> Integer.MAX_VALUE;
-<a class="jxr_linenumber" name="L616" href="#L616">616</a> <strong class="jxr_keyword">return</strong> s1.compareTo(s2);
-<a class="jxr_linenumber" name="L617" href="#L617">617</a> }
-<a class="jxr_linenumber" name="L618" href="#L618">618</a>
-<a class="jxr_linenumber" name="L619" href="#L619">619</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L620" href="#L620">620</a> <em class="jxr_javadoccomment"> * Compares two strings lexicographically, ignoring case.</em>
-<a class="jxr_linenumber" name="L621" href="#L621">621</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L622" href="#L622">622</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L623" href="#L623">623</a> <em class="jxr_javadoccomment"> * Returns a negative integer, zero, or a positive integer as the first string is less than, equal to, or greater than the second string, ignoring case.</em>
-<a class="jxr_linenumber" name="L624" href="#L624">624</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L625" href="#L625">625</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L626" href="#L626">626</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L627" href="#L627">627</a> <em class="jxr_javadoccomment"> * compareIgnoreCase(<js>"apple"</js>, <js>"BANANA"</js>); <jc>// negative (apple &lt; banana)</jc></em>
-<a class="jxr_linenumber" name="L628" href="#L628">628</a> <em class="jxr_javadoccomment"> * compareIgnoreCase(<js>"Hello"</js>, <js>"hello"</js>); <jc>// 0 (equal)</jc></em>
-<a class="jxr_linenumber" name="L629" href="#L629">629</a> <em class="jxr_javadoccomment"> * compareIgnoreCase(<js>"Zebra"</js>, <js>"apple"</js>); <jc>// positive (zebra &gt; apple)</jc></em>
-<a class="jxr_linenumber" name="L630" href="#L630">630</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L631" href="#L631">631</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L632" href="#L632">632</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
-<a class="jxr_linenumber" name="L633" href="#L633">633</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
-<a class="jxr_linenumber" name="L634" href="#L634">634</a> <em class="jxr_javadoccomment"> * @return A negative integer, zero, or a positive integer as the first string is less than, equal to, or greater than the second.</em>
-<a class="jxr_linenumber" name="L635" href="#L635">635</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L636" href="#L636">636</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> compareIgnoreCase(String str1, String str2) {
-<a class="jxr_linenumber" name="L637" href="#L637">637</a> <strong class="jxr_keyword">if</strong> (str1 == str2)
-<a class="jxr_linenumber" name="L638" href="#L638">638</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L639" href="#L639">639</a> <strong class="jxr_keyword">if</strong> (str1 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L640" href="#L640">640</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L641" href="#L641">641</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L642" href="#L642">642</a> <strong class="jxr_keyword">return</strong> 1;
-<a class="jxr_linenumber" name="L643" href="#L643">643</a> <strong class="jxr_keyword">return</strong> str1.compareToIgnoreCase(str2);
-<a class="jxr_linenumber" name="L644" href="#L644">644</a> }
-<a class="jxr_linenumber" name="L645" href="#L645">645</a>
-<a class="jxr_linenumber" name="L646" href="#L646">646</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L647" href="#L647">647</a> <em class="jxr_javadoccomment"> * Compresses a UTF-8 string into a GZIP-compressed byte array.</em>
-<a class="jxr_linenumber" name="L648" href="#L648">648</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L649" href="#L649">649</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L650" href="#L650">650</a> <em class="jxr_javadoccomment"> * This method compresses the input string using GZIP compression. The string is first converted to</em>
-<a class="jxr_linenumber" name="L651" href="#L651">651</a> <em class="jxr_javadoccomment"> * UTF-8 bytes, then compressed. Use {@link #decompress(byte[])} to decompress the result.</em>
-<a class="jxr_linenumber" name="L652" href="#L652">652</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L653" href="#L653">653</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L654" href="#L654">654</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L655" href="#L655">655</a> <em class="jxr_javadoccomment"> * <jc>// Compress a string</jc></em>
-<a class="jxr_linenumber" name="L656" href="#L656">656</a> <em class="jxr_javadoccomment"> * byte[] <jv>compressed</jv> = compress(<js>"Hello World"</js>);</em>
-<a class="jxr_linenumber" name="L657" href="#L657">657</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L658" href="#L658">658</a> <em class="jxr_javadoccomment"> * <jc>// Decompress it back</jc></em>
-<a class="jxr_linenumber" name="L659" href="#L659">659</a> <em class="jxr_javadoccomment"> * String <jv>decompressed</jv> = decompress(<jv>compressed</jv>);</em>
-<a class="jxr_linenumber" name="L660" href="#L660">660</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello World"</jc></em>
-<a class="jxr_linenumber" name="L661" href="#L661">661</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L662" href="#L662">662</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L663" href="#L663">663</a> <em class="jxr_javadoccomment"> * @param contents The UTF-8 string to compress.</em>
-<a class="jxr_linenumber" name="L664" href="#L664">664</a> <em class="jxr_javadoccomment"> * @return The GZIP-compressed byte array.</em>
-<a class="jxr_linenumber" name="L665" href="#L665">665</a> <em class="jxr_javadoccomment"> * @throws Exception If compression fails.</em>
-<a class="jxr_linenumber" name="L666" href="#L666">666</a> <em class="jxr_javadoccomment"> * @see #decompress(byte[])</em>
-<a class="jxr_linenumber" name="L667" href="#L667">667</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L668" href="#L668">668</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] compress(String contents) <strong class="jxr_keyword">throws</strong> Exception {
-<a class="jxr_linenumber" name="L669" href="#L669">669</a> <strong class="jxr_keyword">var</strong> baos = <strong class="jxr_keyword">new</strong> ByteArrayOutputStream(contents.length() >> 1);
-<a class="jxr_linenumber" name="L670" href="#L670">670</a> <strong class="jxr_keyword">try</strong> (<strong class="jxr_keyword">var</strong> gos = <strong class="jxr_keyword">new</strong> GZIPOutputStream(baos)) {
-<a class="jxr_linenumber" name="L671" href="#L671">671</a> gos.write(contents.getBytes());
-<a class="jxr_linenumber" name="L672" href="#L672">672</a> gos.finish();
-<a class="jxr_linenumber" name="L673" href="#L673">673</a> gos.flush();
-<a class="jxr_linenumber" name="L674" href="#L674">674</a> <strong class="jxr_keyword">return</strong> baos.toByteArray();
-<a class="jxr_linenumber" name="L675" href="#L675">675</a> }
-<a class="jxr_linenumber" name="L676" href="#L676">676</a> }
-<a class="jxr_linenumber" name="L677" href="#L677">677</a>
-<a class="jxr_linenumber" name="L678" href="#L678">678</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L679" href="#L679">679</a> <em class="jxr_javadoccomment"> * Checks if a string contains the specified character.</em>
-<a class="jxr_linenumber" name="L680" href="#L680">680</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L681" href="#L681">681</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L682" href="#L682">682</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L683" href="#L683">683</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L684" href="#L684">684</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L685" href="#L685">685</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L686" href="#L686">686</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>'o'</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L687" href="#L687">687</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>'x'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L688" href="#L688">688</a> <em class="jxr_javadoccomment"> * contains(<jk>null</jk>, <js>'a'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L689" href="#L689">689</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L690" href="#L690">690</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L691" href="#L691">691</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L692" href="#L692">692</a> <em class="jxr_javadoccomment"> * @param c The character to check for.</em>
-<a class="jxr_linenumber" name="L693" href="#L693">693</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains the specified character.</em>
-<a class="jxr_linenumber" name="L694" href="#L694">694</a> <em class="jxr_javadoccomment"> * @see #contains(String, CharSequence)</em>
-<a class="jxr_linenumber" name="L695" href="#L695">695</a> <em class="jxr_javadoccomment"> * @see #contains(String, String)</em>
-<a class="jxr_linenumber" name="L696" href="#L696">696</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, char...)</em>
-<a class="jxr_linenumber" name="L697" href="#L697">697</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L698" href="#L698">698</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> contains(String s, <strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L699" href="#L699">699</a> <strong class="jxr_keyword">return</strong> s != <strong class="jxr_keyword">null</strong> && s.indexOf(c) >= 0;
-<a class="jxr_linenumber" name="L700" href="#L700">700</a> }
-<a class="jxr_linenumber" name="L701" href="#L701">701</a>
-<a class="jxr_linenumber" name="L702" href="#L702">702</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L703" href="#L703">703</a> <em class="jxr_javadoccomment"> * Null-safe {@link String#contains(CharSequence)} operation.</em>
-<a class="jxr_linenumber" name="L704" href="#L704">704</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L705" href="#L705">705</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L706" href="#L706">706</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the string is <jk>null</jk>, otherwise behaves the same as</em>
-<a class="jxr_linenumber" name="L707" href="#L707">707</a> <em class="jxr_javadoccomment"> * {@link String#contains(CharSequence)}.</em>
-<a class="jxr_linenumber" name="L708" href="#L708">708</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L709" href="#L709">709</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L710" href="#L710">710</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L711" href="#L711">711</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>"World"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L712" href="#L712">712</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>"Foo"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L713" href="#L713">713</a> <em class="jxr_javadoccomment"> * contains(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L714" href="#L714">714</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L715" href="#L715">715</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L716" href="#L716">716</a> <em class="jxr_javadoccomment"> * @param value The string to check.</em>
-<a class="jxr_linenumber" name="L717" href="#L717">717</a> <em class="jxr_javadoccomment"> * @param substring The substring to check for.</em>
-<a class="jxr_linenumber" name="L718" href="#L718">718</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the value contains the specified substring, <jk>false</jk> if the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L719" href="#L719">719</a> <em class="jxr_javadoccomment"> * @see #contains(String, char)</em>
-<a class="jxr_linenumber" name="L720" href="#L720">720</a> <em class="jxr_javadoccomment"> * @see #contains(String, String)</em>
-<a class="jxr_linenumber" name="L721" href="#L721">721</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, CharSequence...)</em>
-<a class="jxr_linenumber" name="L722" href="#L722">722</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L723" href="#L723">723</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> contains(String value, CharSequence substring) {
-<a class="jxr_linenumber" name="L724" href="#L724">724</a> <strong class="jxr_keyword">return</strong> nn(value) && value.contains(substring);
-<a class="jxr_linenumber" name="L725" href="#L725">725</a> }
-<a class="jxr_linenumber" name="L726" href="#L726">726</a>
-<a class="jxr_linenumber" name="L727" href="#L727">727</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L728" href="#L728">728</a> <em class="jxr_javadoccomment"> * Null-safe check if a string contains another string.</em>
-<a class="jxr_linenumber" name="L729" href="#L729">729</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L730" href="#L730">730</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L731" href="#L731">731</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the string is <jk>null</jk>, otherwise behaves the same as</em>
-<a class="jxr_linenumber" name="L732" href="#L732">732</a> <em class="jxr_javadoccomment"> * {@link String#contains(CharSequence)}.</em>
-<a class="jxr_linenumber" name="L733" href="#L733">733</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L734" href="#L734">734</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L735" href="#L735">735</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L736" href="#L736">736</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>"World"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L737" href="#L737">737</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>"Foo"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L738" href="#L738">738</a> <em class="jxr_javadoccomment"> * contains(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L739" href="#L739">739</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L740" href="#L740">740</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L741" href="#L741">741</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L742" href="#L742">742</a> <em class="jxr_javadoccomment"> * @param substring The substring to check for.</em>
-<a class="jxr_linenumber" name="L743" href="#L743">743</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains the specified substring, <jk>false</jk> if the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L744" href="#L744">744</a> <em class="jxr_javadoccomment"> * @see #contains(String, CharSequence)</em>
-<a class="jxr_linenumber" name="L745" href="#L745">745</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, String...)</em>
-<a class="jxr_linenumber" name="L746" href="#L746">746</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L747" href="#L747">747</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> contains(String s, String substring) {
-<a class="jxr_linenumber" name="L748" href="#L748">748</a> <strong class="jxr_keyword">return</strong> nn(s) && s.contains(substring);
-<a class="jxr_linenumber" name="L749" href="#L749">749</a> }
-<a class="jxr_linenumber" name="L750" href="#L750">750</a>
-<a class="jxr_linenumber" name="L751" href="#L751">751</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L752" href="#L752">752</a> <em class="jxr_javadoccomment"> * Checks if a string contains all of the specified characters.</em>
-<a class="jxr_linenumber" name="L753" href="#L753">753</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L754" href="#L754">754</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L755" href="#L755">755</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
-<a class="jxr_linenumber" name="L756" href="#L756">756</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L757" href="#L757">757</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L758" href="#L758">758</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L759" href="#L759">759</a> <em class="jxr_javadoccomment"> * <li>Any of the specified characters are not found in the string</li></em>
-<a class="jxr_linenumber" name="L760" href="#L760">760</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L761" href="#L761">761</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L762" href="#L762">762</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L763" href="#L763">763</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L764" href="#L764">764</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>'H'</js>, <js>'e'</js>, <js>'l'</js>); <jc>// true (contains all)</jc></em>
-<a class="jxr_linenumber" name="L765" href="#L765">765</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>'H'</js>, <js>'x'</js>); <jc>// false (missing 'x')</jc></em>
-<a class="jxr_linenumber" name="L766" href="#L766">766</a> <em class="jxr_javadoccomment"> * containsAll(<jk>null</jk>, <js>'a'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L767" href="#L767">767</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L768" href="#L768">768</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L769" href="#L769">769</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L770" href="#L770">770</a> <em class="jxr_javadoccomment"> * @param values The characters to check for.</em>
-<a class="jxr_linenumber" name="L771" href="#L771">771</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains all of the specified characters.</em>
-<a class="jxr_linenumber" name="L772" href="#L772">772</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, char...)</em>
-<a class="jxr_linenumber" name="L773" href="#L773">773</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L774" href="#L774">774</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAll(String s, <strong class="jxr_keyword">char</strong>...values) {
-<a class="jxr_linenumber" name="L775" href="#L775">775</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
-<a class="jxr_linenumber" name="L776" href="#L776">776</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L777" href="#L777">777</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
-<a class="jxr_linenumber" name="L778" href="#L778">778</a> <strong class="jxr_keyword">if</strong> (s.indexOf(v) < 0)
-<a class="jxr_linenumber" name="L779" href="#L779">779</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L780" href="#L780">780</a> }
-<a class="jxr_linenumber" name="L781" href="#L781">781</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L782" href="#L782">782</a> }
-<a class="jxr_linenumber" name="L783" href="#L783">783</a>
-<a class="jxr_linenumber" name="L784" href="#L784">784</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L785" href="#L785">785</a> <em class="jxr_javadoccomment"> * Checks if a string contains all of the specified substrings.</em>
-<a class="jxr_linenumber" name="L786" href="#L786">786</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L787" href="#L787">787</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L788" href="#L788">788</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
-<a class="jxr_linenumber" name="L789" href="#L789">789</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L790" href="#L790">790</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L791" href="#L791">791</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L792" href="#L792">792</a> <em class="jxr_javadoccomment"> * <li>Any of the specified substrings are not found in the string</li></em>
-<a class="jxr_linenumber" name="L793" href="#L793">793</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L794" href="#L794">794</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L795" href="#L795">795</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L796" href="#L796">796</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L797" href="#L797">797</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"World"</js>); <jc>// true (contains all)</jc></em>
-<a class="jxr_linenumber" name="L798" href="#L798">798</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// false (missing "Foo")</jc></em>
-<a class="jxr_linenumber" name="L799" href="#L799">799</a> <em class="jxr_javadoccomment"> * containsAll(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L800" href="#L800">800</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L801" href="#L801">801</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L802" href="#L802">802</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L803" href="#L803">803</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
-<a class="jxr_linenumber" name="L804" href="#L804">804</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains all of the specified substrings.</em>
-<a class="jxr_linenumber" name="L805" href="#L805">805</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, CharSequence...)</em>
-<a class="jxr_linenumber" name="L806" href="#L806">806</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L807" href="#L807">807</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAll(String s, CharSequence...values) {
-<a class="jxr_linenumber" name="L808" href="#L808">808</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
-<a class="jxr_linenumber" name="L809" href="#L809">809</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L810" href="#L810">810</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
-<a class="jxr_linenumber" name="L811" href="#L811">811</a> <strong class="jxr_keyword">if</strong> (! s.contains(v))
-<a class="jxr_linenumber" name="L812" href="#L812">812</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L813" href="#L813">813</a> }
-<a class="jxr_linenumber" name="L814" href="#L814">814</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L815" href="#L815">815</a> }
-<a class="jxr_linenumber" name="L816" href="#L816">816</a>
-<a class="jxr_linenumber" name="L817" href="#L817">817</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L818" href="#L818">818</a> <em class="jxr_javadoccomment"> * Checks if a string contains all of the specified substrings.</em>
-<a class="jxr_linenumber" name="L819" href="#L819">819</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L820" href="#L820">820</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L821" href="#L821">821</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
-<a class="jxr_linenumber" name="L822" href="#L822">822</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L823" href="#L823">823</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L824" href="#L824">824</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L825" href="#L825">825</a> <em class="jxr_javadoccomment"> * <li>Any of the specified substrings are not found in the string</li></em>
-<a class="jxr_linenumber" name="L826" href="#L826">826</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L827" href="#L827">827</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L828" href="#L828">828</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L829" href="#L829">829</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L830" href="#L830">830</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"World"</js>); <jc>// true (contains all)</jc></em>
-<a class="jxr_linenumber" name="L831" href="#L831">831</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// false (missing "Foo")</jc></em>
-<a class="jxr_linenumber" name="L832" href="#L832">832</a> <em class="jxr_javadoccomment"> * containsAll(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L833" href="#L833">833</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L834" href="#L834">834</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L835" href="#L835">835</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L836" href="#L836">836</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
-<a class="jxr_linenumber" name="L837" href="#L837">837</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains all of the specified substrings.</em>
-<a class="jxr_linenumber" name="L838" href="#L838">838</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, String...)</em>
-<a class="jxr_linenumber" name="L839" href="#L839">839</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L840" href="#L840">840</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAll(String s, String...values) {
-<a class="jxr_linenumber" name="L841" href="#L841">841</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
-<a class="jxr_linenumber" name="L842" href="#L842">842</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L843" href="#L843">843</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
-<a class="jxr_linenumber" name="L844" href="#L844">844</a> <strong class="jxr_keyword">if</strong> (! s.contains(v))
-<a class="jxr_linenumber" name="L845" href="#L845">845</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L846" href="#L846">846</a> }
-<a class="jxr_linenumber" name="L847" href="#L847">847</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L848" href="#L848">848</a> }
-<a class="jxr_linenumber" name="L849" href="#L849">849</a>
-<a class="jxr_linenumber" name="L850" href="#L850">850</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L851" href="#L851">851</a> <em class="jxr_javadoccomment"> * Checks if a string contains any of the specified characters.</em>
-<a class="jxr_linenumber" name="L852" href="#L852">852</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L853" href="#L853">853</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L854" href="#L854">854</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
-<a class="jxr_linenumber" name="L855" href="#L855">855</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L856" href="#L856">856</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L857" href="#L857">857</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L858" href="#L858">858</a> <em class="jxr_javadoccomment"> * <li>None of the specified characters are found in the string</li></em>
-<a class="jxr_linenumber" name="L859" href="#L859">859</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L860" href="#L860">860</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L861" href="#L861">861</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L862" href="#L862">862</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L863" href="#L863">863</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>'o'</js>, <js>'x'</js>); <jc>// true (contains 'o')</jc></em>
-<a class="jxr_linenumber" name="L864" href="#L864">864</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>'x'</js>, <js>'y'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L865" href="#L865">865</a> <em class="jxr_javadoccomment"> * containsAny(<jk>null</jk>, <js>'a'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L866" href="#L866">866</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L867" href="#L867">867</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L868" href="#L868">868</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L869" href="#L869">869</a> <em class="jxr_javadoccomment"> * @param values The characters to check for.</em>
-<a class="jxr_linenumber" name="L870" href="#L870">870</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains any of the specified characters.</em>
-<a class="jxr_linenumber" name="L871" href="#L871">871</a> <em class="jxr_javadoccomment"> * @see #contains(String, char)</em>
-<a class="jxr_linenumber" name="L872" href="#L872">872</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, char...)</em>
-<a class="jxr_linenumber" name="L873" href="#L873">873</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L874" href="#L874">874</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAny(String s, <strong class="jxr_keyword">char</strong>...values) {
-<a class="jxr_linenumber" name="L875" href="#L875">875</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
-<a class="jxr_linenumber" name="L876" href="#L876">876</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L877" href="#L877">877</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
-<a class="jxr_linenumber" name="L878" href="#L878">878</a> <strong class="jxr_keyword">if</strong> (s.indexOf(v) >= 0)
-<a class="jxr_linenumber" name="L879" href="#L879">879</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L880" href="#L880">880</a> }
-<a class="jxr_linenumber" name="L881" href="#L881">881</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L882" href="#L882">882</a> }
-<a class="jxr_linenumber" name="L883" href="#L883">883</a>
-<a class="jxr_linenumber" name="L884" href="#L884">884</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L885" href="#L885">885</a> <em class="jxr_javadoccomment"> * Checks if a string contains any of the specified substrings.</em>
-<a class="jxr_linenumber" name="L886" href="#L886">886</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L887" href="#L887">887</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L888" href="#L888">888</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
-<a class="jxr_linenumber" name="L889" href="#L889">889</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L890" href="#L890">890</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L891" href="#L891">891</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L892" href="#L892">892</a> <em class="jxr_javadoccomment"> * <li>None of the specified substrings are found in the string</li></em>
-<a class="jxr_linenumber" name="L893" href="#L893">893</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L894" href="#L894">894</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L895" href="#L895">895</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L896" href="#L896">896</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L897" href="#L897">897</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// true (contains "Hello")</jc></em>
-<a class="jxr_linenumber" name="L898" href="#L898">898</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>"Foo"</js>, <js>"Bar"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L899" href="#L899">899</a> <em class="jxr_javadoccomment"> * containsAny(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L900" href="#L900">900</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L901" href="#L901">901</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L902" href="#L902">902</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L903" href="#L903">903</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
-<a class="jxr_linenumber" name="L904" href="#L904">904</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains any of the specified substrings.</em>
-<a class="jxr_linenumber" name="L905" href="#L905">905</a> <em class="jxr_javadoccomment"> * @see #contains(String, CharSequence)</em>
-<a class="jxr_linenumber" name="L906" href="#L906">906</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, CharSequence...)</em>
-<a class="jxr_linenumber" name="L907" href="#L907">907</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L908" href="#L908">908</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAny(String s, CharSequence...values) {
-<a class="jxr_linenumber" name="L909" href="#L909">909</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
-<a class="jxr_linenumber" name="L910" href="#L910">910</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L911" href="#L911">911</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
-<a class="jxr_linenumber" name="L912" href="#L912">912</a> <strong class="jxr_keyword">if</strong> (s.contains(v))
-<a class="jxr_linenumber" name="L913" href="#L913">913</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L914" href="#L914">914</a> }
-<a class="jxr_linenumber" name="L915" href="#L915">915</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L916" href="#L916">916</a> }
-<a class="jxr_linenumber" name="L917" href="#L917">917</a>
-<a class="jxr_linenumber" name="L918" href="#L918">918</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L919" href="#L919">919</a> <em class="jxr_javadoccomment"> * Checks if a string contains any of the specified substrings.</em>
-<a class="jxr_linenumber" name="L920" href="#L920">920</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L921" href="#L921">921</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L922" href="#L922">922</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
-<a class="jxr_linenumber" name="L923" href="#L923">923</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L924" href="#L924">924</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L925" href="#L925">925</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L926" href="#L926">926</a> <em class="jxr_javadoccomment"> * <li>None of the specified substrings are found in the string</li></em>
-<a class="jxr_linenumber" name="L927" href="#L927">927</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L928" href="#L928">928</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L930" href="#L930">930</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L931" href="#L931">931</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// true (contains "Hello")</jc></em>
-<a class="jxr_linenumber" name="L932" href="#L932">932</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>"Foo"</js>, <js>"Bar"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L933" href="#L933">933</a> <em class="jxr_javadoccomment"> * containsAny(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L934" href="#L934">934</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello"</js>); <jc>// false (no values to check)</jc></em>
-<a class="jxr_linenumber" name="L935" href="#L935">935</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L936" href="#L936">936</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L937" href="#L937">937</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L938" href="#L938">938</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
-<a class="jxr_linenumber" name="L939" href="#L939">939</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains any of the specified substrings.</em>
-<a class="jxr_linenumber" name="L940" href="#L940">940</a> <em class="jxr_javadoccomment"> * @see #contains(String, String)</em>
-<a class="jxr_linenumber" name="L941" href="#L941">941</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, String...)</em>
-<a class="jxr_linenumber" name="L942" href="#L942">942</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L943" href="#L943">943</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAny(String s, String...values) {
-<a class="jxr_linenumber" name="L944" href="#L944">944</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
-<a class="jxr_linenumber" name="L945" href="#L945">945</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L946" href="#L946">946</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
-<a class="jxr_linenumber" name="L947" href="#L947">947</a> <strong class="jxr_keyword">if</strong> (s.contains(v))
-<a class="jxr_linenumber" name="L948" href="#L948">948</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L949" href="#L949">949</a> }
-<a class="jxr_linenumber" name="L950" href="#L950">950</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L951" href="#L951">951</a> }
-<a class="jxr_linenumber" name="L952" href="#L952">952</a>
-<a class="jxr_linenumber" name="L953" href="#L953">953</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L954" href="#L954">954</a> <em class="jxr_javadoccomment"> * Checks if a string contains a substring, ignoring case.</em>
-<a class="jxr_linenumber" name="L955" href="#L955">955</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L956" href="#L956">956</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L957" href="#L957">957</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L958" href="#L958">958</a> <em class="jxr_javadoccomment"> * containsIgnoreCase(<js>"Hello World"</js>, <js>"world"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L959" href="#L959">959</a> <em class="jxr_javadoccomment"> * containsIgnoreCase(<js>"Hello World"</js>, <js>"WORLD"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L960" href="#L960">960</a> <em class="jxr_javadoccomment"> * containsIgnoreCase(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L961" href="#L961">961</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L962" href="#L962">962</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L963" href="#L963">963</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
-<a class="jxr_linenumber" name="L964" href="#L964">964</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
-<a class="jxr_linenumber" name="L965" href="#L965">965</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains the substring (ignoring case), <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L966" href="#L966">966</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L967" href="#L967">967</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsIgnoreCase(String str, String search) {
-<a class="jxr_linenumber" name="L968" href="#L968">968</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L969" href="#L969">969</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L970" href="#L970">970</a> <strong class="jxr_keyword">return</strong> str.toLowerCase().contains(search.toLowerCase());
-<a class="jxr_linenumber" name="L971" href="#L971">971</a> }
-<a class="jxr_linenumber" name="L972" href="#L972">972</a>
-<a class="jxr_linenumber" name="L973" href="#L973">973</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L974" href="#L974">974</a> <em class="jxr_javadoccomment"> * Counts the number of occurrences of the specified character in the specified string.</em>
-<a class="jxr_linenumber" name="L975" href="#L975">975</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L976" href="#L976">976</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L977" href="#L977">977</a> <em class="jxr_javadoccomment"> * Returns <c>0</c> if the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L978" href="#L978">978</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L979" href="#L979">979</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L980" href="#L980">980</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L981" href="#L981">981</a> <em class="jxr_javadoccomment"> * countChars(<js>"Hello World"</js>, <js>'o'</js>); <jc>// 2</jc></em>
-<a class="jxr_linenumber" name="L982" href="#L982">982</a> <em class="jxr_javadoccomment"> * countChars(<js>"Hello World"</js>, <js>'x'</js>); <jc>// 0</jc></em>
-<a class="jxr_linenumber" name="L983" href="#L983">983</a> <em class="jxr_javadoccomment"> * countChars(<jk>null</jk>, <js>'a'</js>); <jc>// 0</jc></em>
-<a class="jxr_linenumber" name="L984" href="#L984">984</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L985" href="#L985">985</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L986" href="#L986">986</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L987" href="#L987">987</a> <em class="jxr_javadoccomment"> * @param c The character to count.</em>
-<a class="jxr_linenumber" name="L988" href="#L988">988</a> <em class="jxr_javadoccomment"> * @return The number of occurrences of the character, or <c>0</c> if the string was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L989" href="#L989">989</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L990" href="#L990">990</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> countChars(String s, <strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L991" href="#L991">991</a> <strong class="jxr_keyword">var</strong> count = 0;
-<a class="jxr_linenumber" name="L992" href="#L992">992</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L993" href="#L993">993</a> <strong class="jxr_keyword">return</strong> count;
-<a class="jxr_linenumber" name="L994" href="#L994">994</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++)
-<a class="jxr_linenumber" name="L995" href="#L995">995</a> <strong class="jxr_keyword">if</strong> (s.charAt(i) == c)
-<a class="jxr_linenumber" name="L996" href="#L996">996</a> count++;
-<a class="jxr_linenumber" name="L997" href="#L997">997</a> <strong class="jxr_keyword">return</strong> count;
-<a class="jxr_linenumber" name="L998" href="#L998">998</a> }
-<a class="jxr_linenumber" name="L999" href="#L999">999</a>
-<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a> <em class="jxr_javadoccomment"> * Counts the number of occurrences of a substring within a string.</em>
-<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a> <em class="jxr_javadoccomment"> * countMatches(<js>"hello world world"</js>, <js>"world"</js>); <jc>// 2</jc></em>
-<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a> <em class="jxr_javadoccomment"> * countMatches(<js>"ababab"</js>, <js>"ab"</js>); <jc>// 3</jc></em>
-<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a> <em class="jxr_javadoccomment"> * countMatches(<js>"hello"</js>, <js>"xyz"</js>); <jc>// 0</jc></em>
-<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1010" href="#L1010">1010</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
-<a class="jxr_linenumber" name="L1011" href="#L1011">1011</a> <em class="jxr_javadoccomment"> * @param search The substring to count.</em>
-<a class="jxr_linenumber" name="L1012" href="#L1012">1012</a> <em class="jxr_javadoccomment"> * @return The number of occurrences, or <c>0</c> if not found or if either parameter is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1013" href="#L1013">1013</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1014" href="#L1014">1014</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> countMatches(String str, String search) {
-<a class="jxr_linenumber" name="L1015" href="#L1015">1015</a> <strong class="jxr_keyword">if</strong> (isEmpty(str) || isEmpty(search))
-<a class="jxr_linenumber" name="L1016" href="#L1016">1016</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L1017" href="#L1017">1017</a> <strong class="jxr_keyword">var</strong> count = 0;
-<a class="jxr_linenumber" name="L1018" href="#L1018">1018</a> <strong class="jxr_keyword">var</strong> index = 0;
-<a class="jxr_linenumber" name="L1019" href="#L1019">1019</a> <strong class="jxr_keyword">while</strong> ((index = str.indexOf(search, index)) != -1) {
-<a class="jxr_linenumber" name="L1020" href="#L1020">1020</a> count++;
-<a class="jxr_linenumber" name="L1021" href="#L1021">1021</a> index += search.length();
-<a class="jxr_linenumber" name="L1022" href="#L1022">1022</a> }
-<a class="jxr_linenumber" name="L1023" href="#L1023">1023</a> <strong class="jxr_keyword">return</strong> count;
-<a class="jxr_linenumber" name="L1024" href="#L1024">1024</a> }
-<a class="jxr_linenumber" name="L1025" href="#L1025">1025</a>
-<a class="jxr_linenumber" name="L1026" href="#L1026">1026</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1027" href="#L1027">1027</a> <em class="jxr_javadoccomment"> * Debug method for rendering non-ASCII character sequences.</em>
-<a class="jxr_linenumber" name="L1028" href="#L1028">1028</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1029" href="#L1029">1029</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1030" href="#L1030">1030</a> <em class="jxr_javadoccomment"> * Converts non-printable and non-ASCII characters (outside the range <c>0x20-0x7E</c>) to hexadecimal</em>
-<a class="jxr_linenumber" name="L1031" href="#L1031">1031</a> <em class="jxr_javadoccomment"> * sequences in the format <js>"[hex]"</js>. Printable ASCII characters are left unchanged.</em>
-<a class="jxr_linenumber" name="L1032" href="#L1032">1032</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1033" href="#L1033">1033</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1034" href="#L1034">1034</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1035" href="#L1035">1035</a> <em class="jxr_javadoccomment"> * decodeHex(<js>"Hello"</js>); <jc>// "Hello"</jc></em>
-<a class="jxr_linenumber" name="L1036" href="#L1036">1036</a> <em class="jxr_javadoccomment"> * decodeHex(<js>"Hello\u0000World"</js>); <jc>// "Hello[0]World"</jc></em>
-<a class="jxr_linenumber" name="L1037" href="#L1037">1037</a> <em class="jxr_javadoccomment"> * decodeHex(<js>"Hello\u00A9"</js>); <jc>// "Hello[a9]"</jc></em>
-<a class="jxr_linenumber" name="L1038" href="#L1038">1038</a> <em class="jxr_javadoccomment"> * decodeHex(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L1039" href="#L1039">1039</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1040" href="#L1040">1040</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1041" href="#L1041">1041</a> <em class="jxr_javadoccomment"> * @param s The string to decode.</em>
-<a class="jxr_linenumber" name="L1042" href="#L1042">1042</a> <em class="jxr_javadoccomment"> * @return A string with non-ASCII characters converted to <js>"[hex]"</js> sequences, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1043" href="#L1043">1043</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1044" href="#L1044">1044</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String decodeHex(String s) {
-<a class="jxr_linenumber" name="L1045" href="#L1045">1045</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1046" href="#L1046">1046</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1047" href="#L1047">1047</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L1048" href="#L1048">1048</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> c : s.toCharArray()) {
-<a class="jxr_linenumber" name="L1049" href="#L1049">1049</a> <strong class="jxr_keyword">if</strong> (c < ' ' || c > '~')
-<a class="jxr_linenumber" name="L1050" href="#L1050">1050</a> sb.append(<span class="jxr_string">"["</span>).append(Integer.toHexString(c)).append(<span class="jxr_string">"]"</span>);
-<a class="jxr_linenumber" name="L1051" href="#L1051">1051</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L1052" href="#L1052">1052</a> sb.append(c);
-<a class="jxr_linenumber" name="L1053" href="#L1053">1053</a> }
-<a class="jxr_linenumber" name="L1054" href="#L1054">1054</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L1055" href="#L1055">1055</a> }
-<a class="jxr_linenumber" name="L1056" href="#L1056">1056</a>
-<a class="jxr_linenumber" name="L1057" href="#L1057">1057</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1058" href="#L1058">1058</a> <em class="jxr_javadoccomment"> * Decompresses a GZIP-compressed byte array into a UTF-8 string.</em>
-<a class="jxr_linenumber" name="L1059" href="#L1059">1059</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1060" href="#L1060">1060</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1061" href="#L1061">1061</a> <em class="jxr_javadoccomment"> * This method is the inverse of {@link #compress(String)}. It takes a byte array that was compressed</em>
-<a class="jxr_linenumber" name="L1062" href="#L1062">1062</a> <em class="jxr_javadoccomment"> * using GZIP compression and decompresses it into a UTF-8 encoded string.</em>
-<a class="jxr_linenumber" name="L1063" href="#L1063">1063</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1064" href="#L1064">1064</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1065" href="#L1065">1065</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1066" href="#L1066">1066</a> <em class="jxr_javadoccomment"> * <jc>// Compress a string</jc></em>
-<a class="jxr_linenumber" name="L1067" href="#L1067">1067</a> <em class="jxr_javadoccomment"> * byte[] <jv>compressed</jv> = compress(<js>"Hello World"</js>);</em>
-<a class="jxr_linenumber" name="L1068" href="#L1068">1068</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1069" href="#L1069">1069</a> <em class="jxr_javadoccomment"> * <jc>// Decompress it back</jc></em>
-<a class="jxr_linenumber" name="L1070" href="#L1070">1070</a> <em class="jxr_javadoccomment"> * String <jv>decompressed</jv> = decompress(<jv>compressed</jv>);</em>
-<a class="jxr_linenumber" name="L1071" href="#L1071">1071</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello World"</jc></em>
-<a class="jxr_linenumber" name="L1072" href="#L1072">1072</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1073" href="#L1073">1073</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1074" href="#L1074">1074</a> <em class="jxr_javadoccomment"> * @param is The GZIP-compressed byte array to decompress.</em>
-<a class="jxr_linenumber" name="L1075" href="#L1075">1075</a> <em class="jxr_javadoccomment"> * @return The decompressed UTF-8 string.</em>
-<a class="jxr_linenumber" name="L1076" href="#L1076">1076</a> <em class="jxr_javadoccomment"> * @throws Exception If decompression fails or the input is not valid GZIP data.</em>
-<a class="jxr_linenumber" name="L1077" href="#L1077">1077</a> <em class="jxr_javadoccomment"> * @see #compress(String)</em>
-<a class="jxr_linenumber" name="L1078" href="#L1078">1078</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1079" href="#L1079">1079</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String decompress(byte[] is) <strong class="jxr_keyword">throws</strong> Exception {
-<a class="jxr_linenumber" name="L1080" href="#L1080">1080</a> <strong class="jxr_keyword">return</strong> read(<strong class="jxr_keyword">new</strong> GZIPInputStream(<strong class="jxr_keyword">new</strong> ByteArrayInputStream(is)));
-<a class="jxr_linenumber" name="L1081" href="#L1081">1081</a> }
-<a class="jxr_linenumber" name="L1082" href="#L1082">1082</a>
-<a class="jxr_linenumber" name="L1083" href="#L1083">1083</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1084" href="#L1084">1084</a> <em class="jxr_javadoccomment"> * Returns the specified string, or the default string if that string is <jk>null</jk> or blank.</em>
-<a class="jxr_linenumber" name="L1085" href="#L1085">1085</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1086" href="#L1086">1086</a> <em class="jxr_javadoccomment"> * @param str The string value to check.</em>
-<a class="jxr_linenumber" name="L1087" href="#L1087">1087</a> <em class="jxr_javadoccomment"> * @param defaultStr The default string to return if the string is <jk>null</jk> or blank.</em>
-<a class="jxr_linenumber" name="L1088" href="#L1088">1088</a> <em class="jxr_javadoccomment"> * @return The string value, or the default string if the string is <jk>null</jk> or blank.</em>
-<a class="jxr_linenumber" name="L1089" href="#L1089">1089</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1090" href="#L1090">1090</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String defaultIfBlank(String str, String defaultStr) {
-<a class="jxr_linenumber" name="L1091" href="#L1091">1091</a> <strong class="jxr_keyword">return</strong> isBlank(str) ? defaultStr : str;
-<a class="jxr_linenumber" name="L1092" href="#L1092">1092</a> }
-<a class="jxr_linenumber" name="L1093" href="#L1093">1093</a>
-<a class="jxr_linenumber" name="L1094" href="#L1094">1094</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1095" href="#L1095">1095</a> <em class="jxr_javadoccomment"> * Returns the specified string, or the default string if that string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1096" href="#L1096">1096</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1097" href="#L1097">1097</a> <em class="jxr_javadoccomment"> * @param str The string value to check.</em>
-<a class="jxr_linenumber" name="L1098" href="#L1098">1098</a> <em class="jxr_javadoccomment"> * @param defaultStr The default string to return if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1099" href="#L1099">1099</a> <em class="jxr_javadoccomment"> * @return The string value, or the default string if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1100" href="#L1100">1100</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1101" href="#L1101">1101</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String defaultIfEmpty(String str, String defaultStr) {
-<a class="jxr_linenumber" name="L1102" href="#L1102">1102</a> <strong class="jxr_keyword">return</strong> isEmpty(str) ? defaultStr : str;
-<a class="jxr_linenumber" name="L1103" href="#L1103">1103</a> }
-<a class="jxr_linenumber" name="L1104" href="#L1104">1104</a>
-<a class="jxr_linenumber" name="L1105" href="#L1105">1105</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1106" href="#L1106">1106</a> <em class="jxr_javadoccomment"> * Finds the position where the two strings first differ.</em>
-<a class="jxr_linenumber" name="L1107" href="#L1107">1107</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1108" href="#L1108">1108</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1109" href="#L1109">1109</a> <em class="jxr_javadoccomment"> * This method compares strings character by character and returns the index of the first position</em>
-<a class="jxr_linenumber" name="L1110" href="#L1110">1110</a> <em class="jxr_javadoccomment"> * where they differ. If the strings are equal, returns <c>-1</c>. If one string is a prefix of the other,</em>
-<a class="jxr_linenumber" name="L1111" href="#L1111">1111</a> <em class="jxr_javadoccomment"> * returns the length of the shorter string.</em>
-<a class="jxr_linenumber" name="L1112" href="#L1112">1112</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1113" href="#L1113">1113</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1114" href="#L1114">1114</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1115" href="#L1115">1115</a> <em class="jxr_javadoccomment"> * diffPosition(<js>"apple"</js>, <js>"apple"</js>); <jc>// -1 (equal)</jc></em>
-<a class="jxr_linenumber" name="L1116" href="#L1116">1116</a> <em class="jxr_javadoccomment"> * diffPosition(<js>"apple"</js>, <js>"apricot"</js>); <jc>// 2 (differs at 'p' vs 'r')</jc></em>
-<a class="jxr_linenumber" name="L1117" href="#L1117">1117</a> <em class="jxr_javadoccomment"> * diffPosition(<js>"apple"</js>, <js>"app"</js>); <jc>// 3 (shorter string ends here)</jc></em>
-<a class="jxr_linenumber" name="L1118" href="#L1118">1118</a> <em class="jxr_javadoccomment"> * diffPosition(<js>"app"</js>, <js>"apple"</js>); <jc>// 3 (shorter string ends here)</jc></em>
-<a class="jxr_linenumber" name="L1119" href="#L1119">1119</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1120" href="#L1120">1120</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1121" href="#L1121">1121</a> <em class="jxr_javadoccomment"> * @param s1 The first string.</em>
-<a class="jxr_linenumber" name="L1122" href="#L1122">1122</a> <em class="jxr_javadoccomment"> * @param s2 The second string.</em>
-<a class="jxr_linenumber" name="L1123" href="#L1123">1123</a> <em class="jxr_javadoccomment"> * @return The position where the two strings differ, or <c>-1</c> if they're equal.</em>
-<a class="jxr_linenumber" name="L1124" href="#L1124">1124</a> <em class="jxr_javadoccomment"> * @see #diffPositionIc(String, String)</em>
-<a class="jxr_linenumber" name="L1125" href="#L1125">1125</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1126" href="#L1126">1126</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> diffPosition(String s1, String s2) {
-<a class="jxr_linenumber" name="L1127" href="#L1127">1127</a> s1 = emptyIfNull(s1);
-<a class="jxr_linenumber" name="L1128" href="#L1128">1128</a> s2 = emptyIfNull(s2);
-<a class="jxr_linenumber" name="L1129" href="#L1129">1129</a> <strong class="jxr_keyword">var</strong> i = 0;
-<a class="jxr_linenumber" name="L1130" href="#L1130">1130</a> <strong class="jxr_keyword">var</strong> len = Math.min(s1.length(), s2.length());
-<a class="jxr_linenumber" name="L1131" href="#L1131">1131</a> <strong class="jxr_keyword">while</strong> (i < len) {
-<a class="jxr_linenumber" name="L1132" href="#L1132">1132</a> <strong class="jxr_keyword">var</strong> j = s1.charAt(i) - s2.charAt(i);
-<a class="jxr_linenumber" name="L1133" href="#L1133">1133</a> <strong class="jxr_keyword">if</strong> (j != 0)
-<a class="jxr_linenumber" name="L1134" href="#L1134">1134</a> <strong class="jxr_keyword">return</strong> i;
-<a class="jxr_linenumber" name="L1135" href="#L1135">1135</a> i++;
-<a class="jxr_linenumber" name="L1136" href="#L1136">1136</a> }
-<a class="jxr_linenumber" name="L1137" href="#L1137">1137</a> <strong class="jxr_keyword">if</strong> (i == len && s1.length() == s2.length())
-<a class="jxr_linenumber" name="L1138" href="#L1138">1138</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L1139" href="#L1139">1139</a> <strong class="jxr_keyword">return</strong> i;
-<a class="jxr_linenumber" name="L1140" href="#L1140">1140</a> }
-<a class="jxr_linenumber" name="L1141" href="#L1141">1141</a>
-<a class="jxr_linenumber" name="L1142" href="#L1142">1142</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1143" href="#L1143">1143</a> <em class="jxr_javadoccomment"> * Finds the position where the two strings first differ, ignoring case.</em>
-<a class="jxr_linenumber" name="L1144" href="#L1144">1144</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1145" href="#L1145">1145</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1146" href="#L1146">1146</a> <em class="jxr_javadoccomment"> * This method compares strings character by character (case-insensitive) and returns the index of the first position</em>
-<a class="jxr_linenumber" name="L1147" href="#L1147">1147</a> <em class="jxr_javadoccomment"> * where they differ. If the strings are equal (ignoring case), returns <c>-1</c>. If one string is a prefix of the other,</em>
-<a class="jxr_linenumber" name="L1148" href="#L1148">1148</a> <em class="jxr_javadoccomment"> * returns the length of the shorter string.</em>
-<a class="jxr_linenumber" name="L1149" href="#L1149">1149</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1150" href="#L1150">1150</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1151" href="#L1151">1151</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1152" href="#L1152">1152</a> <em class="jxr_javadoccomment"> * diffPositionIc(<js>"Apple"</js>, <js>"apple"</js>); <jc>// -1 (equal ignoring case)</jc></em>
-<a class="jxr_linenumber" name="L1153" href="#L1153">1153</a> <em class="jxr_javadoccomment"> * diffPositionIc(<js>"Apple"</js>, <js>"Apricot"</js>); <jc>// 2 (differs at 'p' vs 'r')</jc></em>
-<a class="jxr_linenumber" name="L1154" href="#L1154">1154</a> <em class="jxr_javadoccomment"> * diffPositionIc(<js>"APPLE"</js>, <js>"app"</js>); <jc>// 3 (shorter string ends here)</jc></em>
-<a class="jxr_linenumber" name="L1155" href="#L1155">1155</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1156" href="#L1156">1156</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1157" href="#L1157">1157</a> <em class="jxr_javadoccomment"> * @param s1 The first string.</em>
-<a class="jxr_linenumber" name="L1158" href="#L1158">1158</a> <em class="jxr_javadoccomment"> * @param s2 The second string.</em>
-<a class="jxr_linenumber" name="L1159" href="#L1159">1159</a> <em class="jxr_javadoccomment"> * @return The position where the two strings differ, or <c>-1</c> if they're equal (ignoring case).</em>
-<a class="jxr_linenumber" name="L1160" href="#L1160">1160</a> <em class="jxr_javadoccomment"> * @see #diffPosition(String, String)</em>
-<a class="jxr_linenumber" name="L1161" href="#L1161">1161</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1162" href="#L1162">1162</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> diffPositionIc(String s1, String s2) {
-<a class="jxr_linenumber" name="L1163" href="#L1163">1163</a> s1 = emptyIfNull(s1);
-<a class="jxr_linenumber" name="L1164" href="#L1164">1164</a> s2 = emptyIfNull(s2);
-<a class="jxr_linenumber" name="L1165" href="#L1165">1165</a> <strong class="jxr_keyword">var</strong> i = 0;
-<a class="jxr_linenumber" name="L1166" href="#L1166">1166</a> <strong class="jxr_keyword">var</strong> len = Math.min(s1.length(), s2.length());
-<a class="jxr_linenumber" name="L1167" href="#L1167">1167</a> <strong class="jxr_keyword">while</strong> (i < len) {
-<a class="jxr_linenumber" name="L1168" href="#L1168">1168</a> <strong class="jxr_keyword">var</strong> j = toLowerCase(s1.charAt(i)) - toLowerCase(s2.charAt(i));
-<a class="jxr_linenumber" name="L1169" href="#L1169">1169</a> <strong class="jxr_keyword">if</strong> (j != 0)
-<a class="jxr_linenumber" name="L1170" href="#L1170">1170</a> <strong class="jxr_keyword">return</strong> i;
-<a class="jxr_linenumber" name="L1171" href="#L1171">1171</a> i++;
-<a class="jxr_linenumber" name="L1172" href="#L1172">1172</a> }
-<a class="jxr_linenumber" name="L1173" href="#L1173">1173</a> <strong class="jxr_keyword">if</strong> (i == len && s1.length() == s2.length())
-<a class="jxr_linenumber" name="L1174" href="#L1174">1174</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L1175" href="#L1175">1175</a> <strong class="jxr_keyword">return</strong> i;
-<a class="jxr_linenumber" name="L1176" href="#L1176">1176</a> }
-<a class="jxr_linenumber" name="L1177" href="#L1177">1177</a>
-<a class="jxr_linenumber" name="L1178" href="#L1178">1178</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1179" href="#L1179">1179</a> <em class="jxr_javadoccomment"> * Removes duplicate elements from a string array, preserving order.</em>
-<a class="jxr_linenumber" name="L1180" href="#L1180">1180</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1181" href="#L1181">1181</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1182" href="#L1182">1182</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1183" href="#L1183">1183</a> <em class="jxr_javadoccomment"> * Uses a {@link LinkedHashSet} to preserve insertion order while removing duplicates.</em>
-<a class="jxr_linenumber" name="L1184" href="#L1184">1184</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1185" href="#L1185">1185</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L1186" href="#L1186">1186</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1187" href="#L1187">1187</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>"bar"</js>, <js>"foo"</js>, <js>"baz"</js>, <js>"bar"</js>};</em>
-<a class="jxr_linenumber" name="L1188" href="#L1188">1188</a> <em class="jxr_javadoccomment"> * String[] <jv>unique</jv> = distinct(<jv>array</jv>);</em>
-<a class="jxr_linenumber" name="L1189" href="#L1189">1189</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["foo", "bar", "baz"]</jc></em>
-<a class="jxr_linenumber" name="L1190" href="#L1190">1190</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1191" href="#L1191">1191</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1192" href="#L1192">1192</a> <em class="jxr_javadoccomment"> * @param array The array to process. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1193" href="#L1193">1193</a> <em class="jxr_javadoccomment"> * @return A new array with duplicate elements removed, or <jk>null</jk> if the array was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1194" href="#L1194">1194</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1195" href="#L1195">1195</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] distinct(String[] array) {
-<a class="jxr_linenumber" name="L1196" href="#L1196">1196</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1197" href="#L1197">1197</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L1198" href="#L1198">1198</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).collect(Collectors.toCollection(LinkedHashSet::<strong class="jxr_keyword">new</strong>)).toArray(<strong class="jxr_keyword">new</strong> String[0]);
-<a class="jxr_linenumber" name="L1199" href="#L1199">1199</a> }
-<a class="jxr_linenumber" name="L1200" href="#L1200">1200</a>
-<a class="jxr_linenumber" name="L1201" href="#L1201">1201</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1202" href="#L1202">1202</a> <em class="jxr_javadoccomment"> * Generates a Double Metaphone code for a string.</em>
-<a class="jxr_linenumber" name="L1203" href="#L1203">1203</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1204" href="#L1204">1204</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1205" href="#L1205">1205</a> <em class="jxr_javadoccomment"> * Double Metaphone is an improved version of Metaphone that returns two codes:</em>
-<a class="jxr_linenumber" name="L1206" href="#L1206">1206</a> <em class="jxr_javadoccomment"> * a primary code and an alternate code. This handles more edge cases and variations.</em>
-<a class="jxr_linenumber" name="L1207" href="#L1207">1207</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1208" href="#L1208">1208</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1209" href="#L1209">1209</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1210" href="#L1210">1210</a> <em class="jxr_javadoccomment"> * doubleMetaphone(<js>"Smith"</js>); <jc>// "SM0"</jc></em>
-<a class="jxr_linenumber" name="L1211" href="#L1211">1211</a> <em class="jxr_javadoccomment"> * doubleMetaphone(<js>"Schmidt"</js>); <jc>// "XMT"</jc></em>
-<a class="jxr_linenumber" name="L1212" href="#L1212">1212</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L572" href="#L572">572</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L573" href="#L573">573</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L574" href="#L574">574</a> <em class="jxr_javadoccomment"> * clean(<js>"hello\u0000\u0001world"</js>); <jc>// "hello world"</jc></em>
+<a class="jxr_linenumber" name="L575" href="#L575">575</a> <em class="jxr_javadoccomment"> * clean(<js>"hello \t\n world"</js>); <jc>// "hello world"</jc></em>
+<a class="jxr_linenumber" name="L576" href="#L576">576</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L577" href="#L577">577</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L578" href="#L578">578</a> <em class="jxr_javadoccomment"> * @param str The string to clean.</em>
+<a class="jxr_linenumber" name="L579" href="#L579">579</a> <em class="jxr_javadoccomment"> * @return The cleaned string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L580" href="#L580">580</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L581" href="#L581">581</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String clean(String str) {
+<a class="jxr_linenumber" name="L582" href="#L582">582</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L583" href="#L583">583</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L584" href="#L584">584</a> str = removeControlChars(str);
+<a class="jxr_linenumber" name="L585" href="#L585">585</a> <strong class="jxr_keyword">return</strong> normalizeWhitespace(str);
+<a class="jxr_linenumber" name="L586" href="#L586">586</a> }
+<a class="jxr_linenumber" name="L587" href="#L587">587</a>
+<a class="jxr_linenumber" name="L588" href="#L588">588</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L589" href="#L589">589</a> <em class="jxr_javadoccomment"> * Compares two strings lexicographically, but gracefully handles <jk>null</jk> values.</em>
+<a class="jxr_linenumber" name="L590" href="#L590">590</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L591" href="#L591">591</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L592" href="#L592">592</a> <em class="jxr_javadoccomment"> * Null handling:</em>
+<a class="jxr_linenumber" name="L593" href="#L593">593</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L594" href="#L594">594</a> <em class="jxr_javadoccomment"> * <li>Both <jk>null</jk> → returns <c>0</c> (equal)</li></em>
+<a class="jxr_linenumber" name="L595" href="#L595">595</a> <em class="jxr_javadoccomment"> * <li>First <jk>null</jk> → returns {@link Integer#MIN_VALUE}</li></em>
+<a class="jxr_linenumber" name="L596" href="#L596">596</a> <em class="jxr_javadoccomment"> * <li>Second <jk>null</jk> → returns {@link Integer#MAX_VALUE}</li></em>
+<a class="jxr_linenumber" name="L597" href="#L597">597</a> <em class="jxr_javadoccomment"> * <li>Neither <jk>null</jk> → returns the same as {@link String#compareTo(String)}</li></em>
+<a class="jxr_linenumber" name="L598" href="#L598">598</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L599" href="#L599">599</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L600" href="#L600">600</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L601" href="#L601">601</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L602" href="#L602">602</a> <em class="jxr_javadoccomment"> * compare(<js>"apple"</js>, <js>"banana"</js>); <jc>// negative (apple &lt; banana)</jc></em>
+<a class="jxr_linenumber" name="L603" href="#L603">603</a> <em class="jxr_javadoccomment"> * compare(<js>"banana"</js>, <js>"apple"</js>); <jc>// positive (banana &gt; apple)</jc></em>
+<a class="jxr_linenumber" name="L604" href="#L604">604</a> <em class="jxr_javadoccomment"> * compare(<js>"apple"</js>, <js>"apple"</js>); <jc>// 0 (equal)</jc></em>
+<a class="jxr_linenumber" name="L605" href="#L605">605</a> <em class="jxr_javadoccomment"> * compare(<jk>null</jk>, <jk>null</jk>); <jc>// 0 (equal)</jc></em>
+<a class="jxr_linenumber" name="L606" href="#L606">606</a> <em class="jxr_javadoccomment"> * compare(<jk>null</jk>, <js>"apple"</js>); <jc>// Integer.MIN_VALUE</jc></em>
+<a class="jxr_linenumber" name="L607" href="#L607">607</a> <em class="jxr_javadoccomment"> * compare(<js>"apple"</js>, <jk>null</jk>); <jc>// Integer.MAX_VALUE</jc></em>
+<a class="jxr_linenumber" name="L608" href="#L608">608</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L609" href="#L609">609</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L610" href="#L610">610</a> <em class="jxr_javadoccomment"> * @param s1 The first string.</em>
+<a class="jxr_linenumber" name="L611" href="#L611">611</a> <em class="jxr_javadoccomment"> * @param s2 The second string.</em>
+<a class="jxr_linenumber" name="L612" href="#L612">612</a> <em class="jxr_javadoccomment"> * @return A negative integer, zero, or a positive integer as the first string is less than, equal to, or greater than the second.</em>
+<a class="jxr_linenumber" name="L613" href="#L613">613</a> <em class="jxr_javadoccomment"> * @see String#compareTo(String)</em>
+<a class="jxr_linenumber" name="L614" href="#L614">614</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L615" href="#L615">615</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> compare(String s1, String s2) {
+<a class="jxr_linenumber" name="L616" href="#L616">616</a> <strong class="jxr_keyword">if</strong> (s1 == <strong class="jxr_keyword">null</strong> && s2 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L617" href="#L617">617</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L618" href="#L618">618</a> <strong class="jxr_keyword">if</strong> (s1 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L619" href="#L619">619</a> <strong class="jxr_keyword">return</strong> Integer.MIN_VALUE;
+<a class="jxr_linenumber" name="L620" href="#L620">620</a> <strong class="jxr_keyword">if</strong> (s2 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L621" href="#L621">621</a> <strong class="jxr_keyword">return</strong> Integer.MAX_VALUE;
+<a class="jxr_linenumber" name="L622" href="#L622">622</a> <strong class="jxr_keyword">return</strong> s1.compareTo(s2);
+<a class="jxr_linenumber" name="L623" href="#L623">623</a> }
+<a class="jxr_linenumber" name="L624" href="#L624">624</a>
+<a class="jxr_linenumber" name="L625" href="#L625">625</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L626" href="#L626">626</a> <em class="jxr_javadoccomment"> * Compares two strings lexicographically, ignoring case.</em>
+<a class="jxr_linenumber" name="L627" href="#L627">627</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L628" href="#L628">628</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L629" href="#L629">629</a> <em class="jxr_javadoccomment"> * Returns a negative integer, zero, or a positive integer as the first string is less than, equal to, or greater than the second string, ignoring case.</em>
+<a class="jxr_linenumber" name="L630" href="#L630">630</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L631" href="#L631">631</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L632" href="#L632">632</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L633" href="#L633">633</a> <em class="jxr_javadoccomment"> * compareIgnoreCase(<js>"apple"</js>, <js>"BANANA"</js>); <jc>// negative (apple &lt; banana)</jc></em>
+<a class="jxr_linenumber" name="L634" href="#L634">634</a> <em class="jxr_javadoccomment"> * compareIgnoreCase(<js>"Hello"</js>, <js>"hello"</js>); <jc>// 0 (equal)</jc></em>
+<a class="jxr_linenumber" name="L635" href="#L635">635</a> <em class="jxr_javadoccomment"> * compareIgnoreCase(<js>"Zebra"</js>, <js>"apple"</js>); <jc>// positive (zebra &gt; apple)</jc></em>
+<a class="jxr_linenumber" name="L636" href="#L636">636</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L637" href="#L637">637</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L638" href="#L638">638</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
+<a class="jxr_linenumber" name="L639" href="#L639">639</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
+<a class="jxr_linenumber" name="L640" href="#L640">640</a> <em class="jxr_javadoccomment"> * @return A negative integer, zero, or a positive integer as the first string is less than, equal to, or greater than the second.</em>
+<a class="jxr_linenumber" name="L641" href="#L641">641</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L642" href="#L642">642</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> compareIgnoreCase(String str1, String str2) {
+<a class="jxr_linenumber" name="L643" href="#L643">643</a> <strong class="jxr_keyword">if</strong> (str1 == str2)
+<a class="jxr_linenumber" name="L644" href="#L644">644</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L645" href="#L645">645</a> <strong class="jxr_keyword">if</strong> (str1 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L646" href="#L646">646</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L647" href="#L647">647</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L648" href="#L648">648</a> <strong class="jxr_keyword">return</strong> 1;
+<a class="jxr_linenumber" name="L649" href="#L649">649</a> <strong class="jxr_keyword">return</strong> str1.compareToIgnoreCase(str2);
+<a class="jxr_linenumber" name="L650" href="#L650">650</a> }
+<a class="jxr_linenumber" name="L651" href="#L651">651</a>
+<a class="jxr_linenumber" name="L652" href="#L652">652</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L653" href="#L653">653</a> <em class="jxr_javadoccomment"> * Compresses a UTF-8 string into a GZIP-compressed byte array.</em>
+<a class="jxr_linenumber" name="L654" href="#L654">654</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L655" href="#L655">655</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L656" href="#L656">656</a> <em class="jxr_javadoccomment"> * This method compresses the input string using GZIP compression. The string is first converted to</em>
+<a class="jxr_linenumber" name="L657" href="#L657">657</a> <em class="jxr_javadoccomment"> * UTF-8 bytes, then compressed. Use {@link #decompress(byte[])} to decompress the result.</em>
+<a class="jxr_linenumber" name="L658" href="#L658">658</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L659" href="#L659">659</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L660" href="#L660">660</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L661" href="#L661">661</a> <em class="jxr_javadoccomment"> * <jc>// Compress a string</jc></em>
+<a class="jxr_linenumber" name="L662" href="#L662">662</a> <em class="jxr_javadoccomment"> * byte[] <jv>compressed</jv> = compress(<js>"Hello World"</js>);</em>
+<a class="jxr_linenumber" name="L663" href="#L663">663</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L664" href="#L664">664</a> <em class="jxr_javadoccomment"> * <jc>// Decompress it back</jc></em>
+<a class="jxr_linenumber" name="L665" href="#L665">665</a> <em class="jxr_javadoccomment"> * String <jv>decompressed</jv> = decompress(<jv>compressed</jv>);</em>
+<a class="jxr_linenumber" name="L666" href="#L666">666</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello World"</jc></em>
+<a class="jxr_linenumber" name="L667" href="#L667">667</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L668" href="#L668">668</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L669" href="#L669">669</a> <em class="jxr_javadoccomment"> * @param contents The UTF-8 string to compress.</em>
+<a class="jxr_linenumber" name="L670" href="#L670">670</a> <em class="jxr_javadoccomment"> * @return The GZIP-compressed byte array.</em>
+<a class="jxr_linenumber" name="L671" href="#L671">671</a> <em class="jxr_javadoccomment"> * @throws Exception If compression fails.</em>
+<a class="jxr_linenumber" name="L672" href="#L672">672</a> <em class="jxr_javadoccomment"> * @see #decompress(byte[])</em>
+<a class="jxr_linenumber" name="L673" href="#L673">673</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L674" href="#L674">674</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] compress(String contents) <strong class="jxr_keyword">throws</strong> Exception {
+<a class="jxr_linenumber" name="L675" href="#L675">675</a> <strong class="jxr_keyword">var</strong> baos = <strong class="jxr_keyword">new</strong> ByteArrayOutputStream(contents.length() >> 1);
+<a class="jxr_linenumber" name="L676" href="#L676">676</a> <strong class="jxr_keyword">try</strong> (<strong class="jxr_keyword">var</strong> gos = <strong class="jxr_keyword">new</strong> GZIPOutputStream(baos)) {
+<a class="jxr_linenumber" name="L677" href="#L677">677</a> gos.write(contents.getBytes());
+<a class="jxr_linenumber" name="L678" href="#L678">678</a> gos.finish();
+<a class="jxr_linenumber" name="L679" href="#L679">679</a> gos.flush();
+<a class="jxr_linenumber" name="L680" href="#L680">680</a> <strong class="jxr_keyword">return</strong> baos.toByteArray();
+<a class="jxr_linenumber" name="L681" href="#L681">681</a> }
+<a class="jxr_linenumber" name="L682" href="#L682">682</a> }
+<a class="jxr_linenumber" name="L683" href="#L683">683</a>
+<a class="jxr_linenumber" name="L684" href="#L684">684</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L685" href="#L685">685</a> <em class="jxr_javadoccomment"> * Checks if a string contains the specified character.</em>
+<a class="jxr_linenumber" name="L686" href="#L686">686</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L687" href="#L687">687</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L688" href="#L688">688</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L689" href="#L689">689</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L690" href="#L690">690</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L691" href="#L691">691</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L692" href="#L692">692</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>'o'</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L693" href="#L693">693</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>'x'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L694" href="#L694">694</a> <em class="jxr_javadoccomment"> * contains(<jk>null</jk>, <js>'a'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L695" href="#L695">695</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L696" href="#L696">696</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L697" href="#L697">697</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L698" href="#L698">698</a> <em class="jxr_javadoccomment"> * @param c The character to check for.</em>
+<a class="jxr_linenumber" name="L699" href="#L699">699</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains the specified character.</em>
+<a class="jxr_linenumber" name="L700" href="#L700">700</a> <em class="jxr_javadoccomment"> * @see #contains(String, CharSequence)</em>
+<a class="jxr_linenumber" name="L701" href="#L701">701</a> <em class="jxr_javadoccomment"> * @see #contains(String, String)</em>
+<a class="jxr_linenumber" name="L702" href="#L702">702</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, char...)</em>
+<a class="jxr_linenumber" name="L703" href="#L703">703</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L704" href="#L704">704</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> contains(String s, <strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L705" href="#L705">705</a> <strong class="jxr_keyword">return</strong> s != <strong class="jxr_keyword">null</strong> && s.indexOf(c) >= 0;
+<a class="jxr_linenumber" name="L706" href="#L706">706</a> }
+<a class="jxr_linenumber" name="L707" href="#L707">707</a>
+<a class="jxr_linenumber" name="L708" href="#L708">708</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L709" href="#L709">709</a> <em class="jxr_javadoccomment"> * Null-safe {@link String#contains(CharSequence)} operation.</em>
+<a class="jxr_linenumber" name="L710" href="#L710">710</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L711" href="#L711">711</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L712" href="#L712">712</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the string is <jk>null</jk>, otherwise behaves the same as</em>
+<a class="jxr_linenumber" name="L713" href="#L713">713</a> <em class="jxr_javadoccomment"> * {@link String#contains(CharSequence)}.</em>
+<a class="jxr_linenumber" name="L714" href="#L714">714</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L715" href="#L715">715</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L716" href="#L716">716</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L717" href="#L717">717</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>"World"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L718" href="#L718">718</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>"Foo"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L719" href="#L719">719</a> <em class="jxr_javadoccomment"> * contains(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L720" href="#L720">720</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L721" href="#L721">721</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L722" href="#L722">722</a> <em class="jxr_javadoccomment"> * @param value The string to check.</em>
+<a class="jxr_linenumber" name="L723" href="#L723">723</a> <em class="jxr_javadoccomment"> * @param substring The substring to check for.</em>
+<a class="jxr_linenumber" name="L724" href="#L724">724</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the value contains the specified substring, <jk>false</jk> if the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L725" href="#L725">725</a> <em class="jxr_javadoccomment"> * @see #contains(String, char)</em>
+<a class="jxr_linenumber" name="L726" href="#L726">726</a> <em class="jxr_javadoccomment"> * @see #contains(String, String)</em>
+<a class="jxr_linenumber" name="L727" href="#L727">727</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, CharSequence...)</em>
+<a class="jxr_linenumber" name="L728" href="#L728">728</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L729" href="#L729">729</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> contains(String value, CharSequence substring) {
+<a class="jxr_linenumber" name="L730" href="#L730">730</a> <strong class="jxr_keyword">return</strong> nn(value) && value.contains(substring);
+<a class="jxr_linenumber" name="L731" href="#L731">731</a> }
+<a class="jxr_linenumber" name="L732" href="#L732">732</a>
+<a class="jxr_linenumber" name="L733" href="#L733">733</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L734" href="#L734">734</a> <em class="jxr_javadoccomment"> * Null-safe check if a string contains another string.</em>
+<a class="jxr_linenumber" name="L735" href="#L735">735</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L736" href="#L736">736</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L737" href="#L737">737</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the string is <jk>null</jk>, otherwise behaves the same as</em>
+<a class="jxr_linenumber" name="L738" href="#L738">738</a> <em class="jxr_javadoccomment"> * {@link String#contains(CharSequence)}.</em>
+<a class="jxr_linenumber" name="L739" href="#L739">739</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L740" href="#L740">740</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L741" href="#L741">741</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L742" href="#L742">742</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>"World"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L743" href="#L743">743</a> <em class="jxr_javadoccomment"> * contains(<js>"Hello World"</js>, <js>"Foo"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L744" href="#L744">744</a> <em class="jxr_javadoccomment"> * contains(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L745" href="#L745">745</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L746" href="#L746">746</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L747" href="#L747">747</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L748" href="#L748">748</a> <em class="jxr_javadoccomment"> * @param substring The substring to check for.</em>
+<a class="jxr_linenumber" name="L749" href="#L749">749</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains the specified substring, <jk>false</jk> if the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L750" href="#L750">750</a> <em class="jxr_javadoccomment"> * @see #contains(String, CharSequence)</em>
+<a class="jxr_linenumber" name="L751" href="#L751">751</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, String...)</em>
+<a class="jxr_linenumber" name="L752" href="#L752">752</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L753" href="#L753">753</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> contains(String s, String substring) {
+<a class="jxr_linenumber" name="L754" href="#L754">754</a> <strong class="jxr_keyword">return</strong> nn(s) && s.contains(substring);
+<a class="jxr_linenumber" name="L755" href="#L755">755</a> }
+<a class="jxr_linenumber" name="L756" href="#L756">756</a>
+<a class="jxr_linenumber" name="L757" href="#L757">757</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L758" href="#L758">758</a> <em class="jxr_javadoccomment"> * Checks if a string contains all of the specified characters.</em>
+<a class="jxr_linenumber" name="L759" href="#L759">759</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L760" href="#L760">760</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L761" href="#L761">761</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
+<a class="jxr_linenumber" name="L762" href="#L762">762</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L763" href="#L763">763</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L764" href="#L764">764</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L765" href="#L765">765</a> <em class="jxr_javadoccomment"> * <li>Any of the specified characters are not found in the string</li></em>
+<a class="jxr_linenumber" name="L766" href="#L766">766</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L767" href="#L767">767</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L768" href="#L768">768</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L769" href="#L769">769</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L770" href="#L770">770</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>'H'</js>, <js>'e'</js>, <js>'l'</js>); <jc>// true (contains all)</jc></em>
+<a class="jxr_linenumber" name="L771" href="#L771">771</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>'H'</js>, <js>'x'</js>); <jc>// false (missing 'x')</jc></em>
+<a class="jxr_linenumber" name="L772" href="#L772">772</a> <em class="jxr_javadoccomment"> * containsAll(<jk>null</jk>, <js>'a'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L773" href="#L773">773</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L774" href="#L774">774</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L775" href="#L775">775</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L776" href="#L776">776</a> <em class="jxr_javadoccomment"> * @param values The characters to check for.</em>
+<a class="jxr_linenumber" name="L777" href="#L777">777</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains all of the specified characters.</em>
+<a class="jxr_linenumber" name="L778" href="#L778">778</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, char...)</em>
+<a class="jxr_linenumber" name="L779" href="#L779">779</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L780" href="#L780">780</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAll(String s, <strong class="jxr_keyword">char</strong>...values) {
+<a class="jxr_linenumber" name="L781" href="#L781">781</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
+<a class="jxr_linenumber" name="L782" href="#L782">782</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L783" href="#L783">783</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
+<a class="jxr_linenumber" name="L784" href="#L784">784</a> <strong class="jxr_keyword">if</strong> (s.indexOf(v) < 0)
+<a class="jxr_linenumber" name="L785" href="#L785">785</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L786" href="#L786">786</a> }
+<a class="jxr_linenumber" name="L787" href="#L787">787</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L788" href="#L788">788</a> }
+<a class="jxr_linenumber" name="L789" href="#L789">789</a>
+<a class="jxr_linenumber" name="L790" href="#L790">790</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L791" href="#L791">791</a> <em class="jxr_javadoccomment"> * Checks if a string contains all of the specified substrings.</em>
+<a class="jxr_linenumber" name="L792" href="#L792">792</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L793" href="#L793">793</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L794" href="#L794">794</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
+<a class="jxr_linenumber" name="L795" href="#L795">795</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L796" href="#L796">796</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L797" href="#L797">797</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L798" href="#L798">798</a> <em class="jxr_javadoccomment"> * <li>Any of the specified substrings are not found in the string</li></em>
+<a class="jxr_linenumber" name="L799" href="#L799">799</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L800" href="#L800">800</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L801" href="#L801">801</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L802" href="#L802">802</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L803" href="#L803">803</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"World"</js>); <jc>// true (contains all)</jc></em>
+<a class="jxr_linenumber" name="L804" href="#L804">804</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// false (missing "Foo")</jc></em>
+<a class="jxr_linenumber" name="L805" href="#L805">805</a> <em class="jxr_javadoccomment"> * containsAll(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L806" href="#L806">806</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L807" href="#L807">807</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L808" href="#L808">808</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L809" href="#L809">809</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
+<a class="jxr_linenumber" name="L810" href="#L810">810</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains all of the specified substrings.</em>
+<a class="jxr_linenumber" name="L811" href="#L811">811</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, CharSequence...)</em>
+<a class="jxr_linenumber" name="L812" href="#L812">812</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L813" href="#L813">813</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAll(String s, CharSequence...values) {
+<a class="jxr_linenumber" name="L814" href="#L814">814</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
+<a class="jxr_linenumber" name="L815" href="#L815">815</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L816" href="#L816">816</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
+<a class="jxr_linenumber" name="L817" href="#L817">817</a> <strong class="jxr_keyword">if</strong> (! s.contains(v))
+<a class="jxr_linenumber" name="L818" href="#L818">818</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L819" href="#L819">819</a> }
+<a class="jxr_linenumber" name="L820" href="#L820">820</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L821" href="#L821">821</a> }
+<a class="jxr_linenumber" name="L822" href="#L822">822</a>
+<a class="jxr_linenumber" name="L823" href="#L823">823</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L824" href="#L824">824</a> <em class="jxr_javadoccomment"> * Checks if a string contains all of the specified substrings.</em>
+<a class="jxr_linenumber" name="L825" href="#L825">825</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L826" href="#L826">826</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L827" href="#L827">827</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
+<a class="jxr_linenumber" name="L828" href="#L828">828</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L829" href="#L829">829</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L830" href="#L830">830</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L831" href="#L831">831</a> <em class="jxr_javadoccomment"> * <li>Any of the specified substrings are not found in the string</li></em>
+<a class="jxr_linenumber" name="L832" href="#L832">832</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L833" href="#L833">833</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L834" href="#L834">834</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L835" href="#L835">835</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L836" href="#L836">836</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"World"</js>); <jc>// true (contains all)</jc></em>
+<a class="jxr_linenumber" name="L837" href="#L837">837</a> <em class="jxr_javadoccomment"> * containsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// false (missing "Foo")</jc></em>
+<a class="jxr_linenumber" name="L838" href="#L838">838</a> <em class="jxr_javadoccomment"> * containsAll(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L839" href="#L839">839</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L840" href="#L840">840</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L841" href="#L841">841</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L842" href="#L842">842</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
+<a class="jxr_linenumber" name="L843" href="#L843">843</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains all of the specified substrings.</em>
+<a class="jxr_linenumber" name="L844" href="#L844">844</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, String...)</em>
+<a class="jxr_linenumber" name="L845" href="#L845">845</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L846" href="#L846">846</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAll(String s, String...values) {
+<a class="jxr_linenumber" name="L847" href="#L847">847</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
+<a class="jxr_linenumber" name="L848" href="#L848">848</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L849" href="#L849">849</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
+<a class="jxr_linenumber" name="L850" href="#L850">850</a> <strong class="jxr_keyword">if</strong> (! s.contains(v))
+<a class="jxr_linenumber" name="L851" href="#L851">851</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L852" href="#L852">852</a> }
+<a class="jxr_linenumber" name="L853" href="#L853">853</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L854" href="#L854">854</a> }
+<a class="jxr_linenumber" name="L855" href="#L855">855</a>
+<a class="jxr_linenumber" name="L856" href="#L856">856</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L857" href="#L857">857</a> <em class="jxr_javadoccomment"> * Checks if a string contains any of the specified characters.</em>
+<a class="jxr_linenumber" name="L858" href="#L858">858</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L859" href="#L859">859</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L860" href="#L860">860</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
+<a class="jxr_linenumber" name="L861" href="#L861">861</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L862" href="#L862">862</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L863" href="#L863">863</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L864" href="#L864">864</a> <em class="jxr_javadoccomment"> * <li>None of the specified characters are found in the string</li></em>
+<a class="jxr_linenumber" name="L865" href="#L865">865</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L866" href="#L866">866</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L867" href="#L867">867</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L868" href="#L868">868</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L869" href="#L869">869</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>'o'</js>, <js>'x'</js>); <jc>// true (contains 'o')</jc></em>
+<a class="jxr_linenumber" name="L870" href="#L870">870</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>'x'</js>, <js>'y'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L871" href="#L871">871</a> <em class="jxr_javadoccomment"> * containsAny(<jk>null</jk>, <js>'a'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L872" href="#L872">872</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L873" href="#L873">873</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L874" href="#L874">874</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L875" href="#L875">875</a> <em class="jxr_javadoccomment"> * @param values The characters to check for.</em>
+<a class="jxr_linenumber" name="L876" href="#L876">876</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains any of the specified characters.</em>
+<a class="jxr_linenumber" name="L877" href="#L877">877</a> <em class="jxr_javadoccomment"> * @see #contains(String, char)</em>
+<a class="jxr_linenumber" name="L878" href="#L878">878</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, char...)</em>
+<a class="jxr_linenumber" name="L879" href="#L879">879</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L880" href="#L880">880</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAny(String s, <strong class="jxr_keyword">char</strong>...values) {
+<a class="jxr_linenumber" name="L881" href="#L881">881</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
+<a class="jxr_linenumber" name="L882" href="#L882">882</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L883" href="#L883">883</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
+<a class="jxr_linenumber" name="L884" href="#L884">884</a> <strong class="jxr_keyword">if</strong> (s.indexOf(v) >= 0)
+<a class="jxr_linenumber" name="L885" href="#L885">885</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L886" href="#L886">886</a> }
+<a class="jxr_linenumber" name="L887" href="#L887">887</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L888" href="#L888">888</a> }
+<a class="jxr_linenumber" name="L889" href="#L889">889</a>
+<a class="jxr_linenumber" name="L890" href="#L890">890</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L891" href="#L891">891</a> <em class="jxr_javadoccomment"> * Checks if a string contains any of the specified substrings.</em>
+<a class="jxr_linenumber" name="L892" href="#L892">892</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L893" href="#L893">893</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L894" href="#L894">894</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
+<a class="jxr_linenumber" name="L895" href="#L895">895</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L896" href="#L896">896</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L897" href="#L897">897</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L898" href="#L898">898</a> <em class="jxr_javadoccomment"> * <li>None of the specified substrings are found in the string</li></em>
+<a class="jxr_linenumber" name="L899" href="#L899">899</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L900" href="#L900">900</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L901" href="#L901">901</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L902" href="#L902">902</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L903" href="#L903">903</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// true (contains "Hello")</jc></em>
+<a class="jxr_linenumber" name="L904" href="#L904">904</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>"Foo"</js>, <js>"Bar"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L905" href="#L905">905</a> <em class="jxr_javadoccomment"> * containsAny(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L906" href="#L906">906</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L907" href="#L907">907</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L908" href="#L908">908</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L909" href="#L909">909</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
+<a class="jxr_linenumber" name="L910" href="#L910">910</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains any of the specified substrings.</em>
+<a class="jxr_linenumber" name="L911" href="#L911">911</a> <em class="jxr_javadoccomment"> * @see #contains(String, CharSequence)</em>
+<a class="jxr_linenumber" name="L912" href="#L912">912</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, CharSequence...)</em>
+<a class="jxr_linenumber" name="L913" href="#L913">913</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L914" href="#L914">914</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAny(String s, CharSequence...values) {
+<a class="jxr_linenumber" name="L915" href="#L915">915</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
+<a class="jxr_linenumber" name="L916" href="#L916">916</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L917" href="#L917">917</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
+<a class="jxr_linenumber" name="L918" href="#L918">918</a> <strong class="jxr_keyword">if</strong> (s.contains(v))
+<a class="jxr_linenumber" name="L919" href="#L919">919</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L920" href="#L920">920</a> }
+<a class="jxr_linenumber" name="L921" href="#L921">921</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L922" href="#L922">922</a> }
+<a class="jxr_linenumber" name="L923" href="#L923">923</a>
+<a class="jxr_linenumber" name="L924" href="#L924">924</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L925" href="#L925">925</a> <em class="jxr_javadoccomment"> * Checks if a string contains any of the specified substrings.</em>
+<a class="jxr_linenumber" name="L926" href="#L926">926</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L927" href="#L927">927</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L928" href="#L928">928</a> <em class="jxr_javadoccomment"> * This is a null-safe operation that returns <jk>false</jk> if:</em>
+<a class="jxr_linenumber" name="L929" href="#L929">929</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L930" href="#L930">930</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L931" href="#L931">931</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L932" href="#L932">932</a> <em class="jxr_javadoccomment"> * <li>None of the specified substrings are found in the string</li></em>
+<a class="jxr_linenumber" name="L933" href="#L933">933</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L934" href="#L934">934</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L935" href="#L935">935</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L936" href="#L936">936</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L937" href="#L937">937</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// true (contains "Hello")</jc></em>
+<a class="jxr_linenumber" name="L938" href="#L938">938</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello World"</js>, <js>"Foo"</js>, <js>"Bar"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L939" href="#L939">939</a> <em class="jxr_javadoccomment"> * containsAny(<jk>null</jk>, <js>"Hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L940" href="#L940">940</a> <em class="jxr_javadoccomment"> * containsAny(<js>"Hello"</js>); <jc>// false (no values to check)</jc></em>
+<a class="jxr_linenumber" name="L941" href="#L941">941</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L942" href="#L942">942</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L943" href="#L943">943</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L944" href="#L944">944</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
+<a class="jxr_linenumber" name="L945" href="#L945">945</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains any of the specified substrings.</em>
+<a class="jxr_linenumber" name="L946" href="#L946">946</a> <em class="jxr_javadoccomment"> * @see #contains(String, String)</em>
+<a class="jxr_linenumber" name="L947" href="#L947">947</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, String...)</em>
+<a class="jxr_linenumber" name="L948" href="#L948">948</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L949" href="#L949">949</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsAny(String s, String...values) {
+<a class="jxr_linenumber" name="L950" href="#L950">950</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || values == <strong class="jxr_keyword">null</strong> || values.length == 0)
+<a class="jxr_linenumber" name="L951" href="#L951">951</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L952" href="#L952">952</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : values) {
+<a class="jxr_linenumber" name="L953" href="#L953">953</a> <strong class="jxr_keyword">if</strong> (s.contains(v))
+<a class="jxr_linenumber" name="L954" href="#L954">954</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L955" href="#L955">955</a> }
+<a class="jxr_linenumber" name="L956" href="#L956">956</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L957" href="#L957">957</a> }
+<a class="jxr_linenumber" name="L958" href="#L958">958</a>
+<a class="jxr_linenumber" name="L959" href="#L959">959</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L960" href="#L960">960</a> <em class="jxr_javadoccomment"> * Checks if a string contains a substring, ignoring case.</em>
+<a class="jxr_linenumber" name="L961" href="#L961">961</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L962" href="#L962">962</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L963" href="#L963">963</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L964" href="#L964">964</a> <em class="jxr_javadoccomment"> * containsIgnoreCase(<js>"Hello World"</js>, <js>"world"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L965" href="#L965">965</a> <em class="jxr_javadoccomment"> * containsIgnoreCase(<js>"Hello World"</js>, <js>"WORLD"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L966" href="#L966">966</a> <em class="jxr_javadoccomment"> * containsIgnoreCase(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L967" href="#L967">967</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L968" href="#L968">968</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L969" href="#L969">969</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
+<a class="jxr_linenumber" name="L970" href="#L970">970</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
+<a class="jxr_linenumber" name="L971" href="#L971">971</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string contains the substring (ignoring case), <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L972" href="#L972">972</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L973" href="#L973">973</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> containsIgnoreCase(String str, String search) {
+<a class="jxr_linenumber" name="L974" href="#L974">974</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L975" href="#L975">975</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L976" href="#L976">976</a> <strong class="jxr_keyword">return</strong> str.toLowerCase().contains(search.toLowerCase());
+<a class="jxr_linenumber" name="L977" href="#L977">977</a> }
+<a class="jxr_linenumber" name="L978" href="#L978">978</a>
+<a class="jxr_linenumber" name="L979" href="#L979">979</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L980" href="#L980">980</a> <em class="jxr_javadoccomment"> * Counts the number of occurrences of the specified character in the specified string.</em>
+<a class="jxr_linenumber" name="L981" href="#L981">981</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L982" href="#L982">982</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L983" href="#L983">983</a> <em class="jxr_javadoccomment"> * Returns <c>0</c> if the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L984" href="#L984">984</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L985" href="#L985">985</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L986" href="#L986">986</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L987" href="#L987">987</a> <em class="jxr_javadoccomment"> * countChars(<js>"Hello World"</js>, <js>'o'</js>); <jc>// 2</jc></em>
+<a class="jxr_linenumber" name="L988" href="#L988">988</a> <em class="jxr_javadoccomment"> * countChars(<js>"Hello World"</js>, <js>'x'</js>); <jc>// 0</jc></em>
+<a class="jxr_linenumber" name="L989" href="#L989">989</a> <em class="jxr_javadoccomment"> * countChars(<jk>null</jk>, <js>'a'</js>); <jc>// 0</jc></em>
+<a class="jxr_linenumber" name="L990" href="#L990">990</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L991" href="#L991">991</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L992" href="#L992">992</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L993" href="#L993">993</a> <em class="jxr_javadoccomment"> * @param c The character to count.</em>
+<a class="jxr_linenumber" name="L994" href="#L994">994</a> <em class="jxr_javadoccomment"> * @return The number of occurrences of the character, or <c>0</c> if the string was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L995" href="#L995">995</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L996" href="#L996">996</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> countChars(String s, <strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L997" href="#L997">997</a> <strong class="jxr_keyword">var</strong> count = 0;
+<a class="jxr_linenumber" name="L998" href="#L998">998</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L999" href="#L999">999</a> <strong class="jxr_keyword">return</strong> count;
+<a class="jxr_linenumber" name="L1000" href="#L1000">1000</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++)
+<a class="jxr_linenumber" name="L1001" href="#L1001">1001</a> <strong class="jxr_keyword">if</strong> (s.charAt(i) == c)
+<a class="jxr_linenumber" name="L1002" href="#L1002">1002</a> count++;
+<a class="jxr_linenumber" name="L1003" href="#L1003">1003</a> <strong class="jxr_keyword">return</strong> count;
+<a class="jxr_linenumber" name="L1004" href="#L1004">1004</a> }
+<a class="jxr_linenumber" name="L1005" href="#L1005">1005</a>
+<a class="jxr_linenumber" name="L1006" href="#L1006">1006</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1007" href="#L1007">1007</a> <em class="jxr_javadoccomment"> * Counts the number of occurrences of a substring within a string.</em>
+<a class="jxr_linenumber" name="L1008" href="#L1008">1008</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1009" href="#L1009">1009</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1010" href="#L1010">1010</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1011" href="#L1011">1011</a> <em class="jxr_javadoccomment"> * countMatches(<js>"hello world world"</js>, <js>"world"</js>); <jc>// 2</jc></em>
+<a class="jxr_linenumber" name="L1012" href="#L1012">1012</a> <em class="jxr_javadoccomment"> * countMatches(<js>"ababab"</js>, <js>"ab"</js>); <jc>// 3</jc></em>
+<a class="jxr_linenumber" name="L1013" href="#L1013">1013</a> <em class="jxr_javadoccomment"> * countMatches(<js>"hello"</js>, <js>"xyz"</js>); <jc>// 0</jc></em>
+<a class="jxr_linenumber" name="L1014" href="#L1014">1014</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1015" href="#L1015">1015</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1016" href="#L1016">1016</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
+<a class="jxr_linenumber" name="L1017" href="#L1017">1017</a> <em class="jxr_javadoccomment"> * @param search The substring to count.</em>
+<a class="jxr_linenumber" name="L1018" href="#L1018">1018</a> <em class="jxr_javadoccomment"> * @return The number of occurrences, or <c>0</c> if not found or if either parameter is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1019" href="#L1019">1019</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1020" href="#L1020">1020</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> countMatches(String str, String search) {
+<a class="jxr_linenumber" name="L1021" href="#L1021">1021</a> <strong class="jxr_keyword">if</strong> (isEmpty(str) || isEmpty(search))
+<a class="jxr_linenumber" name="L1022" href="#L1022">1022</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L1023" href="#L1023">1023</a> <strong class="jxr_keyword">var</strong> count = 0;
+<a class="jxr_linenumber" name="L1024" href="#L1024">1024</a> <strong class="jxr_keyword">var</strong> index = 0;
+<a class="jxr_linenumber" name="L1025" href="#L1025">1025</a> <strong class="jxr_keyword">while</strong> ((index = str.indexOf(search, index)) != -1) {
+<a class="jxr_linenumber" name="L1026" href="#L1026">1026</a> count++;
+<a class="jxr_linenumber" name="L1027" href="#L1027">1027</a> index += search.length();
+<a class="jxr_linenumber" name="L1028" href="#L1028">1028</a> }
+<a class="jxr_linenumber" name="L1029" href="#L1029">1029</a> <strong class="jxr_keyword">return</strong> count;
+<a class="jxr_linenumber" name="L1030" href="#L1030">1030</a> }
+<a class="jxr_linenumber" name="L1031" href="#L1031">1031</a>
+<a class="jxr_linenumber" name="L1032" href="#L1032">1032</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1033" href="#L1033">1033</a> <em class="jxr_javadoccomment"> * Debug method for rendering non-ASCII character sequences.</em>
+<a class="jxr_linenumber" name="L1034" href="#L1034">1034</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1035" href="#L1035">1035</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1036" href="#L1036">1036</a> <em class="jxr_javadoccomment"> * Converts non-printable and non-ASCII characters (outside the range <c>0x20-0x7E</c>) to hexadecimal</em>
+<a class="jxr_linenumber" name="L1037" href="#L1037">1037</a> <em class="jxr_javadoccomment"> * sequences in the format <js>"[hex]"</js>. Printable ASCII characters are left unchanged.</em>
+<a class="jxr_linenumber" name="L1038" href="#L1038">1038</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1039" href="#L1039">1039</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1040" href="#L1040">1040</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1041" href="#L1041">1041</a> <em class="jxr_javadoccomment"> * decodeHex(<js>"Hello"</js>); <jc>// "Hello"</jc></em>
+<a class="jxr_linenumber" name="L1042" href="#L1042">1042</a> <em class="jxr_javadoccomment"> * decodeHex(<js>"Hello\u0000World"</js>); <jc>// "Hello[0]World"</jc></em>
+<a class="jxr_linenumber" name="L1043" href="#L1043">1043</a> <em class="jxr_javadoccomment"> * decodeHex(<js>"Hello\u00A9"</js>); <jc>// "Hello[a9]"</jc></em>
+<a class="jxr_linenumber" name="L1044" href="#L1044">1044</a> <em class="jxr_javadoccomment"> * decodeHex(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L1045" href="#L1045">1045</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1046" href="#L1046">1046</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1047" href="#L1047">1047</a> <em class="jxr_javadoccomment"> * @param s The string to decode.</em>
+<a class="jxr_linenumber" name="L1048" href="#L1048">1048</a> <em class="jxr_javadoccomment"> * @return A string with non-ASCII characters converted to <js>"[hex]"</js> sequences, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1049" href="#L1049">1049</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1050" href="#L1050">1050</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String decodeHex(String s) {
+<a class="jxr_linenumber" name="L1051" href="#L1051">1051</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1052" href="#L1052">1052</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1053" href="#L1053">1053</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L1054" href="#L1054">1054</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> c : s.toCharArray()) {
+<a class="jxr_linenumber" name="L1055" href="#L1055">1055</a> <strong class="jxr_keyword">if</strong> (c < ' ' || c > '~')
+<a class="jxr_linenumber" name="L1056" href="#L1056">1056</a> sb.append(<span class="jxr_string">"["</span>).append(Integer.toHexString(c)).append(<span class="jxr_string">"]"</span>);
+<a class="jxr_linenumber" name="L1057" href="#L1057">1057</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L1058" href="#L1058">1058</a> sb.append(c);
+<a class="jxr_linenumber" name="L1059" href="#L1059">1059</a> }
+<a class="jxr_linenumber" name="L1060" href="#L1060">1060</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L1061" href="#L1061">1061</a> }
+<a class="jxr_linenumber" name="L1062" href="#L1062">1062</a>
+<a class="jxr_linenumber" name="L1063" href="#L1063">1063</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1064" href="#L1064">1064</a> <em class="jxr_javadoccomment"> * Decompresses a GZIP-compressed byte array into a UTF-8 string.</em>
+<a class="jxr_linenumber" name="L1065" href="#L1065">1065</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1066" href="#L1066">1066</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1067" href="#L1067">1067</a> <em class="jxr_javadoccomment"> * This method is the inverse of {@link #compress(String)}. It takes a byte array that was compressed</em>
+<a class="jxr_linenumber" name="L1068" href="#L1068">1068</a> <em class="jxr_javadoccomment"> * using GZIP compression and decompresses it into a UTF-8 encoded string.</em>
+<a class="jxr_linenumber" name="L1069" href="#L1069">1069</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1070" href="#L1070">1070</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1071" href="#L1071">1071</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1072" href="#L1072">1072</a> <em class="jxr_javadoccomment"> * <jc>// Compress a string</jc></em>
+<a class="jxr_linenumber" name="L1073" href="#L1073">1073</a> <em class="jxr_javadoccomment"> * byte[] <jv>compressed</jv> = compress(<js>"Hello World"</js>);</em>
+<a class="jxr_linenumber" name="L1074" href="#L1074">1074</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1075" href="#L1075">1075</a> <em class="jxr_javadoccomment"> * <jc>// Decompress it back</jc></em>
+<a class="jxr_linenumber" name="L1076" href="#L1076">1076</a> <em class="jxr_javadoccomment"> * String <jv>decompressed</jv> = decompress(<jv>compressed</jv>);</em>
+<a class="jxr_linenumber" name="L1077" href="#L1077">1077</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello World"</jc></em>
+<a class="jxr_linenumber" name="L1078" href="#L1078">1078</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1079" href="#L1079">1079</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1080" href="#L1080">1080</a> <em class="jxr_javadoccomment"> * @param is The GZIP-compressed byte array to decompress.</em>
+<a class="jxr_linenumber" name="L1081" href="#L1081">1081</a> <em class="jxr_javadoccomment"> * @return The decompressed UTF-8 string.</em>
+<a class="jxr_linenumber" name="L1082" href="#L1082">1082</a> <em class="jxr_javadoccomment"> * @throws Exception If decompression fails or the input is not valid GZIP data.</em>
+<a class="jxr_linenumber" name="L1083" href="#L1083">1083</a> <em class="jxr_javadoccomment"> * @see #compress(String)</em>
+<a class="jxr_linenumber" name="L1084" href="#L1084">1084</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1085" href="#L1085">1085</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String decompress(byte[] is) <strong class="jxr_keyword">throws</strong> Exception {
+<a class="jxr_linenumber" name="L1086" href="#L1086">1086</a> <strong class="jxr_keyword">return</strong> read(<strong class="jxr_keyword">new</strong> GZIPInputStream(<strong class="jxr_keyword">new</strong> ByteArrayInputStream(is)));
+<a class="jxr_linenumber" name="L1087" href="#L1087">1087</a> }
+<a class="jxr_linenumber" name="L1088" href="#L1088">1088</a>
+<a class="jxr_linenumber" name="L1089" href="#L1089">1089</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1090" href="#L1090">1090</a> <em class="jxr_javadoccomment"> * Returns the specified string, or the default string if that string is <jk>null</jk> or blank.</em>
+<a class="jxr_linenumber" name="L1091" href="#L1091">1091</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1092" href="#L1092">1092</a> <em class="jxr_javadoccomment"> * @param str The string value to check.</em>
+<a class="jxr_linenumber" name="L1093" href="#L1093">1093</a> <em class="jxr_javadoccomment"> * @param defaultStr The default string to return if the string is <jk>null</jk> or blank.</em>
+<a class="jxr_linenumber" name="L1094" href="#L1094">1094</a> <em class="jxr_javadoccomment"> * @return The string value, or the default string if the string is <jk>null</jk> or blank.</em>
+<a class="jxr_linenumber" name="L1095" href="#L1095">1095</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1096" href="#L1096">1096</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String defaultIfBlank(String str, String defaultStr) {
+<a class="jxr_linenumber" name="L1097" href="#L1097">1097</a> <strong class="jxr_keyword">return</strong> isBlank(str) ? defaultStr : str;
+<a class="jxr_linenumber" name="L1098" href="#L1098">1098</a> }
+<a class="jxr_linenumber" name="L1099" href="#L1099">1099</a>
+<a class="jxr_linenumber" name="L1100" href="#L1100">1100</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1101" href="#L1101">1101</a> <em class="jxr_javadoccomment"> * Returns the specified string, or the default string if that string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1102" href="#L1102">1102</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1103" href="#L1103">1103</a> <em class="jxr_javadoccomment"> * @param str The string value to check.</em>
+<a class="jxr_linenumber" name="L1104" href="#L1104">1104</a> <em class="jxr_javadoccomment"> * @param defaultStr The default string to return if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1105" href="#L1105">1105</a> <em class="jxr_javadoccomment"> * @return The string value, or the default string if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1106" href="#L1106">1106</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1107" href="#L1107">1107</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String defaultIfEmpty(String str, String defaultStr) {
+<a class="jxr_linenumber" name="L1108" href="#L1108">1108</a> <strong class="jxr_keyword">return</strong> isEmpty(str) ? defaultStr : str;
+<a class="jxr_linenumber" name="L1109" href="#L1109">1109</a> }
+<a class="jxr_linenumber" name="L1110" href="#L1110">1110</a>
+<a class="jxr_linenumber" name="L1111" href="#L1111">1111</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1112" href="#L1112">1112</a> <em class="jxr_javadoccomment"> * Finds the position where the two strings first differ.</em>
+<a class="jxr_linenumber" name="L1113" href="#L1113">1113</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1114" href="#L1114">1114</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1115" href="#L1115">1115</a> <em class="jxr_javadoccomment"> * This method compares strings character by character and returns the index of the first position</em>
+<a class="jxr_linenumber" name="L1116" href="#L1116">1116</a> <em class="jxr_javadoccomment"> * where they differ. If the strings are equal, returns <c>-1</c>. If one string is a prefix of the other,</em>
+<a class="jxr_linenumber" name="L1117" href="#L1117">1117</a> <em class="jxr_javadoccomment"> * returns the length of the shorter string.</em>
+<a class="jxr_linenumber" name="L1118" href="#L1118">1118</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1119" href="#L1119">1119</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1120" href="#L1120">1120</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1121" href="#L1121">1121</a> <em class="jxr_javadoccomment"> * diffPosition(<js>"apple"</js>, <js>"apple"</js>); <jc>// -1 (equal)</jc></em>
+<a class="jxr_linenumber" name="L1122" href="#L1122">1122</a> <em class="jxr_javadoccomment"> * diffPosition(<js>"apple"</js>, <js>"apricot"</js>); <jc>// 2 (differs at 'p' vs 'r')</jc></em>
+<a class="jxr_linenumber" name="L1123" href="#L1123">1123</a> <em class="jxr_javadoccomment"> * diffPosition(<js>"apple"</js>, <js>"app"</js>); <jc>// 3 (shorter string ends here)</jc></em>
+<a class="jxr_linenumber" name="L1124" href="#L1124">1124</a> <em class="jxr_javadoccomment"> * diffPosition(<js>"app"</js>, <js>"apple"</js>); <jc>// 3 (shorter string ends here)</jc></em>
+<a class="jxr_linenumber" name="L1125" href="#L1125">1125</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1126" href="#L1126">1126</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1127" href="#L1127">1127</a> <em class="jxr_javadoccomment"> * @param s1 The first string.</em>
+<a class="jxr_linenumber" name="L1128" href="#L1128">1128</a> <em class="jxr_javadoccomment"> * @param s2 The second string.</em>
+<a class="jxr_linenumber" name="L1129" href="#L1129">1129</a> <em class="jxr_javadoccomment"> * @return The position where the two strings differ, or <c>-1</c> if they're equal.</em>
+<a class="jxr_linenumber" name="L1130" href="#L1130">1130</a> <em class="jxr_javadoccomment"> * @see #diffPositionIc(String, String)</em>
+<a class="jxr_linenumber" name="L1131" href="#L1131">1131</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1132" href="#L1132">1132</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> diffPosition(String s1, String s2) {
+<a class="jxr_linenumber" name="L1133" href="#L1133">1133</a> s1 = emptyIfNull(s1);
+<a class="jxr_linenumber" name="L1134" href="#L1134">1134</a> s2 = emptyIfNull(s2);
+<a class="jxr_linenumber" name="L1135" href="#L1135">1135</a> <strong class="jxr_keyword">var</strong> i = 0;
+<a class="jxr_linenumber" name="L1136" href="#L1136">1136</a> <strong class="jxr_keyword">var</strong> len = Math.min(s1.length(), s2.length());
+<a class="jxr_linenumber" name="L1137" href="#L1137">1137</a> <strong class="jxr_keyword">while</strong> (i < len) {
+<a class="jxr_linenumber" name="L1138" href="#L1138">1138</a> <strong class="jxr_keyword">var</strong> j = s1.charAt(i) - s2.charAt(i);
+<a class="jxr_linenumber" name="L1139" href="#L1139">1139</a> <strong class="jxr_keyword">if</strong> (j != 0)
+<a class="jxr_linenumber" name="L1140" href="#L1140">1140</a> <strong class="jxr_keyword">return</strong> i;
+<a class="jxr_linenumber" name="L1141" href="#L1141">1141</a> i++;
+<a class="jxr_linenumber" name="L1142" href="#L1142">1142</a> }
+<a class="jxr_linenumber" name="L1143" href="#L1143">1143</a> <strong class="jxr_keyword">if</strong> (i == len && s1.length() == s2.length())
+<a class="jxr_linenumber" name="L1144" href="#L1144">1144</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L1145" href="#L1145">1145</a> <strong class="jxr_keyword">return</strong> i;
+<a class="jxr_linenumber" name="L1146" href="#L1146">1146</a> }
+<a class="jxr_linenumber" name="L1147" href="#L1147">1147</a>
+<a class="jxr_linenumber" name="L1148" href="#L1148">1148</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1149" href="#L1149">1149</a> <em class="jxr_javadoccomment"> * Finds the position where the two strings first differ, ignoring case.</em>
+<a class="jxr_linenumber" name="L1150" href="#L1150">1150</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1151" href="#L1151">1151</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1152" href="#L1152">1152</a> <em class="jxr_javadoccomment"> * This method compares strings character by character (case-insensitive) and returns the index of the first position</em>
+<a class="jxr_linenumber" name="L1153" href="#L1153">1153</a> <em class="jxr_javadoccomment"> * where they differ. If the strings are equal (ignoring case), returns <c>-1</c>. If one string is a prefix of the other,</em>
+<a class="jxr_linenumber" name="L1154" href="#L1154">1154</a> <em class="jxr_javadoccomment"> * returns the length of the shorter string.</em>
+<a class="jxr_linenumber" name="L1155" href="#L1155">1155</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1156" href="#L1156">1156</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1157" href="#L1157">1157</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1158" href="#L1158">1158</a> <em class="jxr_javadoccomment"> * diffPositionIc(<js>"Apple"</js>, <js>"apple"</js>); <jc>// -1 (equal ignoring case)</jc></em>
+<a class="jxr_linenumber" name="L1159" href="#L1159">1159</a> <em class="jxr_javadoccomment"> * diffPositionIc(<js>"Apple"</js>, <js>"Apricot"</js>); <jc>// 2 (differs at 'p' vs 'r')</jc></em>
+<a class="jxr_linenumber" name="L1160" href="#L1160">1160</a> <em class="jxr_javadoccomment"> * diffPositionIc(<js>"APPLE"</js>, <js>"app"</js>); <jc>// 3 (shorter string ends here)</jc></em>
+<a class="jxr_linenumber" name="L1161" href="#L1161">1161</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1162" href="#L1162">1162</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1163" href="#L1163">1163</a> <em class="jxr_javadoccomment"> * @param s1 The first string.</em>
+<a class="jxr_linenumber" name="L1164" href="#L1164">1164</a> <em class="jxr_javadoccomment"> * @param s2 The second string.</em>
+<a class="jxr_linenumber" name="L1165" href="#L1165">1165</a> <em class="jxr_javadoccomment"> * @return The position where the two strings differ, or <c>-1</c> if they're equal (ignoring case).</em>
+<a class="jxr_linenumber" name="L1166" href="#L1166">1166</a> <em class="jxr_javadoccomment"> * @see #diffPosition(String, String)</em>
+<a class="jxr_linenumber" name="L1167" href="#L1167">1167</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1168" href="#L1168">1168</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> diffPositionIc(String s1, String s2) {
+<a class="jxr_linenumber" name="L1169" href="#L1169">1169</a> s1 = emptyIfNull(s1);
+<a class="jxr_linenumber" name="L1170" href="#L1170">1170</a> s2 = emptyIfNull(s2);
+<a class="jxr_linenumber" name="L1171" href="#L1171">1171</a> <strong class="jxr_keyword">var</strong> i = 0;
+<a class="jxr_linenumber" name="L1172" href="#L1172">1172</a> <strong class="jxr_keyword">var</strong> len = Math.min(s1.length(), s2.length());
+<a class="jxr_linenumber" name="L1173" href="#L1173">1173</a> <strong class="jxr_keyword">while</strong> (i < len) {
+<a class="jxr_linenumber" name="L1174" href="#L1174">1174</a> <strong class="jxr_keyword">var</strong> j = toLowerCase(s1.charAt(i)) - toLowerCase(s2.charAt(i));
+<a class="jxr_linenumber" name="L1175" href="#L1175">1175</a> <strong class="jxr_keyword">if</strong> (j != 0)
+<a class="jxr_linenumber" name="L1176" href="#L1176">1176</a> <strong class="jxr_keyword">return</strong> i;
+<a class="jxr_linenumber" name="L1177" href="#L1177">1177</a> i++;
+<a class="jxr_linenumber" name="L1178" href="#L1178">1178</a> }
+<a class="jxr_linenumber" name="L1179" href="#L1179">1179</a> <strong class="jxr_keyword">if</strong> (i == len && s1.length() == s2.length())
+<a class="jxr_linenumber" name="L1180" href="#L1180">1180</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L1181" href="#L1181">1181</a> <strong class="jxr_keyword">return</strong> i;
+<a class="jxr_linenumber" name="L1182" href="#L1182">1182</a> }
+<a class="jxr_linenumber" name="L1183" href="#L1183">1183</a>
+<a class="jxr_linenumber" name="L1184" href="#L1184">1184</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1185" href="#L1185">1185</a> <em class="jxr_javadoccomment"> * Removes duplicate elements from a string array, preserving order.</em>
+<a class="jxr_linenumber" name="L1186" href="#L1186">1186</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1187" href="#L1187">1187</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1188" href="#L1188">1188</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1189" href="#L1189">1189</a> <em class="jxr_javadoccomment"> * Uses a {@link LinkedHashSet} to preserve insertion order while removing duplicates.</em>
+<a class="jxr_linenumber" name="L1190" href="#L1190">1190</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1191" href="#L1191">1191</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L1192" href="#L1192">1192</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1193" href="#L1193">1193</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>"bar"</js>, <js>"foo"</js>, <js>"baz"</js>, <js>"bar"</js>};</em>
+<a class="jxr_linenumber" name="L1194" href="#L1194">1194</a> <em class="jxr_javadoccomment"> * String[] <jv>unique</jv> = distinct(<jv>array</jv>);</em>
+<a class="jxr_linenumber" name="L1195" href="#L1195">1195</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["foo", "bar", "baz"]</jc></em>
+<a class="jxr_linenumber" name="L1196" href="#L1196">1196</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1197" href="#L1197">1197</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1198" href="#L1198">1198</a> <em class="jxr_javadoccomment"> * @param array The array to process. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1199" href="#L1199">1199</a> <em class="jxr_javadoccomment"> * @return A new array with duplicate elements removed, or <jk>null</jk> if the array was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1200" href="#L1200">1200</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1201" href="#L1201">1201</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] distinct(String[] array) {
+<a class="jxr_linenumber" name="L1202" href="#L1202">1202</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1203" href="#L1203">1203</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L1204" href="#L1204">1204</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).collect(Collectors.toCollection(LinkedHashSet::<strong class="jxr_keyword">new</strong>)).toArray(<strong class="jxr_keyword">new</strong> String[0]);
+<a class="jxr_linenumber" name="L1205" href="#L1205">1205</a> }
+<a class="jxr_linenumber" name="L1206" href="#L1206">1206</a>
+<a class="jxr_linenumber" name="L1207" href="#L1207">1207</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1208" href="#L1208">1208</a> <em class="jxr_javadoccomment"> * Generates a Double Metaphone code for a string.</em>
+<a class="jxr_linenumber" name="L1209" href="#L1209">1209</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1210" href="#L1210">1210</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1211" href="#L1211">1211</a> <em class="jxr_javadoccomment"> * Double Metaphone is an improved version of Metaphone that returns two codes:</em>
+<a class="jxr_linenumber" name="L1212" href="#L1212">1212</a> <em class="jxr_javadoccomment"> * a primary code and an alternate code. This handles more edge cases and variations.</em>
<a class="jxr_linenumber" name="L1213" href="#L1213">1213</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1214" href="#L1214">1214</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Double Metaphone code for. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1215" href="#L1215">1215</a> <em class="jxr_javadoccomment"> * @return An array with two elements: [primary code, alternate code]. Returns <jk>null</jk> if input is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1216" href="#L1216">1216</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1217" href="#L1217">1217</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] doubleMetaphone(String str) {
-<a class="jxr_linenumber" name="L1218" href="#L1218">1218</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L1219" href="#L1219">1219</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1220" href="#L1220">1220</a>
-<a class="jxr_linenumber" name="L1221" href="#L1221">1221</a> <em class="jxr_comment">// For simplicity, return the same code for both primary and alternate</em>
-<a class="jxr_linenumber" name="L1222" href="#L1222">1222</a> <em class="jxr_comment">// A full Double Metaphone implementation would be much more complex</em>
-<a class="jxr_linenumber" name="L1223" href="#L1223">1223</a> <strong class="jxr_keyword">var</strong> primary = metaphone(str);
-<a class="jxr_linenumber" name="L1224" href="#L1224">1224</a> <strong class="jxr_keyword">if</strong> (primary == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1214" href="#L1214">1214</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1215" href="#L1215">1215</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1216" href="#L1216">1216</a> <em class="jxr_javadoccomment"> * doubleMetaphone(<js>"Smith"</js>); <jc>// "SM0"</jc></em>
+<a class="jxr_linenumber" name="L1217" href="#L1217">1217</a> <em class="jxr_javadoccomment"> * doubleMetaphone(<js>"Schmidt"</js>); <jc>// "XMT"</jc></em>
+<a class="jxr_linenumber" name="L1218" href="#L1218">1218</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1219" href="#L1219">1219</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1220" href="#L1220">1220</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Double Metaphone code for. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1221" href="#L1221">1221</a> <em class="jxr_javadoccomment"> * @return An array with two elements: [primary code, alternate code]. Returns <jk>null</jk> if input is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1222" href="#L1222">1222</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1223" href="#L1223">1223</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] doubleMetaphone(String str) {
+<a class="jxr_linenumber" name="L1224" href="#L1224">1224</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
<a class="jxr_linenumber" name="L1225" href="#L1225">1225</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
<a class="jxr_linenumber" name="L1226" href="#L1226">1226</a>
-<a class="jxr_linenumber" name="L1227" href="#L1227">1227</a> <em class="jxr_comment">// Generate alternate code (simplified - full implementation would have different rules)</em>
-<a class="jxr_linenumber" name="L1228" href="#L1228">1228</a> <strong class="jxr_keyword">var</strong> alternate = primary;
-<a class="jxr_linenumber" name="L1229" href="#L1229">1229</a>
-<a class="jxr_linenumber" name="L1230" href="#L1230">1230</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[] { primary, alternate };
-<a class="jxr_linenumber" name="L1231" href="#L1231">1231</a> }
+<a class="jxr_linenumber" name="L1227" href="#L1227">1227</a> <em class="jxr_comment">// For simplicity, return the same code for both primary and alternate</em>
+<a class="jxr_linenumber" name="L1228" href="#L1228">1228</a> <em class="jxr_comment">// A full Double Metaphone implementation would be much more complex</em>
+<a class="jxr_linenumber" name="L1229" href="#L1229">1229</a> <strong class="jxr_keyword">var</strong> primary = metaphone(str);
+<a class="jxr_linenumber" name="L1230" href="#L1230">1230</a> <strong class="jxr_keyword">if</strong> (primary == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1231" href="#L1231">1231</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
<a class="jxr_linenumber" name="L1232" href="#L1232">1232</a>
-<a class="jxr_linenumber" name="L1233" href="#L1233">1233</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1234" href="#L1234">1234</a> <em class="jxr_javadoccomment"> * Returns the specified string, or an empty string if that string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1235" href="#L1235">1235</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1236" href="#L1236">1236</a> <em class="jxr_javadoccomment"> * @param str The string value to check.</em>
-<a class="jxr_linenumber" name="L1237" href="#L1237">1237</a> <em class="jxr_javadoccomment"> * @return The string value, or an empty string if the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1238" href="#L1238">1238</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1239" href="#L1239">1239</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String emptyIfNull(String str) {
-<a class="jxr_linenumber" name="L1240" href="#L1240">1240</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> ? <span class="jxr_string">""</span> : str;
-<a class="jxr_linenumber" name="L1241" href="#L1241">1241</a> }
-<a class="jxr_linenumber" name="L1242" href="#L1242">1242</a>
-<a class="jxr_linenumber" name="L1243" href="#L1243">1243</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1244" href="#L1244">1244</a> <em class="jxr_javadoccomment"> * Checks if a string ends with the specified character.</em>
-<a class="jxr_linenumber" name="L1245" href="#L1245">1245</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1246" href="#L1246">1246</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1247" href="#L1247">1247</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1248" href="#L1248">1248</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1249" href="#L1249">1249</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1250" href="#L1250">1250</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1251" href="#L1251">1251</a> <em class="jxr_javadoccomment"> * endsWith(<js>"Hello"</js>, <js>'o'</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L1252" href="#L1252">1252</a> <em class="jxr_javadoccomment"> * endsWith(<js>"Hello"</js>, <js>'H'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1253" href="#L1253">1253</a> <em class="jxr_javadoccomment"> * endsWith(<jk>null</jk>, <js>'o'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1254" href="#L1254">1254</a> <em class="jxr_javadoccomment"> * endsWith(<js>""</js>, <js>'o'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1255" href="#L1255">1255</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1256" href="#L1256">1256</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1257" href="#L1257">1257</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1258" href="#L1258">1258</a> <em class="jxr_javadoccomment"> * @param c The character to check for.</em>
-<a class="jxr_linenumber" name="L1259" href="#L1259">1259</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is not <jk>null</jk> and ends with the specified character.</em>
-<a class="jxr_linenumber" name="L1260" href="#L1260">1260</a> <em class="jxr_javadoccomment"> * @see #endsWith(String, String)</em>
-<a class="jxr_linenumber" name="L1261" href="#L1261">1261</a> <em class="jxr_javadoccomment"> * @see #endsWithAny(String, char...)</em>
-<a class="jxr_linenumber" name="L1262" href="#L1262">1262</a> <em class="jxr_javadoccomment"> * @see String#endsWith(String)</em>
-<a class="jxr_linenumber" name="L1263" href="#L1263">1263</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1264" href="#L1264">1264</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWith(String s, <strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L1265" href="#L1265">1265</a> <strong class="jxr_keyword">if</strong> (nn(s)) {
-<a class="jxr_linenumber" name="L1266" href="#L1266">1266</a> <strong class="jxr_keyword">var</strong> i = s.length();
-<a class="jxr_linenumber" name="L1267" href="#L1267">1267</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L1268" href="#L1268">1268</a> <strong class="jxr_keyword">return</strong> s.charAt(i - 1) == c;
-<a class="jxr_linenumber" name="L1269" href="#L1269">1269</a> }
-<a class="jxr_linenumber" name="L1270" href="#L1270">1270</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L1271" href="#L1271">1271</a> }
-<a class="jxr_linenumber" name="L1272" href="#L1272">1272</a>
-<a class="jxr_linenumber" name="L1273" href="#L1273">1273</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1274" href="#L1274">1274</a> <em class="jxr_javadoccomment"> * Checks if a string ends with the specified string.</em>
-<a class="jxr_linenumber" name="L1275" href="#L1275">1275</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1276" href="#L1276">1276</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1277" href="#L1277">1277</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1278" href="#L1278">1278</a> <em class="jxr_javadoccomment"> * Otherwise behaves the same as {@link String#endsWith(String)}.</em>
-<a class="jxr_linenumber" name="L1279" href="#L1279">1279</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1280" href="#L1280">1280</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1281" href="#L1281">1281</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1282" href="#L1282">1282</a> <em class="jxr_javadoccomment"> * endsWith(<js>"Hello World"</js>, <js>"World"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L1283" href="#L1283">1283</a> <em class="jxr_javadoccomment"> * endsWith(<js>"Hello World"</js>, <js>"Hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1284" href="#L1284">1284</a> <em class="jxr_javadoccomment"> * endsWith(<jk>null</jk>, <js>"World"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1285" href="#L1285">1285</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1286" href="#L1286">1286</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1287" href="#L1287">1287</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1288" href="#L1288">1288</a> <em class="jxr_javadoccomment"> * @param suffix The suffix to check for.</em>
-<a class="jxr_linenumber" name="L1289" href="#L1289">1289</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string ends with the specified suffix.</em>
-<a class="jxr_linenumber" name="L1290" href="#L1290">1290</a> <em class="jxr_javadoccomment"> * @see #endsWith(String, char)</em>
-<a class="jxr_linenumber" name="L1291" href="#L1291">1291</a> <em class="jxr_javadoccomment"> * @see #endsWithAny(String, String...)</em>
-<a class="jxr_linenumber" name="L1292" href="#L1292">1292</a> <em class="jxr_javadoccomment"> * @see String#endsWith(String)</em>
-<a class="jxr_linenumber" name="L1293" href="#L1293">1293</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1294" href="#L1294">1294</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWith(String s, String suffix) {
-<a class="jxr_linenumber" name="L1295" href="#L1295">1295</a> <strong class="jxr_keyword">return</strong> s != <strong class="jxr_keyword">null</strong> && s.endsWith(suffix);
-<a class="jxr_linenumber" name="L1296" href="#L1296">1296</a> }
-<a class="jxr_linenumber" name="L1297" href="#L1297">1297</a>
-<a class="jxr_linenumber" name="L1298" href="#L1298">1298</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1299" href="#L1299">1299</a> <em class="jxr_javadoccomment"> * Checks if a string ends with any of the specified characters.</em>
-<a class="jxr_linenumber" name="L1300" href="#L1300">1300</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1301" href="#L1301">1301</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1302" href="#L1302">1302</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if:</em>
-<a class="jxr_linenumber" name="L1303" href="#L1303">1303</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1304" href="#L1304">1304</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L1305" href="#L1305">1305</a> <em class="jxr_javadoccomment"> * <li>The characters array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L1306" href="#L1306">1306</a> <em class="jxr_javadoccomment"> * <li>The string does not end with any of the specified characters</li></em>
-<a class="jxr_linenumber" name="L1307" href="#L1307">1307</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1308" href="#L1308">1308</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1309" href="#L1309">1309</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1310" href="#L1310">1310</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1311" href="#L1311">1311</a> <em class="jxr_javadoccomment"> * endsWithAny(<js>"Hello"</js>, <js>'o'</js>, <js>'x'</js>); <jc>// true (ends with 'o')</jc></em>
-<a class="jxr_linenumber" name="L1312" href="#L1312">1312</a> <em class="jxr_javadoccomment"> * endsWithAny(<js>"Hello"</js>, <js>'x'</js>, <js>'y'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1313" href="#L1313">1313</a> <em class="jxr_javadoccomment"> * endsWithAny(<jk>null</jk>, <js>'o'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1314" href="#L1314">1314</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1315" href="#L1315">1315</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1316" href="#L1316">1316</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1317" href="#L1317">1317</a> <em class="jxr_javadoccomment"> * @param c The characters to check for.</em>
-<a class="jxr_linenumber" name="L1318" href="#L1318">1318</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string ends with any of the specified characters.</em>
-<a class="jxr_linenumber" name="L1319" href="#L1319">1319</a> <em class="jxr_javadoccomment"> * @see #endsWith(String, char)</em>
-<a class="jxr_linenumber" name="L1320" href="#L1320">1320</a> <em class="jxr_javadoccomment"> * @see #endsWithAny(String, String...)</em>
-<a class="jxr_linenumber" name="L1321" href="#L1321">1321</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1322" href="#L1322">1322</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWithAny(String s, <strong class="jxr_keyword">char</strong>...c) {
-<a class="jxr_linenumber" name="L1323" href="#L1323">1323</a> <strong class="jxr_keyword">if</strong> (nn(s)) {
-<a class="jxr_linenumber" name="L1324" href="#L1324">1324</a> <strong class="jxr_keyword">var</strong> i = s.length();
-<a class="jxr_linenumber" name="L1325" href="#L1325">1325</a> <strong class="jxr_keyword">if</strong> (i > 0) {
-<a class="jxr_linenumber" name="L1326" href="#L1326">1326</a> <strong class="jxr_keyword">var</strong> c2 = s.charAt(i - 1);
-<a class="jxr_linenumber" name="L1327" href="#L1327">1327</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> cc : c)
-<a class="jxr_linenumber" name="L1328" href="#L1328">1328</a> <strong class="jxr_keyword">if</strong> (c2 == cc)
-<a class="jxr_linenumber" name="L1329" href="#L1329">1329</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L1330" href="#L1330">1330</a> }
-<a class="jxr_linenumber" name="L1331" href="#L1331">1331</a> }
-<a class="jxr_linenumber" name="L1332" href="#L1332">1332</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L1333" href="#L1333">1333</a> }
-<a class="jxr_linenumber" name="L1334" href="#L1334">1334</a>
-<a class="jxr_linenumber" name="L1335" href="#L1335">1335</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1336" href="#L1336">1336</a> <em class="jxr_javadoccomment"> * Checks if a string ends with any of the specified strings.</em>
-<a class="jxr_linenumber" name="L1337" href="#L1337">1337</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1338" href="#L1338">1338</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1339" href="#L1339">1339</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if:</em>
-<a class="jxr_linenumber" name="L1340" href="#L1340">1340</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1341" href="#L1341">1341</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L1342" href="#L1342">1342</a> <em class="jxr_javadoccomment"> * <li>The suffixes array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L1343" href="#L1343">1343</a> <em class="jxr_javadoccomment"> * <li>The string does not end with any of the specified suffixes</li></em>
-<a class="jxr_linenumber" name="L1344" href="#L1344">1344</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1345" href="#L1345">1345</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1346" href="#L1346">1346</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1347" href="#L1347">1347</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1348" href="#L1348">1348</a> <em class="jxr_javadoccomment"> * endsWithAny(<js>"Hello World"</js>, <js>"World"</js>, <js>"Foo"</js>); <jc>// true (ends with "World")</jc></em>
-<a class="jxr_linenumber" name="L1349" href="#L1349">1349</a> <em class="jxr_javadoccomment"> * endsWithAny(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1350" href="#L1350">1350</a> <em class="jxr_javadoccomment"> * endsWithAny(<jk>null</jk>, <js>"World"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1351" href="#L1351">1351</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1352" href="#L1352">1352</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1353" href="#L1353">1353</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1354" href="#L1354">1354</a> <em class="jxr_javadoccomment"> * @param suffixes The suffixes to check for.</em>
-<a class="jxr_linenumber" name="L1355" href="#L1355">1355</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string ends with any of the specified suffixes.</em>
-<a class="jxr_linenumber" name="L1356" href="#L1356">1356</a> <em class="jxr_javadoccomment"> * @see #endsWith(String, String)</em>
-<a class="jxr_linenumber" name="L1357" href="#L1357">1357</a> <em class="jxr_javadoccomment"> * @see #endsWithAny(String, char...)</em>
-<a class="jxr_linenumber" name="L1358" href="#L1358">1358</a> <em class="jxr_javadoccomment"> * @see String#endsWith(String)</em>
-<a class="jxr_linenumber" name="L1359" href="#L1359">1359</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1360" href="#L1360">1360</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWithAny(String s, String...suffixes) {
-<a class="jxr_linenumber" name="L1361" href="#L1361">1361</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || suffixes == <strong class="jxr_keyword">null</strong> || suffixes.length == 0)
-<a class="jxr_linenumber" name="L1362" href="#L1362">1362</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L1363" href="#L1363">1363</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> suffix : suffixes) {
-<a class="jxr_linenumber" name="L1364" href="#L1364">1364</a> <strong class="jxr_keyword">if</strong> (s.endsWith(suffix))
-<a class="jxr_linenumber" name="L1365" href="#L1365">1365</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L1366" href="#L1366">1366</a> }
-<a class="jxr_linenumber" name="L1367" href="#L1367">1367</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L1368" href="#L1368">1368</a> }
-<a class="jxr_linenumber" name="L1369" href="#L1369">1369</a>
-<a class="jxr_linenumber" name="L1370" href="#L1370">1370</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1371" href="#L1371">1371</a> <em class="jxr_javadoccomment"> * Checks if a string ends with a suffix, ignoring case.</em>
-<a class="jxr_linenumber" name="L1372" href="#L1372">1372</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1373" href="#L1373">1373</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1374" href="#L1374">1374</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1375" href="#L1375">1375</a> <em class="jxr_javadoccomment"> * endsWithIgnoreCase(<js>"Hello World"</js>, <js>"world"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L1376" href="#L1376">1376</a> <em class="jxr_javadoccomment"> * endsWithIgnoreCase(<js>"Hello World"</js>, <js>"WORLD"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L1377" href="#L1377">1377</a> <em class="jxr_javadoccomment"> * endsWithIgnoreCase(<js>"hello world"</js>, <js>"hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1378" href="#L1378">1378</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1379" href="#L1379">1379</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1380" href="#L1380">1380</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L1381" href="#L1381">1381</a> <em class="jxr_javadoccomment"> * @param suffix The suffix to check for.</em>
-<a class="jxr_linenumber" name="L1382" href="#L1382">1382</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string ends with the suffix (ignoring case), <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L1383" href="#L1383">1383</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1384" href="#L1384">1384</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWithIgnoreCase(String str, String suffix) {
-<a class="jxr_linenumber" name="L1385" href="#L1385">1385</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || suffix == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1386" href="#L1386">1386</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L1387" href="#L1387">1387</a> <strong class="jxr_keyword">return</strong> str.toLowerCase().endsWith(suffix.toLowerCase());
-<a class="jxr_linenumber" name="L1388" href="#L1388">1388</a> }
-<a class="jxr_linenumber" name="L1389" href="#L1389">1389</a>
-<a class="jxr_linenumber" name="L1390" href="#L1390">1390</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1391" href="#L1391">1391</a> <em class="jxr_javadoccomment"> * Calculates the entropy of a string.</em>
-<a class="jxr_linenumber" name="L1392" href="#L1392">1392</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1393" href="#L1393">1393</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1394" href="#L1394">1394</a> <em class="jxr_javadoccomment"> * Entropy measures the randomness or information content of a string.</em>
-<a class="jxr_linenumber" name="L1395" href="#L1395">1395</a> <em class="jxr_javadoccomment"> * Higher entropy indicates more randomness. The formula used is:</em>
-<a class="jxr_linenumber" name="L1396" href="#L1396">1396</a> <em class="jxr_javadoccomment"> * <c>H(X) = -Σ P(x) * log2(P(x))</c></em>
-<a class="jxr_linenumber" name="L1397" href="#L1397">1397</a> <em class="jxr_javadoccomment"> * where P(x) is the probability of character x.</em>
+<a class="jxr_linenumber" name="L1233" href="#L1233">1233</a> <em class="jxr_comment">// Generate alternate code (simplified - full implementation would have different rules)</em>
+<a class="jxr_linenumber" name="L1234" href="#L1234">1234</a> <strong class="jxr_keyword">var</strong> alternate = primary;
+<a class="jxr_linenumber" name="L1235" href="#L1235">1235</a>
+<a class="jxr_linenumber" name="L1236" href="#L1236">1236</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[] { primary, alternate };
+<a class="jxr_linenumber" name="L1237" href="#L1237">1237</a> }
+<a class="jxr_linenumber" name="L1238" href="#L1238">1238</a>
+<a class="jxr_linenumber" name="L1239" href="#L1239">1239</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1240" href="#L1240">1240</a> <em class="jxr_javadoccomment"> * Returns the specified string, or an empty string if that string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1241" href="#L1241">1241</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1242" href="#L1242">1242</a> <em class="jxr_javadoccomment"> * @param str The string value to check.</em>
+<a class="jxr_linenumber" name="L1243" href="#L1243">1243</a> <em class="jxr_javadoccomment"> * @return The string value, or an empty string if the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1244" href="#L1244">1244</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1245" href="#L1245">1245</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String emptyIfNull(String str) {
+<a class="jxr_linenumber" name="L1246" href="#L1246">1246</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> ? <span class="jxr_string">""</span> : str;
+<a class="jxr_linenumber" name="L1247" href="#L1247">1247</a> }
+<a class="jxr_linenumber" name="L1248" href="#L1248">1248</a>
+<a class="jxr_linenumber" name="L1249" href="#L1249">1249</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1250" href="#L1250">1250</a> <em class="jxr_javadoccomment"> * Checks if a string ends with the specified character.</em>
+<a class="jxr_linenumber" name="L1251" href="#L1251">1251</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1252" href="#L1252">1252</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1253" href="#L1253">1253</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1254" href="#L1254">1254</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1255" href="#L1255">1255</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1256" href="#L1256">1256</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1257" href="#L1257">1257</a> <em class="jxr_javadoccomment"> * endsWith(<js>"Hello"</js>, <js>'o'</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L1258" href="#L1258">1258</a> <em class="jxr_javadoccomment"> * endsWith(<js>"Hello"</js>, <js>'H'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1259" href="#L1259">1259</a> <em class="jxr_javadoccomment"> * endsWith(<jk>null</jk>, <js>'o'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1260" href="#L1260">1260</a> <em class="jxr_javadoccomment"> * endsWith(<js>""</js>, <js>'o'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1261" href="#L1261">1261</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1262" href="#L1262">1262</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1263" href="#L1263">1263</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1264" href="#L1264">1264</a> <em class="jxr_javadoccomment"> * @param c The character to check for.</em>
+<a class="jxr_linenumber" name="L1265" href="#L1265">1265</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is not <jk>null</jk> and ends with the specified character.</em>
+<a class="jxr_linenumber" name="L1266" href="#L1266">1266</a> <em class="jxr_javadoccomment"> * @see #endsWith(String, String)</em>
+<a class="jxr_linenumber" name="L1267" href="#L1267">1267</a> <em class="jxr_javadoccomment"> * @see #endsWithAny(String, char...)</em>
+<a class="jxr_linenumber" name="L1268" href="#L1268">1268</a> <em class="jxr_javadoccomment"> * @see String#endsWith(String)</em>
+<a class="jxr_linenumber" name="L1269" href="#L1269">1269</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1270" href="#L1270">1270</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWith(String s, <strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L1271" href="#L1271">1271</a> <strong class="jxr_keyword">if</strong> (nn(s)) {
+<a class="jxr_linenumber" name="L1272" href="#L1272">1272</a> <strong class="jxr_keyword">var</strong> i = s.length();
+<a class="jxr_linenumber" name="L1273" href="#L1273">1273</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L1274" href="#L1274">1274</a> <strong class="jxr_keyword">return</strong> s.charAt(i - 1) == c;
+<a class="jxr_linenumber" name="L1275" href="#L1275">1275</a> }
+<a class="jxr_linenumber" name="L1276" href="#L1276">1276</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L1277" href="#L1277">1277</a> }
+<a class="jxr_linenumber" name="L1278" href="#L1278">1278</a>
+<a class="jxr_linenumber" name="L1279" href="#L1279">1279</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1280" href="#L1280">1280</a> <em class="jxr_javadoccomment"> * Checks if a string ends with the specified string.</em>
+<a class="jxr_linenumber" name="L1281" href="#L1281">1281</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1282" href="#L1282">1282</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1283" href="#L1283">1283</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if the string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1284" href="#L1284">1284</a> <em class="jxr_javadoccomment"> * Otherwise behaves the same as {@link String#endsWith(String)}.</em>
+<a class="jxr_linenumber" name="L1285" href="#L1285">1285</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1286" href="#L1286">1286</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1287" href="#L1287">1287</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1288" href="#L1288">1288</a> <em class="jxr_javadoccomment"> * endsWith(<js>"Hello World"</js>, <js>"World"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L1289" href="#L1289">1289</a> <em class="jxr_javadoccomment"> * endsWith(<js>"Hello World"</js>, <js>"Hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1290" href="#L1290">1290</a> <em class="jxr_javadoccomment"> * endsWith(<jk>null</jk>, <js>"World"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1291" href="#L1291">1291</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1292" href="#L1292">1292</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1293" href="#L1293">1293</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1294" href="#L1294">1294</a> <em class="jxr_javadoccomment"> * @param suffix The suffix to check for.</em>
+<a class="jxr_linenumber" name="L1295" href="#L1295">1295</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string ends with the specified suffix.</em>
+<a class="jxr_linenumber" name="L1296" href="#L1296">1296</a> <em class="jxr_javadoccomment"> * @see #endsWith(String, char)</em>
+<a class="jxr_linenumber" name="L1297" href="#L1297">1297</a> <em class="jxr_javadoccomment"> * @see #endsWithAny(String, String...)</em>
+<a class="jxr_linenumber" name="L1298" href="#L1298">1298</a> <em class="jxr_javadoccomment"> * @see String#endsWith(String)</em>
+<a class="jxr_linenumber" name="L1299" href="#L1299">1299</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1300" href="#L1300">1300</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWith(String s, String suffix) {
+<a class="jxr_linenumber" name="L1301" href="#L1301">1301</a> <strong class="jxr_keyword">return</strong> s != <strong class="jxr_keyword">null</strong> && s.endsWith(suffix);
+<a class="jxr_linenumber" name="L1302" href="#L1302">1302</a> }
+<a class="jxr_linenumber" name="L1303" href="#L1303">1303</a>
+<a class="jxr_linenumber" name="L1304" href="#L1304">1304</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1305" href="#L1305">1305</a> <em class="jxr_javadoccomment"> * Checks if a string ends with any of the specified characters.</em>
+<a class="jxr_linenumber" name="L1306" href="#L1306">1306</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1307" href="#L1307">1307</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1308" href="#L1308">1308</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if:</em>
+<a class="jxr_linenumber" name="L1309" href="#L1309">1309</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1310" href="#L1310">1310</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L1311" href="#L1311">1311</a> <em class="jxr_javadoccomment"> * <li>The characters array is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L1312" href="#L1312">1312</a> <em class="jxr_javadoccomment"> * <li>The string does not end with any of the specified characters</li></em>
+<a class="jxr_linenumber" name="L1313" href="#L1313">1313</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L1314" href="#L1314">1314</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1315" href="#L1315">1315</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1316" href="#L1316">1316</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1317" href="#L1317">1317</a> <em class="jxr_javadoccomment"> * endsWithAny(<js>"Hello"</js>, <js>'o'</js>, <js>'x'</js>); <jc>// true (ends with 'o')</jc></em>
+<a class="jxr_linenumber" name="L1318" href="#L1318">1318</a> <em class="jxr_javadoccomment"> * endsWithAny(<js>"Hello"</js>, <js>'x'</js>, <js>'y'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1319" href="#L1319">1319</a> <em class="jxr_javadoccomment"> * endsWithAny(<jk>null</jk>, <js>'o'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1320" href="#L1320">1320</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1321" href="#L1321">1321</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1322" href="#L1322">1322</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1323" href="#L1323">1323</a> <em class="jxr_javadoccomment"> * @param c The characters to check for.</em>
+<a class="jxr_linenumber" name="L1324" href="#L1324">1324</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string ends with any of the specified characters.</em>
+<a class="jxr_linenumber" name="L1325" href="#L1325">1325</a> <em class="jxr_javadoccomment"> * @see #endsWith(String, char)</em>
+<a class="jxr_linenumber" name="L1326" href="#L1326">1326</a> <em class="jxr_javadoccomment"> * @see #endsWithAny(String, String...)</em>
+<a class="jxr_linenumber" name="L1327" href="#L1327">1327</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1328" href="#L1328">1328</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWithAny(String s, <strong class="jxr_keyword">char</strong>...c) {
+<a class="jxr_linenumber" name="L1329" href="#L1329">1329</a> <strong class="jxr_keyword">if</strong> (nn(s)) {
+<a class="jxr_linenumber" name="L1330" href="#L1330">1330</a> <strong class="jxr_keyword">var</strong> i = s.length();
+<a class="jxr_linenumber" name="L1331" href="#L1331">1331</a> <strong class="jxr_keyword">if</strong> (i > 0) {
+<a class="jxr_linenumber" name="L1332" href="#L1332">1332</a> <strong class="jxr_keyword">var</strong> c2 = s.charAt(i - 1);
+<a class="jxr_linenumber" name="L1333" href="#L1333">1333</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> cc : c)
+<a class="jxr_linenumber" name="L1334" href="#L1334">1334</a> <strong class="jxr_keyword">if</strong> (c2 == cc)
+<a class="jxr_linenumber" name="L1335" href="#L1335">1335</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L1336" href="#L1336">1336</a> }
+<a class="jxr_linenumber" name="L1337" href="#L1337">1337</a> }
+<a class="jxr_linenumber" name="L1338" href="#L1338">1338</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L1339" href="#L1339">1339</a> }
+<a class="jxr_linenumber" name="L1340" href="#L1340">1340</a>
+<a class="jxr_linenumber" name="L1341" href="#L1341">1341</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1342" href="#L1342">1342</a> <em class="jxr_javadoccomment"> * Checks if a string ends with any of the specified strings.</em>
+<a class="jxr_linenumber" name="L1343" href="#L1343">1343</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1344" href="#L1344">1344</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1345" href="#L1345">1345</a> <em class="jxr_javadoccomment"> * This is a null-safe operation. Returns <jk>false</jk> if:</em>
+<a class="jxr_linenumber" name="L1346" href="#L1346">1346</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1347" href="#L1347">1347</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L1348" href="#L1348">1348</a> <em class="jxr_javadoccomment"> * <li>The suffixes array is <jk>null</jk> or empty</li></em>
+<a class="jxr_linenumber" name="L1349" href="#L1349">1349</a> <em class="jxr_javadoccomment"> * <li>The string does not end with any of the specified suffixes</li></em>
+<a class="jxr_linenumber" name="L1350" href="#L1350">1350</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L1351" href="#L1351">1351</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1352" href="#L1352">1352</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1353" href="#L1353">1353</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1354" href="#L1354">1354</a> <em class="jxr_javadoccomment"> * endsWithAny(<js>"Hello World"</js>, <js>"World"</js>, <js>"Foo"</js>); <jc>// true (ends with "World")</jc></em>
+<a class="jxr_linenumber" name="L1355" href="#L1355">1355</a> <em class="jxr_javadoccomment"> * endsWithAny(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1356" href="#L1356">1356</a> <em class="jxr_javadoccomment"> * endsWithAny(<jk>null</jk>, <js>"World"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1357" href="#L1357">1357</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1358" href="#L1358">1358</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1359" href="#L1359">1359</a> <em class="jxr_javadoccomment"> * @param s The string to check. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1360" href="#L1360">1360</a> <em class="jxr_javadoccomment"> * @param suffixes The suffixes to check for.</em>
+<a class="jxr_linenumber" name="L1361" href="#L1361">1361</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string ends with any of the specified suffixes.</em>
+<a class="jxr_linenumber" name="L1362" href="#L1362">1362</a> <em class="jxr_javadoccomment"> * @see #endsWith(String, String)</em>
+<a class="jxr_linenumber" name="L1363" href="#L1363">1363</a> <em class="jxr_javadoccomment"> * @see #endsWithAny(String, char...)</em>
+<a class="jxr_linenumber" name="L1364" href="#L1364">1364</a> <em class="jxr_javadoccomment"> * @see String#endsWith(String)</em>
+<a class="jxr_linenumber" name="L1365" href="#L1365">1365</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1366" href="#L1366">1366</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWithAny(String s, String...suffixes) {
+<a class="jxr_linenumber" name="L1367" href="#L1367">1367</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || suffixes == <strong class="jxr_keyword">null</strong> || suffixes.length == 0)
+<a class="jxr_linenumber" name="L1368" href="#L1368">1368</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L1369" href="#L1369">1369</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> suffix : suffixes) {
+<a class="jxr_linenumber" name="L1370" href="#L1370">1370</a> <strong class="jxr_keyword">if</strong> (s.endsWith(suffix))
+<a class="jxr_linenumber" name="L1371" href="#L1371">1371</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L1372" href="#L1372">1372</a> }
+<a class="jxr_linenumber" name="L1373" href="#L1373">1373</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L1374" href="#L1374">1374</a> }
+<a class="jxr_linenumber" name="L1375" href="#L1375">1375</a>
+<a class="jxr_linenumber" name="L1376" href="#L1376">1376</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1377" href="#L1377">1377</a> <em class="jxr_javadoccomment"> * Checks if a string ends with a suffix, ignoring case.</em>
+<a class="jxr_linenumber" name="L1378" href="#L1378">1378</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1379" href="#L1379">1379</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1380" href="#L1380">1380</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1381" href="#L1381">1381</a> <em class="jxr_javadoccomment"> * endsWithIgnoreCase(<js>"Hello World"</js>, <js>"world"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L1382" href="#L1382">1382</a> <em class="jxr_javadoccomment"> * endsWithIgnoreCase(<js>"Hello World"</js>, <js>"WORLD"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L1383" href="#L1383">1383</a> <em class="jxr_javadoccomment"> * endsWithIgnoreCase(<js>"hello world"</js>, <js>"hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1384" href="#L1384">1384</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1385" href="#L1385">1385</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1386" href="#L1386">1386</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L1387" href="#L1387">1387</a> <em class="jxr_javadoccomment"> * @param suffix The suffix to check for.</em>
+<a class="jxr_linenumber" name="L1388" href="#L1388">1388</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string ends with the suffix (ignoring case), <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L1389" href="#L1389">1389</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1390" href="#L1390">1390</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> endsWithIgnoreCase(String str, String suffix) {
+<a class="jxr_linenumber" name="L1391" href="#L1391">1391</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || suffix == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1392" href="#L1392">1392</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L1393" href="#L1393">1393</a> <strong class="jxr_keyword">return</strong> str.toLowerCase().endsWith(suffix.toLowerCase());
+<a class="jxr_linenumber" name="L1394" href="#L1394">1394</a> }
+<a class="jxr_linenumber" name="L1395" href="#L1395">1395</a>
+<a class="jxr_linenumber" name="L1396" href="#L1396">1396</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1397" href="#L1397">1397</a> <em class="jxr_javadoccomment"> * Calculates the entropy of a string.</em>
<a class="jxr_linenumber" name="L1398" href="#L1398">1398</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1399" href="#L1399">1399</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1400" href="#L1400">1400</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1401" href="#L1401">1401</a> <em class="jxr_javadoccomment"> * entropy(<js>"aaaa"</js>); <jc>// 0.0 (no randomness)</jc></em>
-<a class="jxr_linenumber" name="L1402" href="#L1402">1402</a> <em class="jxr_javadoccomment"> * entropy(<js>"abcd"</js>); <jc>// 2.0 (high randomness)</jc></em>
-<a class="jxr_linenumber" name="L1403" href="#L1403">1403</a> <em class="jxr_javadoccomment"> * entropy(<js>"hello"</js>); <jc>// ~2.32</jc></em>
-<a class="jxr_linenumber" name="L1404" href="#L1404">1404</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1405" href="#L1405">1405</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1406" href="#L1406">1406</a> <em class="jxr_javadoccomment"> * @param str The string to calculate entropy for. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1407" href="#L1407">1407</a> <em class="jxr_javadoccomment"> * @return The entropy value (0.0 or higher), or <c>0.0</c> if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1408" href="#L1408">1408</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1409" href="#L1409">1409</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">double</strong> entropy(String str) {
-<a class="jxr_linenumber" name="L1410" href="#L1410">1410</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L1411" href="#L1411">1411</a> <strong class="jxr_keyword">return</strong> 0.0;
-<a class="jxr_linenumber" name="L1412" href="#L1412">1412</a>
-<a class="jxr_linenumber" name="L1413" href="#L1413">1413</a> <strong class="jxr_keyword">var</strong> length = str.length();
-<a class="jxr_linenumber" name="L1414" href="#L1414">1414</a> <strong class="jxr_keyword">if</strong> (length == 0)
-<a class="jxr_linenumber" name="L1415" href="#L1415">1415</a> <strong class="jxr_keyword">return</strong> 0.0;
-<a class="jxr_linenumber" name="L1416" href="#L1416">1416</a>
-<a class="jxr_linenumber" name="L1417" href="#L1417">1417</a> <em class="jxr_comment">// Count character frequencies</em>
-<a class="jxr_linenumber" name="L1418" href="#L1418">1418</a> <strong class="jxr_keyword">var</strong> charCounts = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[Character.MAX_VALUE + 1];
-<a class="jxr_linenumber" name="L1419" href="#L1419">1419</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < length; i++) {
-<a class="jxr_linenumber" name="L1420" href="#L1420">1420</a> charCounts[str.charAt(i)]++;
-<a class="jxr_linenumber" name="L1421" href="#L1421">1421</a> }
+<a class="jxr_linenumber" name="L1399" href="#L1399">1399</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1400" href="#L1400">1400</a> <em class="jxr_javadoccomment"> * Entropy measures the randomness or information content of a string.</em>
+<a class="jxr_linenumber" name="L1401" href="#L1401">1401</a> <em class="jxr_javadoccomment"> * Higher entropy indicates more randomness. The formula used is:</em>
+<a class="jxr_linenumber" name="L1402" href="#L1402">1402</a> <em class="jxr_javadoccomment"> * <c>H(X) = -Σ P(x) * log2(P(x))</c></em>
+<a class="jxr_linenumber" name="L1403" href="#L1403">1403</a> <em class="jxr_javadoccomment"> * where P(x) is the probability of character x.</em>
+<a class="jxr_linenumber" name="L1404" href="#L1404">1404</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1405" href="#L1405">1405</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1406" href="#L1406">1406</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1407" href="#L1407">1407</a> <em class="jxr_javadoccomment"> * entropy(<js>"aaaa"</js>); <jc>// 0.0 (no randomness)</jc></em>
+<a class="jxr_linenumber" name="L1408" href="#L1408">1408</a> <em class="jxr_javadoccomment"> * entropy(<js>"abcd"</js>); <jc>// 2.0 (high randomness)</jc></em>
+<a class="jxr_linenumber" name="L1409" href="#L1409">1409</a> <em class="jxr_javadoccomment"> * entropy(<js>"hello"</js>); <jc>// ~2.32</jc></em>
+<a class="jxr_linenumber" name="L1410" href="#L1410">1410</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1411" href="#L1411">1411</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1412" href="#L1412">1412</a> <em class="jxr_javadoccomment"> * @param str The string to calculate entropy for. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1413" href="#L1413">1413</a> <em class="jxr_javadoccomment"> * @return The entropy value (0.0 or higher), or <c>0.0</c> if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1414" href="#L1414">1414</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1415" href="#L1415">1415</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">double</strong> entropy(String str) {
+<a class="jxr_linenumber" name="L1416" href="#L1416">1416</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L1417" href="#L1417">1417</a> <strong class="jxr_keyword">return</strong> 0.0;
+<a class="jxr_linenumber" name="L1418" href="#L1418">1418</a>
+<a class="jxr_linenumber" name="L1419" href="#L1419">1419</a> <strong class="jxr_keyword">var</strong> length = str.length();
+<a class="jxr_linenumber" name="L1420" href="#L1420">1420</a> <strong class="jxr_keyword">if</strong> (length == 0)
+<a class="jxr_linenumber" name="L1421" href="#L1421">1421</a> <strong class="jxr_keyword">return</strong> 0.0;
<a class="jxr_linenumber" name="L1422" href="#L1422">1422</a>
-<a class="jxr_linenumber" name="L1423" href="#L1423">1423</a> <em class="jxr_comment">// Calculate entropy</em>
-<a class="jxr_linenumber" name="L1424" href="#L1424">1424</a> <strong class="jxr_keyword">var</strong> entropy = 0.0;
-<a class="jxr_linenumber" name="L1425" href="#L1425">1425</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> count : charCounts) {
-<a class="jxr_linenumber" name="L1426" href="#L1426">1426</a> <strong class="jxr_keyword">if</strong> (count > 0) {
-<a class="jxr_linenumber" name="L1427" href="#L1427">1427</a> <strong class="jxr_keyword">var</strong> probability = (<strong class="jxr_keyword">double</strong>)count / length;
-<a class="jxr_linenumber" name="L1428" href="#L1428">1428</a> entropy -= probability * (Math.log(probability) / Math.log(2.0));
-<a class="jxr_linenumber" name="L1429" href="#L1429">1429</a> }
-<a class="jxr_linenumber" name="L1430" href="#L1430">1430</a> }
-<a class="jxr_linenumber" name="L1431" href="#L1431">1431</a>
-<a class="jxr_linenumber" name="L1432" href="#L1432">1432</a> <strong class="jxr_keyword">return</strong> entropy;
-<a class="jxr_linenumber" name="L1433" href="#L1433">1433</a> }
-<a class="jxr_linenumber" name="L1434" href="#L1434">1434</a>
-<a class="jxr_linenumber" name="L1435" href="#L1435">1435</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1436" href="#L1436">1436</a> <em class="jxr_javadoccomment"> * Tests two objects for case-insensitive string equality.</em>
-<a class="jxr_linenumber" name="L1437" href="#L1437">1437</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1438" href="#L1438">1438</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1439" href="#L1439">1439</a> <em class="jxr_javadoccomment"> * Converts both objects to strings using {@link Object#toString()} before comparison.</em>
-<a class="jxr_linenumber" name="L1440" href="#L1440">1440</a> <em class="jxr_javadoccomment"> * This method handles <jk>null</jk> values gracefully:</em>
-<a class="jxr_linenumber" name="L1441" href="#L1441">1441</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1442" href="#L1442">1442</a> <em class="jxr_javadoccomment"> * <li>Both <jk>null</jk> → returns <jk>true</jk></li></em>
-<a class="jxr_linenumber" name="L1443" href="#L1443">1443</a> <em class="jxr_javadoccomment"> * <li>One <jk>null</jk> → returns <jk>false</jk></li></em>
-<a class="jxr_linenumber" name="L1444" href="#L1444">1444</a> <em class="jxr_javadoccomment"> * <li>Neither <jk>null</jk> → compares string representations ignoring case</li></em>
-<a class="jxr_linenumber" name="L1445" href="#L1445">1445</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1446" href="#L1446">1446</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1447" href="#L1447">1447</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1448" href="#L1448">1448</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1449" href="#L1449">1449</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <js>"HELLO"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L1450" href="#L1450">1450</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <js>"World"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1451" href="#L1451">1451</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<jk>null</jk>, <jk>null</jk>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L1452" href="#L1452">1452</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1453" href="#L1453">1453</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(123, <js>"123"</js>); <jc>// true (converts 123 to "123")</jc></em>
-<a class="jxr_linenumber" name="L1454" href="#L1454">1454</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1455" href="#L1455">1455</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1456" href="#L1456">1456</a> <em class="jxr_javadoccomment"> * @param a Object 1.</em>
-<a class="jxr_linenumber" name="L1457" href="#L1457">1457</a> <em class="jxr_javadoccomment"> * @param b Object 2.</em>
-<a class="jxr_linenumber" name="L1458" href="#L1458">1458</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if both objects are equal ignoring case.</em>
-<a class="jxr_linenumber" name="L1459" href="#L1459">1459</a> <em class="jxr_javadoccomment"> * @see #equalsIgnoreCase(String, String)</em>
-<a class="jxr_linenumber" name="L1460" href="#L1460">1460</a> <em class="jxr_javadoccomment"> * @see Utils#eqic(Object, Object)</em>
-<a class="jxr_linenumber" name="L1461" href="#L1461">1461</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1462" href="#L1462">1462</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> equalsIgnoreCase(Object a, Object b) {
-<a class="jxr_linenumber" name="L1463" href="#L1463">1463</a> <strong class="jxr_keyword">if</strong> (a == <strong class="jxr_keyword">null</strong> && b == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1464" href="#L1464">1464</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L1465" href="#L1465">1465</a> <strong class="jxr_keyword">if</strong> (a == <strong class="jxr_keyword">null</strong> || b == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1466" href="#L1466">1466</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L1467" href="#L1467">1467</a> <strong class="jxr_keyword">return</strong> a.toString().equalsIgnoreCase(b.toString());
-<a class="jxr_linenumber" name="L1468" href="#L1468">1468</a> }
-<a class="jxr_linenumber" name="L1469" href="#L1469">1469</a>
-<a class="jxr_linenumber" name="L1470" href="#L1470">1470</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1471" href="#L1471">1471</a> <em class="jxr_javadoccomment"> * Tests two strings for case-insensitive equality, but gracefully handles nulls.</em>
-<a class="jxr_linenumber" name="L1472" href="#L1472">1472</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1473" href="#L1473">1473</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1474" href="#L1474">1474</a> <em class="jxr_javadoccomment"> * This method handles <jk>null</jk> values gracefully:</em>
-<a class="jxr_linenumber" name="L1475" href="#L1475">1475</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1476" href="#L1476">1476</a> <em class="jxr_javadoccomment"> * <li>Both <jk>null</jk> → returns <jk>true</jk> (same reference check)</li></em>
-<a class="jxr_linenumber" name="L1477" href="#L1477">1477</a> <em class="jxr_javadoccomment"> * <li>One <jk>null</jk> → returns <jk>false</jk></li></em>
-<a class="jxr_linenumber" name="L1478" href="#L1478">1478</a> <em class="jxr_javadoccomment"> * <li>Neither <jk>null</jk> → compares strings ignoring case</li></em>
-<a class="jxr_linenumber" name="L1479" href="#L1479">1479</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1480" href="#L1480">1480</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1481" href="#L1481">1481</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1482" href="#L1482">1482</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1483" href="#L1483">1483</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <js>"hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L1484" href="#L1484">1484</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <js>"WORLD"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1485" href="#L1485">1485</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<jk>null</jk>, <jk>null</jk>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L1486" href="#L1486">1486</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L1487" href="#L1487">1487</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1488" href="#L1488">1488</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1489" href="#L1489">1489</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
-<a class="jxr_linenumber" name="L1490" href="#L1490">1490</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
-<a class="jxr_linenumber" name="L1491" href="#L1491">1491</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the strings are equal ignoring case, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L1492" href="#L1492">1492</a> <em class="jxr_javadoccomment"> * @see #equalsIgnoreCase(Object, Object)</em>
-<a class="jxr_linenumber" name="L1493" href="#L1493">1493</a> <em class="jxr_javadoccomment"> * @see Utils#eqic(String, String)</em>
-<a class="jxr_linenumber" name="L1494" href="#L1494">1494</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1495" href="#L1495">1495</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> equalsIgnoreCase(String str1, String str2) {
-<a class="jxr_linenumber" name="L1496" href="#L1496">1496</a> <strong class="jxr_keyword">if</strong> (str1 == str2)
-<a class="jxr_linenumber" name="L1497" href="#L1497">1497</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L1498" href="#L1498">1498</a> <strong class="jxr_keyword">if</strong> (str1 == <strong class="jxr_keyword">null</strong> || str2 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1499" href="#L1499">1499</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L1500" href="#L1500">1500</a> <strong class="jxr_keyword">return</strong> str1.equalsIgnoreCase(str2);
-<a class="jxr_linenumber" name="L1501" href="#L1501">1501</a> }
-<a class="jxr_linenumber" name="L1502" href="#L1502">1502</a>
-<a class="jxr_linenumber" name="L1503" href="#L1503">1503</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1504" href="#L1504">1504</a> <em class="jxr_javadoccomment"> * Escapes the specified characters in the string.</em>
-<a class="jxr_linenumber" name="L1505" href="#L1505">1505</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1506" href="#L1506">1506</a> <em class="jxr_javadoccomment"> * @param s The string with characters to escape.</em>
-<a class="jxr_linenumber" name="L1507" href="#L1507">1507</a> <em class="jxr_javadoccomment"> * @param escaped The characters to escape.</em>
-<a class="jxr_linenumber" name="L1508" href="#L1508">1508</a> <em class="jxr_javadoccomment"> * @return The string with characters escaped, or the same string if no escapable characters were found.</em>
-<a class="jxr_linenumber" name="L1509" href="#L1509">1509</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1510" href="#L1510">1510</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeChars(String s, <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> escaped) {
-<a class="jxr_linenumber" name="L1511" href="#L1511">1511</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty())
-<a class="jxr_linenumber" name="L1512" href="#L1512">1512</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L1513" href="#L1513">1513</a>
-<a class="jxr_linenumber" name="L1514" href="#L1514">1514</a> <strong class="jxr_keyword">var</strong> count = 0;
-<a class="jxr_linenumber" name="L1515" href="#L1515">1515</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++)
-<a class="jxr_linenumber" name="L1516" href="#L1516">1516</a> <strong class="jxr_keyword">if</strong> (escaped.contains(s.charAt(i)))
-<a class="jxr_linenumber" name="L1517" href="#L1517">1517</a> count++;
-<a class="jxr_linenumber" name="L1518" href="#L1518">1518</a> <strong class="jxr_keyword">if</strong> (count == 0)
-<a class="jxr_linenumber" name="L1519" href="#L1519">1519</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L1520" href="#L1520">1520</a>
-<a class="jxr_linenumber" name="L1521" href="#L1521">1521</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuffer(s.length() + count);
-<a class="jxr_linenumber" name="L1522" href="#L1522">1522</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L1523" href="#L1523">1523</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L1524" href="#L1524">1524</a> <strong class="jxr_keyword">if</strong> (escaped.contains(c))
-<a class="jxr_linenumber" name="L1525" href="#L1525">1525</a> sb.append('\\');
-<a class="jxr_linenumber" name="L1526" href="#L1526">1526</a> sb.append(c);
-<a class="jxr_linenumber" name="L1527" href="#L1527">1527</a> }
-<a class="jxr_linenumber" name="L1528" href="#L1528">1528</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L1529" href="#L1529">1529</a> }
-<a class="jxr_linenumber" name="L1530" href="#L1530">1530</a>
-<a class="jxr_linenumber" name="L1531" href="#L1531">1531</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1532" href="#L1532">1532</a> <em class="jxr_javadoccomment"> * Escapes a string for safe inclusion in Java source code.</em>
-<a class="jxr_linenumber" name="L1533" href="#L1533">1533</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1534" href="#L1534">1534</a> <em class="jxr_javadoccomment"> * <p>This method converts special characters to their Java escape sequences and</em>
-<a class="jxr_linenumber" name="L1535" href="#L1535">1535</a> <em class="jxr_javadoccomment"> * converts non-printable ASCII characters to Unicode escape sequences.</em>
-<a class="jxr_linenumber" name="L1536" href="#L1536">1536</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1537" href="#L1537">1537</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Escape mappings:</h5></em>
-<a class="jxr_linenumber" name="L1538" href="#L1538">1538</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1539" href="#L1539">1539</a> <em class="jxr_javadoccomment"> * <li>{@code "} → {@code \"}</li></em>
-<a class="jxr_linenumber" name="L1540" href="#L1540">1540</a> <em class="jxr_javadoccomment"> * <li>{@code \} → {@code \\}</li></em>
-<a class="jxr_linenumber" name="L1541" href="#L1541">1541</a> <em class="jxr_javadoccomment"> * <li>{@code \n} → {@code \\n}</li></em>
-<a class="jxr_linenumber" name="L1542" href="#L1542">1542</a> <em class="jxr_javadoccomment"> * <li>{@code \r} → {@code \\r}</li></em>
-<a class="jxr_linenumber" name="L1543" href="#L1543">1543</a> <em class="jxr_javadoccomment"> * <li>{@code \t} → {@code \\t}</li></em>
-<a class="jxr_linenumber" name="L1544" href="#L1544">1544</a> <em class="jxr_javadoccomment"> * <li>{@code \f} → {@code \\f}</li></em>
-<a class="jxr_linenumber" name="L1545" href="#L1545">1545</a> <em class="jxr_javadoccomment"> * <li>{@code \b} → {@code \\b}</li></em>
-<a class="jxr_linenumber" name="L1546" href="#L1546">1546</a> <em class="jxr_javadoccomment"> * <li>Non-printable characters → {@code \\uXXXX}</li></em>
-<a class="jxr_linenumber" name="L1547" href="#L1547">1547</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1548" href="#L1548">1548</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1549" href="#L1549">1549</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1550" href="#L1550">1550</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1551" href="#L1551">1551</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>escaped</jv> = <jsm>escapeForJava</jsm>(<js>"Hello\nWorld\"Test\""</js>);</em>
-<a class="jxr_linenumber" name="L1552" href="#L1552">1552</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello\\nWorld\\\"Test\\\""</jc></em>
-<a class="jxr_linenumber" name="L1553" href="#L1553">1553</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1423" href="#L1423">1423</a> <em class="jxr_comment">// Count character frequencies</em>
+<a class="jxr_linenumber" name="L1424" href="#L1424">1424</a> <strong class="jxr_keyword">var</strong> charCounts = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[Character.MAX_VALUE + 1];
+<a class="jxr_linenumber" name="L1425" href="#L1425">1425</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < length; i++) {
+<a class="jxr_linenumber" name="L1426" href="#L1426">1426</a> charCounts[str.charAt(i)]++;
+<a class="jxr_linenumber" name="L1427" href="#L1427">1427</a> }
+<a class="jxr_linenumber" name="L1428" href="#L1428">1428</a>
+<a class="jxr_linenumber" name="L1429" href="#L1429">1429</a> <em class="jxr_comment">// Calculate entropy</em>
+<a class="jxr_linenumber" name="L1430" href="#L1430">1430</a> <strong class="jxr_keyword">var</strong> entropy = 0.0;
+<a class="jxr_linenumber" name="L1431" href="#L1431">1431</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> count : charCounts) {
+<a class="jxr_linenumber" name="L1432" href="#L1432">1432</a> <strong class="jxr_keyword">if</strong> (count > 0) {
+<a class="jxr_linenumber" name="L1433" href="#L1433">1433</a> <strong class="jxr_keyword">var</strong> probability = (<strong class="jxr_keyword">double</strong>)count / length;
+<a class="jxr_linenumber" name="L1434" href="#L1434">1434</a> entropy -= probability * (Math.log(probability) / Math.log(2.0));
+<a class="jxr_linenumber" name="L1435" href="#L1435">1435</a> }
+<a class="jxr_linenumber" name="L1436" href="#L1436">1436</a> }
+<a class="jxr_linenumber" name="L1437" href="#L1437">1437</a>
+<a class="jxr_linenumber" name="L1438" href="#L1438">1438</a> <strong class="jxr_keyword">return</strong> entropy;
+<a class="jxr_linenumber" name="L1439" href="#L1439">1439</a> }
+<a class="jxr_linenumber" name="L1440" href="#L1440">1440</a>
+<a class="jxr_linenumber" name="L1441" href="#L1441">1441</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1442" href="#L1442">1442</a> <em class="jxr_javadoccomment"> * Tests two objects for case-insensitive string equality.</em>
+<a class="jxr_linenumber" name="L1443" href="#L1443">1443</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1444" href="#L1444">1444</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1445" href="#L1445">1445</a> <em class="jxr_javadoccomment"> * Converts both objects to strings using {@link Object#toString()} before comparison.</em>
+<a class="jxr_linenumber" name="L1446" href="#L1446">1446</a> <em class="jxr_javadoccomment"> * This method handles <jk>null</jk> values gracefully:</em>
+<a class="jxr_linenumber" name="L1447" href="#L1447">1447</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1448" href="#L1448">1448</a> <em class="jxr_javadoccomment"> * <li>Both <jk>null</jk> → returns <jk>true</jk></li></em>
+<a class="jxr_linenumber" name="L1449" href="#L1449">1449</a> <em class="jxr_javadoccomment"> * <li>One <jk>null</jk> → returns <jk>false</jk></li></em>
+<a class="jxr_linenumber" name="L1450" href="#L1450">1450</a> <em class="jxr_javadoccomment"> * <li>Neither <jk>null</jk> → compares string representations ignoring case</li></em>
+<a class="jxr_linenumber" name="L1451" href="#L1451">1451</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L1452" href="#L1452">1452</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1453" href="#L1453">1453</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1454" href="#L1454">1454</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1455" href="#L1455">1455</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <js>"HELLO"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L1456" href="#L1456">1456</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <js>"World"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1457" href="#L1457">1457</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<jk>null</jk>, <jk>null</jk>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L1458" href="#L1458">1458</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1459" href="#L1459">1459</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(123, <js>"123"</js>); <jc>// true (converts 123 to "123")</jc></em>
+<a class="jxr_linenumber" name="L1460" href="#L1460">1460</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1461" href="#L1461">1461</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1462" href="#L1462">1462</a> <em class="jxr_javadoccomment"> * @param a Object 1.</em>
+<a class="jxr_linenumber" name="L1463" href="#L1463">1463</a> <em class="jxr_javadoccomment"> * @param b Object 2.</em>
+<a class="jxr_linenumber" name="L1464" href="#L1464">1464</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if both objects are equal ignoring case.</em>
+<a class="jxr_linenumber" name="L1465" href="#L1465">1465</a> <em class="jxr_javadoccomment"> * @see #equalsIgnoreCase(String, String)</em>
+<a class="jxr_linenumber" name="L1466" href="#L1466">1466</a> <em class="jxr_javadoccomment"> * @see Utils#eqic(Object, Object)</em>
+<a class="jxr_linenumber" name="L1467" href="#L1467">1467</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1468" href="#L1468">1468</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> equalsIgnoreCase(Object a, Object b) {
+<a class="jxr_linenumber" name="L1469" href="#L1469">1469</a> <strong class="jxr_keyword">if</strong> (a == <strong class="jxr_keyword">null</strong> && b == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1470" href="#L1470">1470</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L1471" href="#L1471">1471</a> <strong class="jxr_keyword">if</strong> (a == <strong class="jxr_keyword">null</strong> || b == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1472" href="#L1472">1472</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L1473" href="#L1473">1473</a> <strong class="jxr_keyword">return</strong> a.toString().equalsIgnoreCase(b.toString());
+<a class="jxr_linenumber" name="L1474" href="#L1474">1474</a> }
+<a class="jxr_linenumber" name="L1475" href="#L1475">1475</a>
+<a class="jxr_linenumber" name="L1476" href="#L1476">1476</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1477" href="#L1477">1477</a> <em class="jxr_javadoccomment"> * Tests two strings for case-insensitive equality, but gracefully handles nulls.</em>
+<a class="jxr_linenumber" name="L1478" href="#L1478">1478</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1479" href="#L1479">1479</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1480" href="#L1480">1480</a> <em class="jxr_javadoccomment"> * This method handles <jk>null</jk> values gracefully:</em>
+<a class="jxr_linenumber" name="L1481" href="#L1481">1481</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1482" href="#L1482">1482</a> <em class="jxr_javadoccomment"> * <li>Both <jk>null</jk> → returns <jk>true</jk> (same reference check)</li></em>
+<a class="jxr_linenumber" name="L1483" href="#L1483">1483</a> <em class="jxr_javadoccomment"> * <li>One <jk>null</jk> → returns <jk>false</jk></li></em>
+<a class="jxr_linenumber" name="L1484" href="#L1484">1484</a> <em class="jxr_javadoccomment"> * <li>Neither <jk>null</jk> → compares strings ignoring case</li></em>
+<a class="jxr_linenumber" name="L1485" href="#L1485">1485</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L1486" href="#L1486">1486</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1487" href="#L1487">1487</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1488" href="#L1488">1488</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1489" href="#L1489">1489</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <js>"hello"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L1490" href="#L1490">1490</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <js>"WORLD"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1491" href="#L1491">1491</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<jk>null</jk>, <jk>null</jk>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L1492" href="#L1492">1492</a> <em class="jxr_javadoccomment"> * equalsIgnoreCase(<js>"Hello"</js>, <jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L1493" href="#L1493">1493</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1494" href="#L1494">1494</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1495" href="#L1495">1495</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
+<a class="jxr_linenumber" name="L1496" href="#L1496">1496</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
+<a class="jxr_linenumber" name="L1497" href="#L1497">1497</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the strings are equal ignoring case, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L1498" href="#L1498">1498</a> <em class="jxr_javadoccomment"> * @see #equalsIgnoreCase(Object, Object)</em>
+<a class="jxr_linenumber" name="L1499" href="#L1499">1499</a> <em class="jxr_javadoccomment"> * @see Utils#eqic(String, String)</em>
+<a class="jxr_linenumber" name="L1500" href="#L1500">1500</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1501" href="#L1501">1501</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> equalsIgnoreCase(String str1, String str2) {
+<a class="jxr_linenumber" name="L1502" href="#L1502">1502</a> <strong class="jxr_keyword">if</strong> (str1 == str2)
+<a class="jxr_linenumber" name="L1503" href="#L1503">1503</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L1504" href="#L1504">1504</a> <strong class="jxr_keyword">if</strong> (str1 == <strong class="jxr_keyword">null</strong> || str2 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1505" href="#L1505">1505</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L1506" href="#L1506">1506</a> <strong class="jxr_keyword">return</strong> str1.equalsIgnoreCase(str2);
+<a class="jxr_linenumber" name="L1507" href="#L1507">1507</a> }
+<a class="jxr_linenumber" name="L1508" href="#L1508">1508</a>
+<a class="jxr_linenumber" name="L1509" href="#L1509">1509</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1510" href="#L1510">1510</a> <em class="jxr_javadoccomment"> * Escapes the specified characters in the string.</em>
+<a class="jxr_linenumber" name="L1511" href="#L1511">1511</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1512" href="#L1512">1512</a> <em class="jxr_javadoccomment"> * @param s The string with characters to escape.</em>
+<a class="jxr_linenumber" name="L1513" href="#L1513">1513</a> <em class="jxr_javadoccomment"> * @param escaped The characters to escape.</em>
+<a class="jxr_linenumber" name="L1514" href="#L1514">1514</a> <em class="jxr_javadoccomment"> * @return The string with characters escaped, or the same string if no escapable characters were found.</em>
+<a class="jxr_linenumber" name="L1515" href="#L1515">1515</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1516" href="#L1516">1516</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeChars(String s, <a name="AsciiSet" href="../../../../../org/apache/juneau/commons/utils/AsciiSet.html#AsciiSet">AsciiSet</a> escaped) {
+<a class="jxr_linenumber" name="L1517" href="#L1517">1517</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty())
+<a class="jxr_linenumber" name="L1518" href="#L1518">1518</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L1519" href="#L1519">1519</a>
+<a class="jxr_linenumber" name="L1520" href="#L1520">1520</a> <strong class="jxr_keyword">var</strong> count = 0;
+<a class="jxr_linenumber" name="L1521" href="#L1521">1521</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++)
+<a class="jxr_linenumber" name="L1522" href="#L1522">1522</a> <strong class="jxr_keyword">if</strong> (escaped.contains(s.charAt(i)))
+<a class="jxr_linenumber" name="L1523" href="#L1523">1523</a> count++;
+<a class="jxr_linenumber" name="L1524" href="#L1524">1524</a> <strong class="jxr_keyword">if</strong> (count == 0)
+<a class="jxr_linenumber" name="L1525" href="#L1525">1525</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L1526" href="#L1526">1526</a>
+<a class="jxr_linenumber" name="L1527" href="#L1527">1527</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuffer(s.length() + count);
+<a class="jxr_linenumber" name="L1528" href="#L1528">1528</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L1529" href="#L1529">1529</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L1530" href="#L1530">1530</a> <strong class="jxr_keyword">if</strong> (escaped.contains(c))
+<a class="jxr_linenumber" name="L1531" href="#L1531">1531</a> sb.append('\\');
+<a class="jxr_linenumber" name="L1532" href="#L1532">1532</a> sb.append(c);
+<a class="jxr_linenumber" name="L1533" href="#L1533">1533</a> }
+<a class="jxr_linenumber" name="L1534" href="#L1534">1534</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L1535" href="#L1535">1535</a> }
+<a class="jxr_linenumber" name="L1536" href="#L1536">1536</a>
+<a class="jxr_linenumber" name="L1537" href="#L1537">1537</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1538" href="#L1538">1538</a> <em class="jxr_javadoccomment"> * Escapes a string for safe inclusion in Java source code.</em>
+<a class="jxr_linenumber" name="L1539" href="#L1539">1539</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1540" href="#L1540">1540</a> <em class="jxr_javadoccomment"> * <p>This method converts special characters to their Java escape sequences and</em>
+<a class="jxr_linenumber" name="L1541" href="#L1541">1541</a> <em class="jxr_javadoccomment"> * converts non-printable ASCII characters to Unicode escape sequences.</em>
+<a class="jxr_linenumber" name="L1542" href="#L1542">1542</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1543" href="#L1543">1543</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Escape mappings:</h5></em>
+<a class="jxr_linenumber" name="L1544" href="#L1544">1544</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1545" href="#L1545">1545</a> <em class="jxr_javadoccomment"> * <li>{@code "} → {@code \"}</li></em>
+<a class="jxr_linenumber" name="L1546" href="#L1546">1546</a> <em class="jxr_javadoccomment"> * <li>{@code \} → {@code \\}</li></em>
+<a class="jxr_linenumber" name="L1547" href="#L1547">1547</a> <em class="jxr_javadoccomment"> * <li>{@code \n} → {@code \\n}</li></em>
+<a class="jxr_linenumber" name="L1548" href="#L1548">1548</a> <em class="jxr_javadoccomment"> * <li>{@code \r} → {@code \\r}</li></em>
+<a class="jxr_linenumber" name="L1549" href="#L1549">1549</a> <em class="jxr_javadoccomment"> * <li>{@code \t} → {@code \\t}</li></em>
+<a class="jxr_linenumber" name="L1550" href="#L1550">1550</a> <em class="jxr_javadoccomment"> * <li>{@code \f} → {@code \\f}</li></em>
+<a class="jxr_linenumber" name="L1551" href="#L1551">1551</a> <em class="jxr_javadoccomment"> * <li>{@code \b} → {@code \\b}</li></em>
+<a class="jxr_linenumber" name="L1552" href="#L1552">1552</a> <em class="jxr_javadoccomment"> * <li>Non-printable characters → {@code \\uXXXX}</li></em>
+<a class="jxr_linenumber" name="L1553" href="#L1553">1553</a> <em class="jxr_javadoccomment"> * </ul></em>
<a class="jxr_linenumber" name="L1554" href="#L1554">1554</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1555" href="#L1555">1555</a> <em class="jxr_javadoccomment"> * @param s The string to escape.</em>
-<a class="jxr_linenumber" name="L1556" href="#L1556">1556</a> <em class="jxr_javadoccomment"> * @return The escaped string safe for Java source code, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1557" href="#L1557">1557</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1558" href="#L1558">1558</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeForJava(String s) {
-<a class="jxr_linenumber" name="L1559" href="#L1559">1559</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1560" href="#L1560">1560</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1561" href="#L1561">1561</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L1562" href="#L1562">1562</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> c : s.toCharArray()) {
-<a class="jxr_linenumber" name="L1563" href="#L1563">1563</a> sb.append(<strong class="jxr_keyword">switch</strong> (c) {
-<a class="jxr_linenumber" name="L1564" href="#L1564">1564</a> <strong class="jxr_keyword">case</strong> '\"' -> <span class="jxr_string">"\\\""</span>;
-<a class="jxr_linenumber" name="L1565" href="#L1565">1565</a> <strong class="jxr_keyword">case</strong> '\\' -> <span class="jxr_string">"\\\\"</span>;
-<a class="jxr_linenumber" name="L1566" href="#L1566">1566</a> <strong class="jxr_keyword">case</strong> '\n' -> <span class="jxr_string">"\\n"</span>;
-<a class="jxr_linenumber" name="L1567" href="#L1567">1567</a> <strong class="jxr_keyword">case</strong> '\r' -> <span class="jxr_string">"\\r"</span>;
-<a class="jxr_linenumber" name="L1568" href="#L1568">1568</a> <strong class="jxr_keyword">case</strong> '\t' -> <span class="jxr_string">"\\t"</span>;
-<a class="jxr_linenumber" name="L1569" href="#L1569">1569</a> <strong class="jxr_keyword">case</strong> '\f' -> <span class="jxr_string">"\\f"</span>;
-<a class="jxr_linenumber" name="L1570" href="#L1570">1570</a> <strong class="jxr_keyword">case</strong> '\b' -> <span class="jxr_string">"\\b"</span>;
-<a class="jxr_linenumber" name="L1571" href="#L1571">1571</a> <strong class="jxr_keyword">default</strong> -> {
-<a class="jxr_linenumber" name="L1572" href="#L1572">1572</a> <strong class="jxr_keyword">if</strong> (c < 0x20 || c > 0x7E)
-<a class="jxr_linenumber" name="L1573" href="#L1573">1573</a> yield String.format(<span class="jxr_string">"\\u%04x"</span>, (<strong class="jxr_keyword">int</strong>)c);
-<a class="jxr_linenumber" name="L1574" href="#L1574">1574</a> yield String.valueOf(c);
-<a class="jxr_linenumber" name="L1575" href="#L1575">1575</a> }
-<a class="jxr_linenumber" name="L1576" href="#L1576">1576</a> });
-<a class="jxr_linenumber" name="L1577" href="#L1577">1577</a> }
-<a class="jxr_linenumber" name="L1578" href="#L1578">1578</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L1579" href="#L1579">1579</a> }
-<a class="jxr_linenumber" name="L1580" href="#L1580">1580</a>
-<a class="jxr_linenumber" name="L1581" href="#L1581">1581</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1582" href="#L1582">1582</a> <em class="jxr_javadoccomment"> * Escapes HTML entities in a string.</em>
-<a class="jxr_linenumber" name="L1583" href="#L1583">1583</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1584" href="#L1584">1584</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1585" href="#L1585">1585</a> <em class="jxr_javadoccomment"> * Escapes the following characters:</em>
-<a class="jxr_linenumber" name="L1586" href="#L1586">1586</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1587" href="#L1587">1587</a> <em class="jxr_javadoccomment"> * <li><js>'&amp;'</js> → <js>"&amp;amp;"</js></li></em>
-<a class="jxr_linenumber" name="L1588" href="#L1588">1588</a> <em class="jxr_javadoccomment"> * <li><js>'&lt;'</js> → <js>"&amp;lt;"</js></li></em>
-<a class="jxr_linenumber" name="L1589" href="#L1589">1589</a> <em class="jxr_javadoccomment"> * <li><js>'&gt;'</js> → <js>"&amp;gt;"</js></li></em>
-<a class="jxr_linenumber" name="L1590" href="#L1590">1590</a> <em class="jxr_javadoccomment"> * <li><js>'"'</js> → <js>"&amp;quot;"</js></li></em>
-<a class="jxr_linenumber" name="L1591" href="#L1591">1591</a> <em class="jxr_javadoccomment"> * <li><js>'\''</js> → <js>"&amp;#39;"</js></li></em>
-<a class="jxr_linenumber" name="L1592" href="#L1592">1592</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1593" href="#L1593">1593</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1594" href="#L1594">1594</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1595" href="#L1595">1595</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1596" href="#L1596">1596</a> <em class="jxr_javadoccomment"> * escapeHtml(<js>"&lt;script&gt;alert('xss')&lt;/script&gt;"</js>);</em>
-<a class="jxr_linenumber" name="L1597" href="#L1597">1597</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "&amp;lt;script&amp;gt;alert(&amp;#39;xss&amp;#39;)&amp;lt;/script&amp;gt;"</jc></em>
-<a class="jxr_linenumber" name="L1598" href="#L1598">1598</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1555" href="#L1555">1555</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1556" href="#L1556">1556</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1557" href="#L1557">1557</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>escaped</jv> = <jsm>escapeForJava</jsm>(<js>"Hello\nWorld\"Test\""</js>);</em>
+<a class="jxr_linenumber" name="L1558" href="#L1558">1558</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello\\nWorld\\\"Test\\\""</jc></em>
+<a class="jxr_linenumber" name="L1559" href="#L1559">1559</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1560" href="#L1560">1560</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1561" href="#L1561">1561</a> <em class="jxr_javadoccomment"> * @param s The string to escape.</em>
+<a class="jxr_linenumber" name="L1562" href="#L1562">1562</a> <em class="jxr_javadoccomment"> * @return The escaped string safe for Java source code, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1563" href="#L1563">1563</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1564" href="#L1564">1564</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeForJava(String s) {
+<a class="jxr_linenumber" name="L1565" href="#L1565">1565</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1566" href="#L1566">1566</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1567" href="#L1567">1567</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L1568" href="#L1568">1568</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> c : s.toCharArray()) {
+<a class="jxr_linenumber" name="L1569" href="#L1569">1569</a> sb.append(<strong class="jxr_keyword">switch</strong> (c) {
+<a class="jxr_linenumber" name="L1570" href="#L1570">1570</a> <strong class="jxr_keyword">case</strong> '\"' -> <span class="jxr_string">"\\\""</span>;
+<a class="jxr_linenumber" name="L1571" href="#L1571">1571</a> <strong class="jxr_keyword">case</strong> '\\' -> <span class="jxr_string">"\\\\"</span>;
+<a class="jxr_linenumber" name="L1572" href="#L1572">1572</a> <strong class="jxr_keyword">case</strong> '\n' -> <span class="jxr_string">"\\n"</span>;
+<a class="jxr_linenumber" name="L1573" href="#L1573">1573</a> <strong class="jxr_keyword">case</strong> '\r' -> <span class="jxr_string">"\\r"</span>;
+<a class="jxr_linenumber" name="L1574" href="#L1574">1574</a> <strong class="jxr_keyword">case</strong> '\t' -> <span class="jxr_string">"\\t"</span>;
+<a class="jxr_linenumber" name="L1575" href="#L1575">1575</a> <strong class="jxr_keyword">case</strong> '\f' -> <span class="jxr_string">"\\f"</span>;
+<a class="jxr_linenumber" name="L1576" href="#L1576">1576</a> <strong class="jxr_keyword">case</strong> '\b' -> <span class="jxr_string">"\\b"</span>;
+<a class="jxr_linenumber" name="L1577" href="#L1577">1577</a> <strong class="jxr_keyword">default</strong> -> {
+<a class="jxr_linenumber" name="L1578" href="#L1578">1578</a> <strong class="jxr_keyword">if</strong> (c < 0x20 || c > 0x7E)
+<a class="jxr_linenumber" name="L1579" href="#L1579">1579</a> yield String.format(<span class="jxr_string">"\\u%04x"</span>, (<strong class="jxr_keyword">int</strong>)c);
+<a class="jxr_linenumber" name="L1580" href="#L1580">1580</a> yield String.valueOf(c);
+<a class="jxr_linenumber" name="L1581" href="#L1581">1581</a> }
+<a class="jxr_linenumber" name="L1582" href="#L1582">1582</a> });
+<a class="jxr_linenumber" name="L1583" href="#L1583">1583</a> }
+<a class="jxr_linenumber" name="L1584" href="#L1584">1584</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L1585" href="#L1585">1585</a> }
+<a class="jxr_linenumber" name="L1586" href="#L1586">1586</a>
+<a class="jxr_linenumber" name="L1587" href="#L1587">1587</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1588" href="#L1588">1588</a> <em class="jxr_javadoccomment"> * Escapes HTML entities in a string.</em>
+<a class="jxr_linenumber" name="L1589" href="#L1589">1589</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1590" href="#L1590">1590</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1591" href="#L1591">1591</a> <em class="jxr_javadoccomment"> * Escapes the following characters:</em>
+<a class="jxr_linenumber" name="L1592" href="#L1592">1592</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1593" href="#L1593">1593</a> <em class="jxr_javadoccomment"> * <li><js>'&amp;'</js> → <js>"&amp;amp;"</js></li></em>
+<a class="jxr_linenumber" name="L1594" href="#L1594">1594</a> <em class="jxr_javadoccomment"> * <li><js>'&lt;'</js> → <js>"&amp;lt;"</js></li></em>
+<a class="jxr_linenumber" name="L1595" href="#L1595">1595</a> <em class="jxr_javadoccomment"> * <li><js>'&gt;'</js> → <js>"&amp;gt;"</js></li></em>
+<a class="jxr_linenumber" name="L1596" href="#L1596">1596</a> <em class="jxr_javadoccomment"> * <li><js>'"'</js> → <js>"&amp;quot;"</js></li></em>
+<a class="jxr_linenumber" name="L1597" href="#L1597">1597</a> <em class="jxr_javadoccomment"> * <li><js>'\''</js> → <js>"&amp;#39;"</js></li></em>
+<a class="jxr_linenumber" name="L1598" href="#L1598">1598</a> <em class="jxr_javadoccomment"> * </ul></em>
<a class="jxr_linenumber" name="L1599" href="#L1599">1599</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1600" href="#L1600">1600</a> <em class="jxr_javadoccomment"> * @param str The string to escape.</em>
-<a class="jxr_linenumber" name="L1601" href="#L1601">1601</a> <em class="jxr_javadoccomment"> * @return The escaped string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1602" href="#L1602">1602</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1603" href="#L1603">1603</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeHtml(String str) {
-<a class="jxr_linenumber" name="L1604" href="#L1604">1604</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1605" href="#L1605">1605</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1606" href="#L1606">1606</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(str.length() * 2);
-<a class="jxr_linenumber" name="L1607" href="#L1607">1607</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L1608" href="#L1608">1608</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
-<a class="jxr_linenumber" name="L1609" href="#L1609">1609</a> <strong class="jxr_keyword">switch</strong> (c) {
-<a class="jxr_linenumber" name="L1610" href="#L1610">1610</a> <strong class="jxr_keyword">case</strong> '&' -> sb.append(<span class="jxr_string">"&amp;"</span>);
-<a class="jxr_linenumber" name="L1611" href="#L1611">1611</a> <strong class="jxr_keyword">case</strong> '<' -> sb.append(<span class="jxr_string">"&lt;"</span>);
-<a class="jxr_linenumber" name="L1612" href="#L1612">1612</a> <strong class="jxr_keyword">case</strong> '>' -> sb.append(<span class="jxr_string">"&gt;"</span>);
-<a class="jxr_linenumber" name="L1613" href="#L1613">1613</a> <strong class="jxr_keyword">case</strong> '"' -> sb.append(<span class="jxr_string">"&quot;"</span>);
-<a class="jxr_linenumber" name="L1614" href="#L1614">1614</a> <strong class="jxr_keyword">case</strong> '\'' -> sb.append(<span class="jxr_string">"&#39;"</span>);
-<a class="jxr_linenumber" name="L1615" href="#L1615">1615</a> <strong class="jxr_keyword">default</strong> -> sb.append(c);
-<a class="jxr_linenumber" name="L1616" href="#L1616">1616</a> }
-<a class="jxr_linenumber" name="L1617" href="#L1617">1617</a> }
-<a class="jxr_linenumber" name="L1618" href="#L1618">1618</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L1619" href="#L1619">1619</a> }
-<a class="jxr_linenumber" name="L1620" href="#L1620">1620</a>
-<a class="jxr_linenumber" name="L1621" href="#L1621">1621</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1622" href="#L1622">1622</a> <em class="jxr_javadoccomment"> * Escapes regex special characters in a string.</em>
-<a class="jxr_linenumber" name="L1623" href="#L1623">1623</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1624" href="#L1624">1624</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1625" href="#L1625">1625</a> <em class="jxr_javadoccomment"> * Escapes the following regex special characters: <js>\.*+?^${}()[]|\\</js></em>
-<a class="jxr_linenumber" name="L1626" href="#L1626">1626</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1627" href="#L1627">1627</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1628" href="#L1628">1628</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1629" href="#L1629">1629</a> <em class="jxr_javadoccomment"> * escapeRegex(<js>"file.txt"</js>); <jc>// Returns: "file\\.txt"</jc></em>
-<a class="jxr_linenumber" name="L1630" href="#L1630">1630</a> <em class="jxr_javadoccomment"> * escapeRegex(<js>"price: $10.99"</js>); <jc>// Returns: "price: \\$10\\.99"</jc></em>
-<a class="jxr_linenumber" name="L1631" href="#L1631">1631</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1600" href="#L1600">1600</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1601" href="#L1601">1601</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1602" href="#L1602">1602</a> <em class="jxr_javadoccomment"> * escapeHtml(<js>"&lt;script&gt;alert('xss')&lt;/script&gt;"</js>);</em>
+<a class="jxr_linenumber" name="L1603" href="#L1603">1603</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "&amp;lt;script&amp;gt;alert(&amp;#39;xss&amp;#39;)&amp;lt;/script&amp;gt;"</jc></em>
+<a class="jxr_linenumber" name="L1604" href="#L1604">1604</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1605" href="#L1605">1605</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1606" href="#L1606">1606</a> <em class="jxr_javadoccomment"> * @param str The string to escape.</em>
+<a class="jxr_linenumber" name="L1607" href="#L1607">1607</a> <em class="jxr_javadoccomment"> * @return The escaped string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1608" href="#L1608">1608</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1609" href="#L1609">1609</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeHtml(String str) {
+<a class="jxr_linenumber" name="L1610" href="#L1610">1610</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1611" href="#L1611">1611</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1612" href="#L1612">1612</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(str.length() * 2);
+<a class="jxr_linenumber" name="L1613" href="#L1613">1613</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L1614" href="#L1614">1614</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
+<a class="jxr_linenumber" name="L1615" href="#L1615">1615</a> <strong class="jxr_keyword">switch</strong> (c) {
+<a class="jxr_linenumber" name="L1616" href="#L1616">1616</a> <strong class="jxr_keyword">case</strong> '&' -> sb.append(<span class="jxr_string">"&amp;"</span>);
+<a class="jxr_linenumber" name="L1617" href="#L1617">1617</a> <strong class="jxr_keyword">case</strong> '<' -> sb.append(<span class="jxr_string">"&lt;"</span>);
+<a class="jxr_linenumber" name="L1618" href="#L1618">1618</a> <strong class="jxr_keyword">case</strong> '>' -> sb.append(<span class="jxr_string">"&gt;"</span>);
+<a class="jxr_linenumber" name="L1619" href="#L1619">1619</a> <strong class="jxr_keyword">case</strong> '"' -> sb.append(<span class="jxr_string">"&quot;"</span>);
+<a class="jxr_linenumber" name="L1620" href="#L1620">1620</a> <strong class="jxr_keyword">case</strong> '\'' -> sb.append(<span class="jxr_string">"&#39;"</span>);
+<a class="jxr_linenumber" name="L1621" href="#L1621">1621</a> <strong class="jxr_keyword">default</strong> -> sb.append(c);
+<a class="jxr_linenumber" name="L1622" href="#L1622">1622</a> }
+<a class="jxr_linenumber" name="L1623" href="#L1623">1623</a> }
+<a class="jxr_linenumber" name="L1624" href="#L1624">1624</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L1625" href="#L1625">1625</a> }
+<a class="jxr_linenumber" name="L1626" href="#L1626">1626</a>
+<a class="jxr_linenumber" name="L1627" href="#L1627">1627</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1628" href="#L1628">1628</a> <em class="jxr_javadoccomment"> * Escapes regex special characters in a string.</em>
+<a class="jxr_linenumber" name="L1629" href="#L1629">1629</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1630" href="#L1630">1630</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1631" href="#L1631">1631</a> <em class="jxr_javadoccomment"> * Escapes the following regex special characters: <js>\.*+?^${}()[]|\\</js></em>
<a class="jxr_linenumber" name="L1632" href="#L1632">1632</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1633" href="#L1633">1633</a> <em class="jxr_javadoccomment"> * @param str The string to escape.</em>
-<a class="jxr_linenumber" name="L1634" href="#L1634">1634</a> <em class="jxr_javadoccomment"> * @return The escaped string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1635" href="#L1635">1635</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1636" href="#L1636">1636</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeRegex(String str) {
-<a class="jxr_linenumber" name="L1637" href="#L1637">1637</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1638" href="#L1638">1638</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1639" href="#L1639">1639</a> <em class="jxr_comment">// Escape regex special characters: . * + ? ^ $ { } ( ) [ ] | \</em>
-<a class="jxr_linenumber" name="L1640" href="#L1640">1640</a> <strong class="jxr_keyword">return</strong> str.replace(<span class="jxr_string">"\\"</span>, <span class="jxr_string">"\\\\"</span>).replace(<span class="jxr_string">"."</span>, <span class="jxr_string">"\\."</span>).replace(<span class="jxr_string">"*"</span>, <span class="jxr_string">"\\*"</span>).replace(<span class="jxr_string">"+"</span>, <span class="jxr_string">"\\+"</s [...]
-<a class="jxr_linenumber" name="L1641" href="#L1641">1641</a> .replace(<span class="jxr_string">"("</span>, <span class="jxr_string">"\\("</span>).replace(<span class="jxr_string">")"</span>, <span class="jxr_string">"\\)"</span>).replace(<span class="jxr_string">"["</span>, <span class="jxr_string">"\\["</span>).replace(<span class="jxr_string">"]"</span>, <span class="jxr_string">"\\]"</span>).replace(<span class="jxr_string">"|"</span>, <span class=" [...]
-<a class="jxr_linenumber" name="L1642" href="#L1642">1642</a> }
-<a class="jxr_linenumber" name="L1643" href="#L1643">1643</a>
-<a class="jxr_linenumber" name="L1644" href="#L1644">1644</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1645" href="#L1645">1645</a> <em class="jxr_javadoccomment"> * Escapes SQL string literals by doubling single quotes.</em>
-<a class="jxr_linenumber" name="L1646" href="#L1646">1646</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1647" href="#L1647">1647</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1648" href="#L1648">1648</a> <em class="jxr_javadoccomment"> * Basic SQL escaping for string literals. Escapes single quotes by doubling them.</em>
-<a class="jxr_linenumber" name="L1649" href="#L1649">1649</a> <em class="jxr_javadoccomment"> * This is a basic implementation - for production use, consider using prepared statements.</em>
-<a class="jxr_linenumber" name="L1650" href="#L1650">1650</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1651" href="#L1651">1651</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1652" href="#L1652">1652</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1653" href="#L1653">1653</a> <em class="jxr_javadoccomment"> * escapeSql(<js>"O'Brien"</js>); <jc>// Returns: "O''Brien"</jc></em>
-<a class="jxr_linenumber" name="L1654" href="#L1654">1654</a> <em class="jxr_javadoccomment"> * escapeSql(<js>"It's a test"</js>); <jc>// Returns: "It''s a test"</jc></em>
-<a class="jxr_linenumber" name="L1655" href="#L1655">1655</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1633" href="#L1633">1633</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1634" href="#L1634">1634</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1635" href="#L1635">1635</a> <em class="jxr_javadoccomment"> * escapeRegex(<js>"file.txt"</js>); <jc>// Returns: "file\\.txt"</jc></em>
+<a class="jxr_linenumber" name="L1636" href="#L1636">1636</a> <em class="jxr_javadoccomment"> * escapeRegex(<js>"price: $10.99"</js>); <jc>// Returns: "price: \\$10\\.99"</jc></em>
+<a class="jxr_linenumber" name="L1637" href="#L1637">1637</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1638" href="#L1638">1638</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1639" href="#L1639">1639</a> <em class="jxr_javadoccomment"> * @param str The string to escape.</em>
+<a class="jxr_linenumber" name="L1640" href="#L1640">1640</a> <em class="jxr_javadoccomment"> * @return The escaped string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1641" href="#L1641">1641</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1642" href="#L1642">1642</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeRegex(String str) {
+<a class="jxr_linenumber" name="L1643" href="#L1643">1643</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1644" href="#L1644">1644</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1645" href="#L1645">1645</a> <em class="jxr_comment">// Escape regex special characters: . * + ? ^ $ { } ( ) [ ] | \</em>
+<a class="jxr_linenumber" name="L1646" href="#L1646">1646</a> <strong class="jxr_keyword">return</strong> str.replace(<span class="jxr_string">"\\"</span>, <span class="jxr_string">"\\\\"</span>).replace(<span class="jxr_string">"."</span>, <span class="jxr_string">"\\."</span>).replace(<span class="jxr_string">"*"</span>, <span class="jxr_string">"\\*"</span>).replace(<span class="jxr_string">"+"</span>, <span class="jxr_string">"\\+"</s [...]
+<a class="jxr_linenumber" name="L1647" href="#L1647">1647</a> .replace(<span class="jxr_string">"("</span>, <span class="jxr_string">"\\("</span>).replace(<span class="jxr_string">")"</span>, <span class="jxr_string">"\\)"</span>).replace(<span class="jxr_string">"["</span>, <span class="jxr_string">"\\["</span>).replace(<span class="jxr_string">"]"</span>, <span class="jxr_string">"\\]"</span>).replace(<span class="jxr_string">"|"</span>, <span class=" [...]
+<a class="jxr_linenumber" name="L1648" href="#L1648">1648</a> }
+<a class="jxr_linenumber" name="L1649" href="#L1649">1649</a>
+<a class="jxr_linenumber" name="L1650" href="#L1650">1650</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1651" href="#L1651">1651</a> <em class="jxr_javadoccomment"> * Escapes SQL string literals by doubling single quotes.</em>
+<a class="jxr_linenumber" name="L1652" href="#L1652">1652</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1653" href="#L1653">1653</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1654" href="#L1654">1654</a> <em class="jxr_javadoccomment"> * Basic SQL escaping for string literals. Escapes single quotes by doubling them.</em>
+<a class="jxr_linenumber" name="L1655" href="#L1655">1655</a> <em class="jxr_javadoccomment"> * This is a basic implementation - for production use, consider using prepared statements.</em>
<a class="jxr_linenumber" name="L1656" href="#L1656">1656</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1657" href="#L1657">1657</a> <em class="jxr_javadoccomment"> * @param str The string to escape.</em>
-<a class="jxr_linenumber" name="L1658" href="#L1658">1658</a> <em class="jxr_javadoccomment"> * @return The escaped string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1659" href="#L1659">1659</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1660" href="#L1660">1660</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeSql(String str) {
-<a class="jxr_linenumber" name="L1661" href="#L1661">1661</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1662" href="#L1662">1662</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1663" href="#L1663">1663</a> <strong class="jxr_keyword">return</strong> str.replace(<span class="jxr_string">"'"</span>, <span class="jxr_string">"''"</span>);
-<a class="jxr_linenumber" name="L1664" href="#L1664">1664</a> }
-<a class="jxr_linenumber" name="L1665" href="#L1665">1665</a>
-<a class="jxr_linenumber" name="L1666" href="#L1666">1666</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1667" href="#L1667">1667</a> <em class="jxr_javadoccomment"> * Escapes XML entities in a string.</em>
-<a class="jxr_linenumber" name="L1668" href="#L1668">1668</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1669" href="#L1669">1669</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1670" href="#L1670">1670</a> <em class="jxr_javadoccomment"> * Escapes the following characters:</em>
-<a class="jxr_linenumber" name="L1671" href="#L1671">1671</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1672" href="#L1672">1672</a> <em class="jxr_javadoccomment"> * <li><js>'&amp;'</js> → <js>"&amp;amp;"</js></li></em>
-<a class="jxr_linenumber" name="L1673" href="#L1673">1673</a> <em class="jxr_javadoccomment"> * <li><js>'&lt;'</js> → <js>"&amp;lt;"</js></li></em>
-<a class="jxr_linenumber" name="L1674" href="#L1674">1674</a> <em class="jxr_javadoccomment"> * <li><js>'&gt;'</js> → <js>"&amp;gt;"</js></li></em>
-<a class="jxr_linenumber" name="L1675" href="#L1675">1675</a> <em class="jxr_javadoccomment"> * <li><js>'"'</js> → <js>"&amp;quot;"</js></li></em>
-<a class="jxr_linenumber" name="L1676" href="#L1676">1676</a> <em class="jxr_javadoccomment"> * <li><js>'\''</js> → <js>"&amp;apos;"</js></li></em>
-<a class="jxr_linenumber" name="L1677" href="#L1677">1677</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1678" href="#L1678">1678</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1679" href="#L1679">1679</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1680" href="#L1680">1680</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1681" href="#L1681">1681</a> <em class="jxr_javadoccomment"> * escapeXml(<js>"&lt;tag attr='value'&gt;text&lt;/tag&gt;"</js>);</em>
-<a class="jxr_linenumber" name="L1682" href="#L1682">1682</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "&amp;lt;tag attr=&amp;apos;value&amp;apos;&amp;gt;text&amp;lt;/tag&amp;gt;"</jc></em>
-<a class="jxr_linenumber" name="L1683" href="#L1683">1683</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1657" href="#L1657">1657</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1658" href="#L1658">1658</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1659" href="#L1659">1659</a> <em class="jxr_javadoccomment"> * escapeSql(<js>"O'Brien"</js>); <jc>// Returns: "O''Brien"</jc></em>
+<a class="jxr_linenumber" name="L1660" href="#L1660">1660</a> <em class="jxr_javadoccomment"> * escapeSql(<js>"It's a test"</js>); <jc>// Returns: "It''s a test"</jc></em>
+<a class="jxr_linenumber" name="L1661" href="#L1661">1661</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1662" href="#L1662">1662</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1663" href="#L1663">1663</a> <em class="jxr_javadoccomment"> * @param str The string to escape.</em>
+<a class="jxr_linenumber" name="L1664" href="#L1664">1664</a> <em class="jxr_javadoccomment"> * @return The escaped string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1665" href="#L1665">1665</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1666" href="#L1666">1666</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeSql(String str) {
+<a class="jxr_linenumber" name="L1667" href="#L1667">1667</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1668" href="#L1668">1668</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1669" href="#L1669">1669</a> <strong class="jxr_keyword">return</strong> str.replace(<span class="jxr_string">"'"</span>, <span class="jxr_string">"''"</span>);
+<a class="jxr_linenumber" name="L1670" href="#L1670">1670</a> }
+<a class="jxr_linenumber" name="L1671" href="#L1671">1671</a>
+<a class="jxr_linenumber" name="L1672" href="#L1672">1672</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1673" href="#L1673">1673</a> <em class="jxr_javadoccomment"> * Escapes XML entities in a string.</em>
+<a class="jxr_linenumber" name="L1674" href="#L1674">1674</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1675" href="#L1675">1675</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1676" href="#L1676">1676</a> <em class="jxr_javadoccomment"> * Escapes the following characters:</em>
+<a class="jxr_linenumber" name="L1677" href="#L1677">1677</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1678" href="#L1678">1678</a> <em class="jxr_javadoccomment"> * <li><js>'&amp;'</js> → <js>"&amp;amp;"</js></li></em>
+<a class="jxr_linenumber" name="L1679" href="#L1679">1679</a> <em class="jxr_javadoccomment"> * <li><js>'&lt;'</js> → <js>"&amp;lt;"</js></li></em>
+<a class="jxr_linenumber" name="L1680" href="#L1680">1680</a> <em class="jxr_javadoccomment"> * <li><js>'&gt;'</js> → <js>"&amp;gt;"</js></li></em>
+<a class="jxr_linenumber" name="L1681" href="#L1681">1681</a> <em class="jxr_javadoccomment"> * <li><js>'"'</js> → <js>"&amp;quot;"</js></li></em>
+<a class="jxr_linenumber" name="L1682" href="#L1682">1682</a> <em class="jxr_javadoccomment"> * <li><js>'\''</js> → <js>"&amp;apos;"</js></li></em>
+<a class="jxr_linenumber" name="L1683" href="#L1683">1683</a> <em class="jxr_javadoccomment"> * </ul></em>
<a class="jxr_linenumber" name="L1684" href="#L1684">1684</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1685" href="#L1685">1685</a> <em class="jxr_javadoccomment"> * @param str The string to escape.</em>
-<a class="jxr_linenumber" name="L1686" href="#L1686">1686</a> <em class="jxr_javadoccomment"> * @return The escaped string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1687" href="#L1687">1687</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1688" href="#L1688">1688</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeXml(String str) {
-<a class="jxr_linenumber" name="L1689" href="#L1689">1689</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1690" href="#L1690">1690</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1691" href="#L1691">1691</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(str.length() * 2);
-<a class="jxr_linenumber" name="L1692" href="#L1692">1692</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L1693" href="#L1693">1693</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
-<a class="jxr_linenumber" name="L1694" href="#L1694">1694</a> <strong class="jxr_keyword">switch</strong> (c) {
-<a class="jxr_linenumber" name="L1695" href="#L1695">1695</a> <strong class="jxr_keyword">case</strong> '&' -> sb.append(<span class="jxr_string">"&amp;"</span>);
-<a class="jxr_linenumber" name="L1696" href="#L1696">1696</a> <strong class="jxr_keyword">case</strong> '<' -> sb.append(<span class="jxr_string">"&lt;"</span>);
-<a class="jxr_linenumber" name="L1697" href="#L1697">1697</a> <strong class="jxr_keyword">case</strong> '>' -> sb.append(<span class="jxr_string">"&gt;"</span>);
-<a class="jxr_linenumber" name="L1698" href="#L1698">1698</a> <strong class="jxr_keyword">case</strong> '"' -> sb.append(<span class="jxr_string">"&quot;"</span>);
-<a class="jxr_linenumber" name="L1699" href="#L1699">1699</a> <strong class="jxr_keyword">case</strong> '\'' -> sb.append(<span class="jxr_string">"&apos;"</span>);
-<a class="jxr_linenumber" name="L1700" href="#L1700">1700</a> <strong class="jxr_keyword">default</strong> -> sb.append(c);
-<a class="jxr_linenumber" name="L1701" href="#L1701">1701</a> }
-<a class="jxr_linenumber" name="L1702" href="#L1702">1702</a> }
-<a class="jxr_linenumber" name="L1703" href="#L1703">1703</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L1704" href="#L1704">1704</a> }
-<a class="jxr_linenumber" name="L1705" href="#L1705">1705</a>
-<a class="jxr_linenumber" name="L1706" href="#L1706">1706</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1707" href="#L1707">1707</a> <em class="jxr_javadoccomment"> * Extracts all text segments between start and end markers.</em>
-<a class="jxr_linenumber" name="L1708" href="#L1708">1708</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1709" href="#L1709">1709</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1710" href="#L1710">1710</a> <em class="jxr_javadoccomment"> * Finds all occurrences of text between the start and end markers (non-overlapping).</em>
-<a class="jxr_linenumber" name="L1711" href="#L1711">1711</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1712" href="#L1712">1712</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1713" href="#L1713">1713</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1714" href="#L1714">1714</a> <em class="jxr_javadoccomment"> * extractBetween(<js>"&lt;tag&gt;content&lt;/tag&gt;"</js>, <js>"&lt;"</js>, <js>"&gt;"</js>);</em>
-<a class="jxr_linenumber" name="L1715" href="#L1715">1715</a> <em class="jxr_javadoccomment"> * <jc>// ["tag", "/tag"]</jc></em>
-<a class="jxr_linenumber" name="L1716" href="#L1716">1716</a> <em class="jxr_javadoccomment"> * extractBetween(<js>"[one][two][three]"</js>, <js>"["</js>, <js>"]"</js>);</em>
-<a class="jxr_linenumber" name="L1717" href="#L1717">1717</a> <em class="jxr_javadoccomment"> * <jc>// ["one", "two", "three"]</jc></em>
-<a class="jxr_linenumber" name="L1718" href="#L1718">1718</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1719" href="#L1719">1719</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1720" href="#L1720">1720</a> <em class="jxr_javadoccomment"> * @param str The string to extract from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1721" href="#L1721">1721</a> <em class="jxr_javadoccomment"> * @param start The start marker. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1722" href="#L1722">1722</a> <em class="jxr_javadoccomment"> * @param end The end marker. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1723" href="#L1723">1723</a> <em class="jxr_javadoccomment"> * @return A list of text segments found between the markers, or an empty list if any parameter is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1724" href="#L1724">1724</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1725" href="#L1725">1725</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractBetween(String str, String start, String end) {
-<a class="jxr_linenumber" name="L1726" href="#L1726">1726</a> <strong class="jxr_keyword">if</strong> (isEmpty(str) || isEmpty(start) || isEmpty(end))
-<a class="jxr_linenumber" name="L1727" href="#L1727">1727</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L1728" href="#L1728">1728</a>
-<a class="jxr_linenumber" name="L1729" href="#L1729">1729</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L1730" href="#L1730">1730</a> <strong class="jxr_keyword">var</strong> startIndex = 0;
-<a class="jxr_linenumber" name="L1731" href="#L1731">1731</a> <strong class="jxr_keyword">while</strong> (<strong class="jxr_keyword">true</strong>) {
-<a class="jxr_linenumber" name="L1732" href="#L1732">1732</a> <strong class="jxr_keyword">var</strong> startPos = str.indexOf(start, startIndex);
-<a class="jxr_linenumber" name="L1733" href="#L1733">1733</a> <strong class="jxr_keyword">if</strong> (startPos == -1)
-<a class="jxr_linenumber" name="L1734" href="#L1734">1734</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L1735" href="#L1735">1735</a> <strong class="jxr_keyword">var</strong> endPos = str.indexOf(end, startPos + start.length());
-<a class="jxr_linenumber" name="L1736" href="#L1736">1736</a> <strong class="jxr_keyword">if</strong> (endPos == -1)
-<a class="jxr_linenumber" name="L1737" href="#L1737">1737</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L1738" href="#L1738">1738</a> result.add(str.substring(startPos + start.length(), endPos));
-<a class="jxr_linenumber" name="L1739" href="#L1739">1739</a> startIndex = endPos + end.length();
-<a class="jxr_linenumber" name="L1740" href="#L1740">1740</a> }
-<a class="jxr_linenumber" name="L1741" href="#L1741">1741</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L1742" href="#L1742">1742</a> }
-<a class="jxr_linenumber" name="L1743" href="#L1743">1743</a>
-<a class="jxr_linenumber" name="L1744" href="#L1744">1744</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1745" href="#L1745">1745</a> <em class="jxr_javadoccomment"> * Extracts all email addresses from a string.</em>
-<a class="jxr_linenumber" name="L1746" href="#L1746">1746</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1747" href="#L1747">1747</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1748" href="#L1748">1748</a> <em class="jxr_javadoccomment"> * Uses a basic email regex pattern to find email addresses.</em>
-<a class="jxr_linenumber" name="L1749" href="#L1749">1749</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1750" href="#L1750">1750</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1751" href="#L1751">1751</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1752" href="#L1752">1752</a> <em class="jxr_javadoccomment"> * extractEmails(<js>"Contact: user@example.com or admin@test.org"</js>);</em>
-<a class="jxr_linenumber" name="L1753" href="#L1753">1753</a> <em class="jxr_javadoccomment"> * <jc>// ["user@example.com", "admin@test.org"]</jc></em>
-<a class="jxr_linenumber" name="L1754" href="#L1754">1754</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1685" href="#L1685">1685</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1686" href="#L1686">1686</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1687" href="#L1687">1687</a> <em class="jxr_javadoccomment"> * escapeXml(<js>"&lt;tag attr='value'&gt;text&lt;/tag&gt;"</js>);</em>
+<a class="jxr_linenumber" name="L1688" href="#L1688">1688</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "&amp;lt;tag attr=&amp;apos;value&amp;apos;&amp;gt;text&amp;lt;/tag&amp;gt;"</jc></em>
+<a class="jxr_linenumber" name="L1689" href="#L1689">1689</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1690" href="#L1690">1690</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1691" href="#L1691">1691</a> <em class="jxr_javadoccomment"> * @param str The string to escape.</em>
+<a class="jxr_linenumber" name="L1692" href="#L1692">1692</a> <em class="jxr_javadoccomment"> * @return The escaped string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1693" href="#L1693">1693</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1694" href="#L1694">1694</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String escapeXml(String str) {
+<a class="jxr_linenumber" name="L1695" href="#L1695">1695</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1696" href="#L1696">1696</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1697" href="#L1697">1697</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder(str.length() * 2);
+<a class="jxr_linenumber" name="L1698" href="#L1698">1698</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L1699" href="#L1699">1699</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
+<a class="jxr_linenumber" name="L1700" href="#L1700">1700</a> <strong class="jxr_keyword">switch</strong> (c) {
+<a class="jxr_linenumber" name="L1701" href="#L1701">1701</a> <strong class="jxr_keyword">case</strong> '&' -> sb.append(<span class="jxr_string">"&amp;"</span>);
+<a class="jxr_linenumber" name="L1702" href="#L1702">1702</a> <strong class="jxr_keyword">case</strong> '<' -> sb.append(<span class="jxr_string">"&lt;"</span>);
+<a class="jxr_linenumber" name="L1703" href="#L1703">1703</a> <strong class="jxr_keyword">case</strong> '>' -> sb.append(<span class="jxr_string">"&gt;"</span>);
+<a class="jxr_linenumber" name="L1704" href="#L1704">1704</a> <strong class="jxr_keyword">case</strong> '"' -> sb.append(<span class="jxr_string">"&quot;"</span>);
+<a class="jxr_linenumber" name="L1705" href="#L1705">1705</a> <strong class="jxr_keyword">case</strong> '\'' -> sb.append(<span class="jxr_string">"&apos;"</span>);
+<a class="jxr_linenumber" name="L1706" href="#L1706">1706</a> <strong class="jxr_keyword">default</strong> -> sb.append(c);
+<a class="jxr_linenumber" name="L1707" href="#L1707">1707</a> }
+<a class="jxr_linenumber" name="L1708" href="#L1708">1708</a> }
+<a class="jxr_linenumber" name="L1709" href="#L1709">1709</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L1710" href="#L1710">1710</a> }
+<a class="jxr_linenumber" name="L1711" href="#L1711">1711</a>
+<a class="jxr_linenumber" name="L1712" href="#L1712">1712</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1713" href="#L1713">1713</a> <em class="jxr_javadoccomment"> * Extracts all text segments between start and end markers.</em>
+<a class="jxr_linenumber" name="L1714" href="#L1714">1714</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1715" href="#L1715">1715</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1716" href="#L1716">1716</a> <em class="jxr_javadoccomment"> * Finds all occurrences of text between the start and end markers (non-overlapping).</em>
+<a class="jxr_linenumber" name="L1717" href="#L1717">1717</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1718" href="#L1718">1718</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1719" href="#L1719">1719</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1720" href="#L1720">1720</a> <em class="jxr_javadoccomment"> * extractBetween(<js>"&lt;tag&gt;content&lt;/tag&gt;"</js>, <js>"&lt;"</js>, <js>"&gt;"</js>);</em>
+<a class="jxr_linenumber" name="L1721" href="#L1721">1721</a> <em class="jxr_javadoccomment"> * <jc>// ["tag", "/tag"]</jc></em>
+<a class="jxr_linenumber" name="L1722" href="#L1722">1722</a> <em class="jxr_javadoccomment"> * extractBetween(<js>"[one][two][three]"</js>, <js>"["</js>, <js>"]"</js>);</em>
+<a class="jxr_linenumber" name="L1723" href="#L1723">1723</a> <em class="jxr_javadoccomment"> * <jc>// ["one", "two", "three"]</jc></em>
+<a class="jxr_linenumber" name="L1724" href="#L1724">1724</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1725" href="#L1725">1725</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1726" href="#L1726">1726</a> <em class="jxr_javadoccomment"> * @param str The string to extract from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1727" href="#L1727">1727</a> <em class="jxr_javadoccomment"> * @param start The start marker. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1728" href="#L1728">1728</a> <em class="jxr_javadoccomment"> * @param end The end marker. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1729" href="#L1729">1729</a> <em class="jxr_javadoccomment"> * @return A list of text segments found between the markers, or an empty list if any parameter is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1730" href="#L1730">1730</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1731" href="#L1731">1731</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractBetween(String str, String start, String end) {
+<a class="jxr_linenumber" name="L1732" href="#L1732">1732</a> <strong class="jxr_keyword">if</strong> (isEmpty(str) || isEmpty(start) || isEmpty(end))
+<a class="jxr_linenumber" name="L1733" href="#L1733">1733</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L1734" href="#L1734">1734</a>
+<a class="jxr_linenumber" name="L1735" href="#L1735">1735</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L1736" href="#L1736">1736</a> <strong class="jxr_keyword">var</strong> startIndex = 0;
+<a class="jxr_linenumber" name="L1737" href="#L1737">1737</a> <strong class="jxr_keyword">while</strong> (<strong class="jxr_keyword">true</strong>) {
+<a class="jxr_linenumber" name="L1738" href="#L1738">1738</a> <strong class="jxr_keyword">var</strong> startPos = str.indexOf(start, startIndex);
+<a class="jxr_linenumber" name="L1739" href="#L1739">1739</a> <strong class="jxr_keyword">if</strong> (startPos == -1)
+<a class="jxr_linenumber" name="L1740" href="#L1740">1740</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L1741" href="#L1741">1741</a> <strong class="jxr_keyword">var</strong> endPos = str.indexOf(end, startPos + start.length());
+<a class="jxr_linenumber" name="L1742" href="#L1742">1742</a> <strong class="jxr_keyword">if</strong> (endPos == -1)
+<a class="jxr_linenumber" name="L1743" href="#L1743">1743</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L1744" href="#L1744">1744</a> result.add(str.substring(startPos + start.length(), endPos));
+<a class="jxr_linenumber" name="L1745" href="#L1745">1745</a> startIndex = endPos + end.length();
+<a class="jxr_linenumber" name="L1746" href="#L1746">1746</a> }
+<a class="jxr_linenumber" name="L1747" href="#L1747">1747</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L1748" href="#L1748">1748</a> }
+<a class="jxr_linenumber" name="L1749" href="#L1749">1749</a>
+<a class="jxr_linenumber" name="L1750" href="#L1750">1750</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1751" href="#L1751">1751</a> <em class="jxr_javadoccomment"> * Extracts all email addresses from a string.</em>
+<a class="jxr_linenumber" name="L1752" href="#L1752">1752</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1753" href="#L1753">1753</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1754" href="#L1754">1754</a> <em class="jxr_javadoccomment"> * Uses a basic email regex pattern to find email addresses.</em>
<a class="jxr_linenumber" name="L1755" href="#L1755">1755</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1756" href="#L1756">1756</a> <em class="jxr_javadoccomment"> * @param str The string to extract emails from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1757" href="#L1757">1757</a> <em class="jxr_javadoccomment"> * @return A list of email addresses found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1758" href="#L1758">1758</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1759" href="#L1759">1759</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractEmails(String str) {
-<a class="jxr_linenumber" name="L1760" href="#L1760">1760</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L1761" href="#L1761">1761</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L1762" href="#L1762">1762</a>
-<a class="jxr_linenumber" name="L1763" href="#L1763">1763</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L1764" href="#L1764">1764</a> <em class="jxr_comment">// Email regex pattern (same as isEmail but without ^ and $ anchors)</em>
-<a class="jxr_linenumber" name="L1765" href="#L1765">1765</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}"</span>);
-<a class="jxr_linenumber" name="L1766" href="#L1766">1766</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
-<a class="jxr_linenumber" name="L1767" href="#L1767">1767</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
-<a class="jxr_linenumber" name="L1768" href="#L1768">1768</a> result.add(matcher.group());
-<a class="jxr_linenumber" name="L1769" href="#L1769">1769</a> }
-<a class="jxr_linenumber" name="L1770" href="#L1770">1770</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L1771" href="#L1771">1771</a> }
-<a class="jxr_linenumber" name="L1772" href="#L1772">1772</a>
-<a class="jxr_linenumber" name="L1773" href="#L1773">1773</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1774" href="#L1774">1774</a> <em class="jxr_javadoccomment"> * Extracts all numeric sequences from a string.</em>
-<a class="jxr_linenumber" name="L1775" href="#L1775">1775</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1776" href="#L1776">1776</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1777" href="#L1777">1777</a> <em class="jxr_javadoccomment"> * Finds all sequences of digits (including decimal numbers with dots).</em>
-<a class="jxr_linenumber" name="L1778" href="#L1778">1778</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1779" href="#L1779">1779</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1780" href="#L1780">1780</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1781" href="#L1781">1781</a> <em class="jxr_javadoccomment"> * extractNumbers(<js>"Price: $19.99, Quantity: 5"</js>);</em>
-<a class="jxr_linenumber" name="L1782" href="#L1782">1782</a> <em class="jxr_javadoccomment"> * <jc>// ["19.99", "5"]</jc></em>
-<a class="jxr_linenumber" name="L1783" href="#L1783">1783</a> <em class="jxr_javadoccomment"> * extractNumbers(<js>"Version 1.2.3"</js>);</em>
-<a class="jxr_linenumber" name="L1784" href="#L1784">1784</a> <em class="jxr_javadoccomment"> * <jc>// ["1.2", "3"]</jc></em>
-<a class="jxr_linenumber" name="L1785" href="#L1785">1785</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1786" href="#L1786">1786</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1787" href="#L1787">1787</a> <em class="jxr_javadoccomment"> * @param str The string to extract numbers from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1788" href="#L1788">1788</a> <em class="jxr_javadoccomment"> * @return A list of numeric strings found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1789" href="#L1789">1789</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1790" href="#L1790">1790</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractNumbers(String str) {
-<a class="jxr_linenumber" name="L1791" href="#L1791">1791</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L1792" href="#L1792">1792</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L1793" href="#L1793">1793</a>
-<a class="jxr_linenumber" name="L1794" href="#L1794">1794</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L1795" href="#L1795">1795</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"\\d+(?:\\.\\d+)?"</span>);
-<a class="jxr_linenumber" name="L1796" href="#L1796">1796</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
-<a class="jxr_linenumber" name="L1797" href="#L1797">1797</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
-<a class="jxr_linenumber" name="L1798" href="#L1798">1798</a> result.add(matcher.group());
-<a class="jxr_linenumber" name="L1799" href="#L1799">1799</a> }
-<a class="jxr_linenumber" name="L1800" href="#L1800">1800</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L1801" href="#L1801">1801</a> }
-<a class="jxr_linenumber" name="L1802" href="#L1802">1802</a>
-<a class="jxr_linenumber" name="L1803" href="#L1803">1803</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1804" href="#L1804">1804</a> <em class="jxr_javadoccomment"> * Extracts all URLs from a string.</em>
-<a class="jxr_linenumber" name="L1805" href="#L1805">1805</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1806" href="#L1806">1806</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1807" href="#L1807">1807</a> <em class="jxr_javadoccomment"> * Uses a basic URL regex pattern to find URLs (http, https, ftp).</em>
-<a class="jxr_linenumber" name="L1808" href="#L1808">1808</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1809" href="#L1809">1809</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1810" href="#L1810">1810</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1811" href="#L1811">1811</a> <em class="jxr_javadoccomment"> * extractUrls(<js>"Visit <a href="https://example.com" target="alexandria_uri">https://example.com</a> or <a href="http://test.org" target="alexandria_uri">http://test.org</a>"</js>);</em>
-<a class="jxr_linenumber" name="L1812" href="#L1812">1812</a> <em class="jxr_javadoccomment"> * <jc>// ["<a href="https://example.com" target="alexandria_uri">https://example.com</a>", "<a href="http://test.org" target="alexandria_uri">http://test.org</a>"]</jc></em>
-<a class="jxr_linenumber" name="L1813" href="#L1813">1813</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1756" href="#L1756">1756</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1757" href="#L1757">1757</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1758" href="#L1758">1758</a> <em class="jxr_javadoccomment"> * extractEmails(<js>"Contact: user@example.com or admin@test.org"</js>);</em>
+<a class="jxr_linenumber" name="L1759" href="#L1759">1759</a> <em class="jxr_javadoccomment"> * <jc>// ["user@example.com", "admin@test.org"]</jc></em>
+<a class="jxr_linenumber" name="L1760" href="#L1760">1760</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1761" href="#L1761">1761</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1762" href="#L1762">1762</a> <em class="jxr_javadoccomment"> * @param str The string to extract emails from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1763" href="#L1763">1763</a> <em class="jxr_javadoccomment"> * @return A list of email addresses found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1764" href="#L1764">1764</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1765" href="#L1765">1765</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractEmails(String str) {
+<a class="jxr_linenumber" name="L1766" href="#L1766">1766</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L1767" href="#L1767">1767</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L1768" href="#L1768">1768</a>
+<a class="jxr_linenumber" name="L1769" href="#L1769">1769</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L1770" href="#L1770">1770</a> <em class="jxr_comment">// Email regex pattern (same as isEmail but without ^ and $ anchors)</em>
+<a class="jxr_linenumber" name="L1771" href="#L1771">1771</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}"</span>);
+<a class="jxr_linenumber" name="L1772" href="#L1772">1772</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
+<a class="jxr_linenumber" name="L1773" href="#L1773">1773</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
+<a class="jxr_linenumber" name="L1774" href="#L1774">1774</a> result.add(matcher.group());
+<a class="jxr_linenumber" name="L1775" href="#L1775">1775</a> }
+<a class="jxr_linenumber" name="L1776" href="#L1776">1776</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L1777" href="#L1777">1777</a> }
+<a class="jxr_linenumber" name="L1778" href="#L1778">1778</a>
+<a class="jxr_linenumber" name="L1779" href="#L1779">1779</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1780" href="#L1780">1780</a> <em class="jxr_javadoccomment"> * Extracts all numeric sequences from a string.</em>
+<a class="jxr_linenumber" name="L1781" href="#L1781">1781</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1782" href="#L1782">1782</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1783" href="#L1783">1783</a> <em class="jxr_javadoccomment"> * Finds all sequences of digits (including decimal numbers with dots).</em>
+<a class="jxr_linenumber" name="L1784" href="#L1784">1784</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1785" href="#L1785">1785</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1786" href="#L1786">1786</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1787" href="#L1787">1787</a> <em class="jxr_javadoccomment"> * extractNumbers(<js>"Price: $19.99, Quantity: 5"</js>);</em>
+<a class="jxr_linenumber" name="L1788" href="#L1788">1788</a> <em class="jxr_javadoccomment"> * <jc>// ["19.99", "5"]</jc></em>
+<a class="jxr_linenumber" name="L1789" href="#L1789">1789</a> <em class="jxr_javadoccomment"> * extractNumbers(<js>"Version 1.2.3"</js>);</em>
+<a class="jxr_linenumber" name="L1790" href="#L1790">1790</a> <em class="jxr_javadoccomment"> * <jc>// ["1.2", "3"]</jc></em>
+<a class="jxr_linenumber" name="L1791" href="#L1791">1791</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1792" href="#L1792">1792</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1793" href="#L1793">1793</a> <em class="jxr_javadoccomment"> * @param str The string to extract numbers from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1794" href="#L1794">1794</a> <em class="jxr_javadoccomment"> * @return A list of numeric strings found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1795" href="#L1795">1795</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1796" href="#L1796">1796</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractNumbers(String str) {
+<a class="jxr_linenumber" name="L1797" href="#L1797">1797</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L1798" href="#L1798">1798</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L1799" href="#L1799">1799</a>
+<a class="jxr_linenumber" name="L1800" href="#L1800">1800</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L1801" href="#L1801">1801</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"\\d+(?:\\.\\d+)?"</span>);
+<a class="jxr_linenumber" name="L1802" href="#L1802">1802</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
+<a class="jxr_linenumber" name="L1803" href="#L1803">1803</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
+<a class="jxr_linenumber" name="L1804" href="#L1804">1804</a> result.add(matcher.group());
+<a class="jxr_linenumber" name="L1805" href="#L1805">1805</a> }
+<a class="jxr_linenumber" name="L1806" href="#L1806">1806</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L1807" href="#L1807">1807</a> }
+<a class="jxr_linenumber" name="L1808" href="#L1808">1808</a>
+<a class="jxr_linenumber" name="L1809" href="#L1809">1809</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1810" href="#L1810">1810</a> <em class="jxr_javadoccomment"> * Extracts all URLs from a string.</em>
+<a class="jxr_linenumber" name="L1811" href="#L1811">1811</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1812" href="#L1812">1812</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1813" href="#L1813">1813</a> <em class="jxr_javadoccomment"> * Uses a basic URL regex pattern to find URLs (http, https, ftp).</em>
<a class="jxr_linenumber" name="L1814" href="#L1814">1814</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1815" href="#L1815">1815</a> <em class="jxr_javadoccomment"> * @param str The string to extract URLs from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1816" href="#L1816">1816</a> <em class="jxr_javadoccomment"> * @return A list of URLs found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1817" href="#L1817">1817</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1818" href="#L1818">1818</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractUrls(String str) {
-<a class="jxr_linenumber" name="L1819" href="#L1819">1819</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L1820" href="#L1820">1820</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L1821" href="#L1821">1821</a>
-<a class="jxr_linenumber" name="L1822" href="#L1822">1822</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L1823" href="#L1823">1823</a> <em class="jxr_comment">// Basic URL pattern: protocol://domain/path</em>
-<a class="jxr_linenumber" name="L1824" href="#L1824">1824</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"(?:https?|ftp)://[\\w\\-._~:/?#\\[\\]@!$&'()*+,;=%]+"</span>, Pattern.CASE_INSENSITIVE);
-<a class="jxr_linenumber" name="L1825" href="#L1825">1825</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
-<a class="jxr_linenumber" name="L1826" href="#L1826">1826</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
-<a class="jxr_linenumber" name="L1827" href="#L1827">1827</a> result.add(matcher.group());
-<a class="jxr_linenumber" name="L1828" href="#L1828">1828</a> }
-<a class="jxr_linenumber" name="L1829" href="#L1829">1829</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L1830" href="#L1830">1830</a> }
-<a class="jxr_linenumber" name="L1831" href="#L1831">1831</a>
-<a class="jxr_linenumber" name="L1832" href="#L1832">1832</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1833" href="#L1833">1833</a> <em class="jxr_javadoccomment"> * Extracts all words from a string.</em>
-<a class="jxr_linenumber" name="L1834" href="#L1834">1834</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1835" href="#L1835">1835</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1836" href="#L1836">1836</a> <em class="jxr_javadoccomment"> * A word is defined as a sequence of letters, digits, and underscores.</em>
-<a class="jxr_linenumber" name="L1837" href="#L1837">1837</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1838" href="#L1838">1838</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1839" href="#L1839">1839</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1840" href="#L1840">1840</a> <em class="jxr_javadoccomment"> * extractWords(<js>"Hello world! This is a test."</js>);</em>
-<a class="jxr_linenumber" name="L1841" href="#L1841">1841</a> <em class="jxr_javadoccomment"> * <jc>// ["Hello", "world", "This", "is", "a", "test"]</jc></em>
-<a class="jxr_linenumber" name="L1842" href="#L1842">1842</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1815" href="#L1815">1815</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1816" href="#L1816">1816</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1817" href="#L1817">1817</a> <em class="jxr_javadoccomment"> * extractUrls(<js>"Visit <a href="https://example.com" target="alexandria_uri">https://example.com</a> or <a href="http://test.org" target="alexandria_uri">http://test.org</a>"</js>);</em>
+<a class="jxr_linenumber" name="L1818" href="#L1818">1818</a> <em class="jxr_javadoccomment"> * <jc>// ["<a href="https://example.com" target="alexandria_uri">https://example.com</a>", "<a href="http://test.org" target="alexandria_uri">http://test.org</a>"]</jc></em>
+<a class="jxr_linenumber" name="L1819" href="#L1819">1819</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1820" href="#L1820">1820</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1821" href="#L1821">1821</a> <em class="jxr_javadoccomment"> * @param str The string to extract URLs from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1822" href="#L1822">1822</a> <em class="jxr_javadoccomment"> * @return A list of URLs found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1823" href="#L1823">1823</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1824" href="#L1824">1824</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractUrls(String str) {
+<a class="jxr_linenumber" name="L1825" href="#L1825">1825</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L1826" href="#L1826">1826</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L1827" href="#L1827">1827</a>
+<a class="jxr_linenumber" name="L1828" href="#L1828">1828</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L1829" href="#L1829">1829</a> <em class="jxr_comment">// Basic URL pattern: protocol://domain/path</em>
+<a class="jxr_linenumber" name="L1830" href="#L1830">1830</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"(?:https?|ftp)://[\\w\\-._~:/?#\\[\\]@!$&'()*+,;=%]+"</span>, Pattern.CASE_INSENSITIVE);
+<a class="jxr_linenumber" name="L1831" href="#L1831">1831</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
+<a class="jxr_linenumber" name="L1832" href="#L1832">1832</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
+<a class="jxr_linenumber" name="L1833" href="#L1833">1833</a> result.add(matcher.group());
+<a class="jxr_linenumber" name="L1834" href="#L1834">1834</a> }
+<a class="jxr_linenumber" name="L1835" href="#L1835">1835</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L1836" href="#L1836">1836</a> }
+<a class="jxr_linenumber" name="L1837" href="#L1837">1837</a>
+<a class="jxr_linenumber" name="L1838" href="#L1838">1838</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1839" href="#L1839">1839</a> <em class="jxr_javadoccomment"> * Extracts all words from a string.</em>
+<a class="jxr_linenumber" name="L1840" href="#L1840">1840</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1841" href="#L1841">1841</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1842" href="#L1842">1842</a> <em class="jxr_javadoccomment"> * A word is defined as a sequence of letters, digits, and underscores.</em>
<a class="jxr_linenumber" name="L1843" href="#L1843">1843</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1844" href="#L1844">1844</a> <em class="jxr_javadoccomment"> * @param str The string to extract words from. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1845" href="#L1845">1845</a> <em class="jxr_javadoccomment"> * @return A list of words found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1846" href="#L1846">1846</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1847" href="#L1847">1847</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractWords(String str) {
-<a class="jxr_linenumber" name="L1848" href="#L1848">1848</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L1849" href="#L1849">1849</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
-<a class="jxr_linenumber" name="L1850" href="#L1850">1850</a>
-<a class="jxr_linenumber" name="L1851" href="#L1851">1851</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L1852" href="#L1852">1852</a> <em class="jxr_comment">// Word pattern: sequence of word characters (letters, digits, underscore)</em>
-<a class="jxr_linenumber" name="L1853" href="#L1853">1853</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"\\w+"</span>);
-<a class="jxr_linenumber" name="L1854" href="#L1854">1854</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
-<a class="jxr_linenumber" name="L1855" href="#L1855">1855</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
-<a class="jxr_linenumber" name="L1856" href="#L1856">1856</a> result.add(matcher.group());
-<a class="jxr_linenumber" name="L1857" href="#L1857">1857</a> }
-<a class="jxr_linenumber" name="L1858" href="#L1858">1858</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L1859" href="#L1859">1859</a> }
-<a class="jxr_linenumber" name="L1860" href="#L1860">1860</a>
-<a class="jxr_linenumber" name="L1861" href="#L1861">1861</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1862" href="#L1862">1862</a> <em class="jxr_javadoccomment"> * Filters a string array using the specified predicate.</em>
-<a class="jxr_linenumber" name="L1863" href="#L1863">1863</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1864" href="#L1864">1864</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1865" href="#L1865">1865</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1866" href="#L1866">1866</a> <em class="jxr_javadoccomment"> * Returns an empty array if the predicate is <jk>null</jk> or no elements match.</em>
-<a class="jxr_linenumber" name="L1867" href="#L1867">1867</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1868" href="#L1868">1868</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L1869" href="#L1869">1869</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1870" href="#L1870">1870</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>""</js>, <js>"bar"</js>, <jk>null</jk>, <js>"baz"</js>};</em>
-<a class="jxr_linenumber" name="L1871" href="#L1871">1871</a> <em class="jxr_javadoccomment"> * String[] <jv>filtered</jv> = filter(<jv>array</jv>, StringUtils.<jsf>NOT_EMPTY</jsf>);</em>
-<a class="jxr_linenumber" name="L1872" href="#L1872">1872</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["foo", "bar", "baz"]</jc></em>
+<a class="jxr_linenumber" name="L1844" href="#L1844">1844</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1845" href="#L1845">1845</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1846" href="#L1846">1846</a> <em class="jxr_javadoccomment"> * extractWords(<js>"Hello world! This is a test."</js>);</em>
+<a class="jxr_linenumber" name="L1847" href="#L1847">1847</a> <em class="jxr_javadoccomment"> * <jc>// ["Hello", "world", "This", "is", "a", "test"]</jc></em>
+<a class="jxr_linenumber" name="L1848" href="#L1848">1848</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1849" href="#L1849">1849</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1850" href="#L1850">1850</a> <em class="jxr_javadoccomment"> * @param str The string to extract words from. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1851" href="#L1851">1851</a> <em class="jxr_javadoccomment"> * @return A list of words found in the input, or an empty list if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1852" href="#L1852">1852</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1853" href="#L1853">1853</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> List<String> extractWords(String str) {
+<a class="jxr_linenumber" name="L1854" href="#L1854">1854</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L1855" href="#L1855">1855</a> <strong class="jxr_keyword">return</strong> Collections.emptyList();
+<a class="jxr_linenumber" name="L1856" href="#L1856">1856</a>
+<a class="jxr_linenumber" name="L1857" href="#L1857">1857</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> ArrayList<String>();
+<a class="jxr_linenumber" name="L1858" href="#L1858">1858</a> <em class="jxr_comment">// Word pattern: sequence of word characters (letters, digits, underscore)</em>
+<a class="jxr_linenumber" name="L1859" href="#L1859">1859</a> <strong class="jxr_keyword">var</strong> pattern = Pattern.compile(<span class="jxr_string">"\\w+"</span>);
+<a class="jxr_linenumber" name="L1860" href="#L1860">1860</a> <strong class="jxr_keyword">var</strong> matcher = pattern.matcher(str);
+<a class="jxr_linenumber" name="L1861" href="#L1861">1861</a> <strong class="jxr_keyword">while</strong> (matcher.find()) {
+<a class="jxr_linenumber" name="L1862" href="#L1862">1862</a> result.add(matcher.group());
+<a class="jxr_linenumber" name="L1863" href="#L1863">1863</a> }
+<a class="jxr_linenumber" name="L1864" href="#L1864">1864</a> <strong class="jxr_keyword">return</strong> result;
+<a class="jxr_linenumber" name="L1865" href="#L1865">1865</a> }
+<a class="jxr_linenumber" name="L1866" href="#L1866">1866</a>
+<a class="jxr_linenumber" name="L1867" href="#L1867">1867</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1868" href="#L1868">1868</a> <em class="jxr_javadoccomment"> * Filters a string array using the specified predicate.</em>
+<a class="jxr_linenumber" name="L1869" href="#L1869">1869</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1870" href="#L1870">1870</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1871" href="#L1871">1871</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1872" href="#L1872">1872</a> <em class="jxr_javadoccomment"> * Returns an empty array if the predicate is <jk>null</jk> or no elements match.</em>
<a class="jxr_linenumber" name="L1873" href="#L1873">1873</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1874" href="#L1874">1874</a> <em class="jxr_javadoccomment"> * String[] <jv>longStrings</jv> = filter(<jv>array</jv>, s -&gt; s != <jk>null</jk> &amp;&amp; s.length() &gt; 3);</em>
-<a class="jxr_linenumber" name="L1875" href="#L1875">1875</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["baz"]</jc></em>
-<a class="jxr_linenumber" name="L1876" href="#L1876">1876</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1877" href="#L1877">1877</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1878" href="#L1878">1878</a> <em class="jxr_javadoccomment"> * @param array The array to filter. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1879" href="#L1879">1879</a> <em class="jxr_javadoccomment"> * @param predicate The predicate to apply to each element. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1880" href="#L1880">1880</a> <em class="jxr_javadoccomment"> * @return A new array containing only the elements that match the predicate, or <jk>null</jk> if the array was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1881" href="#L1881">1881</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1882" href="#L1882">1882</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] filter(String[] array, Predicate<String> predicate) {
-<a class="jxr_linenumber" name="L1883" href="#L1883">1883</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1884" href="#L1884">1884</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L1885" href="#L1885">1885</a> <strong class="jxr_keyword">if</strong> (predicate == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L1886" href="#L1886">1886</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[0];
-<a class="jxr_linenumber" name="L1887" href="#L1887">1887</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).filter(predicate).toArray(String[]::<strong class="jxr_keyword">new</strong>);
-<a class="jxr_linenumber" name="L1888" href="#L1888">1888</a> }
-<a class="jxr_linenumber" name="L1889" href="#L1889">1889</a>
-<a class="jxr_linenumber" name="L1890" href="#L1890">1890</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1891" href="#L1891">1891</a> <em class="jxr_javadoccomment"> * Returns the first character in the specified string.</em>
-<a class="jxr_linenumber" name="L1892" href="#L1892">1892</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1893" href="#L1893">1893</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1894" href="#L1894">1894</a> <em class="jxr_javadoccomment"> * This is a null-safe and bounds-safe operation. Returns <c>0</c> (null character) if:</em>
-<a class="jxr_linenumber" name="L1895" href="#L1895">1895</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L1896" href="#L1896">1896</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L1897" href="#L1897">1897</a> <em class="jxr_javadoccomment"> * <li>The string is empty</li></em>
-<a class="jxr_linenumber" name="L1898" href="#L1898">1898</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L1899" href="#L1899">1899</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1900" href="#L1900">1900</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1901" href="#L1901">1901</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1902" href="#L1902">1902</a> <em class="jxr_javadoccomment"> * firstChar(<js>"Hello"</js>); <jc>// 'H'</jc></em>
-<a class="jxr_linenumber" name="L1903" href="#L1903">1903</a> <em class="jxr_javadoccomment"> * firstChar(<js>"World"</js>); <jc>// 'W'</jc></em>
-<a class="jxr_linenumber" name="L1904" href="#L1904">1904</a> <em class="jxr_javadoccomment"> * firstChar(<js>""</js>); <jc>// 0 (empty string)</jc></em>
-<a class="jxr_linenumber" name="L1905" href="#L1905">1905</a> <em class="jxr_javadoccomment"> * firstChar(<jk>null</jk>); <jc>// 0 (null string)</jc></em>
-<a class="jxr_linenumber" name="L1906" href="#L1906">1906</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1907" href="#L1907">1907</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1908" href="#L1908">1908</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L1909" href="#L1909">1909</a> <em class="jxr_javadoccomment"> * @return The first character in the string, or <c>0</c> if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1910" href="#L1910">1910</a> <em class="jxr_javadoccomment"> * @see #charAt(String, int)</em>
-<a class="jxr_linenumber" name="L1911" href="#L1911">1911</a> <em class="jxr_javadoccomment"> * @see #firstNonWhitespaceChar(String)</em>
-<a class="jxr_linenumber" name="L1912" href="#L1912">1912</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1913" href="#L1913">1913</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> firstChar(String s) {
-<a class="jxr_linenumber" name="L1914" href="#L1914">1914</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty())
-<a class="jxr_linenumber" name="L1915" href="#L1915">1915</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L1916" href="#L1916">1916</a> <strong class="jxr_keyword">return</strong> s.charAt(0);
-<a class="jxr_linenumber" name="L1917" href="#L1917">1917</a> }
-<a class="jxr_linenumber" name="L1918" href="#L1918">1918</a>
-<a class="jxr_linenumber" name="L1919" href="#L1919">1919</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1920" href="#L1920">1920</a> <em class="jxr_javadoccomment"> * Returns the first non-blank string in the array.</em>
-<a class="jxr_linenumber" name="L1921" href="#L1921">1921</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1922" href="#L1922">1922</a> <em class="jxr_javadoccomment"> * @param vals The strings to check.</em>
-<a class="jxr_linenumber" name="L1923" href="#L1923">1923</a> <em class="jxr_javadoccomment"> * @return The first non-blank string, or <jk>null</jk> if all values were blank or <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L1924" href="#L1924">1924</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1925" href="#L1925">1925</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String firstNonBlank(String...vals) {
-<a class="jxr_linenumber" name="L1926" href="#L1926">1926</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : vals) {
-<a class="jxr_linenumber" name="L1927" href="#L1927">1927</a> <strong class="jxr_keyword">if</strong> (isNotBlank(v))
-<a class="jxr_linenumber" name="L1928" href="#L1928">1928</a> <strong class="jxr_keyword">return</strong> v;
-<a class="jxr_linenumber" name="L1929" href="#L1929">1929</a> }
-<a class="jxr_linenumber" name="L1930" href="#L1930">1930</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1931" href="#L1931">1931</a> }
-<a class="jxr_linenumber" name="L1932" href="#L1932">1932</a>
-<a class="jxr_linenumber" name="L1933" href="#L1933">1933</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1934" href="#L1934">1934</a> <em class="jxr_javadoccomment"> * Returns the first non-null, non-empty string in the list.</em>
-<a class="jxr_linenumber" name="L1935" href="#L1935">1935</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1936" href="#L1936">1936</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1937" href="#L1937">1937</a> <em class="jxr_javadoccomment"> * This method iterates through the provided strings and returns the first one that is not <jk>null</jk></em>
-<a class="jxr_linenumber" name="L1938" href="#L1938">1938</a> <em class="jxr_javadoccomment"> * and not empty (as determined by {@link #isNotEmpty(String)}).</em>
-<a class="jxr_linenumber" name="L1939" href="#L1939">1939</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1940" href="#L1940">1940</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1941" href="#L1941">1941</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1942" href="#L1942">1942</a> <em class="jxr_javadoccomment"> * firstNonEmpty(<jk>null</jk>, <js>""</js>, <js>"Hello"</js>, <js>"World"</js>); <jc>// "Hello"</jc></em>
-<a class="jxr_linenumber" name="L1943" href="#L1943">1943</a> <em class="jxr_javadoccomment"> * firstNonEmpty(<js>"Hello"</js>, <js>"World"</js>); <jc>// "Hello"</jc></em>
-<a class="jxr_linenumber" name="L1944" href="#L1944">1944</a> <em class="jxr_javadoccomment"> * firstNonEmpty(<jk>null</jk>, <js>""</js>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L1945" href="#L1945">1945</a> <em class="jxr_javadoccomment"> * firstNonEmpty(); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L1946" href="#L1946">1946</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1947" href="#L1947">1947</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1948" href="#L1948">1948</a> <em class="jxr_javadoccomment"> * @param s The strings to test.</em>
-<a class="jxr_linenumber" name="L1949" href="#L1949">1949</a> <em class="jxr_javadoccomment"> * @return The first non-empty string in the list, or <jk>null</jk> if they were all <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L1950" href="#L1950">1950</a> <em class="jxr_javadoccomment"> * @see #firstNonBlank(String...)</em>
-<a class="jxr_linenumber" name="L1951" href="#L1951">1951</a> <em class="jxr_javadoccomment"> * @see #isNotEmpty(String)</em>
-<a class="jxr_linenumber" name="L1952" href="#L1952">1952</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1953" href="#L1953">1953</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String firstNonEmpty(String...s) {
-<a class="jxr_linenumber" name="L1954" href="#L1954">1954</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> ss : s)
-<a class="jxr_linenumber" name="L1955" href="#L1955">1955</a> <strong class="jxr_keyword">if</strong> (isNotEmpty(ss))
-<a class="jxr_linenumber" name="L1956" href="#L1956">1956</a> <strong class="jxr_keyword">return</strong> ss;
-<a class="jxr_linenumber" name="L1957" href="#L1957">1957</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L1958" href="#L1958">1958</a> }
-<a class="jxr_linenumber" name="L1959" href="#L1959">1959</a>
-<a class="jxr_linenumber" name="L1960" href="#L1960">1960</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1961" href="#L1961">1961</a> <em class="jxr_javadoccomment"> * Returns the first non-whitespace character in the string.</em>
-<a class="jxr_linenumber" name="L1962" href="#L1962">1962</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1963" href="#L1963">1963</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1964" href="#L1964">1964</a> <em class="jxr_javadoccomment"> * This method scans the string from the beginning and returns the first character that is not</em>
-<a class="jxr_linenumber" name="L1965" href="#L1965">1965</a> <em class="jxr_javadoccomment"> * a whitespace character (as determined by {@link Character#isWhitespace(char)}).</em>
-<a class="jxr_linenumber" name="L1966" href="#L1966">1966</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1967" href="#L1967">1967</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L1968" href="#L1968">1968</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L1969" href="#L1969">1969</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<js>"Hello"</js>); <jc>// 'H'</jc></em>
-<a class="jxr_linenumber" name="L1970" href="#L1970">1970</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<js>" Hello"</js>); <jc>// 'H'</jc></em>
-<a class="jxr_linenumber" name="L1971" href="#L1971">1971</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<js>"\t\nWorld"</js>); <jc>// 'W'</jc></em>
-<a class="jxr_linenumber" name="L1972" href="#L1972">1972</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<js>" "</js>); <jc>// 0 (only whitespace)</jc></em>
-<a class="jxr_linenumber" name="L1973" href="#L1973">1973</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<jk>null</jk>); <jc>// 0 (null string)</jc></em>
-<a class="jxr_linenumber" name="L1974" href="#L1974">1974</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L1975" href="#L1975">1975</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1976" href="#L1976">1976</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L1977" href="#L1977">1977</a> <em class="jxr_javadoccomment"> * @return The first non-whitespace character, or <c>0</c> if the string is <jk>null</jk>, empty, or composed of only whitespace.</em>
-<a class="jxr_linenumber" name="L1978" href="#L1978">1978</a> <em class="jxr_javadoccomment"> * @see #firstChar(String)</em>
-<a class="jxr_linenumber" name="L1979" href="#L1979">1979</a> <em class="jxr_javadoccomment"> * @see Character#isWhitespace(char)</em>
-<a class="jxr_linenumber" name="L1980" href="#L1980">1980</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L1981" href="#L1981">1981</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> firstNonWhitespaceChar(String s) {
-<a class="jxr_linenumber" name="L1982" href="#L1982">1982</a> <strong class="jxr_keyword">if</strong> (nn(s))
-<a class="jxr_linenumber" name="L1983" href="#L1983">1983</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++)
-<a class="jxr_linenumber" name="L1984" href="#L1984">1984</a> <strong class="jxr_keyword">if</strong> (! isWhitespace(s.charAt(i)))
-<a class="jxr_linenumber" name="L1985" href="#L1985">1985</a> <strong class="jxr_keyword">return</strong> s.charAt(i);
-<a class="jxr_linenumber" name="L1986" href="#L1986">1986</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L1987" href="#L1987">1987</a> }
-<a class="jxr_linenumber" name="L1988" href="#L1988">1988</a>
-<a class="jxr_linenumber" name="L1989" href="#L1989">1989</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L1990" href="#L1990">1990</a> <em class="jxr_javadoccomment"> * URL-encodes invalid characters in a URI string.</em>
-<a class="jxr_linenumber" name="L1991" href="#L1991">1991</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1992" href="#L1992">1992</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1993" href="#L1993">1993</a> <em class="jxr_javadoccomment"> * This method escapes characters that are not valid in URIs by converting them to percent-encoded</em>
-<a class="jxr_linenumber" name="L1994" href="#L1994">1994</a> <em class="jxr_javadoccomment"> * format. Spaces are converted to <js>"+"</js> characters, and other invalid characters are</em>
-<a class="jxr_linenumber" name="L1995" href="#L1995">1995</a> <em class="jxr_javadoccomment"> * percent-encoded (e.g., <js>"hello world"</js> becomes <js>"hello+world"</js>).</em>
-<a class="jxr_linenumber" name="L1996" href="#L1996">1996</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L1997" href="#L1997">1997</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L1998" href="#L1998">1998</a> <em class="jxr_javadoccomment"> * Only ASCII characters (0-127) that are not in the valid URI character set are encoded.</em>
-<a class="jxr_linenumber" name="L1999" href="#L1999">1999</a> <em class="jxr_javadoccomment"> * If the string contains no invalid characters, the original string is returned.</em>
-<a class="jxr_linenumber" name="L2000" href="#L2000">2000</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2001" href="#L2001">2001</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2002" href="#L2002">2002</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2003" href="#L2003">2003</a> <em class="jxr_javadoccomment"> * fixUrl(<js>"hello world"</js>); <jc>// "hello+world"</jc></em>
-<a class="jxr_linenumber" name="L2004" href="#L2004">2004</a> <em class="jxr_javadoccomment"> * fixUrl(<js>"file://path/to file.txt"</js>); <jc>// "file://path/to+file.txt"</jc></em>
-<a class="jxr_linenumber" name="L2005" href="#L2005">2005</a> <em class="jxr_javadoccomment"> * fixUrl(<js>"valid-url"</js>); <jc>// "valid-url" (no change)</jc></em>
-<a class="jxr_linenumber" name="L2006" href="#L2006">2006</a> <em class="jxr_javadoccomment"> * fixUrl(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L2007" href="#L2007">2007</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2008" href="#L2008">2008</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2009" href="#L2009">2009</a> <em class="jxr_javadoccomment"> * @param in The URI string to encode. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2010" href="#L2010">2010</a> <em class="jxr_javadoccomment"> * @return The URI with invalid characters encoded, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2011" href="#L2011">2011</a> <em class="jxr_javadoccomment"> * @see #urlEncode(String)</em>
-<a class="jxr_linenumber" name="L2012" href="#L2012">2012</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2013" href="#L2013">2013</a> @SuppressWarnings(<span class="jxr_string">"null"</span>)
-<a class="jxr_linenumber" name="L2014" href="#L2014">2014</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String fixUrl(String in) {
-<a class="jxr_linenumber" name="L2015" href="#L2015">2015</a>
-<a class="jxr_linenumber" name="L2016" href="#L2016">2016</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2017" href="#L2017">2017</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L2018" href="#L2018">2018</a>
-<a class="jxr_linenumber" name="L2019" href="#L2019">2019</a> <strong class="jxr_keyword">var</strong> sb = (StringBuilder)<strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L2020" href="#L2020">2020</a>
-<a class="jxr_linenumber" name="L2021" href="#L2021">2021</a> <strong class="jxr_keyword">var</strong> m = 0;
-<a class="jxr_linenumber" name="L2022" href="#L2022">2022</a>
-<a class="jxr_linenumber" name="L2023" href="#L2023">2023</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < in.length(); i++) {
-<a class="jxr_linenumber" name="L2024" href="#L2024">2024</a> <strong class="jxr_keyword">var</strong> c = in.charAt(i);
-<a class="jxr_linenumber" name="L2025" href="#L2025">2025</a> <strong class="jxr_keyword">if</strong> (c <= 127 && ! URI_CHARS.contains(c)) {
-<a class="jxr_linenumber" name="L2026" href="#L2026">2026</a> sb = append(sb, in.substring(m, i));
-<a class="jxr_linenumber" name="L2027" href="#L2027">2027</a> <strong class="jxr_keyword">if</strong> (c == ' ')
-<a class="jxr_linenumber" name="L2028" href="#L2028">2028</a> sb.append(<span class="jxr_string">"+"</span>);
-<a class="jxr_linenumber" name="L2029" href="#L2029">2029</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2030" href="#L2030">2030</a> sb.append('%').append(toHex2(c));
-<a class="jxr_linenumber" name="L2031" href="#L2031">2031</a> m = i + 1;
-<a class="jxr_linenumber" name="L2032" href="#L2032">2032</a> }
-<a class="jxr_linenumber" name="L2033" href="#L2033">2033</a> }
-<a class="jxr_linenumber" name="L2034" href="#L2034">2034</a> <strong class="jxr_keyword">if</strong> (nn(sb)) {
-<a class="jxr_linenumber" name="L2035" href="#L2035">2035</a> sb.append(in.substring(m));
-<a class="jxr_linenumber" name="L2036" href="#L2036">2036</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L2037" href="#L2037">2037</a> }
-<a class="jxr_linenumber" name="L2038" href="#L2038">2038</a> <strong class="jxr_keyword">return</strong> in;
-<a class="jxr_linenumber" name="L2039" href="#L2039">2039</a>
-<a class="jxr_linenumber" name="L2040" href="#L2040">2040</a> }
-<a class="jxr_linenumber" name="L2041" href="#L2041">2041</a>
-<a class="jxr_linenumber" name="L2042" href="#L2042">2042</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2043" href="#L2043">2043</a> <em class="jxr_javadoccomment"> * Formats a string using printf-style and/or MessageFormat-style format specifiers.</em>
-<a class="jxr_linenumber" name="L2044" href="#L2044">2044</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2045" href="#L2045">2045</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2046" href="#L2046">2046</a> <em class="jxr_javadoccomment"> * This method provides unified string formatting that supports both printf-style formatting</em>
-<a class="jxr_linenumber" name="L2047" href="#L2047">2047</a> <em class="jxr_javadoccomment"> * (similar to C's <c>printf()</c> function and Java's {@link String#format(String, Object...)})</em>
-<a class="jxr_linenumber" name="L2048" href="#L2048">2048</a> <em class="jxr_javadoccomment"> * and MessageFormat-style formatting in the same pattern.</em>
-<a class="jxr_linenumber" name="L2049" href="#L2049">2049</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2050" href="#L2050">2050</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Format Support:</h5></em>
-<a class="jxr_linenumber" name="L2051" href="#L2051">2051</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L2052" href="#L2052">2052</a> <em class="jxr_javadoccomment"> * <li><b>Printf-style:</b> <js>"%s"</js>, <js>"%d"</js>, <js>"%.2f"</js>, <js>"%1$s"</js>, etc.</li></em>
-<a class="jxr_linenumber" name="L2053" href="#L2053">2053</a> <em class="jxr_javadoccomment"> * <li><b>MessageFormat-style:</b> <js>"{0}"</js>, <js>"{1,number}"</js>, <js>"{2,date}"</js>, etc.</li></em>
-<a class="jxr_linenumber" name="L2054" href="#L2054">2054</a> <em class="jxr_javadoccomment"> * <li><b>Un-numbered MessageFormat:</b> <js>"{}"</js> - Sequential placeholders that are automatically numbered</li></em>
-<a class="jxr_linenumber" name="L2055" href="#L2055">2055</a> <em class="jxr_javadoccomment"> * <li><b>Mixed formats:</b> Both styles can be used in the same pattern</li></em>
-<a class="jxr_linenumber" name="L2056" href="#L2056">2056</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L2057" href="#L2057">2057</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2058" href="#L2058">2058</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Printf Format Specifiers:</h5></em>
-<a class="jxr_linenumber" name="L2059" href="#L2059">2059</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L2060" href="#L2060">2060</a> <em class="jxr_javadoccomment"> * <li><b>%s</b> - String</li></em>
-<a class="jxr_linenumber" name="L2061" href="#L2061">2061</a> <em class="jxr_javadoccomment"> * <li><b>%d</b> - Decimal integer</li></em>
-<a class="jxr_linenumber" name="L2062" href="#L2062">2062</a> <em class="jxr_javadoccomment"> * <li><b>%f</b> - Floating point</li></em>
-<a class="jxr_linenumber" name="L2063" href="#L2063">2063</a> <em class="jxr_javadoccomment"> * <li><b>%x</b> - Hexadecimal (lowercase)</li></em>
-<a class="jxr_linenumber" name="L2064" href="#L2064">2064</a> <em class="jxr_javadoccomment"> * <li><b>%X</b> - Hexadecimal (uppercase)</li></em>
-<a class="jxr_linenumber" name="L2065" href="#L2065">2065</a> <em class="jxr_javadoccomment"> * <li><b>%o</b> - Octal</li></em>
-<a class="jxr_linenumber" name="L2066" href="#L2066">2066</a> <em class="jxr_javadoccomment"> * <li><b>%b</b> - Boolean</li></em>
-<a class="jxr_linenumber" name="L2067" href="#L2067">2067</a> <em class="jxr_javadoccomment"> * <li><b>%c</b> - Character</li></em>
-<a class="jxr_linenumber" name="L2068" href="#L2068">2068</a> <em class="jxr_javadoccomment"> * <li><b>%e</b> - Scientific notation (lowercase)</li></em>
-<a class="jxr_linenumber" name="L2069" href="#L2069">2069</a> <em class="jxr_javadoccomment"> * <li><b>%E</b> - Scientific notation (uppercase)</li></em>
-<a class="jxr_linenumber" name="L2070" href="#L2070">2070</a> <em class="jxr_javadoccomment"> * <li><b>%g</b> - General format (lowercase)</li></em>
-<a class="jxr_linenumber" name="L2071" href="#L2071">2071</a> <em class="jxr_javadoccomment"> * <li><b>%G</b> - General format (uppercase)</li></em>
-<a class="jxr_linenumber" name="L2072" href="#L2072">2072</a> <em class="jxr_javadoccomment"> * <li><b>%n</b> - Platform-specific line separator</li></em>
-<a class="jxr_linenumber" name="L2073" href="#L2073">2073</a> <em class="jxr_javadoccomment"> * <li><b>%%</b> - Literal percent sign</li></em>
-<a class="jxr_linenumber" name="L2074" href="#L2074">2074</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L2075" href="#L2075">2075</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2076" href="#L2076">2076</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Format Specifier Syntax:</h5></em>
-<a class="jxr_linenumber" name="L2077" href="#L2077">2077</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2078" href="#L2078">2078</a> <em class="jxr_javadoccomment"> * Printf format specifiers follow this pattern: <c>%[argument_index$][flags][width][.precision]conversion</c></em>
-<a class="jxr_linenumber" name="L2079" href="#L2079">2079</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2080" href="#L2080">2080</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2081" href="#L2081">2081</a> <em class="jxr_javadoccomment"> * MessageFormat placeholders follow this pattern: <c>{argument_index[,format_type[,format_style]]}</c></em>
-<a class="jxr_linenumber" name="L2082" href="#L2082">2082</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2083" href="#L2083">2083</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2084" href="#L2084">2084</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L2085" href="#L2085">2085</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2086" href="#L2086">2086</a> <em class="jxr_javadoccomment"> * <jc>// Printf-style formatting</jc></em>
-<a class="jxr_linenumber" name="L2087" href="#L2087">2087</a> <em class="jxr_javadoccomment"> * format(<js>"Hello %s, you have %d items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L2088" href="#L2088">2088</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
+<a class="jxr_linenumber" name="L1874" href="#L1874">1874</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L1875" href="#L1875">1875</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1876" href="#L1876">1876</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>""</js>, <js>"bar"</js>, <jk>null</jk>, <js>"baz"</js>};</em>
+<a class="jxr_linenumber" name="L1877" href="#L1877">1877</a> <em class="jxr_javadoccomment"> * String[] <jv>filtered</jv> = filter(<jv>array</jv>, StringUtils.<jsf>NOT_EMPTY</jsf>);</em>
+<a class="jxr_linenumber" name="L1878" href="#L1878">1878</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["foo", "bar", "baz"]</jc></em>
+<a class="jxr_linenumber" name="L1879" href="#L1879">1879</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1880" href="#L1880">1880</a> <em class="jxr_javadoccomment"> * String[] <jv>longStrings</jv> = filter(<jv>array</jv>, s -&gt; s != <jk>null</jk> &amp;&amp; s.length() &gt; 3);</em>
+<a class="jxr_linenumber" name="L1881" href="#L1881">1881</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["baz"]</jc></em>
+<a class="jxr_linenumber" name="L1882" href="#L1882">1882</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1883" href="#L1883">1883</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1884" href="#L1884">1884</a> <em class="jxr_javadoccomment"> * @param array The array to filter. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1885" href="#L1885">1885</a> <em class="jxr_javadoccomment"> * @param predicate The predicate to apply to each element. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1886" href="#L1886">1886</a> <em class="jxr_javadoccomment"> * @return A new array containing only the elements that match the predicate, or <jk>null</jk> if the array was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1887" href="#L1887">1887</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1888" href="#L1888">1888</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] filter(String[] array, Predicate<String> predicate) {
+<a class="jxr_linenumber" name="L1889" href="#L1889">1889</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1890" href="#L1890">1890</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L1891" href="#L1891">1891</a> <strong class="jxr_keyword">if</strong> (predicate == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L1892" href="#L1892">1892</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> String[0];
+<a class="jxr_linenumber" name="L1893" href="#L1893">1893</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).filter(predicate).toArray(String[]::<strong class="jxr_keyword">new</strong>);
+<a class="jxr_linenumber" name="L1894" href="#L1894">1894</a> }
+<a class="jxr_linenumber" name="L1895" href="#L1895">1895</a>
+<a class="jxr_linenumber" name="L1896" href="#L1896">1896</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1897" href="#L1897">1897</a> <em class="jxr_javadoccomment"> * Returns the first character in the specified string.</em>
+<a class="jxr_linenumber" name="L1898" href="#L1898">1898</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1899" href="#L1899">1899</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1900" href="#L1900">1900</a> <em class="jxr_javadoccomment"> * This is a null-safe and bounds-safe operation. Returns <c>0</c> (null character) if:</em>
+<a class="jxr_linenumber" name="L1901" href="#L1901">1901</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L1902" href="#L1902">1902</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
+<a class="jxr_linenumber" name="L1903" href="#L1903">1903</a> <em class="jxr_javadoccomment"> * <li>The string is empty</li></em>
+<a class="jxr_linenumber" name="L1904" href="#L1904">1904</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L1905" href="#L1905">1905</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1906" href="#L1906">1906</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1907" href="#L1907">1907</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1908" href="#L1908">1908</a> <em class="jxr_javadoccomment"> * firstChar(<js>"Hello"</js>); <jc>// 'H'</jc></em>
+<a class="jxr_linenumber" name="L1909" href="#L1909">1909</a> <em class="jxr_javadoccomment"> * firstChar(<js>"World"</js>); <jc>// 'W'</jc></em>
+<a class="jxr_linenumber" name="L1910" href="#L1910">1910</a> <em class="jxr_javadoccomment"> * firstChar(<js>""</js>); <jc>// 0 (empty string)</jc></em>
+<a class="jxr_linenumber" name="L1911" href="#L1911">1911</a> <em class="jxr_javadoccomment"> * firstChar(<jk>null</jk>); <jc>// 0 (null string)</jc></em>
+<a class="jxr_linenumber" name="L1912" href="#L1912">1912</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1913" href="#L1913">1913</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1914" href="#L1914">1914</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L1915" href="#L1915">1915</a> <em class="jxr_javadoccomment"> * @return The first character in the string, or <c>0</c> if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1916" href="#L1916">1916</a> <em class="jxr_javadoccomment"> * @see #charAt(String, int)</em>
+<a class="jxr_linenumber" name="L1917" href="#L1917">1917</a> <em class="jxr_javadoccomment"> * @see #firstNonWhitespaceChar(String)</em>
+<a class="jxr_linenumber" name="L1918" href="#L1918">1918</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1919" href="#L1919">1919</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> firstChar(String s) {
+<a class="jxr_linenumber" name="L1920" href="#L1920">1920</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty())
+<a class="jxr_linenumber" name="L1921" href="#L1921">1921</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L1922" href="#L1922">1922</a> <strong class="jxr_keyword">return</strong> s.charAt(0);
+<a class="jxr_linenumber" name="L1923" href="#L1923">1923</a> }
+<a class="jxr_linenumber" name="L1924" href="#L1924">1924</a>
+<a class="jxr_linenumber" name="L1925" href="#L1925">1925</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1926" href="#L1926">1926</a> <em class="jxr_javadoccomment"> * Returns the first non-blank string in the array.</em>
+<a class="jxr_linenumber" name="L1927" href="#L1927">1927</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1928" href="#L1928">1928</a> <em class="jxr_javadoccomment"> * @param vals The strings to check.</em>
+<a class="jxr_linenumber" name="L1929" href="#L1929">1929</a> <em class="jxr_javadoccomment"> * @return The first non-blank string, or <jk>null</jk> if all values were blank or <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L1930" href="#L1930">1930</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1931" href="#L1931">1931</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String firstNonBlank(String...vals) {
+<a class="jxr_linenumber" name="L1932" href="#L1932">1932</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> v : vals) {
+<a class="jxr_linenumber" name="L1933" href="#L1933">1933</a> <strong class="jxr_keyword">if</strong> (isNotBlank(v))
+<a class="jxr_linenumber" name="L1934" href="#L1934">1934</a> <strong class="jxr_keyword">return</strong> v;
+<a class="jxr_linenumber" name="L1935" href="#L1935">1935</a> }
+<a class="jxr_linenumber" name="L1936" href="#L1936">1936</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1937" href="#L1937">1937</a> }
+<a class="jxr_linenumber" name="L1938" href="#L1938">1938</a>
+<a class="jxr_linenumber" name="L1939" href="#L1939">1939</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1940" href="#L1940">1940</a> <em class="jxr_javadoccomment"> * Returns the first non-null, non-empty string in the list.</em>
+<a class="jxr_linenumber" name="L1941" href="#L1941">1941</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1942" href="#L1942">1942</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1943" href="#L1943">1943</a> <em class="jxr_javadoccomment"> * This method iterates through the provided strings and returns the first one that is not <jk>null</jk></em>
+<a class="jxr_linenumber" name="L1944" href="#L1944">1944</a> <em class="jxr_javadoccomment"> * and not empty (as determined by {@link #isNotEmpty(String)}).</em>
+<a class="jxr_linenumber" name="L1945" href="#L1945">1945</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1946" href="#L1946">1946</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1947" href="#L1947">1947</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1948" href="#L1948">1948</a> <em class="jxr_javadoccomment"> * firstNonEmpty(<jk>null</jk>, <js>""</js>, <js>"Hello"</js>, <js>"World"</js>); <jc>// "Hello"</jc></em>
+<a class="jxr_linenumber" name="L1949" href="#L1949">1949</a> <em class="jxr_javadoccomment"> * firstNonEmpty(<js>"Hello"</js>, <js>"World"</js>); <jc>// "Hello"</jc></em>
+<a class="jxr_linenumber" name="L1950" href="#L1950">1950</a> <em class="jxr_javadoccomment"> * firstNonEmpty(<jk>null</jk>, <js>""</js>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L1951" href="#L1951">1951</a> <em class="jxr_javadoccomment"> * firstNonEmpty(); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L1952" href="#L1952">1952</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1953" href="#L1953">1953</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1954" href="#L1954">1954</a> <em class="jxr_javadoccomment"> * @param s The strings to test.</em>
+<a class="jxr_linenumber" name="L1955" href="#L1955">1955</a> <em class="jxr_javadoccomment"> * @return The first non-empty string in the list, or <jk>null</jk> if they were all <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L1956" href="#L1956">1956</a> <em class="jxr_javadoccomment"> * @see #firstNonBlank(String...)</em>
+<a class="jxr_linenumber" name="L1957" href="#L1957">1957</a> <em class="jxr_javadoccomment"> * @see #isNotEmpty(String)</em>
+<a class="jxr_linenumber" name="L1958" href="#L1958">1958</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1959" href="#L1959">1959</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String firstNonEmpty(String...s) {
+<a class="jxr_linenumber" name="L1960" href="#L1960">1960</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> ss : s)
+<a class="jxr_linenumber" name="L1961" href="#L1961">1961</a> <strong class="jxr_keyword">if</strong> (isNotEmpty(ss))
+<a class="jxr_linenumber" name="L1962" href="#L1962">1962</a> <strong class="jxr_keyword">return</strong> ss;
+<a class="jxr_linenumber" name="L1963" href="#L1963">1963</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L1964" href="#L1964">1964</a> }
+<a class="jxr_linenumber" name="L1965" href="#L1965">1965</a>
+<a class="jxr_linenumber" name="L1966" href="#L1966">1966</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1967" href="#L1967">1967</a> <em class="jxr_javadoccomment"> * Returns the first non-whitespace character in the string.</em>
+<a class="jxr_linenumber" name="L1968" href="#L1968">1968</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1969" href="#L1969">1969</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1970" href="#L1970">1970</a> <em class="jxr_javadoccomment"> * This method scans the string from the beginning and returns the first character that is not</em>
+<a class="jxr_linenumber" name="L1971" href="#L1971">1971</a> <em class="jxr_javadoccomment"> * a whitespace character (as determined by {@link Character#isWhitespace(char)}).</em>
+<a class="jxr_linenumber" name="L1972" href="#L1972">1972</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1973" href="#L1973">1973</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L1974" href="#L1974">1974</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L1975" href="#L1975">1975</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<js>"Hello"</js>); <jc>// 'H'</jc></em>
+<a class="jxr_linenumber" name="L1976" href="#L1976">1976</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<js>" Hello"</js>); <jc>// 'H'</jc></em>
+<a class="jxr_linenumber" name="L1977" href="#L1977">1977</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<js>"\t\nWorld"</js>); <jc>// 'W'</jc></em>
+<a class="jxr_linenumber" name="L1978" href="#L1978">1978</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<js>" "</js>); <jc>// 0 (only whitespace)</jc></em>
+<a class="jxr_linenumber" name="L1979" href="#L1979">1979</a> <em class="jxr_javadoccomment"> * firstNonWhitespaceChar(<jk>null</jk>); <jc>// 0 (null string)</jc></em>
+<a class="jxr_linenumber" name="L1980" href="#L1980">1980</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L1981" href="#L1981">1981</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1982" href="#L1982">1982</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L1983" href="#L1983">1983</a> <em class="jxr_javadoccomment"> * @return The first non-whitespace character, or <c>0</c> if the string is <jk>null</jk>, empty, or composed of only whitespace.</em>
+<a class="jxr_linenumber" name="L1984" href="#L1984">1984</a> <em class="jxr_javadoccomment"> * @see #firstChar(String)</em>
+<a class="jxr_linenumber" name="L1985" href="#L1985">1985</a> <em class="jxr_javadoccomment"> * @see Character#isWhitespace(char)</em>
+<a class="jxr_linenumber" name="L1986" href="#L1986">1986</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L1987" href="#L1987">1987</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> firstNonWhitespaceChar(String s) {
+<a class="jxr_linenumber" name="L1988" href="#L1988">1988</a> <strong class="jxr_keyword">if</strong> (nn(s))
+<a class="jxr_linenumber" name="L1989" href="#L1989">1989</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++)
+<a class="jxr_linenumber" name="L1990" href="#L1990">1990</a> <strong class="jxr_keyword">if</strong> (! isWhitespace(s.charAt(i)))
+<a class="jxr_linenumber" name="L1991" href="#L1991">1991</a> <strong class="jxr_keyword">return</strong> s.charAt(i);
+<a class="jxr_linenumber" name="L1992" href="#L1992">1992</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L1993" href="#L1993">1993</a> }
+<a class="jxr_linenumber" name="L1994" href="#L1994">1994</a>
+<a class="jxr_linenumber" name="L1995" href="#L1995">1995</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L1996" href="#L1996">1996</a> <em class="jxr_javadoccomment"> * URL-encodes invalid characters in a URI string.</em>
+<a class="jxr_linenumber" name="L1997" href="#L1997">1997</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L1998" href="#L1998">1998</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L1999" href="#L1999">1999</a> <em class="jxr_javadoccomment"> * This method escapes characters that are not valid in URIs by converting them to percent-encoded</em>
+<a class="jxr_linenumber" name="L2000" href="#L2000">2000</a> <em class="jxr_javadoccomment"> * format. Spaces are converted to <js>"+"</js> characters, and other invalid characters are</em>
+<a class="jxr_linenumber" name="L2001" href="#L2001">2001</a> <em class="jxr_javadoccomment"> * percent-encoded (e.g., <js>"hello world"</js> becomes <js>"hello+world"</js>).</em>
+<a class="jxr_linenumber" name="L2002" href="#L2002">2002</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2003" href="#L2003">2003</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2004" href="#L2004">2004</a> <em class="jxr_javadoccomment"> * Only ASCII characters (0-127) that are not in the valid URI character set are encoded.</em>
+<a class="jxr_linenumber" name="L2005" href="#L2005">2005</a> <em class="jxr_javadoccomment"> * If the string contains no invalid characters, the original string is returned.</em>
+<a class="jxr_linenumber" name="L2006" href="#L2006">2006</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2007" href="#L2007">2007</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2008" href="#L2008">2008</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2009" href="#L2009">2009</a> <em class="jxr_javadoccomment"> * fixUrl(<js>"hello world"</js>); <jc>// "hello+world"</jc></em>
+<a class="jxr_linenumber" name="L2010" href="#L2010">2010</a> <em class="jxr_javadoccomment"> * fixUrl(<js>"file://path/to file.txt"</js>); <jc>// "file://path/to+file.txt"</jc></em>
+<a class="jxr_linenumber" name="L2011" href="#L2011">2011</a> <em class="jxr_javadoccomment"> * fixUrl(<js>"valid-url"</js>); <jc>// "valid-url" (no change)</jc></em>
+<a class="jxr_linenumber" name="L2012" href="#L2012">2012</a> <em class="jxr_javadoccomment"> * fixUrl(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L2013" href="#L2013">2013</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2014" href="#L2014">2014</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2015" href="#L2015">2015</a> <em class="jxr_javadoccomment"> * @param in The URI string to encode. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2016" href="#L2016">2016</a> <em class="jxr_javadoccomment"> * @return The URI with invalid characters encoded, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2017" href="#L2017">2017</a> <em class="jxr_javadoccomment"> * @see #urlEncode(String)</em>
+<a class="jxr_linenumber" name="L2018" href="#L2018">2018</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2019" href="#L2019">2019</a> @SuppressWarnings(<span class="jxr_string">"null"</span>)
+<a class="jxr_linenumber" name="L2020" href="#L2020">2020</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String fixUrl(String in) {
+<a class="jxr_linenumber" name="L2021" href="#L2021">2021</a>
+<a class="jxr_linenumber" name="L2022" href="#L2022">2022</a> <strong class="jxr_keyword">if</strong> (in == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2023" href="#L2023">2023</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L2024" href="#L2024">2024</a>
+<a class="jxr_linenumber" name="L2025" href="#L2025">2025</a> <strong class="jxr_keyword">var</strong> sb = (StringBuilder)<strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L2026" href="#L2026">2026</a>
+<a class="jxr_linenumber" name="L2027" href="#L2027">2027</a> <strong class="jxr_keyword">var</strong> m = 0;
+<a class="jxr_linenumber" name="L2028" href="#L2028">2028</a>
+<a class="jxr_linenumber" name="L2029" href="#L2029">2029</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < in.length(); i++) {
+<a class="jxr_linenumber" name="L2030" href="#L2030">2030</a> <strong class="jxr_keyword">var</strong> c = in.charAt(i);
+<a class="jxr_linenumber" name="L2031" href="#L2031">2031</a> <strong class="jxr_keyword">if</strong> (c <= 127 && ! URI_CHARS.contains(c)) {
+<a class="jxr_linenumber" name="L2032" href="#L2032">2032</a> sb = append(sb, in.substring(m, i));
+<a class="jxr_linenumber" name="L2033" href="#L2033">2033</a> <strong class="jxr_keyword">if</strong> (c == ' ')
+<a class="jxr_linenumber" name="L2034" href="#L2034">2034</a> sb.append(<span class="jxr_string">"+"</span>);
+<a class="jxr_linenumber" name="L2035" href="#L2035">2035</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2036" href="#L2036">2036</a> sb.append('%').append(toHex2(c));
+<a class="jxr_linenumber" name="L2037" href="#L2037">2037</a> m = i + 1;
+<a class="jxr_linenumber" name="L2038" href="#L2038">2038</a> }
+<a class="jxr_linenumber" name="L2039" href="#L2039">2039</a> }
+<a class="jxr_linenumber" name="L2040" href="#L2040">2040</a> <strong class="jxr_keyword">if</strong> (nn(sb)) {
+<a class="jxr_linenumber" name="L2041" href="#L2041">2041</a> sb.append(in.substring(m));
+<a class="jxr_linenumber" name="L2042" href="#L2042">2042</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L2043" href="#L2043">2043</a> }
+<a class="jxr_linenumber" name="L2044" href="#L2044">2044</a> <strong class="jxr_keyword">return</strong> in;
+<a class="jxr_linenumber" name="L2045" href="#L2045">2045</a>
+<a class="jxr_linenumber" name="L2046" href="#L2046">2046</a> }
+<a class="jxr_linenumber" name="L2047" href="#L2047">2047</a>
+<a class="jxr_linenumber" name="L2048" href="#L2048">2048</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2049" href="#L2049">2049</a> <em class="jxr_javadoccomment"> * Formats a string using printf-style and/or MessageFormat-style format specifiers.</em>
+<a class="jxr_linenumber" name="L2050" href="#L2050">2050</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2051" href="#L2051">2051</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2052" href="#L2052">2052</a> <em class="jxr_javadoccomment"> * This method provides unified string formatting that supports both printf-style formatting</em>
+<a class="jxr_linenumber" name="L2053" href="#L2053">2053</a> <em class="jxr_javadoccomment"> * (similar to C's <c>printf()</c> function and Java's {@link String#format(String, Object...)})</em>
+<a class="jxr_linenumber" name="L2054" href="#L2054">2054</a> <em class="jxr_javadoccomment"> * and MessageFormat-style formatting in the same pattern.</em>
+<a class="jxr_linenumber" name="L2055" href="#L2055">2055</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2056" href="#L2056">2056</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Format Support:</h5></em>
+<a class="jxr_linenumber" name="L2057" href="#L2057">2057</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L2058" href="#L2058">2058</a> <em class="jxr_javadoccomment"> * <li><b>Printf-style:</b> <js>"%s"</js>, <js>"%d"</js>, <js>"%.2f"</js>, <js>"%1$s"</js>, etc.</li></em>
+<a class="jxr_linenumber" name="L2059" href="#L2059">2059</a> <em class="jxr_javadoccomment"> * <li><b>MessageFormat-style:</b> <js>"{0}"</js>, <js>"{1,number}"</js>, <js>"{2,date}"</js>, etc.</li></em>
+<a class="jxr_linenumber" name="L2060" href="#L2060">2060</a> <em class="jxr_javadoccomment"> * <li><b>Un-numbered MessageFormat:</b> <js>"{}"</js> - Sequential placeholders that are automatically numbered</li></em>
+<a class="jxr_linenumber" name="L2061" href="#L2061">2061</a> <em class="jxr_javadoccomment"> * <li><b>Mixed formats:</b> Both styles can be used in the same pattern</li></em>
+<a class="jxr_linenumber" name="L2062" href="#L2062">2062</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L2063" href="#L2063">2063</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2064" href="#L2064">2064</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Printf Format Specifiers:</h5></em>
+<a class="jxr_linenumber" name="L2065" href="#L2065">2065</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L2066" href="#L2066">2066</a> <em class="jxr_javadoccomment"> * <li><b>%s</b> - String</li></em>
+<a class="jxr_linenumber" name="L2067" href="#L2067">2067</a> <em class="jxr_javadoccomment"> * <li><b>%d</b> - Decimal integer</li></em>
+<a class="jxr_linenumber" name="L2068" href="#L2068">2068</a> <em class="jxr_javadoccomment"> * <li><b>%f</b> - Floating point</li></em>
+<a class="jxr_linenumber" name="L2069" href="#L2069">2069</a> <em class="jxr_javadoccomment"> * <li><b>%x</b> - Hexadecimal (lowercase)</li></em>
+<a class="jxr_linenumber" name="L2070" href="#L2070">2070</a> <em class="jxr_javadoccomment"> * <li><b>%X</b> - Hexadecimal (uppercase)</li></em>
+<a class="jxr_linenumber" name="L2071" href="#L2071">2071</a> <em class="jxr_javadoccomment"> * <li><b>%o</b> - Octal</li></em>
+<a class="jxr_linenumber" name="L2072" href="#L2072">2072</a> <em class="jxr_javadoccomment"> * <li><b>%b</b> - Boolean</li></em>
+<a class="jxr_linenumber" name="L2073" href="#L2073">2073</a> <em class="jxr_javadoccomment"> * <li><b>%c</b> - Character</li></em>
+<a class="jxr_linenumber" name="L2074" href="#L2074">2074</a> <em class="jxr_javadoccomment"> * <li><b>%e</b> - Scientific notation (lowercase)</li></em>
+<a class="jxr_linenumber" name="L2075" href="#L2075">2075</a> <em class="jxr_javadoccomment"> * <li><b>%E</b> - Scientific notation (uppercase)</li></em>
+<a class="jxr_linenumber" name="L2076" href="#L2076">2076</a> <em class="jxr_javadoccomment"> * <li><b>%g</b> - General format (lowercase)</li></em>
+<a class="jxr_linenumber" name="L2077" href="#L2077">2077</a> <em class="jxr_javadoccomment"> * <li><b>%G</b> - General format (uppercase)</li></em>
+<a class="jxr_linenumber" name="L2078" href="#L2078">2078</a> <em class="jxr_javadoccomment"> * <li><b>%n</b> - Platform-specific line separator</li></em>
+<a class="jxr_linenumber" name="L2079" href="#L2079">2079</a> <em class="jxr_javadoccomment"> * <li><b>%%</b> - Literal percent sign</li></em>
+<a class="jxr_linenumber" name="L2080" href="#L2080">2080</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L2081" href="#L2081">2081</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2082" href="#L2082">2082</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Format Specifier Syntax:</h5></em>
+<a class="jxr_linenumber" name="L2083" href="#L2083">2083</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2084" href="#L2084">2084</a> <em class="jxr_javadoccomment"> * Printf format specifiers follow this pattern: <c>%[argument_index$][flags][width][.precision]conversion</c></em>
+<a class="jxr_linenumber" name="L2085" href="#L2085">2085</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2086" href="#L2086">2086</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2087" href="#L2087">2087</a> <em class="jxr_javadoccomment"> * MessageFormat placeholders follow this pattern: <c>{argument_index[,format_type[,format_style]]}</c></em>
+<a class="jxr_linenumber" name="L2088" href="#L2088">2088</a> <em class="jxr_javadoccomment"> * </p></em>
<a class="jxr_linenumber" name="L2089" href="#L2089">2089</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2090" href="#L2090">2090</a> <em class="jxr_javadoccomment"> * <jc>// Floating point with precision</jc></em>
-<a class="jxr_linenumber" name="L2091" href="#L2091">2091</a> <em class="jxr_javadoccomment"> * format(<js>"Price: $%.2f"</js>, 19.99);</em>
-<a class="jxr_linenumber" name="L2092" href="#L2092">2092</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Price: $19.99"</jc></em>
-<a class="jxr_linenumber" name="L2093" href="#L2093">2093</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2094" href="#L2094">2094</a> <em class="jxr_javadoccomment"> * <jc>// MessageFormat-style formatting</jc></em>
-<a class="jxr_linenumber" name="L2095" href="#L2095">2095</a> <em class="jxr_javadoccomment"> * format(<js>"Hello {0}, you have {1} items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L2096" href="#L2096">2096</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
-<a class="jxr_linenumber" name="L2097" href="#L2097">2097</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2098" href="#L2098">2098</a> <em class="jxr_javadoccomment"> * <jc>// Un-numbered MessageFormat placeholders (sequential)</jc></em>
-<a class="jxr_linenumber" name="L2099" href="#L2099">2099</a> <em class="jxr_javadoccomment"> * format(<js>"Hello {}, you have {} items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L2100" href="#L2100">2100</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
-<a class="jxr_linenumber" name="L2101" href="#L2101">2101</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2102" href="#L2102">2102</a> <em class="jxr_javadoccomment"> * <jc>// Mixed format styles in the same pattern</jc></em>
-<a class="jxr_linenumber" name="L2103" href="#L2103">2103</a> <em class="jxr_javadoccomment"> * format(<js>"User {0} has %d items and %s status"</js>, <js>"Alice"</js>, 10, <js>"active"</js>);</em>
-<a class="jxr_linenumber" name="L2104" href="#L2104">2104</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "User Alice has 10 items and active status"</jc></em>
-<a class="jxr_linenumber" name="L2105" href="#L2105">2105</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2106" href="#L2106">2106</a> <em class="jxr_javadoccomment"> * <jc>// Width and alignment (printf)</jc></em>
-<a class="jxr_linenumber" name="L2107" href="#L2107">2107</a> <em class="jxr_javadoccomment"> * format(<js>"Name: %-20s Age: %3d"</js>, <js>"John"</js>, 25);</em>
-<a class="jxr_linenumber" name="L2108" href="#L2108">2108</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Name: John Age: 25"</jc></em>
-<a class="jxr_linenumber" name="L2109" href="#L2109">2109</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2110" href="#L2110">2110</a> <em class="jxr_javadoccomment"> * <jc>// Hexadecimal (printf)</jc></em>
-<a class="jxr_linenumber" name="L2111" href="#L2111">2111</a> <em class="jxr_javadoccomment"> * format(<js>"Color: #%06X"</js>, 0xFF5733);</em>
-<a class="jxr_linenumber" name="L2112" href="#L2112">2112</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Color: #FF5733"</jc></em>
-<a class="jxr_linenumber" name="L2113" href="#L2113">2113</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2114" href="#L2114">2114</a> <em class="jxr_javadoccomment"> * <jc>// Argument index (reuse arguments)</jc></em>
-<a class="jxr_linenumber" name="L2115" href="#L2115">2115</a> <em class="jxr_javadoccomment"> * format(<js>"%1$s loves %2$s, and {0} also loves %3$s"</js>, <js>"Alice"</js>, <js>"Bob"</js>, <js>"Charlie"</js>);</em>
-<a class="jxr_linenumber" name="L2116" href="#L2116">2116</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Alice loves Bob, and Alice also loves Charlie"</jc></em>
-<a class="jxr_linenumber" name="L2117" href="#L2117">2117</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2118" href="#L2118">2118</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2119" href="#L2119">2119</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Comparison with mformat():</h5></em>
-<a class="jxr_linenumber" name="L2120" href="#L2120">2120</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2121" href="#L2121">2121</a> <em class="jxr_javadoccomment"> * This method supports both formats, while {@link #mformat(String, Object...)} only supports MessageFormat-style.</em>
-<a class="jxr_linenumber" name="L2122" href="#L2122">2122</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2123" href="#L2123">2123</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2124" href="#L2124">2124</a> <em class="jxr_javadoccomment"> * <jc>// Both styles supported (this method)</jc></em>
-<a class="jxr_linenumber" name="L2125" href="#L2125">2125</a> <em class="jxr_javadoccomment"> * format(<js>"Hello %s, you have %d items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L2126" href="#L2126">2126</a> <em class="jxr_javadoccomment"> * format(<js>"Hello {0}, you have {1} items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L2127" href="#L2127">2127</a> <em class="jxr_javadoccomment"> * format(<js>"User {0} has %d items"</js>, <js>"Alice"</js>, 10);</em>
-<a class="jxr_linenumber" name="L2128" href="#L2128">2128</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2129" href="#L2129">2129</a> <em class="jxr_javadoccomment"> * <jc>// MessageFormat style only</jc></em>
-<a class="jxr_linenumber" name="L2130" href="#L2130">2130</a> <em class="jxr_javadoccomment"> * mformat(<js>"Hello {0}, you have {1} items"</js>, <js>"John"</js>, 5);</em>
-<a class="jxr_linenumber" name="L2131" href="#L2131">2131</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2132" href="#L2132">2132</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2133" href="#L2133">2133</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Null Handling:</h5></em>
-<a class="jxr_linenumber" name="L2134" href="#L2134">2134</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2135" href="#L2135">2135</a> <em class="jxr_javadoccomment"> * Null arguments are formatted as the string <js>"null"</js> for string conversions,</em>
-<a class="jxr_linenumber" name="L2136" href="#L2136">2136</a> <em class="jxr_javadoccomment"> * or cause a {@link NullPointerException} for numeric conversions (consistent with {@link String#format(String, Object...)}).</em>
+<a class="jxr_linenumber" name="L2090" href="#L2090">2090</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L2091" href="#L2091">2091</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2092" href="#L2092">2092</a> <em class="jxr_javadoccomment"> * <jc>// Printf-style formatting</jc></em>
+<a class="jxr_linenumber" name="L2093" href="#L2093">2093</a> <em class="jxr_javadoccomment"> * format(<js>"Hello %s, you have %d items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L2094" href="#L2094">2094</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
+<a class="jxr_linenumber" name="L2095" href="#L2095">2095</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2096" href="#L2096">2096</a> <em class="jxr_javadoccomment"> * <jc>// Floating point with precision</jc></em>
+<a class="jxr_linenumber" name="L2097" href="#L2097">2097</a> <em class="jxr_javadoccomment"> * format(<js>"Price: $%.2f"</js>, 19.99);</em>
+<a class="jxr_linenumber" name="L2098" href="#L2098">2098</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Price: $19.99"</jc></em>
+<a class="jxr_linenumber" name="L2099" href="#L2099">2099</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2100" href="#L2100">2100</a> <em class="jxr_javadoccomment"> * <jc>// MessageFormat-style formatting</jc></em>
+<a class="jxr_linenumber" name="L2101" href="#L2101">2101</a> <em class="jxr_javadoccomment"> * format(<js>"Hello {0}, you have {1} items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L2102" href="#L2102">2102</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
+<a class="jxr_linenumber" name="L2103" href="#L2103">2103</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2104" href="#L2104">2104</a> <em class="jxr_javadoccomment"> * <jc>// Un-numbered MessageFormat placeholders (sequential)</jc></em>
+<a class="jxr_linenumber" name="L2105" href="#L2105">2105</a> <em class="jxr_javadoccomment"> * format(<js>"Hello {}, you have {} items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L2106" href="#L2106">2106</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, you have 5 items"</jc></em>
+<a class="jxr_linenumber" name="L2107" href="#L2107">2107</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2108" href="#L2108">2108</a> <em class="jxr_javadoccomment"> * <jc>// Mixed format styles in the same pattern</jc></em>
+<a class="jxr_linenumber" name="L2109" href="#L2109">2109</a> <em class="jxr_javadoccomment"> * format(<js>"User {0} has %d items and %s status"</js>, <js>"Alice"</js>, 10, <js>"active"</js>);</em>
+<a class="jxr_linenumber" name="L2110" href="#L2110">2110</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "User Alice has 10 items and active status"</jc></em>
+<a class="jxr_linenumber" name="L2111" href="#L2111">2111</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2112" href="#L2112">2112</a> <em class="jxr_javadoccomment"> * <jc>// Width and alignment (printf)</jc></em>
+<a class="jxr_linenumber" name="L2113" href="#L2113">2113</a> <em class="jxr_javadoccomment"> * format(<js>"Name: %-20s Age: %3d"</js>, <js>"John"</js>, 25);</em>
+<a class="jxr_linenumber" name="L2114" href="#L2114">2114</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Name: John Age: 25"</jc></em>
+<a class="jxr_linenumber" name="L2115" href="#L2115">2115</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2116" href="#L2116">2116</a> <em class="jxr_javadoccomment"> * <jc>// Hexadecimal (printf)</jc></em>
+<a class="jxr_linenumber" name="L2117" href="#L2117">2117</a> <em class="jxr_javadoccomment"> * format(<js>"Color: #%06X"</js>, 0xFF5733);</em>
+<a class="jxr_linenumber" name="L2118" href="#L2118">2118</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Color: #FF5733"</jc></em>
+<a class="jxr_linenumber" name="L2119" href="#L2119">2119</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2120" href="#L2120">2120</a> <em class="jxr_javadoccomment"> * <jc>// Argument index (reuse arguments)</jc></em>
+<a class="jxr_linenumber" name="L2121" href="#L2121">2121</a> <em class="jxr_javadoccomment"> * format(<js>"%1$s loves %2$s, and {0} also loves %3$s"</js>, <js>"Alice"</js>, <js>"Bob"</js>, <js>"Charlie"</js>);</em>
+<a class="jxr_linenumber" name="L2122" href="#L2122">2122</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Alice loves Bob, and Alice also loves Charlie"</jc></em>
+<a class="jxr_linenumber" name="L2123" href="#L2123">2123</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2124" href="#L2124">2124</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2125" href="#L2125">2125</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Comparison with mformat():</h5></em>
+<a class="jxr_linenumber" name="L2126" href="#L2126">2126</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2127" href="#L2127">2127</a> <em class="jxr_javadoccomment"> * This method supports both formats, while {@link #mformat(String, Object...)} only supports MessageFormat-style.</em>
+<a class="jxr_linenumber" name="L2128" href="#L2128">2128</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2129" href="#L2129">2129</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2130" href="#L2130">2130</a> <em class="jxr_javadoccomment"> * <jc>// Both styles supported (this method)</jc></em>
+<a class="jxr_linenumber" name="L2131" href="#L2131">2131</a> <em class="jxr_javadoccomment"> * format(<js>"Hello %s, you have %d items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L2132" href="#L2132">2132</a> <em class="jxr_javadoccomment"> * format(<js>"Hello {0}, you have {1} items"</js>, <js>"John"</js>, 5);</em>
+<a class="jxr_linenumber" name="L2133" href="#L2133">2133</a> <em class="jxr_javadoccomment"> * format(<js>"User {0} has %d items"</js>, <js>"Alice"</js>, 10);</em>
+<a class="jxr_linenumber" name="L2134" href="#L2134">2134</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2135" href="#L2135">2135</a> <em class="jxr_javadoccomment"> * <jc>// MessageFormat style only</jc></em>
+<a class="jxr_linenumber" name="L2136" href="#L2136">2136</a> <em class="jxr_javadoccomment"> * mformat(<js>"Hello {0}, you have {1} items"</js>, <js>"John"</js>, 5);</em>
<a class="jxr_linenumber" name="L2137" href="#L2137">2137</a> <em class="jxr_javadoccomment"> * </p></em>
<a class="jxr_linenumber" name="L2138" href="#L2138">2138</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2139" href="#L2139">2139</a> <em class="jxr_javadoccomment"> * @param pattern The format string supporting both MessageFormat and printf-style placeholders.</em>
-<a class="jxr_linenumber" name="L2140" href="#L2140">2140</a> <em class="jxr_javadoccomment"> * @param args The arguments to format.</em>
-<a class="jxr_linenumber" name="L2141" href="#L2141">2141</a> <em class="jxr_javadoccomment"> * @return The formatted string.</em>
-<a class="jxr_linenumber" name="L2142" href="#L2142">2142</a> <em class="jxr_javadoccomment"> * @throws java.util.IllegalFormatException If the format string is invalid or arguments don't match the format specifiers.</em>
-<a class="jxr_linenumber" name="L2143" href="#L2143">2143</a> <em class="jxr_javadoccomment"> * @see StringFormat for detailed format specification</em>
-<a class="jxr_linenumber" name="L2144" href="#L2144">2144</a> <em class="jxr_javadoccomment"> * @see String#format(String, Object...)</em>
-<a class="jxr_linenumber" name="L2145" href="#L2145">2145</a> <em class="jxr_javadoccomment"> * @see #mformat(String, Object...) for MessageFormat-only formatting</em>
-<a class="jxr_linenumber" name="L2146" href="#L2146">2146</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2147" href="#L2147">2147</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String format(String pattern, Object...args) {
-<a class="jxr_linenumber" name="L2148" href="#L2148">2148</a> <strong class="jxr_keyword">return</strong> StringFormat.format(pattern, args);
-<a class="jxr_linenumber" name="L2149" href="#L2149">2149</a> }
-<a class="jxr_linenumber" name="L2150" href="#L2150">2150</a>
-<a class="jxr_linenumber" name="L2151" href="#L2151">2151</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2152" href="#L2152">2152</a> <em class="jxr_javadoccomment"> * Simple utility for replacing variables of the form <js>"{key}"</js> with values in the specified map.</em>
-<a class="jxr_linenumber" name="L2153" href="#L2153">2153</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2154" href="#L2154">2154</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2155" href="#L2155">2155</a> <em class="jxr_javadoccomment"> * Supports named MessageFormat-style variables: <js>"{key}"</js> where <c>key</c> is a map key.</em>
-<a class="jxr_linenumber" name="L2156" href="#L2156">2156</a> <em class="jxr_javadoccomment"> * For un-numbered sequential placeholders <js>"{}"</js>, use {@link #format(String, Object...)} instead.</em>
-<a class="jxr_linenumber" name="L2157" href="#L2157">2157</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2158" href="#L2158">2158</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2159" href="#L2159">2159</a> <em class="jxr_javadoccomment"> * Variable values are converted to strings using {@link #readable(Object)} to ensure consistent,</em>
-<a class="jxr_linenumber" name="L2160" href="#L2160">2160</a> <em class="jxr_javadoccomment"> * readable formatting (e.g., byte arrays are converted to hex, collections are formatted without spaces).</em>
-<a class="jxr_linenumber" name="L2161" href="#L2161">2161</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2162" href="#L2162">2162</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2163" href="#L2163">2163</a> <em class="jxr_javadoccomment"> * Nested variables are supported in both the input string and map values.</em>
-<a class="jxr_linenumber" name="L2164" href="#L2164">2164</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2165" href="#L2165">2165</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2166" href="#L2166">2166</a> <em class="jxr_javadoccomment"> * If the map does not contain the specified value, the variable is not replaced.</em>
+<a class="jxr_linenumber" name="L2139" href="#L2139">2139</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Null Handling:</h5></em>
+<a class="jxr_linenumber" name="L2140" href="#L2140">2140</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2141" href="#L2141">2141</a> <em class="jxr_javadoccomment"> * Null arguments are formatted as the string <js>"null"</js> for string conversions,</em>
+<a class="jxr_linenumber" name="L2142" href="#L2142">2142</a> <em class="jxr_javadoccomment"> * or cause a {@link NullPointerException} for numeric conversions (consistent with {@link String#format(String, Object...)}).</em>
+<a class="jxr_linenumber" name="L2143" href="#L2143">2143</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2144" href="#L2144">2144</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2145" href="#L2145">2145</a> <em class="jxr_javadoccomment"> * @param pattern The format string supporting both MessageFormat and printf-style placeholders.</em>
+<a class="jxr_linenumber" name="L2146" href="#L2146">2146</a> <em class="jxr_javadoccomment"> * @param args The arguments to format.</em>
+<a class="jxr_linenumber" name="L2147" href="#L2147">2147</a> <em class="jxr_javadoccomment"> * @return The formatted string.</em>
+<a class="jxr_linenumber" name="L2148" href="#L2148">2148</a> <em class="jxr_javadoccomment"> * @throws java.util.IllegalFormatException If the format string is invalid or arguments don't match the format specifiers.</em>
+<a class="jxr_linenumber" name="L2149" href="#L2149">2149</a> <em class="jxr_javadoccomment"> * @see StringFormat for detailed format specification</em>
+<a class="jxr_linenumber" name="L2150" href="#L2150">2150</a> <em class="jxr_javadoccomment"> * @see String#format(String, Object...)</em>
+<a class="jxr_linenumber" name="L2151" href="#L2151">2151</a> <em class="jxr_javadoccomment"> * @see #mformat(String, Object...) for MessageFormat-only formatting</em>
+<a class="jxr_linenumber" name="L2152" href="#L2152">2152</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2153" href="#L2153">2153</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String format(String pattern, Object...args) {
+<a class="jxr_linenumber" name="L2154" href="#L2154">2154</a> <strong class="jxr_keyword">return</strong> StringFormat.format(pattern, args);
+<a class="jxr_linenumber" name="L2155" href="#L2155">2155</a> }
+<a class="jxr_linenumber" name="L2156" href="#L2156">2156</a>
+<a class="jxr_linenumber" name="L2157" href="#L2157">2157</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2158" href="#L2158">2158</a> <em class="jxr_javadoccomment"> * Simple utility for replacing variables of the form <js>"{key}"</js> with values in the specified map.</em>
+<a class="jxr_linenumber" name="L2159" href="#L2159">2159</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2160" href="#L2160">2160</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2161" href="#L2161">2161</a> <em class="jxr_javadoccomment"> * Supports named MessageFormat-style variables: <js>"{key}"</js> where <c>key</c> is a map key.</em>
+<a class="jxr_linenumber" name="L2162" href="#L2162">2162</a> <em class="jxr_javadoccomment"> * For un-numbered sequential placeholders <js>"{}"</js>, use {@link #format(String, Object...)} instead.</em>
+<a class="jxr_linenumber" name="L2163" href="#L2163">2163</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2164" href="#L2164">2164</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2165" href="#L2165">2165</a> <em class="jxr_javadoccomment"> * Variable values are converted to strings using {@link #readable(Object)} to ensure consistent,</em>
+<a class="jxr_linenumber" name="L2166" href="#L2166">2166</a> <em class="jxr_javadoccomment"> * readable formatting (e.g., byte arrays are converted to hex, collections are formatted without spaces).</em>
<a class="jxr_linenumber" name="L2167" href="#L2167">2167</a> <em class="jxr_javadoccomment"> *</em>
<a class="jxr_linenumber" name="L2168" href="#L2168">2168</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2169" href="#L2169">2169</a> <em class="jxr_javadoccomment"> * <jk>null</jk> values in the map are treated as blank strings.</em>
+<a class="jxr_linenumber" name="L2169" href="#L2169">2169</a> <em class="jxr_javadoccomment"> * Nested variables are supported in both the input string and map values.</em>
<a class="jxr_linenumber" name="L2170" href="#L2170">2170</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2171" href="#L2171">2171</a> <em class="jxr_javadoccomment"> * @param s The string containing variables to replace.</em>
-<a class="jxr_linenumber" name="L2172" href="#L2172">2172</a> <em class="jxr_javadoccomment"> * @param m The map containing the variable values.</em>
-<a class="jxr_linenumber" name="L2173" href="#L2173">2173</a> <em class="jxr_javadoccomment"> * @return The new string with variables replaced, or the original string if it didn't have variables in it.</em>
-<a class="jxr_linenumber" name="L2174" href="#L2174">2174</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2175" href="#L2175">2175</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String formatNamed(String s, Map<String,Object> m) {
-<a class="jxr_linenumber" name="L2176" href="#L2176">2176</a>
-<a class="jxr_linenumber" name="L2177" href="#L2177">2177</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2178" href="#L2178">2178</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L2179" href="#L2179">2179</a>
-<a class="jxr_linenumber" name="L2180" href="#L2180">2180</a> <strong class="jxr_keyword">if</strong> (m == <strong class="jxr_keyword">null</strong> || m.isEmpty() || s.indexOf('{') == -1)
-<a class="jxr_linenumber" name="L2181" href="#L2181">2181</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L2171" href="#L2171">2171</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2172" href="#L2172">2172</a> <em class="jxr_javadoccomment"> * If the map does not contain the specified value, the variable is not replaced.</em>
+<a class="jxr_linenumber" name="L2173" href="#L2173">2173</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2174" href="#L2174">2174</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2175" href="#L2175">2175</a> <em class="jxr_javadoccomment"> * <jk>null</jk> values in the map are treated as blank strings.</em>
+<a class="jxr_linenumber" name="L2176" href="#L2176">2176</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2177" href="#L2177">2177</a> <em class="jxr_javadoccomment"> * @param s The string containing variables to replace.</em>
+<a class="jxr_linenumber" name="L2178" href="#L2178">2178</a> <em class="jxr_javadoccomment"> * @param m The map containing the variable values.</em>
+<a class="jxr_linenumber" name="L2179" href="#L2179">2179</a> <em class="jxr_javadoccomment"> * @return The new string with variables replaced, or the original string if it didn't have variables in it.</em>
+<a class="jxr_linenumber" name="L2180" href="#L2180">2180</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2181" href="#L2181">2181</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String formatNamed(String s, Map<String,Object> m) {
<a class="jxr_linenumber" name="L2182" href="#L2182">2182</a>
-<a class="jxr_linenumber" name="L2183" href="#L2183">2183</a> <em class="jxr_comment">// S1: Not in variable, looking for '{'</em>
-<a class="jxr_linenumber" name="L2184" href="#L2184">2184</a> <em class="jxr_comment">// S2: Found '{', Looking for '}'</em>
+<a class="jxr_linenumber" name="L2183" href="#L2183">2183</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2184" href="#L2184">2184</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
<a class="jxr_linenumber" name="L2185" href="#L2185">2185</a>
-<a class="jxr_linenumber" name="L2186" href="#L2186">2186</a> <strong class="jxr_keyword">var</strong> state = S1;
-<a class="jxr_linenumber" name="L2187" href="#L2187">2187</a> <strong class="jxr_keyword">var</strong> hasInternalVar = false;
-<a class="jxr_linenumber" name="L2188" href="#L2188">2188</a> <strong class="jxr_keyword">var</strong> x = 0;
-<a class="jxr_linenumber" name="L2189" href="#L2189">2189</a> <strong class="jxr_keyword">var</strong> depth = 0;
-<a class="jxr_linenumber" name="L2190" href="#L2190">2190</a> <strong class="jxr_keyword">var</strong> length = s.length();
-<a class="jxr_linenumber" name="L2191" href="#L2191">2191</a> <strong class="jxr_keyword">var</strong> out = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L2192" href="#L2192">2192</a>
-<a class="jxr_linenumber" name="L2193" href="#L2193">2193</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < length; i++) {
-<a class="jxr_linenumber" name="L2194" href="#L2194">2194</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L2195" href="#L2195">2195</a> <strong class="jxr_keyword">if</strong> (state == S1) {
-<a class="jxr_linenumber" name="L2196" href="#L2196">2196</a> <strong class="jxr_keyword">if</strong> (c == '{') {
-<a class="jxr_linenumber" name="L2197" href="#L2197">2197</a> state = S2;
-<a class="jxr_linenumber" name="L2198" href="#L2198">2198</a> x = i;
-<a class="jxr_linenumber" name="L2199" href="#L2199">2199</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L2200" href="#L2200">2200</a> out.append(c);
-<a class="jxr_linenumber" name="L2201" href="#L2201">2201</a> }
-<a class="jxr_linenumber" name="L2202" href="#L2202">2202</a> } <strong class="jxr_keyword">else</strong> <em class="jxr_comment">/* state == S2 */</em> {
-<a class="jxr_linenumber" name="L2203" href="#L2203">2203</a> <strong class="jxr_keyword">if</strong> (c == '{') {
-<a class="jxr_linenumber" name="L2204" href="#L2204">2204</a> depth++;
-<a class="jxr_linenumber" name="L2205" href="#L2205">2205</a> hasInternalVar = <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L2206" href="#L2206">2206</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '}') {
-<a class="jxr_linenumber" name="L2207" href="#L2207">2207</a> <strong class="jxr_keyword">if</strong> (depth > 0) {
-<a class="jxr_linenumber" name="L2208" href="#L2208">2208</a> depth--;
-<a class="jxr_linenumber" name="L2209" href="#L2209">2209</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L2210" href="#L2210">2210</a> <strong class="jxr_keyword">var</strong> key = s.substring(x + 1, i);
-<a class="jxr_linenumber" name="L2211" href="#L2211">2211</a> key = (hasInternalVar ? formatNamed(key, m) : key);
-<a class="jxr_linenumber" name="L2212" href="#L2212">2212</a> hasInternalVar = false;
-<a class="jxr_linenumber" name="L2213" href="#L2213">2213</a> <em class="jxr_comment">// JUNEAU-248: Check if key exists in map by attempting to get it</em>
-<a class="jxr_linenumber" name="L2214" href="#L2214">2214</a> <em class="jxr_comment">// For regular maps: use containsKey() OR nn(get()) check</em>
-<a class="jxr_linenumber" name="L2215" href="#L2215">2215</a> <em class="jxr_comment">// For BeanMaps: get() returns non-null for accessible properties (including hidden ones)</em>
-<a class="jxr_linenumber" name="L2216" href="#L2216">2216</a> <strong class="jxr_keyword">var</strong> val = m.get(key);
-<a class="jxr_linenumber" name="L2217" href="#L2217">2217</a> <em class="jxr_comment">// Check if key actually exists: either containsKey is true, or val is non-null</em>
-<a class="jxr_linenumber" name="L2218" href="#L2218">2218</a> <em class="jxr_comment">// This handles both regular maps and BeanMaps correctly</em>
-<a class="jxr_linenumber" name="L2219" href="#L2219">2219</a> <strong class="jxr_keyword">var</strong> keyExists = m.containsKey(key) || nn(val);
-<a class="jxr_linenumber" name="L2220" href="#L2220">2220</a> <strong class="jxr_keyword">if</strong> (! keyExists)
-<a class="jxr_linenumber" name="L2221" href="#L2221">2221</a> out.append('{').append(key).append('}');
-<a class="jxr_linenumber" name="L2222" href="#L2222">2222</a> <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L2223" href="#L2223">2223</a> <strong class="jxr_keyword">if</strong> (val == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2224" href="#L2224">2224</a> val = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L2225" href="#L2225">2225</a> <strong class="jxr_keyword">var</strong> v = r(val);
-<a class="jxr_linenumber" name="L2226" href="#L2226">2226</a> <em class="jxr_comment">// If the replacement also contains variables, replace them now.</em>
-<a class="jxr_linenumber" name="L2227" href="#L2227">2227</a> <strong class="jxr_keyword">if</strong> (v.indexOf('{') != -1)
-<a class="jxr_linenumber" name="L2228" href="#L2228">2228</a> v = formatNamed(v, m);
-<a class="jxr_linenumber" name="L2229" href="#L2229">2229</a> out.append(v);
-<a class="jxr_linenumber" name="L2230" href="#L2230">2230</a> }
-<a class="jxr_linenumber" name="L2231" href="#L2231">2231</a> state = S1;
-<a class="jxr_linenumber" name="L2232" href="#L2232">2232</a> }
-<a class="jxr_linenumber" name="L2233" href="#L2233">2233</a> }
-<a class="jxr_linenumber" name="L2234" href="#L2234">2234</a> }
-<a class="jxr_linenumber" name="L2235" href="#L2235">2235</a> }
-<a class="jxr_linenumber" name="L2236" href="#L2236">2236</a> <strong class="jxr_keyword">return</strong> out.toString();
-<a class="jxr_linenumber" name="L2237" href="#L2237">2237</a> }
-<a class="jxr_linenumber" name="L2238" href="#L2238">2238</a>
-<a class="jxr_linenumber" name="L2239" href="#L2239">2239</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2240" href="#L2240">2240</a> <em class="jxr_javadoccomment"> * Converts a hexadecimal character string to a byte array.</em>
-<a class="jxr_linenumber" name="L2241" href="#L2241">2241</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2242" href="#L2242">2242</a> <em class="jxr_javadoccomment"> * @param hex The string to convert to a byte array.</em>
-<a class="jxr_linenumber" name="L2243" href="#L2243">2243</a> <em class="jxr_javadoccomment"> * @return A new byte array.</em>
-<a class="jxr_linenumber" name="L2244" href="#L2244">2244</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2245" href="#L2245">2245</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] fromHex(String hex) {
-<a class="jxr_linenumber" name="L2246" href="#L2246">2246</a> <strong class="jxr_keyword">var</strong> buff = ByteBuffer.allocate(hex.length() / 2);
-<a class="jxr_linenumber" name="L2247" href="#L2247">2247</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < hex.length(); i += 2)
-<a class="jxr_linenumber" name="L2248" href="#L2248">2248</a> buff.put((byte)Integer.parseInt(hex.substring(i, i + 2), 16));
-<a class="jxr_linenumber" name="L2249" href="#L2249">2249</a> buff.rewind();
-<a class="jxr_linenumber" name="L2250" href="#L2250">2250</a> <strong class="jxr_keyword">return</strong> buff.array();
-<a class="jxr_linenumber" name="L2251" href="#L2251">2251</a> }
-<a class="jxr_linenumber" name="L2252" href="#L2252">2252</a>
-<a class="jxr_linenumber" name="L2253" href="#L2253">2253</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2254" href="#L2254">2254</a> <em class="jxr_javadoccomment"> * Converts a hexadecimal byte stream (e.g. "34A5BC") into a UTF-8 encoded string.</em>
-<a class="jxr_linenumber" name="L2255" href="#L2255">2255</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2256" href="#L2256">2256</a> <em class="jxr_javadoccomment"> * @param hex The hexadecimal string.</em>
-<a class="jxr_linenumber" name="L2257" href="#L2257">2257</a> <em class="jxr_javadoccomment"> * @return The UTF-8 string.</em>
-<a class="jxr_linenumber" name="L2258" href="#L2258">2258</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2259" href="#L2259">2259</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String fromHexToUTF8(String hex) {
-<a class="jxr_linenumber" name="L2260" href="#L2260">2260</a> <strong class="jxr_keyword">var</strong> buff = ByteBuffer.allocate(hex.length() / 2);
-<a class="jxr_linenumber" name="L2261" href="#L2261">2261</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < hex.length(); i += 2)
-<a class="jxr_linenumber" name="L2262" href="#L2262">2262</a> buff.put((byte)Integer.parseInt(hex.substring(i, i + 2), 16));
-<a class="jxr_linenumber" name="L2263" href="#L2263">2263</a> buff.rewind(); <em class="jxr_comment">// Fixes Java 11 issue.</em>
-<a class="jxr_linenumber" name="L2264" href="#L2264">2264</a> <strong class="jxr_keyword">return</strong> UTF_8.decode(buff).toString();
-<a class="jxr_linenumber" name="L2265" href="#L2265">2265</a> }
-<a class="jxr_linenumber" name="L2266" href="#L2266">2266</a>
-<a class="jxr_linenumber" name="L2267" href="#L2267">2267</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2268" href="#L2268">2268</a> <em class="jxr_javadoccomment"> * Same as {@link #fromHex(String)} except expects spaces between the byte strings.</em>
-<a class="jxr_linenumber" name="L2269" href="#L2269">2269</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2270" href="#L2270">2270</a> <em class="jxr_javadoccomment"> * @param hex The string to convert to a byte array.</em>
-<a class="jxr_linenumber" name="L2271" href="#L2271">2271</a> <em class="jxr_javadoccomment"> * @return A new byte array.</em>
-<a class="jxr_linenumber" name="L2272" href="#L2272">2272</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2273" href="#L2273">2273</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] fromSpacedHex(String hex) {
-<a class="jxr_linenumber" name="L2274" href="#L2274">2274</a> <strong class="jxr_keyword">var</strong> buff = ByteBuffer.allocate((hex.length() + 1) / 3);
-<a class="jxr_linenumber" name="L2275" href="#L2275">2275</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < hex.length(); i += 3)
-<a class="jxr_linenumber" name="L2276" href="#L2276">2276</a> buff.put((byte)Integer.parseInt(hex.substring(i, i + 2), 16));
-<a class="jxr_linenumber" name="L2277" href="#L2277">2277</a> buff.rewind();
-<a class="jxr_linenumber" name="L2278" href="#L2278">2278</a> <strong class="jxr_keyword">return</strong> buff.array();
-<a class="jxr_linenumber" name="L2279" href="#L2279">2279</a> }
-<a class="jxr_linenumber" name="L2280" href="#L2280">2280</a>
-<a class="jxr_linenumber" name="L2281" href="#L2281">2281</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2282" href="#L2282">2282</a> <em class="jxr_javadoccomment"> * Converts a space-deliminted hexadecimal byte stream (e.g. "34 A5 BC") into a UTF-8 encoded string.</em>
-<a class="jxr_linenumber" name="L2283" href="#L2283">2283</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2284" href="#L2284">2284</a> <em class="jxr_javadoccomment"> * @param hex The hexadecimal string.</em>
-<a class="jxr_linenumber" name="L2285" href="#L2285">2285</a> <em class="jxr_javadoccomment"> * @return The UTF-8 string.</em>
-<a class="jxr_linenumber" name="L2286" href="#L2286">2286</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2287" href="#L2287">2287</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String fromSpacedHexToUTF8(String hex) {
-<a class="jxr_linenumber" name="L2288" href="#L2288">2288</a> <strong class="jxr_keyword">var</strong> buff = ByteBuffer.allocate((hex.length() + 1) / 3);
-<a class="jxr_linenumber" name="L2289" href="#L2289">2289</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < hex.length(); i += 3)
-<a class="jxr_linenumber" name="L2290" href="#L2290">2290</a> buff.put((byte)Integer.parseInt(hex.substring(i, i + 2), 16));
-<a class="jxr_linenumber" name="L2291" href="#L2291">2291</a> buff.rewind(); <em class="jxr_comment">// Fixes Java 11 issue.</em>
-<a class="jxr_linenumber" name="L2292" href="#L2292">2292</a> <strong class="jxr_keyword">return</strong> UTF_8.decode(buff).toString();
-<a class="jxr_linenumber" name="L2293" href="#L2293">2293</a> }
-<a class="jxr_linenumber" name="L2294" href="#L2294">2294</a>
-<a class="jxr_linenumber" name="L2295" href="#L2295">2295</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2296" href="#L2296">2296</a> <em class="jxr_javadoccomment"> * Generates a random UUID string in standard format.</em>
-<a class="jxr_linenumber" name="L2297" href="#L2297">2297</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2298" href="#L2298">2298</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2299" href="#L2299">2299</a> <em class="jxr_javadoccomment"> * Returns a UUID in the format: <c>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</c></em>
-<a class="jxr_linenumber" name="L2300" href="#L2300">2300</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2301" href="#L2301">2301</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2302" href="#L2302">2302</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2303" href="#L2303">2303</a> <em class="jxr_javadoccomment"> * generateUUID(); <jc>// "550e8400-e29b-41d4-a716-446655440000"</jc></em>
-<a class="jxr_linenumber" name="L2304" href="#L2304">2304</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2305" href="#L2305">2305</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2306" href="#L2306">2306</a> <em class="jxr_javadoccomment"> * @return A new random UUID string.</em>
-<a class="jxr_linenumber" name="L2307" href="#L2307">2307</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2308" href="#L2308">2308</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String generateUUID() {
-<a class="jxr_linenumber" name="L2309" href="#L2309">2309</a> <strong class="jxr_keyword">return</strong> UUID.randomUUID().toString();
-<a class="jxr_linenumber" name="L2310" href="#L2310">2310</a> }
-<a class="jxr_linenumber" name="L2311" href="#L2311">2311</a>
-<a class="jxr_linenumber" name="L2312" href="#L2312">2312</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2313" href="#L2313">2313</a> <em class="jxr_javadoccomment"> * Given an absolute URI, returns just the authority portion (e.g. <js>"<a href="http://hostname:port" target="alexandria_uri">http://hostname:port</a>"</js>)</em>
-<a class="jxr_linenumber" name="L2314" href="#L2314">2314</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2315" href="#L2315">2315</a> <em class="jxr_javadoccomment"> * @param s The URI string.</em>
-<a class="jxr_linenumber" name="L2316" href="#L2316">2316</a> <em class="jxr_javadoccomment"> * @return Just the authority portion of the URI.</em>
-<a class="jxr_linenumber" name="L2317" href="#L2317">2317</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2318" href="#L2318">2318</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String getAuthorityUri(String s) { <em class="jxr_comment">// NOSONAR - False positive.</em>
-<a class="jxr_linenumber" name="L2319" href="#L2319">2319</a>
-<a class="jxr_linenumber" name="L2320" href="#L2320">2320</a> <em class="jxr_comment">// Use a state machine for maximum performance.</em>
-<a class="jxr_linenumber" name="L2321" href="#L2321">2321</a>
-<a class="jxr_linenumber" name="L2322" href="#L2322">2322</a> <em class="jxr_comment">// S1: Looking for http</em>
-<a class="jxr_linenumber" name="L2323" href="#L2323">2323</a> <em class="jxr_comment">// S2: Found http, looking for :</em>
-<a class="jxr_linenumber" name="L2324" href="#L2324">2324</a> <em class="jxr_comment">// S3: Found :, looking for /</em>
-<a class="jxr_linenumber" name="L2325" href="#L2325">2325</a> <em class="jxr_comment">// S4: Found /, looking for /</em>
-<a class="jxr_linenumber" name="L2326" href="#L2326">2326</a> <em class="jxr_comment">// S5: Found /, looking for x</em>
-<a class="jxr_linenumber" name="L2327" href="#L2327">2327</a> <em class="jxr_comment">// S6: Found x, looking for /</em>
-<a class="jxr_linenumber" name="L2328" href="#L2328">2328</a>
-<a class="jxr_linenumber" name="L2329" href="#L2329">2329</a> <strong class="jxr_keyword">var</strong> state = S1;
-<a class="jxr_linenumber" name="L2330" href="#L2330">2330</a>
-<a class="jxr_linenumber" name="L2331" href="#L2331">2331</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L2332" href="#L2332">2332</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L2333" href="#L2333">2333</a> <strong class="jxr_keyword">if</strong> (state == S1) {
-<a class="jxr_linenumber" name="L2334" href="#L2334">2334</a> <strong class="jxr_keyword">if</strong> (c >= 'a' && c <= 'z')
-<a class="jxr_linenumber" name="L2335" href="#L2335">2335</a> state = S2;
-<a class="jxr_linenumber" name="L2336" href="#L2336">2336</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2337" href="#L2337">2337</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L2338" href="#L2338">2338</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2) {
-<a class="jxr_linenumber" name="L2339" href="#L2339">2339</a> <strong class="jxr_keyword">if</strong> (c == ':')
-<a class="jxr_linenumber" name="L2340" href="#L2340">2340</a> state = S3;
-<a class="jxr_linenumber" name="L2341" href="#L2341">2341</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c < 'a' || c > 'z')
-<a class="jxr_linenumber" name="L2342" href="#L2342">2342</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L2343" href="#L2343">2343</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S3) { <em class="jxr_comment">// NOSONAR - False positive.</em>
-<a class="jxr_linenumber" name="L2344" href="#L2344">2344</a> <strong class="jxr_keyword">if</strong> (c == '/')
-<a class="jxr_linenumber" name="L2345" href="#L2345">2345</a> state = S4;
-<a class="jxr_linenumber" name="L2346" href="#L2346">2346</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2347" href="#L2347">2347</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L2348" href="#L2348">2348</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S4) {
-<a class="jxr_linenumber" name="L2349" href="#L2349">2349</a> <strong class="jxr_keyword">if</strong> (c == '/')
-<a class="jxr_linenumber" name="L2350" href="#L2350">2350</a> state = S5;
-<a class="jxr_linenumber" name="L2351" href="#L2351">2351</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2352" href="#L2352">2352</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L2353" href="#L2353">2353</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S5) {
-<a class="jxr_linenumber" name="L2354" href="#L2354">2354</a> <strong class="jxr_keyword">if</strong> (c != '/')
-<a class="jxr_linenumber" name="L2355" href="#L2355">2355</a> state = S6;
-<a class="jxr_linenumber" name="L2356" href="#L2356">2356</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2357" href="#L2357">2357</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L2358" href="#L2358">2358</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S6) {
-<a class="jxr_linenumber" name="L2359" href="#L2359">2359</a> <strong class="jxr_keyword">if</strong> (c == '/') <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L2360" href="#L2360">2360</a> <strong class="jxr_keyword">return</strong> s.substring(0, i);
-<a class="jxr_linenumber" name="L2361" href="#L2361">2361</a> }
-<a class="jxr_linenumber" name="L2362" href="#L2362">2362</a> }
-<a class="jxr_linenumber" name="L2363" href="#L2363">2363</a>
-<a class="jxr_linenumber" name="L2364" href="#L2364">2364</a> <strong class="jxr_keyword">return</strong> s;
-<a class="jxr_linenumber" name="L2365" href="#L2365">2365</a> }
-<a class="jxr_linenumber" name="L2366" href="#L2366">2366</a>
-<a class="jxr_linenumber" name="L2367" href="#L2367">2367</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2368" href="#L2368">2368</a> <em class="jxr_javadoccomment"> * Parses a duration string.</em>
-<a class="jxr_linenumber" name="L2369" href="#L2369">2369</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2370" href="#L2370">2370</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2371" href="#L2371">2371</a> <em class="jxr_javadoccomment"> * Supports simple duration formats:</em>
-<a class="jxr_linenumber" name="L2372" href="#L2372">2372</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2373" href="#L2373">2373</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Format Examples:</h5></em>
-<a class="jxr_linenumber" name="L2374" href="#L2374">2374</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L2375" href="#L2375">2375</a> <em class="jxr_javadoccomment"> * <li><js>"1000"</js> - 1000 milliseconds (no suffix)</em>
-<a class="jxr_linenumber" name="L2376" href="#L2376">2376</a> <em class="jxr_javadoccomment"> * <li><js>"10s"</js> - 10 seconds</em>
-<a class="jxr_linenumber" name="L2377" href="#L2377">2377</a> <em class="jxr_javadoccomment"> * <li><js>"10 sec"</js> - 10 seconds</em>
-<a class="jxr_linenumber" name="L2378" href="#L2378">2378</a> <em class="jxr_javadoccomment"> * <li><js>"10 seconds"</js> - 10 seconds</em>
-<a class="jxr_linenumber" name="L2379" href="#L2379">2379</a> <em class="jxr_javadoccomment"> * <li><js>"1.5h"</js> - 1.5 hours (5400000 ms)</em>
-<a class="jxr_linenumber" name="L2380" href="#L2380">2380</a> <em class="jxr_javadoccomment"> * <li><js>"1h30m"</js> - 1 hour 30 minutes (5400000 ms)</em>
-<a class="jxr_linenumber" name="L2381" href="#L2381">2381</a> <em class="jxr_javadoccomment"> * <li><js>"1h 30m"</js> - 1 hour 30 minutes (with spaces)</em>
-<a class="jxr_linenumber" name="L2382" href="#L2382">2382</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L2383" href="#L2383">2383</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2384" href="#L2384">2384</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Supported Units:</h5></em>
-<a class="jxr_linenumber" name="L2385" href="#L2385">2385</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L2386" href="#L2386">2386</a> <em class="jxr_javadoccomment"> * <li><b>Milliseconds:</b> <js>"ms"</js>, <js>"millis"</js>, <js>"milliseconds"</js> (or no suffix)</em>
-<a class="jxr_linenumber" name="L2387" href="#L2387">2387</a> <em class="jxr_javadoccomment"> * <li><b>Seconds:</b> <js>"s"</js>, <js>"sec"</js>, <js>"second"</js>, <js>"seconds"</js></em>
-<a class="jxr_linenumber" name="L2388" href="#L2388">2388</a> <em class="jxr_javadoccomment"> * <li><b>Minutes:</b> <js>"m"</js>, <js>"min"</js>, <js>"minute"</js>, <js>"minutes"</js></em>
-<a class="jxr_linenumber" name="L2389" href="#L2389">2389</a> <em class="jxr_javadoccomment"> * <li><b>Hours:</b> <js>"h"</js>, <js>"hour"</js>, <js>"hours"</js></em>
-<a class="jxr_linenumber" name="L2390" href="#L2390">2390</a> <em class="jxr_javadoccomment"> * <li><b>Days:</b> <js>"d"</js>, <js>"day"</js>, <js>"days"</js></em>
-<a class="jxr_linenumber" name="L2391" href="#L2391">2391</a> <em class="jxr_javadoccomment"> * <li><b>Weeks:</b> <js>"w"</js>, <js>"week"</js>, <js>"weeks"</js></em>
-<a class="jxr_linenumber" name="L2392" href="#L2392">2392</a> <em class="jxr_javadoccomment"> * <li><b>Months:</b> <js>"mo"</js>, <js>"month"</js>, <js>"months"</js> (30 days)</em>
-<a class="jxr_linenumber" name="L2393" href="#L2393">2393</a> <em class="jxr_javadoccomment"> * <li><b>Years:</b> <js>"y"</js>, <js>"yr"</js>, <js>"year"</js>, <js>"years"</js> (365 days)</em>
-<a class="jxr_linenumber" name="L2394" href="#L2394">2394</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L2395" href="#L2395">2395</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2396" href="#L2396">2396</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2397" href="#L2397">2397</a> <em class="jxr_javadoccomment"> * Suffixes are case-insensitive.</em>
-<a class="jxr_linenumber" name="L2398" href="#L2398">2398</a> <em class="jxr_javadoccomment"> * <br>Whitespace is ignored.</em>
-<a class="jxr_linenumber" name="L2399" href="#L2399">2399</a> <em class="jxr_javadoccomment"> * <br>Decimal values are supported (e.g., <js>"1.5h"</js>).</em>
-<a class="jxr_linenumber" name="L2400" href="#L2400">2400</a> <em class="jxr_javadoccomment"> * <br>Combined formats are supported (e.g., <js>"1h30m"</js>).</em>
+<a class="jxr_linenumber" name="L2186" href="#L2186">2186</a> <strong class="jxr_keyword">if</strong> (m == <strong class="jxr_keyword">null</strong> || m.isEmpty() || s.indexOf('{') == -1)
+<a class="jxr_linenumber" name="L2187" href="#L2187">2187</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L2188" href="#L2188">2188</a>
+<a class="jxr_linenumber" name="L2189" href="#L2189">2189</a> <em class="jxr_comment">// S1: Not in variable, looking for '{'</em>
+<a class="jxr_linenumber" name="L2190" href="#L2190">2190</a> <em class="jxr_comment">// S2: Found '{', Looking for '}'</em>
+<a class="jxr_linenumber" name="L2191" href="#L2191">2191</a>
+<a class="jxr_linenumber" name="L2192" href="#L2192">2192</a> <strong class="jxr_keyword">var</strong> state = S1;
+<a class="jxr_linenumber" name="L2193" href="#L2193">2193</a> <strong class="jxr_keyword">var</strong> hasInternalVar = false;
+<a class="jxr_linenumber" name="L2194" href="#L2194">2194</a> <strong class="jxr_keyword">var</strong> x = 0;
+<a class="jxr_linenumber" name="L2195" href="#L2195">2195</a> <strong class="jxr_keyword">var</strong> depth = 0;
+<a class="jxr_linenumber" name="L2196" href="#L2196">2196</a> <strong class="jxr_keyword">var</strong> length = s.length();
+<a class="jxr_linenumber" name="L2197" href="#L2197">2197</a> <strong class="jxr_keyword">var</strong> out = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L2198" href="#L2198">2198</a>
+<a class="jxr_linenumber" name="L2199" href="#L2199">2199</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < length; i++) {
+<a class="jxr_linenumber" name="L2200" href="#L2200">2200</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L2201" href="#L2201">2201</a> <strong class="jxr_keyword">if</strong> (state == S1) {
+<a class="jxr_linenumber" name="L2202" href="#L2202">2202</a> <strong class="jxr_keyword">if</strong> (c == '{') {
+<a class="jxr_linenumber" name="L2203" href="#L2203">2203</a> state = S2;
+<a class="jxr_linenumber" name="L2204" href="#L2204">2204</a> x = i;
+<a class="jxr_linenumber" name="L2205" href="#L2205">2205</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L2206" href="#L2206">2206</a> out.append(c);
+<a class="jxr_linenumber" name="L2207" href="#L2207">2207</a> }
+<a class="jxr_linenumber" name="L2208" href="#L2208">2208</a> } <strong class="jxr_keyword">else</strong> <em class="jxr_comment">/* state == S2 */</em> {
+<a class="jxr_linenumber" name="L2209" href="#L2209">2209</a> <strong class="jxr_keyword">if</strong> (c == '{') {
+<a class="jxr_linenumber" name="L2210" href="#L2210">2210</a> depth++;
+<a class="jxr_linenumber" name="L2211" href="#L2211">2211</a> hasInternalVar = <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L2212" href="#L2212">2212</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '}') {
+<a class="jxr_linenumber" name="L2213" href="#L2213">2213</a> <strong class="jxr_keyword">if</strong> (depth > 0) {
+<a class="jxr_linenumber" name="L2214" href="#L2214">2214</a> depth--;
+<a class="jxr_linenumber" name="L2215" href="#L2215">2215</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L2216" href="#L2216">2216</a> <strong class="jxr_keyword">var</strong> key = s.substring(x + 1, i);
+<a class="jxr_linenumber" name="L2217" href="#L2217">2217</a> key = (hasInternalVar ? formatNamed(key, m) : key);
+<a class="jxr_linenumber" name="L2218" href="#L2218">2218</a> hasInternalVar = false;
+<a class="jxr_linenumber" name="L2219" href="#L2219">2219</a> <em class="jxr_comment">// JUNEAU-248: Check if key exists in map by attempting to get it</em>
+<a class="jxr_linenumber" name="L2220" href="#L2220">2220</a> <em class="jxr_comment">// For regular maps: use containsKey() OR nn(get()) check</em>
+<a class="jxr_linenumber" name="L2221" href="#L2221">2221</a> <em class="jxr_comment">// For BeanMaps: get() returns non-null for accessible properties (including hidden ones)</em>
+<a class="jxr_linenumber" name="L2222" href="#L2222">2222</a> <strong class="jxr_keyword">var</strong> val = m.get(key);
+<a class="jxr_linenumber" name="L2223" href="#L2223">2223</a> <em class="jxr_comment">// Check if key actually exists: either containsKey is true, or val is non-null</em>
+<a class="jxr_linenumber" name="L2224" href="#L2224">2224</a> <em class="jxr_comment">// This handles both regular maps and BeanMaps correctly</em>
+<a class="jxr_linenumber" name="L2225" href="#L2225">2225</a> <strong class="jxr_keyword">var</strong> keyExists = m.containsKey(key) || nn(val);
+<a class="jxr_linenumber" name="L2226" href="#L2226">2226</a> <strong class="jxr_keyword">if</strong> (! keyExists)
+<a class="jxr_linenumber" name="L2227" href="#L2227">2227</a> out.append('{').append(key).append('}');
+<a class="jxr_linenumber" name="L2228" href="#L2228">2228</a> <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L2229" href="#L2229">2229</a> <strong class="jxr_keyword">if</strong> (val == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2230" href="#L2230">2230</a> val = <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L2231" href="#L2231">2231</a> <strong class="jxr_keyword">var</strong> v = r(val);
+<a class="jxr_linenumber" name="L2232" href="#L2232">2232</a> <em class="jxr_comment">// If the replacement also contains variables, replace them now.</em>
+<a class="jxr_linenumber" name="L2233" href="#L2233">2233</a> <strong class="jxr_keyword">if</strong> (v.indexOf('{') != -1)
+<a class="jxr_linenumber" name="L2234" href="#L2234">2234</a> v = formatNamed(v, m);
+<a class="jxr_linenumber" name="L2235" href="#L2235">2235</a> out.append(v);
+<a class="jxr_linenumber" name="L2236" href="#L2236">2236</a> }
+<a class="jxr_linenumber" name="L2237" href="#L2237">2237</a> state = S1;
+<a class="jxr_linenumber" name="L2238" href="#L2238">2238</a> }
+<a class="jxr_linenumber" name="L2239" href="#L2239">2239</a> }
+<a class="jxr_linenumber" name="L2240" href="#L2240">2240</a> }
+<a class="jxr_linenumber" name="L2241" href="#L2241">2241</a> }
+<a class="jxr_linenumber" name="L2242" href="#L2242">2242</a> <strong class="jxr_keyword">return</strong> out.toString();
+<a class="jxr_linenumber" name="L2243" href="#L2243">2243</a> }
+<a class="jxr_linenumber" name="L2244" href="#L2244">2244</a>
+<a class="jxr_linenumber" name="L2245" href="#L2245">2245</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2246" href="#L2246">2246</a> <em class="jxr_javadoccomment"> * Converts a hexadecimal character string to a byte array.</em>
+<a class="jxr_linenumber" name="L2247" href="#L2247">2247</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2248" href="#L2248">2248</a> <em class="jxr_javadoccomment"> * @param hex The string to convert to a byte array.</em>
+<a class="jxr_linenumber" name="L2249" href="#L2249">2249</a> <em class="jxr_javadoccomment"> * @return A new byte array.</em>
+<a class="jxr_linenumber" name="L2250" href="#L2250">2250</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2251" href="#L2251">2251</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] fromHex(String hex) {
+<a class="jxr_linenumber" name="L2252" href="#L2252">2252</a> <strong class="jxr_keyword">var</strong> buff = ByteBuffer.allocate(hex.length() / 2);
+<a class="jxr_linenumber" name="L2253" href="#L2253">2253</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < hex.length(); i += 2)
+<a class="jxr_linenumber" name="L2254" href="#L2254">2254</a> buff.put((byte)Integer.parseInt(hex.substring(i, i + 2), 16));
+<a class="jxr_linenumber" name="L2255" href="#L2255">2255</a> buff.rewind();
+<a class="jxr_linenumber" name="L2256" href="#L2256">2256</a> <strong class="jxr_keyword">return</strong> buff.array();
+<a class="jxr_linenumber" name="L2257" href="#L2257">2257</a> }
+<a class="jxr_linenumber" name="L2258" href="#L2258">2258</a>
+<a class="jxr_linenumber" name="L2259" href="#L2259">2259</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2260" href="#L2260">2260</a> <em class="jxr_javadoccomment"> * Converts a hexadecimal byte stream (e.g. "34A5BC") into a UTF-8 encoded string.</em>
+<a class="jxr_linenumber" name="L2261" href="#L2261">2261</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2262" href="#L2262">2262</a> <em class="jxr_javadoccomment"> * @param hex The hexadecimal string.</em>
+<a class="jxr_linenumber" name="L2263" href="#L2263">2263</a> <em class="jxr_javadoccomment"> * @return The UTF-8 string.</em>
+<a class="jxr_linenumber" name="L2264" href="#L2264">2264</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2265" href="#L2265">2265</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String fromHexToUTF8(String hex) {
+<a class="jxr_linenumber" name="L2266" href="#L2266">2266</a> <strong class="jxr_keyword">var</strong> buff = ByteBuffer.allocate(hex.length() / 2);
+<a class="jxr_linenumber" name="L2267" href="#L2267">2267</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < hex.length(); i += 2)
+<a class="jxr_linenumber" name="L2268" href="#L2268">2268</a> buff.put((byte)Integer.parseInt(hex.substring(i, i + 2), 16));
+<a class="jxr_linenumber" name="L2269" href="#L2269">2269</a> buff.rewind(); <em class="jxr_comment">// Fixes Java 11 issue.</em>
+<a class="jxr_linenumber" name="L2270" href="#L2270">2270</a> <strong class="jxr_keyword">return</strong> UTF_8.decode(buff).toString();
+<a class="jxr_linenumber" name="L2271" href="#L2271">2271</a> }
+<a class="jxr_linenumber" name="L2272" href="#L2272">2272</a>
+<a class="jxr_linenumber" name="L2273" href="#L2273">2273</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2274" href="#L2274">2274</a> <em class="jxr_javadoccomment"> * Same as {@link #fromHex(String)} except expects spaces between the byte strings.</em>
+<a class="jxr_linenumber" name="L2275" href="#L2275">2275</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2276" href="#L2276">2276</a> <em class="jxr_javadoccomment"> * @param hex The string to convert to a byte array.</em>
+<a class="jxr_linenumber" name="L2277" href="#L2277">2277</a> <em class="jxr_javadoccomment"> * @return A new byte array.</em>
+<a class="jxr_linenumber" name="L2278" href="#L2278">2278</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2279" href="#L2279">2279</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> byte[] fromSpacedHex(String hex) {
+<a class="jxr_linenumber" name="L2280" href="#L2280">2280</a> <strong class="jxr_keyword">var</strong> buff = ByteBuffer.allocate((hex.length() + 1) / 3);
+<a class="jxr_linenumber" name="L2281" href="#L2281">2281</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < hex.length(); i += 3)
+<a class="jxr_linenumber" name="L2282" href="#L2282">2282</a> buff.put((byte)Integer.parseInt(hex.substring(i, i + 2), 16));
+<a class="jxr_linenumber" name="L2283" href="#L2283">2283</a> buff.rewind();
+<a class="jxr_linenumber" name="L2284" href="#L2284">2284</a> <strong class="jxr_keyword">return</strong> buff.array();
+<a class="jxr_linenumber" name="L2285" href="#L2285">2285</a> }
+<a class="jxr_linenumber" name="L2286" href="#L2286">2286</a>
+<a class="jxr_linenumber" name="L2287" href="#L2287">2287</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2288" href="#L2288">2288</a> <em class="jxr_javadoccomment"> * Converts a space-deliminted hexadecimal byte stream (e.g. "34 A5 BC") into a UTF-8 encoded string.</em>
+<a class="jxr_linenumber" name="L2289" href="#L2289">2289</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2290" href="#L2290">2290</a> <em class="jxr_javadoccomment"> * @param hex The hexadecimal string.</em>
+<a class="jxr_linenumber" name="L2291" href="#L2291">2291</a> <em class="jxr_javadoccomment"> * @return The UTF-8 string.</em>
+<a class="jxr_linenumber" name="L2292" href="#L2292">2292</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2293" href="#L2293">2293</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String fromSpacedHexToUTF8(String hex) {
+<a class="jxr_linenumber" name="L2294" href="#L2294">2294</a> <strong class="jxr_keyword">var</strong> buff = ByteBuffer.allocate((hex.length() + 1) / 3);
+<a class="jxr_linenumber" name="L2295" href="#L2295">2295</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < hex.length(); i += 3)
+<a class="jxr_linenumber" name="L2296" href="#L2296">2296</a> buff.put((byte)Integer.parseInt(hex.substring(i, i + 2), 16));
+<a class="jxr_linenumber" name="L2297" href="#L2297">2297</a> buff.rewind(); <em class="jxr_comment">// Fixes Java 11 issue.</em>
+<a class="jxr_linenumber" name="L2298" href="#L2298">2298</a> <strong class="jxr_keyword">return</strong> UTF_8.decode(buff).toString();
+<a class="jxr_linenumber" name="L2299" href="#L2299">2299</a> }
+<a class="jxr_linenumber" name="L2300" href="#L2300">2300</a>
+<a class="jxr_linenumber" name="L2301" href="#L2301">2301</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2302" href="#L2302">2302</a> <em class="jxr_javadoccomment"> * Generates a random UUID string in standard format.</em>
+<a class="jxr_linenumber" name="L2303" href="#L2303">2303</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2304" href="#L2304">2304</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2305" href="#L2305">2305</a> <em class="jxr_javadoccomment"> * Returns a UUID in the format: <c>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</c></em>
+<a class="jxr_linenumber" name="L2306" href="#L2306">2306</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2307" href="#L2307">2307</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2308" href="#L2308">2308</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2309" href="#L2309">2309</a> <em class="jxr_javadoccomment"> * generateUUID(); <jc>// "550e8400-e29b-41d4-a716-446655440000"</jc></em>
+<a class="jxr_linenumber" name="L2310" href="#L2310">2310</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2311" href="#L2311">2311</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2312" href="#L2312">2312</a> <em class="jxr_javadoccomment"> * @return A new random UUID string.</em>
+<a class="jxr_linenumber" name="L2313" href="#L2313">2313</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2314" href="#L2314">2314</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String generateUUID() {
+<a class="jxr_linenumber" name="L2315" href="#L2315">2315</a> <strong class="jxr_keyword">return</strong> UUID.randomUUID().toString();
+<a class="jxr_linenumber" name="L2316" href="#L2316">2316</a> }
+<a class="jxr_linenumber" name="L2317" href="#L2317">2317</a>
+<a class="jxr_linenumber" name="L2318" href="#L2318">2318</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2319" href="#L2319">2319</a> <em class="jxr_javadoccomment"> * Given an absolute URI, returns just the authority portion (e.g. <js>"<a href="http://hostname:port" target="alexandria_uri">http://hostname:port</a>"</js>)</em>
+<a class="jxr_linenumber" name="L2320" href="#L2320">2320</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2321" href="#L2321">2321</a> <em class="jxr_javadoccomment"> * @param s The URI string.</em>
+<a class="jxr_linenumber" name="L2322" href="#L2322">2322</a> <em class="jxr_javadoccomment"> * @return Just the authority portion of the URI.</em>
+<a class="jxr_linenumber" name="L2323" href="#L2323">2323</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2324" href="#L2324">2324</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String getAuthorityUri(String s) { <em class="jxr_comment">// NOSONAR - False positive.</em>
+<a class="jxr_linenumber" name="L2325" href="#L2325">2325</a>
+<a class="jxr_linenumber" name="L2326" href="#L2326">2326</a> <em class="jxr_comment">// Use a state machine for maximum performance.</em>
+<a class="jxr_linenumber" name="L2327" href="#L2327">2327</a>
+<a class="jxr_linenumber" name="L2328" href="#L2328">2328</a> <em class="jxr_comment">// S1: Looking for http</em>
+<a class="jxr_linenumber" name="L2329" href="#L2329">2329</a> <em class="jxr_comment">// S2: Found http, looking for :</em>
+<a class="jxr_linenumber" name="L2330" href="#L2330">2330</a> <em class="jxr_comment">// S3: Found :, looking for /</em>
+<a class="jxr_linenumber" name="L2331" href="#L2331">2331</a> <em class="jxr_comment">// S4: Found /, looking for /</em>
+<a class="jxr_linenumber" name="L2332" href="#L2332">2332</a> <em class="jxr_comment">// S5: Found /, looking for x</em>
+<a class="jxr_linenumber" name="L2333" href="#L2333">2333</a> <em class="jxr_comment">// S6: Found x, looking for /</em>
+<a class="jxr_linenumber" name="L2334" href="#L2334">2334</a>
+<a class="jxr_linenumber" name="L2335" href="#L2335">2335</a> <strong class="jxr_keyword">var</strong> state = S1;
+<a class="jxr_linenumber" name="L2336" href="#L2336">2336</a>
+<a class="jxr_linenumber" name="L2337" href="#L2337">2337</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L2338" href="#L2338">2338</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L2339" href="#L2339">2339</a> <strong class="jxr_keyword">if</strong> (state == S1) {
+<a class="jxr_linenumber" name="L2340" href="#L2340">2340</a> <strong class="jxr_keyword">if</strong> (c >= 'a' && c <= 'z')
+<a class="jxr_linenumber" name="L2341" href="#L2341">2341</a> state = S2;
+<a class="jxr_linenumber" name="L2342" href="#L2342">2342</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2343" href="#L2343">2343</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L2344" href="#L2344">2344</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2) {
+<a class="jxr_linenumber" name="L2345" href="#L2345">2345</a> <strong class="jxr_keyword">if</strong> (c == ':')
+<a class="jxr_linenumber" name="L2346" href="#L2346">2346</a> state = S3;
+<a class="jxr_linenumber" name="L2347" href="#L2347">2347</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c < 'a' || c > 'z')
+<a class="jxr_linenumber" name="L2348" href="#L2348">2348</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L2349" href="#L2349">2349</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S3) { <em class="jxr_comment">// NOSONAR - False positive.</em>
+<a class="jxr_linenumber" name="L2350" href="#L2350">2350</a> <strong class="jxr_keyword">if</strong> (c == '/')
+<a class="jxr_linenumber" name="L2351" href="#L2351">2351</a> state = S4;
+<a class="jxr_linenumber" name="L2352" href="#L2352">2352</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2353" href="#L2353">2353</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L2354" href="#L2354">2354</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S4) {
+<a class="jxr_linenumber" name="L2355" href="#L2355">2355</a> <strong class="jxr_keyword">if</strong> (c == '/')
+<a class="jxr_linenumber" name="L2356" href="#L2356">2356</a> state = S5;
+<a class="jxr_linenumber" name="L2357" href="#L2357">2357</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2358" href="#L2358">2358</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L2359" href="#L2359">2359</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S5) {
+<a class="jxr_linenumber" name="L2360" href="#L2360">2360</a> <strong class="jxr_keyword">if</strong> (c != '/')
+<a class="jxr_linenumber" name="L2361" href="#L2361">2361</a> state = S6;
+<a class="jxr_linenumber" name="L2362" href="#L2362">2362</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2363" href="#L2363">2363</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L2364" href="#L2364">2364</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S6) {
+<a class="jxr_linenumber" name="L2365" href="#L2365">2365</a> <strong class="jxr_keyword">if</strong> (c == '/') <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L2366" href="#L2366">2366</a> <strong class="jxr_keyword">return</strong> s.substring(0, i);
+<a class="jxr_linenumber" name="L2367" href="#L2367">2367</a> }
+<a class="jxr_linenumber" name="L2368" href="#L2368">2368</a> }
+<a class="jxr_linenumber" name="L2369" href="#L2369">2369</a>
+<a class="jxr_linenumber" name="L2370" href="#L2370">2370</a> <strong class="jxr_keyword">return</strong> s;
+<a class="jxr_linenumber" name="L2371" href="#L2371">2371</a> }
+<a class="jxr_linenumber" name="L2372" href="#L2372">2372</a>
+<a class="jxr_linenumber" name="L2373" href="#L2373">2373</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2374" href="#L2374">2374</a> <em class="jxr_javadoccomment"> * Parses a duration string.</em>
+<a class="jxr_linenumber" name="L2375" href="#L2375">2375</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2376" href="#L2376">2376</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2377" href="#L2377">2377</a> <em class="jxr_javadoccomment"> * Supports simple duration formats:</em>
+<a class="jxr_linenumber" name="L2378" href="#L2378">2378</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2379" href="#L2379">2379</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Format Examples:</h5></em>
+<a class="jxr_linenumber" name="L2380" href="#L2380">2380</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L2381" href="#L2381">2381</a> <em class="jxr_javadoccomment"> * <li><js>"1000"</js> - 1000 milliseconds (no suffix)</em>
+<a class="jxr_linenumber" name="L2382" href="#L2382">2382</a> <em class="jxr_javadoccomment"> * <li><js>"10s"</js> - 10 seconds</em>
+<a class="jxr_linenumber" name="L2383" href="#L2383">2383</a> <em class="jxr_javadoccomment"> * <li><js>"10 sec"</js> - 10 seconds</em>
+<a class="jxr_linenumber" name="L2384" href="#L2384">2384</a> <em class="jxr_javadoccomment"> * <li><js>"10 seconds"</js> - 10 seconds</em>
+<a class="jxr_linenumber" name="L2385" href="#L2385">2385</a> <em class="jxr_javadoccomment"> * <li><js>"1.5h"</js> - 1.5 hours (5400000 ms)</em>
+<a class="jxr_linenumber" name="L2386" href="#L2386">2386</a> <em class="jxr_javadoccomment"> * <li><js>"1h30m"</js> - 1 hour 30 minutes (5400000 ms)</em>
+<a class="jxr_linenumber" name="L2387" href="#L2387">2387</a> <em class="jxr_javadoccomment"> * <li><js>"1h 30m"</js> - 1 hour 30 minutes (with spaces)</em>
+<a class="jxr_linenumber" name="L2388" href="#L2388">2388</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L2389" href="#L2389">2389</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2390" href="#L2390">2390</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Supported Units:</h5></em>
+<a class="jxr_linenumber" name="L2391" href="#L2391">2391</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L2392" href="#L2392">2392</a> <em class="jxr_javadoccomment"> * <li><b>Milliseconds:</b> <js>"ms"</js>, <js>"millis"</js>, <js>"milliseconds"</js> (or no suffix)</em>
+<a class="jxr_linenumber" name="L2393" href="#L2393">2393</a> <em class="jxr_javadoccomment"> * <li><b>Seconds:</b> <js>"s"</js>, <js>"sec"</js>, <js>"second"</js>, <js>"seconds"</js></em>
+<a class="jxr_linenumber" name="L2394" href="#L2394">2394</a> <em class="jxr_javadoccomment"> * <li><b>Minutes:</b> <js>"m"</js>, <js>"min"</js>, <js>"minute"</js>, <js>"minutes"</js></em>
+<a class="jxr_linenumber" name="L2395" href="#L2395">2395</a> <em class="jxr_javadoccomment"> * <li><b>Hours:</b> <js>"h"</js>, <js>"hour"</js>, <js>"hours"</js></em>
+<a class="jxr_linenumber" name="L2396" href="#L2396">2396</a> <em class="jxr_javadoccomment"> * <li><b>Days:</b> <js>"d"</js>, <js>"day"</js>, <js>"days"</js></em>
+<a class="jxr_linenumber" name="L2397" href="#L2397">2397</a> <em class="jxr_javadoccomment"> * <li><b>Weeks:</b> <js>"w"</js>, <js>"week"</js>, <js>"weeks"</js></em>
+<a class="jxr_linenumber" name="L2398" href="#L2398">2398</a> <em class="jxr_javadoccomment"> * <li><b>Months:</b> <js>"mo"</js>, <js>"month"</js>, <js>"months"</js> (30 days)</em>
+<a class="jxr_linenumber" name="L2399" href="#L2399">2399</a> <em class="jxr_javadoccomment"> * <li><b>Years:</b> <js>"y"</js>, <js>"yr"</js>, <js>"year"</js>, <js>"years"</js> (365 days)</em>
+<a class="jxr_linenumber" name="L2400" href="#L2400">2400</a> <em class="jxr_javadoccomment"> * </ul></em>
<a class="jxr_linenumber" name="L2401" href="#L2401">2401</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2402" href="#L2402">2402</a> <em class="jxr_javadoccomment"> * @param s The string to parse.</em>
-<a class="jxr_linenumber" name="L2403" href="#L2403">2403</a> <em class="jxr_javadoccomment"> * @return</em>
-<a class="jxr_linenumber" name="L2404" href="#L2404">2404</a> <em class="jxr_javadoccomment"> * The time in milliseconds, or <c>-1</c> if the string is empty or <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2405" href="#L2405">2405</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2406" href="#L2406">2406</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> getDuration(String s) {
-<a class="jxr_linenumber" name="L2407" href="#L2407">2407</a> s = trim(s);
-<a class="jxr_linenumber" name="L2408" href="#L2408">2408</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L2409" href="#L2409">2409</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L2410" href="#L2410">2410</a>
-<a class="jxr_linenumber" name="L2411" href="#L2411">2411</a> <em class="jxr_comment">// Parse simple format (number + unit or combined format)</em>
-<a class="jxr_linenumber" name="L2412" href="#L2412">2412</a> <strong class="jxr_keyword">var</strong> totalMs = 0L;
-<a class="jxr_linenumber" name="L2413" href="#L2413">2413</a> <strong class="jxr_keyword">var</strong> i = 0;
-<a class="jxr_linenumber" name="L2414" href="#L2414">2414</a> <strong class="jxr_keyword">var</strong> len = s.length();
-<a class="jxr_linenumber" name="L2415" href="#L2415">2415</a>
-<a class="jxr_linenumber" name="L2416" href="#L2416">2416</a> <strong class="jxr_keyword">while</strong> (i < len) {
-<a class="jxr_linenumber" name="L2417" href="#L2417">2417</a> <em class="jxr_comment">// Skip whitespace</em>
-<a class="jxr_linenumber" name="L2418" href="#L2418">2418</a> <strong class="jxr_keyword">while</strong> (i < len && Character.isWhitespace(s.charAt(i)))
-<a class="jxr_linenumber" name="L2419" href="#L2419">2419</a> i++;
-<a class="jxr_linenumber" name="L2420" href="#L2420">2420</a> <strong class="jxr_keyword">if</strong> (i >= len)
-<a class="jxr_linenumber" name="L2421" href="#L2421">2421</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L2422" href="#L2422">2422</a>
-<a class="jxr_linenumber" name="L2423" href="#L2423">2423</a> <em class="jxr_comment">// Parse number (including decimal)</em>
-<a class="jxr_linenumber" name="L2424" href="#L2424">2424</a> <strong class="jxr_keyword">var</strong> numStart = i;
-<a class="jxr_linenumber" name="L2425" href="#L2425">2425</a> <strong class="jxr_keyword">var</strong> hasDecimal = false;
-<a class="jxr_linenumber" name="L2426" href="#L2426">2426</a> <strong class="jxr_keyword">while</strong> (i < len) {
-<a class="jxr_linenumber" name="L2427" href="#L2427">2427</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L2428" href="#L2428">2428</a> <strong class="jxr_keyword">if</strong> (c >= '0' && c <= '9') {
-<a class="jxr_linenumber" name="L2429" href="#L2429">2429</a> i++;
-<a class="jxr_linenumber" name="L2430" href="#L2430">2430</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '.' && !hasDecimal) {
-<a class="jxr_linenumber" name="L2431" href="#L2431">2431</a> hasDecimal = <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L2432" href="#L2432">2432</a> i++;
-<a class="jxr_linenumber" name="L2433" href="#L2433">2433</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L2434" href="#L2434">2434</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L2435" href="#L2435">2435</a> }
-<a class="jxr_linenumber" name="L2436" href="#L2436">2436</a> }
-<a class="jxr_linenumber" name="L2437" href="#L2437">2437</a>
-<a class="jxr_linenumber" name="L2438" href="#L2438">2438</a> <strong class="jxr_keyword">if</strong> (i == numStart) {
-<a class="jxr_linenumber" name="L2439" href="#L2439">2439</a> <em class="jxr_comment">// No number found, invalid format</em>
-<a class="jxr_linenumber" name="L2440" href="#L2440">2440</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L2441" href="#L2441">2441</a> }
-<a class="jxr_linenumber" name="L2442" href="#L2442">2442</a>
-<a class="jxr_linenumber" name="L2443" href="#L2443">2443</a> <strong class="jxr_keyword">var</strong> numStr = s.substring(numStart, i).trim();
-<a class="jxr_linenumber" name="L2444" href="#L2444">2444</a> <strong class="jxr_keyword">var</strong> value = Double.parseDouble(numStr);
-<a class="jxr_linenumber" name="L2445" href="#L2445">2445</a>
-<a class="jxr_linenumber" name="L2446" href="#L2446">2446</a> <em class="jxr_comment">// Skip whitespace</em>
-<a class="jxr_linenumber" name="L2447" href="#L2447">2447</a> <strong class="jxr_keyword">while</strong> (i < len && Character.isWhitespace(s.charAt(i)))
-<a class="jxr_linenumber" name="L2448" href="#L2448">2448</a> i++;
-<a class="jxr_linenumber" name="L2449" href="#L2449">2449</a>
-<a class="jxr_linenumber" name="L2450" href="#L2450">2450</a> <em class="jxr_comment">// Parse unit (read all letters until we hit a digit or whitespace)</em>
-<a class="jxr_linenumber" name="L2451" href="#L2451">2451</a> <strong class="jxr_keyword">var</strong> unitStart = i;
-<a class="jxr_linenumber" name="L2452" href="#L2452">2452</a> <strong class="jxr_keyword">while</strong> (i < len && Character.isLetter(s.charAt(i)))
-<a class="jxr_linenumber" name="L2453" href="#L2453">2453</a> i++;
-<a class="jxr_linenumber" name="L2454" href="#L2454">2454</a> <strong class="jxr_keyword">var</strong> unit = s.substring(unitStart, i).trim().toLowerCase();
+<a class="jxr_linenumber" name="L2402" href="#L2402">2402</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2403" href="#L2403">2403</a> <em class="jxr_javadoccomment"> * Suffixes are case-insensitive.</em>
+<a class="jxr_linenumber" name="L2404" href="#L2404">2404</a> <em class="jxr_javadoccomment"> * <br>Whitespace is ignored.</em>
+<a class="jxr_linenumber" name="L2405" href="#L2405">2405</a> <em class="jxr_javadoccomment"> * <br>Decimal values are supported (e.g., <js>"1.5h"</js>).</em>
+<a class="jxr_linenumber" name="L2406" href="#L2406">2406</a> <em class="jxr_javadoccomment"> * <br>Combined formats are supported (e.g., <js>"1h30m"</js>).</em>
+<a class="jxr_linenumber" name="L2407" href="#L2407">2407</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2408" href="#L2408">2408</a> <em class="jxr_javadoccomment"> * @param s The string to parse.</em>
+<a class="jxr_linenumber" name="L2409" href="#L2409">2409</a> <em class="jxr_javadoccomment"> * @return</em>
+<a class="jxr_linenumber" name="L2410" href="#L2410">2410</a> <em class="jxr_javadoccomment"> * The time in milliseconds, or <c>-1</c> if the string is empty or <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2411" href="#L2411">2411</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2412" href="#L2412">2412</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> getDuration(String s) {
+<a class="jxr_linenumber" name="L2413" href="#L2413">2413</a> s = trim(s);
+<a class="jxr_linenumber" name="L2414" href="#L2414">2414</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L2415" href="#L2415">2415</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L2416" href="#L2416">2416</a>
+<a class="jxr_linenumber" name="L2417" href="#L2417">2417</a> <em class="jxr_comment">// Parse simple format (number + unit or combined format)</em>
+<a class="jxr_linenumber" name="L2418" href="#L2418">2418</a> <strong class="jxr_keyword">var</strong> totalMs = 0L;
+<a class="jxr_linenumber" name="L2419" href="#L2419">2419</a> <strong class="jxr_keyword">var</strong> i = 0;
+<a class="jxr_linenumber" name="L2420" href="#L2420">2420</a> <strong class="jxr_keyword">var</strong> len = s.length();
+<a class="jxr_linenumber" name="L2421" href="#L2421">2421</a>
+<a class="jxr_linenumber" name="L2422" href="#L2422">2422</a> <strong class="jxr_keyword">while</strong> (i < len) {
+<a class="jxr_linenumber" name="L2423" href="#L2423">2423</a> <em class="jxr_comment">// Skip whitespace</em>
+<a class="jxr_linenumber" name="L2424" href="#L2424">2424</a> <strong class="jxr_keyword">while</strong> (i < len && Character.isWhitespace(s.charAt(i)))
+<a class="jxr_linenumber" name="L2425" href="#L2425">2425</a> i++;
+<a class="jxr_linenumber" name="L2426" href="#L2426">2426</a> <strong class="jxr_keyword">if</strong> (i >= len)
+<a class="jxr_linenumber" name="L2427" href="#L2427">2427</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L2428" href="#L2428">2428</a>
+<a class="jxr_linenumber" name="L2429" href="#L2429">2429</a> <em class="jxr_comment">// Parse number (including decimal)</em>
+<a class="jxr_linenumber" name="L2430" href="#L2430">2430</a> <strong class="jxr_keyword">var</strong> numStart = i;
+<a class="jxr_linenumber" name="L2431" href="#L2431">2431</a> <strong class="jxr_keyword">var</strong> hasDecimal = false;
+<a class="jxr_linenumber" name="L2432" href="#L2432">2432</a> <strong class="jxr_keyword">while</strong> (i < len) {
+<a class="jxr_linenumber" name="L2433" href="#L2433">2433</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L2434" href="#L2434">2434</a> <strong class="jxr_keyword">if</strong> (c >= '0' && c <= '9') {
+<a class="jxr_linenumber" name="L2435" href="#L2435">2435</a> i++;
+<a class="jxr_linenumber" name="L2436" href="#L2436">2436</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '.' && !hasDecimal) {
+<a class="jxr_linenumber" name="L2437" href="#L2437">2437</a> hasDecimal = <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L2438" href="#L2438">2438</a> i++;
+<a class="jxr_linenumber" name="L2439" href="#L2439">2439</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L2440" href="#L2440">2440</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L2441" href="#L2441">2441</a> }
+<a class="jxr_linenumber" name="L2442" href="#L2442">2442</a> }
+<a class="jxr_linenumber" name="L2443" href="#L2443">2443</a>
+<a class="jxr_linenumber" name="L2444" href="#L2444">2444</a> <strong class="jxr_keyword">if</strong> (i == numStart) {
+<a class="jxr_linenumber" name="L2445" href="#L2445">2445</a> <em class="jxr_comment">// No number found, invalid format</em>
+<a class="jxr_linenumber" name="L2446" href="#L2446">2446</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L2447" href="#L2447">2447</a> }
+<a class="jxr_linenumber" name="L2448" href="#L2448">2448</a>
+<a class="jxr_linenumber" name="L2449" href="#L2449">2449</a> <strong class="jxr_keyword">var</strong> numStr = s.substring(numStart, i).trim();
+<a class="jxr_linenumber" name="L2450" href="#L2450">2450</a> <strong class="jxr_keyword">var</strong> value = Double.parseDouble(numStr);
+<a class="jxr_linenumber" name="L2451" href="#L2451">2451</a>
+<a class="jxr_linenumber" name="L2452" href="#L2452">2452</a> <em class="jxr_comment">// Skip whitespace</em>
+<a class="jxr_linenumber" name="L2453" href="#L2453">2453</a> <strong class="jxr_keyword">while</strong> (i < len && Character.isWhitespace(s.charAt(i)))
+<a class="jxr_linenumber" name="L2454" href="#L2454">2454</a> i++;
<a class="jxr_linenumber" name="L2455" href="#L2455">2455</a>
-<a class="jxr_linenumber" name="L2456" href="#L2456">2456</a> <em class="jxr_comment">// Convert to milliseconds</em>
-<a class="jxr_linenumber" name="L2457" href="#L2457">2457</a> <strong class="jxr_keyword">var</strong> ms = parseUnit(unit, value);
-<a class="jxr_linenumber" name="L2458" href="#L2458">2458</a> <strong class="jxr_keyword">if</strong> (ms < 0)
-<a class="jxr_linenumber" name="L2459" href="#L2459">2459</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L2460" href="#L2460">2460</a> totalMs += ms;
-<a class="jxr_linenumber" name="L2461" href="#L2461">2461</a> }
-<a class="jxr_linenumber" name="L2462" href="#L2462">2462</a>
-<a class="jxr_linenumber" name="L2463" href="#L2463">2463</a> <strong class="jxr_keyword">return</strong> totalMs;
-<a class="jxr_linenumber" name="L2464" href="#L2464">2464</a> }
-<a class="jxr_linenumber" name="L2465" href="#L2465">2465</a>
-<a class="jxr_linenumber" name="L2466" href="#L2466">2466</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2467" href="#L2467">2467</a> <em class="jxr_javadoccomment"> * Converts a string containing glob-style wildcard characters to a regular expression {@link java.util.regex.Pattern}.</em>
-<a class="jxr_linenumber" name="L2468" href="#L2468">2468</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2469" href="#L2469">2469</a> <em class="jxr_javadoccomment"> * <p>This method converts glob-style patterns to regular expressions with the following mappings:</em>
-<a class="jxr_linenumber" name="L2470" href="#L2470">2470</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L2471" href="#L2471">2471</a> <em class="jxr_javadoccomment"> * <li>{@code *} matches any sequence of characters (including none)</li></em>
-<a class="jxr_linenumber" name="L2472" href="#L2472">2472</a> <em class="jxr_javadoccomment"> * <li>{@code ?} matches exactly one character</li></em>
-<a class="jxr_linenumber" name="L2473" href="#L2473">2473</a> <em class="jxr_javadoccomment"> * <li>All other characters are treated literally</li></em>
-<a class="jxr_linenumber" name="L2474" href="#L2474">2474</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L2475" href="#L2475">2475</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2476" href="#L2476">2476</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2477" href="#L2477">2477</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2478" href="#L2478">2478</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>pattern</jv> = <jsm>getGlobMatchPattern</jsm>(<js>"user_*_temp"</js>);</em>
-<a class="jxr_linenumber" name="L2479" href="#L2479">2479</a> <em class="jxr_javadoccomment"> * <jk>boolean</jk> <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_alice_temp"</js>).matches(); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2480" href="#L2480">2480</a> <em class="jxr_javadoccomment"> * <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_bob_temp"</js>).matches(); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2481" href="#L2481">2481</a> <em class="jxr_javadoccomment"> * <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"admin_alice_temp"</js>).matches(); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2482" href="#L2482">2482</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2483" href="#L2483">2483</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2484" href="#L2484">2484</a> <em class="jxr_javadoccomment"> * @param s The glob-style wildcard pattern string.</em>
-<a class="jxr_linenumber" name="L2485" href="#L2485">2485</a> <em class="jxr_javadoccomment"> * @return A compiled {@link java.util.regex.Pattern} object, or <jk>null</jk> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2486" href="#L2486">2486</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2487" href="#L2487">2487</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> java.util.regex.Pattern getGlobMatchPattern(String s) {
-<a class="jxr_linenumber" name="L2488" href="#L2488">2488</a> <strong class="jxr_keyword">return</strong> getGlobMatchPattern(s, 0);
-<a class="jxr_linenumber" name="L2489" href="#L2489">2489</a> }
-<a class="jxr_linenumber" name="L2490" href="#L2490">2490</a>
-<a class="jxr_linenumber" name="L2491" href="#L2491">2491</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2492" href="#L2492">2492</a> <em class="jxr_javadoccomment"> * Converts a string containing glob-style wildcard characters to a regular expression {@link java.util.regex.Pattern} with flags.</em>
-<a class="jxr_linenumber" name="L2493" href="#L2493">2493</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2494" href="#L2494">2494</a> <em class="jxr_javadoccomment"> * <p>This method converts glob-style patterns to regular expressions with the following mappings:</em>
-<a class="jxr_linenumber" name="L2495" href="#L2495">2495</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L2496" href="#L2496">2496</a> <em class="jxr_javadoccomment"> * <li>{@code *} matches any sequence of characters (including none)</li></em>
-<a class="jxr_linenumber" name="L2497" href="#L2497">2497</a> <em class="jxr_javadoccomment"> * <li>{@code ?} matches exactly one character</li></em>
-<a class="jxr_linenumber" name="L2498" href="#L2498">2498</a> <em class="jxr_javadoccomment"> * <li>All other characters are treated literally</li></em>
-<a class="jxr_linenumber" name="L2499" href="#L2499">2499</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L2500" href="#L2500">2500</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2501" href="#L2501">2501</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2502" href="#L2502">2502</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2503" href="#L2503">2503</a> <em class="jxr_javadoccomment"> * <jc>// Case-insensitive matching</jc></em>
-<a class="jxr_linenumber" name="L2504" href="#L2504">2504</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>pattern</jv> = <jsm>getGlobMatchPattern</jsm>(<js>"USER_*"</js>, Pattern.<jsf>CASE_INSENSITIVE</jsf>);</em>
-<a class="jxr_linenumber" name="L2505" href="#L2505">2505</a> <em class="jxr_javadoccomment"> * <jk>boolean</jk> <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_alice"</js>).matches(); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2506" href="#L2506">2506</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2507" href="#L2507">2507</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2508" href="#L2508">2508</a> <em class="jxr_javadoccomment"> * @param s The glob-style wildcard pattern string.</em>
-<a class="jxr_linenumber" name="L2509" href="#L2509">2509</a> <em class="jxr_javadoccomment"> * @param flags Regular expression flags (see {@link java.util.regex.Pattern} constants).</em>
-<a class="jxr_linenumber" name="L2510" href="#L2510">2510</a> <em class="jxr_javadoccomment"> * @return A compiled {@link java.util.regex.Pattern} object, or <jk>null</jk> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2511" href="#L2511">2511</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2512" href="#L2512">2512</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> java.util.regex.Pattern getGlobMatchPattern(String s, <strong class="jxr_keyword">int</strong> flags) {
-<a class="jxr_linenumber" name="L2513" href="#L2513">2513</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2514" href="#L2514">2514</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L2515" href="#L2515">2515</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L2516" href="#L2516">2516</a> sb.append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L2517" href="#L2517">2517</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L2518" href="#L2518">2518</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L2519" href="#L2519">2519</a> <strong class="jxr_keyword">if</strong> (c == '*')
-<a class="jxr_linenumber" name="L2520" href="#L2520">2520</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">".*"</span>).append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L2521" href="#L2521">2521</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '?')
-<a class="jxr_linenumber" name="L2522" href="#L2522">2522</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">"."</span>).append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L2523" href="#L2523">2523</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2524" href="#L2524">2524</a> sb.append(c);
-<a class="jxr_linenumber" name="L2525" href="#L2525">2525</a> }
-<a class="jxr_linenumber" name="L2526" href="#L2526">2526</a> sb.append(<span class="jxr_string">"\\E"</span>);
-<a class="jxr_linenumber" name="L2527" href="#L2527">2527</a> <strong class="jxr_keyword">return</strong> java.util.regex.Pattern.compile(sb.toString(), flags);
-<a class="jxr_linenumber" name="L2528" href="#L2528">2528</a> }
-<a class="jxr_linenumber" name="L2529" href="#L2529">2529</a>
-<a class="jxr_linenumber" name="L2530" href="#L2530">2530</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2531" href="#L2531">2531</a> <em class="jxr_javadoccomment"> * Converts a string containing <js>"*"</js> meta characters with a regular expression pattern.</em>
-<a class="jxr_linenumber" name="L2532" href="#L2532">2532</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2533" href="#L2533">2533</a> <em class="jxr_javadoccomment"> * @param s The string to create a pattern from.</em>
-<a class="jxr_linenumber" name="L2534" href="#L2534">2534</a> <em class="jxr_javadoccomment"> * @return A regular expression pattern.</em>
-<a class="jxr_linenumber" name="L2535" href="#L2535">2535</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2536" href="#L2536">2536</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Pattern getMatchPattern(String s) {
-<a class="jxr_linenumber" name="L2537" href="#L2537">2537</a> <strong class="jxr_keyword">return</strong> getMatchPattern(s, 0);
-<a class="jxr_linenumber" name="L2538" href="#L2538">2538</a> }
-<a class="jxr_linenumber" name="L2539" href="#L2539">2539</a>
-<a class="jxr_linenumber" name="L2540" href="#L2540">2540</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2541" href="#L2541">2541</a> <em class="jxr_javadoccomment"> * Converts a string containing <js>"*"</js> meta characters with a regular expression pattern.</em>
-<a class="jxr_linenumber" name="L2542" href="#L2542">2542</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2543" href="#L2543">2543</a> <em class="jxr_javadoccomment"> * @param s The string to create a pattern from.</em>
-<a class="jxr_linenumber" name="L2544" href="#L2544">2544</a> <em class="jxr_javadoccomment"> * @param flags Regular expression flags.</em>
-<a class="jxr_linenumber" name="L2545" href="#L2545">2545</a> <em class="jxr_javadoccomment"> * @return A regular expression pattern.</em>
-<a class="jxr_linenumber" name="L2546" href="#L2546">2546</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2547" href="#L2547">2547</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Pattern getMatchPattern(String s, <strong class="jxr_keyword">int</strong> flags) {
-<a class="jxr_linenumber" name="L2548" href="#L2548">2548</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2549" href="#L2549">2549</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L2550" href="#L2550">2550</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L2551" href="#L2551">2551</a> sb.append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L2552" href="#L2552">2552</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L2553" href="#L2553">2553</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L2554" href="#L2554">2554</a> <strong class="jxr_keyword">if</strong> (c == '*')
-<a class="jxr_linenumber" name="L2555" href="#L2555">2555</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">".*"</span>).append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L2556" href="#L2556">2556</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '?')
-<a class="jxr_linenumber" name="L2557" href="#L2557">2557</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">"."</span>).append(<span class="jxr_string">"\\Q"</span>);
-<a class="jxr_linenumber" name="L2558" href="#L2558">2558</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2559" href="#L2559">2559</a> sb.append(c);
-<a class="jxr_linenumber" name="L2560" href="#L2560">2560</a> }
-<a class="jxr_linenumber" name="L2561" href="#L2561">2561</a> sb.append(<span class="jxr_string">"\\E"</span>);
-<a class="jxr_linenumber" name="L2562" href="#L2562">2562</a> <strong class="jxr_keyword">return</strong> Pattern.compile(sb.toString(), flags);
-<a class="jxr_linenumber" name="L2563" href="#L2563">2563</a> }
-<a class="jxr_linenumber" name="L2564" href="#L2564">2564</a>
-<a class="jxr_linenumber" name="L2565" href="#L2565">2565</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2566" href="#L2566">2566</a> <em class="jxr_javadoccomment"> * Takes in a string, splits it by lines, and then prepends each line with line numbers.</em>
-<a class="jxr_linenumber" name="L2567" href="#L2567">2567</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2568" href="#L2568">2568</a> <em class="jxr_javadoccomment"> * @param s The string.</em>
-<a class="jxr_linenumber" name="L2569" href="#L2569">2569</a> <em class="jxr_javadoccomment"> * @return The string with line numbers added.</em>
-<a class="jxr_linenumber" name="L2570" href="#L2570">2570</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2571" href="#L2571">2571</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String getNumberedLines(String s) {
-<a class="jxr_linenumber" name="L2572" href="#L2572">2572</a> <strong class="jxr_keyword">return</strong> getNumberedLines(s, 1, Integer.MAX_VALUE);
-<a class="jxr_linenumber" name="L2573" href="#L2573">2573</a> }
-<a class="jxr_linenumber" name="L2574" href="#L2574">2574</a>
-<a class="jxr_linenumber" name="L2575" href="#L2575">2575</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2576" href="#L2576">2576</a> <em class="jxr_javadoccomment"> * Same as {@link #getNumberedLines(String)} except only returns the specified lines.</em>
-<a class="jxr_linenumber" name="L2577" href="#L2577">2577</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2578" href="#L2578">2578</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2579" href="#L2579">2579</a> <em class="jxr_javadoccomment"> * Out-of-bounds values are allowed and fixed.</em>
-<a class="jxr_linenumber" name="L2580" href="#L2580">2580</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2581" href="#L2581">2581</a> <em class="jxr_javadoccomment"> * @param s The string.</em>
-<a class="jxr_linenumber" name="L2582" href="#L2582">2582</a> <em class="jxr_javadoccomment"> * @param start The starting line (1-indexed).</em>
-<a class="jxr_linenumber" name="L2583" href="#L2583">2583</a> <em class="jxr_javadoccomment"> * @param end The ending line (1-indexed).</em>
-<a class="jxr_linenumber" name="L2584" href="#L2584">2584</a> <em class="jxr_javadoccomment"> * @return The string with line numbers added.</em>
-<a class="jxr_linenumber" name="L2585" href="#L2585">2585</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2586" href="#L2586">2586</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String getNumberedLines(String s, <strong class="jxr_keyword">int</strong> start, <strong class="jxr_keyword">int</strong> end) {
-<a class="jxr_linenumber" name="L2587" href="#L2587">2587</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2588" href="#L2588">2588</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L2589" href="#L2589">2589</a> <strong class="jxr_keyword">var</strong> lines = s.split(<span class="jxr_string">"[\r\n]+"</span>);
-<a class="jxr_linenumber" name="L2590" href="#L2590">2590</a> <strong class="jxr_keyword">var</strong> digits = String.valueOf(lines.length).length();
-<a class="jxr_linenumber" name="L2591" href="#L2591">2591</a> <strong class="jxr_keyword">if</strong> (start < 1)
-<a class="jxr_linenumber" name="L2592" href="#L2592">2592</a> start = 1;
-<a class="jxr_linenumber" name="L2593" href="#L2593">2593</a> <strong class="jxr_keyword">if</strong> (end < 0)
-<a class="jxr_linenumber" name="L2594" href="#L2594">2594</a> end = Integer.MAX_VALUE;
-<a class="jxr_linenumber" name="L2595" href="#L2595">2595</a> <strong class="jxr_keyword">if</strong> (end > lines.length)
-<a class="jxr_linenumber" name="L2596" href="#L2596">2596</a> end = lines.length;
-<a class="jxr_linenumber" name="L2597" href="#L2597">2597</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L2598" href="#L2598">2598</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> l : l(lines).subList(start - 1, end))
-<a class="jxr_linenumber" name="L2599" href="#L2599">2599</a> sb.append(String.format(<span class="jxr_string">"%0"</span> + digits + <span class="jxr_string">"d"</span>, start++)).append(<span class="jxr_string">": "</span>).append(l).append(<span class="jxr_string">"\n"</span>); <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L2600" href="#L2600">2600</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L2601" href="#L2601">2601</a> }
-<a class="jxr_linenumber" name="L2602" href="#L2602">2602</a>
-<a class="jxr_linenumber" name="L2603" href="#L2603">2603</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2604" href="#L2604">2604</a> <em class="jxr_javadoccomment"> * Calculates the approximate memory size of a string in bytes.</em>
-<a class="jxr_linenumber" name="L2605" href="#L2605">2605</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2606" href="#L2606">2606</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2607" href="#L2607">2607</a> <em class="jxr_javadoccomment"> * Returns <c>0</c> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2608" href="#L2608">2608</a> <em class="jxr_javadoccomment"> * This method provides an estimate based on typical JVM object layout:</em>
-<a class="jxr_linenumber" name="L2609" href="#L2609">2609</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L2610" href="#L2610">2610</a> <em class="jxr_javadoccomment"> * <li>String object overhead: ~24 bytes (object header + fields)</li></em>
-<a class="jxr_linenumber" name="L2611" href="#L2611">2611</a> <em class="jxr_javadoccomment"> * <li>char[] array overhead: ~16 bytes (array header)</li></em>
-<a class="jxr_linenumber" name="L2612" href="#L2612">2612</a> <em class="jxr_javadoccomment"> * <li>Character data: 2 bytes per character</li></em>
-<a class="jxr_linenumber" name="L2613" href="#L2613">2613</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L2614" href="#L2614">2614</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2615" href="#L2615">2615</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2616" href="#L2616">2616</a> <em class="jxr_javadoccomment"> * <b>Note:</b> Actual memory usage may vary based on JVM implementation, object alignment,</em>
-<a class="jxr_linenumber" name="L2617" href="#L2617">2617</a> <em class="jxr_javadoccomment"> * and whether compressed OOPs are enabled. This is an approximation for informational purposes.</em>
-<a class="jxr_linenumber" name="L2618" href="#L2618">2618</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2619" href="#L2619">2619</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L2620" href="#L2620">2620</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2621" href="#L2621">2621</a> <em class="jxr_javadoccomment"> * getStringSize(<jk>null</jk>); <jc>// Returns: 0</jc></em>
-<a class="jxr_linenumber" name="L2622" href="#L2622">2622</a> <em class="jxr_javadoccomment"> * getStringSize(<js>""</js>); <jc>// Returns: ~40 bytes</jc></em>
-<a class="jxr_linenumber" name="L2623" href="#L2623">2623</a> <em class="jxr_javadoccomment"> * getStringSize(<js>"hello"</js>); <jc>// Returns: ~50 bytes (40 + 10)</jc></em>
-<a class="jxr_linenumber" name="L2624" href="#L2624">2624</a> <em class="jxr_javadoccomment"> * getStringSize(<js>"test"</js>); <jc>// Returns: ~48 bytes (40 + 8)</jc></em>
-<a class="jxr_linenumber" name="L2625" href="#L2625">2625</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2626" href="#L2626">2626</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2627" href="#L2627">2627</a> <em class="jxr_javadoccomment"> * @param str The string to measure. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2628" href="#L2628">2628</a> <em class="jxr_javadoccomment"> * @return The approximate memory size in bytes, or <c>0</c> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2629" href="#L2629">2629</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2630" href="#L2630">2630</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> getStringSize(String str) {
-<a class="jxr_linenumber" name="L2631" href="#L2631">2631</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2632" href="#L2632">2632</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L2633" href="#L2633">2633</a> <em class="jxr_comment">// String object overhead: ~24 bytes (object header + fields: value, hash, coder)</em>
-<a class="jxr_linenumber" name="L2634" href="#L2634">2634</a> <em class="jxr_comment">// char[] array overhead: ~16 bytes (array header)</em>
-<a class="jxr_linenumber" name="L2635" href="#L2635">2635</a> <em class="jxr_comment">// Character data: 2 bytes per character</em>
-<a class="jxr_linenumber" name="L2636" href="#L2636">2636</a> <strong class="jxr_keyword">return</strong> 24L + 16L + (2L * str.length());
-<a class="jxr_linenumber" name="L2637" href="#L2637">2637</a> }
-<a class="jxr_linenumber" name="L2638" href="#L2638">2638</a>
-<a class="jxr_linenumber" name="L2639" href="#L2639">2639</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2640" href="#L2640">2640</a> <em class="jxr_javadoccomment"> * Checks if a string has text (not null, not empty, and contains at least one non-whitespace character).</em>
-<a class="jxr_linenumber" name="L2641" href="#L2641">2641</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2642" href="#L2642">2642</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2643" href="#L2643">2643</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2644" href="#L2644">2644</a> <em class="jxr_javadoccomment"> * hasText(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2645" href="#L2645">2645</a> <em class="jxr_javadoccomment"> * hasText(<js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2646" href="#L2646">2646</a> <em class="jxr_javadoccomment"> * hasText(<js>" "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2647" href="#L2647">2647</a> <em class="jxr_javadoccomment"> * hasText(<js>"hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2648" href="#L2648">2648</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2649" href="#L2649">2649</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2650" href="#L2650">2650</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L2651" href="#L2651">2651</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains at least one non-whitespace character.</em>
-<a class="jxr_linenumber" name="L2652" href="#L2652">2652</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2653" href="#L2653">2653</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> hasText(String str) {
-<a class="jxr_linenumber" name="L2654" href="#L2654">2654</a> <strong class="jxr_keyword">return</strong> isNotBlank(str);
-<a class="jxr_linenumber" name="L2655" href="#L2655">2655</a> }
-<a class="jxr_linenumber" name="L2656" href="#L2656">2656</a>
-<a class="jxr_linenumber" name="L2657" href="#L2657">2657</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2658" href="#L2658">2658</a> <em class="jxr_javadoccomment"> * Same as {@link String#indexOf(int)} except allows you to check for multiple characters.</em>
-<a class="jxr_linenumber" name="L2659" href="#L2659">2659</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2660" href="#L2660">2660</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L2661" href="#L2661">2661</a> <em class="jxr_javadoccomment"> * @param c The characters to check for.</em>
-<a class="jxr_linenumber" name="L2662" href="#L2662">2662</a> <em class="jxr_javadoccomment"> * @return The index into the string that is one of the specified characters.</em>
-<a class="jxr_linenumber" name="L2663" href="#L2663">2663</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2664" href="#L2664">2664</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> indexOf(String s, <strong class="jxr_keyword">char</strong>...c) {
-<a class="jxr_linenumber" name="L2665" href="#L2665">2665</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2666" href="#L2666">2666</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L2667" href="#L2667">2667</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L2668" href="#L2668">2668</a> <strong class="jxr_keyword">var</strong> c2 = s.charAt(i);
-<a class="jxr_linenumber" name="L2669" href="#L2669">2669</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> cc : c)
-<a class="jxr_linenumber" name="L2670" href="#L2670">2670</a> <strong class="jxr_keyword">if</strong> (c2 == cc)
-<a class="jxr_linenumber" name="L2671" href="#L2671">2671</a> <strong class="jxr_keyword">return</strong> i;
-<a class="jxr_linenumber" name="L2672" href="#L2672">2672</a> }
-<a class="jxr_linenumber" name="L2673" href="#L2673">2673</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L2674" href="#L2674">2674</a> }
-<a class="jxr_linenumber" name="L2675" href="#L2675">2675</a>
-<a class="jxr_linenumber" name="L2676" href="#L2676">2676</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2677" href="#L2677">2677</a> <em class="jxr_javadoccomment"> * Finds the index of the first occurrence of a substring within a string.</em>
-<a class="jxr_linenumber" name="L2678" href="#L2678">2678</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2679" href="#L2679">2679</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2680" href="#L2680">2680</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2681" href="#L2681">2681</a> <em class="jxr_javadoccomment"> * indexOf(<js>"hello world"</js>, <js>"world"</js>); <jc>// 6</jc></em>
-<a class="jxr_linenumber" name="L2682" href="#L2682">2682</a> <em class="jxr_javadoccomment"> * indexOf(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// -1</jc></em>
-<a class="jxr_linenumber" name="L2683" href="#L2683">2683</a> <em class="jxr_javadoccomment"> * indexOf(<jk>null</jk>, <js>"test"</js>); <jc>// -1</jc></em>
-<a class="jxr_linenumber" name="L2684" href="#L2684">2684</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2685" href="#L2685">2685</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2686" href="#L2686">2686</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
-<a class="jxr_linenumber" name="L2687" href="#L2687">2687</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
-<a class="jxr_linenumber" name="L2688" href="#L2688">2688</a> <em class="jxr_javadoccomment"> * @return The index of the first occurrence, or <c>-1</c> if not found or if either parameter is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2689" href="#L2689">2689</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2690" href="#L2690">2690</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> indexOf(String str, String search) {
-<a class="jxr_linenumber" name="L2691" href="#L2691">2691</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2692" href="#L2692">2692</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L2693" href="#L2693">2693</a> <strong class="jxr_keyword">return</strong> str.indexOf(search);
-<a class="jxr_linenumber" name="L2694" href="#L2694">2694</a> }
-<a class="jxr_linenumber" name="L2695" href="#L2695">2695</a>
-<a class="jxr_linenumber" name="L2696" href="#L2696">2696</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2697" href="#L2697">2697</a> <em class="jxr_javadoccomment"> * Finds the index of the first occurrence of a substring within a string, ignoring case.</em>
-<a class="jxr_linenumber" name="L2698" href="#L2698">2698</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2699" href="#L2699">2699</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2700" href="#L2700">2700</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2701" href="#L2701">2701</a> <em class="jxr_javadoccomment"> * indexOfIgnoreCase(<js>"Hello World"</js>, <js>"world"</js>); <jc>// 6</jc></em>
-<a class="jxr_linenumber" name="L2702" href="#L2702">2702</a> <em class="jxr_javadoccomment"> * indexOfIgnoreCase(<js>"Hello World"</js>, <js>"WORLD"</js>); <jc>// 6</jc></em>
-<a class="jxr_linenumber" name="L2703" href="#L2703">2703</a> <em class="jxr_javadoccomment"> * indexOfIgnoreCase(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// -1</jc></em>
-<a class="jxr_linenumber" name="L2704" href="#L2704">2704</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2705" href="#L2705">2705</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2706" href="#L2706">2706</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
-<a class="jxr_linenumber" name="L2707" href="#L2707">2707</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
-<a class="jxr_linenumber" name="L2708" href="#L2708">2708</a> <em class="jxr_javadoccomment"> * @return The index of the first occurrence, or <c>-1</c> if not found or if either parameter is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2709" href="#L2709">2709</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2710" href="#L2710">2710</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> indexOfIgnoreCase(String str, String search) {
-<a class="jxr_linenumber" name="L2711" href="#L2711">2711</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2712" href="#L2712">2712</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L2713" href="#L2713">2713</a> <strong class="jxr_keyword">return</strong> str.toLowerCase().indexOf(search.toLowerCase());
-<a class="jxr_linenumber" name="L2714" href="#L2714">2714</a> }
-<a class="jxr_linenumber" name="L2715" href="#L2715">2715</a>
-<a class="jxr_linenumber" name="L2716" href="#L2716">2716</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2717" href="#L2717">2717</a> <em class="jxr_javadoccomment"> * Interns a string, returning the canonical representation.</em>
-<a class="jxr_linenumber" name="L2718" href="#L2718">2718</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2719" href="#L2719">2719</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2720" href="#L2720">2720</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2721" href="#L2721">2721</a> <em class="jxr_javadoccomment"> * This method provides a null-safe wrapper around {@link String#intern()}.</em>
-<a class="jxr_linenumber" name="L2722" href="#L2722">2722</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2723" href="#L2723">2723</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L2724" href="#L2724">2724</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2725" href="#L2725">2725</a> <em class="jxr_javadoccomment"> * String <jv>s1</jv> = <jk>new</jk> String(<js>"test"</js>);</em>
-<a class="jxr_linenumber" name="L2726" href="#L2726">2726</a> <em class="jxr_javadoccomment"> * String <jv>s2</jv> = <jk>new</jk> String(<js>"test"</js>);</em>
-<a class="jxr_linenumber" name="L2727" href="#L2727">2727</a> <em class="jxr_javadoccomment"> * assertTrue(<jv>s1</jv> != <jv>s2</jv>); <jc>// Different objects</jc></em>
+<a class="jxr_linenumber" name="L2456" href="#L2456">2456</a> <em class="jxr_comment">// Parse unit (read all letters until we hit a digit or whitespace)</em>
+<a class="jxr_linenumber" name="L2457" href="#L2457">2457</a> <strong class="jxr_keyword">var</strong> unitStart = i;
+<a class="jxr_linenumber" name="L2458" href="#L2458">2458</a> <strong class="jxr_keyword">while</strong> (i < len && Character.isLetter(s.charAt(i)))
+<a class="jxr_linenumber" name="L2459" href="#L2459">2459</a> i++;
+<a class="jxr_linenumber" name="L2460" href="#L2460">2460</a> <strong class="jxr_keyword">var</strong> unit = s.substring(unitStart, i).trim().toLowerCase();
+<a class="jxr_linenumber" name="L2461" href="#L2461">2461</a>
+<a class="jxr_linenumber" name="L2462" href="#L2462">2462</a> <em class="jxr_comment">// Convert to milliseconds</em>
+<a class="jxr_linenumber" name="L2463" href="#L2463">2463</a> <strong class="jxr_keyword">var</strong> ms = parseUnit(unit, value);
+<a class="jxr_linenumber" name="L2464" href="#L2464">2464</a> <strong class="jxr_keyword">if</strong> (ms < 0)
+<a class="jxr_linenumber" name="L2465" href="#L2465">2465</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L2466" href="#L2466">2466</a> totalMs += ms;
+<a class="jxr_linenumber" name="L2467" href="#L2467">2467</a> }
+<a class="jxr_linenumber" name="L2468" href="#L2468">2468</a>
+<a class="jxr_linenumber" name="L2469" href="#L2469">2469</a> <strong class="jxr_keyword">return</strong> totalMs;
+<a class="jxr_linenumber" name="L2470" href="#L2470">2470</a> }
+<a class="jxr_linenumber" name="L2471" href="#L2471">2471</a>
+<a class="jxr_linenumber" name="L2472" href="#L2472">2472</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2473" href="#L2473">2473</a> <em class="jxr_javadoccomment"> * Converts a string containing glob-style wildcard characters to a regular expression {@link java.util.regex.Pattern}.</em>
+<a class="jxr_linenumber" name="L2474" href="#L2474">2474</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2475" href="#L2475">2475</a> <em class="jxr_javadoccomment"> * <p>This method converts glob-style patterns to regular expressions with the following mappings:</em>
+<a class="jxr_linenumber" name="L2476" href="#L2476">2476</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L2477" href="#L2477">2477</a> <em class="jxr_javadoccomment"> * <li>{@code *} matches any sequence of characters (including none)</li></em>
+<a class="jxr_linenumber" name="L2478" href="#L2478">2478</a> <em class="jxr_javadoccomment"> * <li>{@code ?} matches exactly one character</li></em>
+<a class="jxr_linenumber" name="L2479" href="#L2479">2479</a> <em class="jxr_javadoccomment"> * <li>All other characters are treated literally</li></em>
+<a class="jxr_linenumber" name="L2480" href="#L2480">2480</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L2481" href="#L2481">2481</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2482" href="#L2482">2482</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2483" href="#L2483">2483</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2484" href="#L2484">2484</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>pattern</jv> = <jsm>getGlobMatchPattern</jsm>(<js>"user_*_temp"</js>);</em>
+<a class="jxr_linenumber" name="L2485" href="#L2485">2485</a> <em class="jxr_javadoccomment"> * <jk>boolean</jk> <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_alice_temp"</js>).matches(); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2486" href="#L2486">2486</a> <em class="jxr_javadoccomment"> * <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_bob_temp"</js>).matches(); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2487" href="#L2487">2487</a> <em class="jxr_javadoccomment"> * <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"admin_alice_temp"</js>).matches(); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2488" href="#L2488">2488</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2489" href="#L2489">2489</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2490" href="#L2490">2490</a> <em class="jxr_javadoccomment"> * @param s The glob-style wildcard pattern string.</em>
+<a class="jxr_linenumber" name="L2491" href="#L2491">2491</a> <em class="jxr_javadoccomment"> * @return A compiled {@link java.util.regex.Pattern} object, or <jk>null</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2492" href="#L2492">2492</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2493" href="#L2493">2493</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> java.util.regex.Pattern getGlobMatchPattern(String s) {
+<a class="jxr_linenumber" name="L2494" href="#L2494">2494</a> <strong class="jxr_keyword">return</strong> getGlobMatchPattern(s, 0);
+<a class="jxr_linenumber" name="L2495" href="#L2495">2495</a> }
+<a class="jxr_linenumber" name="L2496" href="#L2496">2496</a>
+<a class="jxr_linenumber" name="L2497" href="#L2497">2497</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2498" href="#L2498">2498</a> <em class="jxr_javadoccomment"> * Converts a string containing glob-style wildcard characters to a regular expression {@link java.util.regex.Pattern} with flags.</em>
+<a class="jxr_linenumber" name="L2499" href="#L2499">2499</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2500" href="#L2500">2500</a> <em class="jxr_javadoccomment"> * <p>This method converts glob-style patterns to regular expressions with the following mappings:</em>
+<a class="jxr_linenumber" name="L2501" href="#L2501">2501</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L2502" href="#L2502">2502</a> <em class="jxr_javadoccomment"> * <li>{@code *} matches any sequence of characters (including none)</li></em>
+<a class="jxr_linenumber" name="L2503" href="#L2503">2503</a> <em class="jxr_javadoccomment"> * <li>{@code ?} matches exactly one character</li></em>
+<a class="jxr_linenumber" name="L2504" href="#L2504">2504</a> <em class="jxr_javadoccomment"> * <li>All other characters are treated literally</li></em>
+<a class="jxr_linenumber" name="L2505" href="#L2505">2505</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L2506" href="#L2506">2506</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2507" href="#L2507">2507</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2508" href="#L2508">2508</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2509" href="#L2509">2509</a> <em class="jxr_javadoccomment"> * <jc>// Case-insensitive matching</jc></em>
+<a class="jxr_linenumber" name="L2510" href="#L2510">2510</a> <em class="jxr_javadoccomment"> * <jk>var</jk> <jv>pattern</jv> = <jsm>getGlobMatchPattern</jsm>(<js>"USER_*"</js>, Pattern.<jsf>CASE_INSENSITIVE</jsf>);</em>
+<a class="jxr_linenumber" name="L2511" href="#L2511">2511</a> <em class="jxr_javadoccomment"> * <jk>boolean</jk> <jv>matches</jv> = <jv>pattern</jv>.matcher(<js>"user_alice"</js>).matches(); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2512" href="#L2512">2512</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2513" href="#L2513">2513</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2514" href="#L2514">2514</a> <em class="jxr_javadoccomment"> * @param s The glob-style wildcard pattern string.</em>
+<a class="jxr_linenumber" name="L2515" href="#L2515">2515</a> <em class="jxr_javadoccomment"> * @param flags Regular expression flags (see {@link java.util.regex.Pattern} constants).</em>
+<a class="jxr_linenumber" name="L2516" href="#L2516">2516</a> <em class="jxr_javadoccomment"> * @return A compiled {@link java.util.regex.Pattern} object, or <jk>null</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2517" href="#L2517">2517</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2518" href="#L2518">2518</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> java.util.regex.Pattern getGlobMatchPattern(String s, <strong class="jxr_keyword">int</strong> flags) {
+<a class="jxr_linenumber" name="L2519" href="#L2519">2519</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2520" href="#L2520">2520</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L2521" href="#L2521">2521</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L2522" href="#L2522">2522</a> sb.append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L2523" href="#L2523">2523</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L2524" href="#L2524">2524</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L2525" href="#L2525">2525</a> <strong class="jxr_keyword">if</strong> (c == '*')
+<a class="jxr_linenumber" name="L2526" href="#L2526">2526</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">".*"</span>).append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L2527" href="#L2527">2527</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '?')
+<a class="jxr_linenumber" name="L2528" href="#L2528">2528</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">"."</span>).append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L2529" href="#L2529">2529</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2530" href="#L2530">2530</a> sb.append(c);
+<a class="jxr_linenumber" name="L2531" href="#L2531">2531</a> }
+<a class="jxr_linenumber" name="L2532" href="#L2532">2532</a> sb.append(<span class="jxr_string">"\\E"</span>);
+<a class="jxr_linenumber" name="L2533" href="#L2533">2533</a> <strong class="jxr_keyword">return</strong> java.util.regex.Pattern.compile(sb.toString(), flags);
+<a class="jxr_linenumber" name="L2534" href="#L2534">2534</a> }
+<a class="jxr_linenumber" name="L2535" href="#L2535">2535</a>
+<a class="jxr_linenumber" name="L2536" href="#L2536">2536</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2537" href="#L2537">2537</a> <em class="jxr_javadoccomment"> * Converts a string containing <js>"*"</js> meta characters with a regular expression pattern.</em>
+<a class="jxr_linenumber" name="L2538" href="#L2538">2538</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2539" href="#L2539">2539</a> <em class="jxr_javadoccomment"> * @param s The string to create a pattern from.</em>
+<a class="jxr_linenumber" name="L2540" href="#L2540">2540</a> <em class="jxr_javadoccomment"> * @return A regular expression pattern.</em>
+<a class="jxr_linenumber" name="L2541" href="#L2541">2541</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2542" href="#L2542">2542</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Pattern getMatchPattern(String s) {
+<a class="jxr_linenumber" name="L2543" href="#L2543">2543</a> <strong class="jxr_keyword">return</strong> getMatchPattern(s, 0);
+<a class="jxr_linenumber" name="L2544" href="#L2544">2544</a> }
+<a class="jxr_linenumber" name="L2545" href="#L2545">2545</a>
+<a class="jxr_linenumber" name="L2546" href="#L2546">2546</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2547" href="#L2547">2547</a> <em class="jxr_javadoccomment"> * Converts a string containing <js>"*"</js> meta characters with a regular expression pattern.</em>
+<a class="jxr_linenumber" name="L2548" href="#L2548">2548</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2549" href="#L2549">2549</a> <em class="jxr_javadoccomment"> * @param s The string to create a pattern from.</em>
+<a class="jxr_linenumber" name="L2550" href="#L2550">2550</a> <em class="jxr_javadoccomment"> * @param flags Regular expression flags.</em>
+<a class="jxr_linenumber" name="L2551" href="#L2551">2551</a> <em class="jxr_javadoccomment"> * @return A regular expression pattern.</em>
+<a class="jxr_linenumber" name="L2552" href="#L2552">2552</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2553" href="#L2553">2553</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Pattern getMatchPattern(String s, <strong class="jxr_keyword">int</strong> flags) {
+<a class="jxr_linenumber" name="L2554" href="#L2554">2554</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2555" href="#L2555">2555</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L2556" href="#L2556">2556</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L2557" href="#L2557">2557</a> sb.append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L2558" href="#L2558">2558</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L2559" href="#L2559">2559</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L2560" href="#L2560">2560</a> <strong class="jxr_keyword">if</strong> (c == '*')
+<a class="jxr_linenumber" name="L2561" href="#L2561">2561</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">".*"</span>).append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L2562" href="#L2562">2562</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '?')
+<a class="jxr_linenumber" name="L2563" href="#L2563">2563</a> sb.append(<span class="jxr_string">"\\E"</span>).append(<span class="jxr_string">"."</span>).append(<span class="jxr_string">"\\Q"</span>);
+<a class="jxr_linenumber" name="L2564" href="#L2564">2564</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2565" href="#L2565">2565</a> sb.append(c);
+<a class="jxr_linenumber" name="L2566" href="#L2566">2566</a> }
+<a class="jxr_linenumber" name="L2567" href="#L2567">2567</a> sb.append(<span class="jxr_string">"\\E"</span>);
+<a class="jxr_linenumber" name="L2568" href="#L2568">2568</a> <strong class="jxr_keyword">return</strong> Pattern.compile(sb.toString(), flags);
+<a class="jxr_linenumber" name="L2569" href="#L2569">2569</a> }
+<a class="jxr_linenumber" name="L2570" href="#L2570">2570</a>
+<a class="jxr_linenumber" name="L2571" href="#L2571">2571</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2572" href="#L2572">2572</a> <em class="jxr_javadoccomment"> * Takes in a string, splits it by lines, and then prepends each line with line numbers.</em>
+<a class="jxr_linenumber" name="L2573" href="#L2573">2573</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2574" href="#L2574">2574</a> <em class="jxr_javadoccomment"> * @param s The string.</em>
+<a class="jxr_linenumber" name="L2575" href="#L2575">2575</a> <em class="jxr_javadoccomment"> * @return The string with line numbers added.</em>
+<a class="jxr_linenumber" name="L2576" href="#L2576">2576</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2577" href="#L2577">2577</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String getNumberedLines(String s) {
+<a class="jxr_linenumber" name="L2578" href="#L2578">2578</a> <strong class="jxr_keyword">return</strong> getNumberedLines(s, 1, Integer.MAX_VALUE);
+<a class="jxr_linenumber" name="L2579" href="#L2579">2579</a> }
+<a class="jxr_linenumber" name="L2580" href="#L2580">2580</a>
+<a class="jxr_linenumber" name="L2581" href="#L2581">2581</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2582" href="#L2582">2582</a> <em class="jxr_javadoccomment"> * Same as {@link #getNumberedLines(String)} except only returns the specified lines.</em>
+<a class="jxr_linenumber" name="L2583" href="#L2583">2583</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2584" href="#L2584">2584</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2585" href="#L2585">2585</a> <em class="jxr_javadoccomment"> * Out-of-bounds values are allowed and fixed.</em>
+<a class="jxr_linenumber" name="L2586" href="#L2586">2586</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2587" href="#L2587">2587</a> <em class="jxr_javadoccomment"> * @param s The string.</em>
+<a class="jxr_linenumber" name="L2588" href="#L2588">2588</a> <em class="jxr_javadoccomment"> * @param start The starting line (1-indexed).</em>
+<a class="jxr_linenumber" name="L2589" href="#L2589">2589</a> <em class="jxr_javadoccomment"> * @param end The ending line (1-indexed).</em>
+<a class="jxr_linenumber" name="L2590" href="#L2590">2590</a> <em class="jxr_javadoccomment"> * @return The string with line numbers added.</em>
+<a class="jxr_linenumber" name="L2591" href="#L2591">2591</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2592" href="#L2592">2592</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String getNumberedLines(String s, <strong class="jxr_keyword">int</strong> start, <strong class="jxr_keyword">int</strong> end) {
+<a class="jxr_linenumber" name="L2593" href="#L2593">2593</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2594" href="#L2594">2594</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L2595" href="#L2595">2595</a> <strong class="jxr_keyword">var</strong> lines = s.split(<span class="jxr_string">"[\r\n]+"</span>);
+<a class="jxr_linenumber" name="L2596" href="#L2596">2596</a> <strong class="jxr_keyword">var</strong> digits = String.valueOf(lines.length).length();
+<a class="jxr_linenumber" name="L2597" href="#L2597">2597</a> <strong class="jxr_keyword">if</strong> (start < 1)
+<a class="jxr_linenumber" name="L2598" href="#L2598">2598</a> start = 1;
+<a class="jxr_linenumber" name="L2599" href="#L2599">2599</a> <strong class="jxr_keyword">if</strong> (end < 0)
+<a class="jxr_linenumber" name="L2600" href="#L2600">2600</a> end = Integer.MAX_VALUE;
+<a class="jxr_linenumber" name="L2601" href="#L2601">2601</a> <strong class="jxr_keyword">if</strong> (end > lines.length)
+<a class="jxr_linenumber" name="L2602" href="#L2602">2602</a> end = lines.length;
+<a class="jxr_linenumber" name="L2603" href="#L2603">2603</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L2604" href="#L2604">2604</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> l : l(lines).subList(start - 1, end))
+<a class="jxr_linenumber" name="L2605" href="#L2605">2605</a> sb.append(String.format(<span class="jxr_string">"%0"</span> + digits + <span class="jxr_string">"d"</span>, start++)).append(<span class="jxr_string">": "</span>).append(l).append(<span class="jxr_string">"\n"</span>); <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L2606" href="#L2606">2606</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L2607" href="#L2607">2607</a> }
+<a class="jxr_linenumber" name="L2608" href="#L2608">2608</a>
+<a class="jxr_linenumber" name="L2609" href="#L2609">2609</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2610" href="#L2610">2610</a> <em class="jxr_javadoccomment"> * Calculates the approximate memory size of a string in bytes.</em>
+<a class="jxr_linenumber" name="L2611" href="#L2611">2611</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2612" href="#L2612">2612</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2613" href="#L2613">2613</a> <em class="jxr_javadoccomment"> * Returns <c>0</c> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2614" href="#L2614">2614</a> <em class="jxr_javadoccomment"> * This method provides an estimate based on typical JVM object layout:</em>
+<a class="jxr_linenumber" name="L2615" href="#L2615">2615</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L2616" href="#L2616">2616</a> <em class="jxr_javadoccomment"> * <li>String object overhead: ~24 bytes (object header + fields)</li></em>
+<a class="jxr_linenumber" name="L2617" href="#L2617">2617</a> <em class="jxr_javadoccomment"> * <li>char[] array overhead: ~16 bytes (array header)</li></em>
+<a class="jxr_linenumber" name="L2618" href="#L2618">2618</a> <em class="jxr_javadoccomment"> * <li>Character data: 2 bytes per character</li></em>
+<a class="jxr_linenumber" name="L2619" href="#L2619">2619</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L2620" href="#L2620">2620</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2621" href="#L2621">2621</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2622" href="#L2622">2622</a> <em class="jxr_javadoccomment"> * <b>Note:</b> Actual memory usage may vary based on JVM implementation, object alignment,</em>
+<a class="jxr_linenumber" name="L2623" href="#L2623">2623</a> <em class="jxr_javadoccomment"> * and whether compressed OOPs are enabled. This is an approximation for informational purposes.</em>
+<a class="jxr_linenumber" name="L2624" href="#L2624">2624</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2625" href="#L2625">2625</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L2626" href="#L2626">2626</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2627" href="#L2627">2627</a> <em class="jxr_javadoccomment"> * getStringSize(<jk>null</jk>); <jc>// Returns: 0</jc></em>
+<a class="jxr_linenumber" name="L2628" href="#L2628">2628</a> <em class="jxr_javadoccomment"> * getStringSize(<js>""</js>); <jc>// Returns: ~40 bytes</jc></em>
+<a class="jxr_linenumber" name="L2629" href="#L2629">2629</a> <em class="jxr_javadoccomment"> * getStringSize(<js>"hello"</js>); <jc>// Returns: ~50 bytes (40 + 10)</jc></em>
+<a class="jxr_linenumber" name="L2630" href="#L2630">2630</a> <em class="jxr_javadoccomment"> * getStringSize(<js>"test"</js>); <jc>// Returns: ~48 bytes (40 + 8)</jc></em>
+<a class="jxr_linenumber" name="L2631" href="#L2631">2631</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2632" href="#L2632">2632</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2633" href="#L2633">2633</a> <em class="jxr_javadoccomment"> * @param str The string to measure. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2634" href="#L2634">2634</a> <em class="jxr_javadoccomment"> * @return The approximate memory size in bytes, or <c>0</c> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2635" href="#L2635">2635</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2636" href="#L2636">2636</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> getStringSize(String str) {
+<a class="jxr_linenumber" name="L2637" href="#L2637">2637</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2638" href="#L2638">2638</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L2639" href="#L2639">2639</a> <em class="jxr_comment">// String object overhead: ~24 bytes (object header + fields: value, hash, coder)</em>
+<a class="jxr_linenumber" name="L2640" href="#L2640">2640</a> <em class="jxr_comment">// char[] array overhead: ~16 bytes (array header)</em>
+<a class="jxr_linenumber" name="L2641" href="#L2641">2641</a> <em class="jxr_comment">// Character data: 2 bytes per character</em>
+<a class="jxr_linenumber" name="L2642" href="#L2642">2642</a> <strong class="jxr_keyword">return</strong> 24L + 16L + (2L * str.length());
+<a class="jxr_linenumber" name="L2643" href="#L2643">2643</a> }
+<a class="jxr_linenumber" name="L2644" href="#L2644">2644</a>
+<a class="jxr_linenumber" name="L2645" href="#L2645">2645</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2646" href="#L2646">2646</a> <em class="jxr_javadoccomment"> * Checks if a string has text (not null, not empty, and contains at least one non-whitespace character).</em>
+<a class="jxr_linenumber" name="L2647" href="#L2647">2647</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2648" href="#L2648">2648</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2649" href="#L2649">2649</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2650" href="#L2650">2650</a> <em class="jxr_javadoccomment"> * hasText(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2651" href="#L2651">2651</a> <em class="jxr_javadoccomment"> * hasText(<js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2652" href="#L2652">2652</a> <em class="jxr_javadoccomment"> * hasText(<js>" "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2653" href="#L2653">2653</a> <em class="jxr_javadoccomment"> * hasText(<js>"hello"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2654" href="#L2654">2654</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2655" href="#L2655">2655</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2656" href="#L2656">2656</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L2657" href="#L2657">2657</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains at least one non-whitespace character.</em>
+<a class="jxr_linenumber" name="L2658" href="#L2658">2658</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2659" href="#L2659">2659</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> hasText(String str) {
+<a class="jxr_linenumber" name="L2660" href="#L2660">2660</a> <strong class="jxr_keyword">return</strong> isNotBlank(str);
+<a class="jxr_linenumber" name="L2661" href="#L2661">2661</a> }
+<a class="jxr_linenumber" name="L2662" href="#L2662">2662</a>
+<a class="jxr_linenumber" name="L2663" href="#L2663">2663</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2664" href="#L2664">2664</a> <em class="jxr_javadoccomment"> * Same as {@link String#indexOf(int)} except allows you to check for multiple characters.</em>
+<a class="jxr_linenumber" name="L2665" href="#L2665">2665</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2666" href="#L2666">2666</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L2667" href="#L2667">2667</a> <em class="jxr_javadoccomment"> * @param c The characters to check for.</em>
+<a class="jxr_linenumber" name="L2668" href="#L2668">2668</a> <em class="jxr_javadoccomment"> * @return The index into the string that is one of the specified characters.</em>
+<a class="jxr_linenumber" name="L2669" href="#L2669">2669</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2670" href="#L2670">2670</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> indexOf(String s, <strong class="jxr_keyword">char</strong>...c) {
+<a class="jxr_linenumber" name="L2671" href="#L2671">2671</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2672" href="#L2672">2672</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L2673" href="#L2673">2673</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L2674" href="#L2674">2674</a> <strong class="jxr_keyword">var</strong> c2 = s.charAt(i);
+<a class="jxr_linenumber" name="L2675" href="#L2675">2675</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> cc : c)
+<a class="jxr_linenumber" name="L2676" href="#L2676">2676</a> <strong class="jxr_keyword">if</strong> (c2 == cc)
+<a class="jxr_linenumber" name="L2677" href="#L2677">2677</a> <strong class="jxr_keyword">return</strong> i;
+<a class="jxr_linenumber" name="L2678" href="#L2678">2678</a> }
+<a class="jxr_linenumber" name="L2679" href="#L2679">2679</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L2680" href="#L2680">2680</a> }
+<a class="jxr_linenumber" name="L2681" href="#L2681">2681</a>
+<a class="jxr_linenumber" name="L2682" href="#L2682">2682</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2683" href="#L2683">2683</a> <em class="jxr_javadoccomment"> * Finds the index of the first occurrence of a substring within a string.</em>
+<a class="jxr_linenumber" name="L2684" href="#L2684">2684</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2685" href="#L2685">2685</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2686" href="#L2686">2686</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2687" href="#L2687">2687</a> <em class="jxr_javadoccomment"> * indexOf(<js>"hello world"</js>, <js>"world"</js>); <jc>// 6</jc></em>
+<a class="jxr_linenumber" name="L2688" href="#L2688">2688</a> <em class="jxr_javadoccomment"> * indexOf(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// -1</jc></em>
+<a class="jxr_linenumber" name="L2689" href="#L2689">2689</a> <em class="jxr_javadoccomment"> * indexOf(<jk>null</jk>, <js>"test"</js>); <jc>// -1</jc></em>
+<a class="jxr_linenumber" name="L2690" href="#L2690">2690</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2691" href="#L2691">2691</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2692" href="#L2692">2692</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
+<a class="jxr_linenumber" name="L2693" href="#L2693">2693</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
+<a class="jxr_linenumber" name="L2694" href="#L2694">2694</a> <em class="jxr_javadoccomment"> * @return The index of the first occurrence, or <c>-1</c> if not found or if either parameter is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2695" href="#L2695">2695</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2696" href="#L2696">2696</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> indexOf(String str, String search) {
+<a class="jxr_linenumber" name="L2697" href="#L2697">2697</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2698" href="#L2698">2698</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L2699" href="#L2699">2699</a> <strong class="jxr_keyword">return</strong> str.indexOf(search);
+<a class="jxr_linenumber" name="L2700" href="#L2700">2700</a> }
+<a class="jxr_linenumber" name="L2701" href="#L2701">2701</a>
+<a class="jxr_linenumber" name="L2702" href="#L2702">2702</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2703" href="#L2703">2703</a> <em class="jxr_javadoccomment"> * Finds the index of the first occurrence of a substring within a string, ignoring case.</em>
+<a class="jxr_linenumber" name="L2704" href="#L2704">2704</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2705" href="#L2705">2705</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2706" href="#L2706">2706</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2707" href="#L2707">2707</a> <em class="jxr_javadoccomment"> * indexOfIgnoreCase(<js>"Hello World"</js>, <js>"world"</js>); <jc>// 6</jc></em>
+<a class="jxr_linenumber" name="L2708" href="#L2708">2708</a> <em class="jxr_javadoccomment"> * indexOfIgnoreCase(<js>"Hello World"</js>, <js>"WORLD"</js>); <jc>// 6</jc></em>
+<a class="jxr_linenumber" name="L2709" href="#L2709">2709</a> <em class="jxr_javadoccomment"> * indexOfIgnoreCase(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// -1</jc></em>
+<a class="jxr_linenumber" name="L2710" href="#L2710">2710</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2711" href="#L2711">2711</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2712" href="#L2712">2712</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
+<a class="jxr_linenumber" name="L2713" href="#L2713">2713</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
+<a class="jxr_linenumber" name="L2714" href="#L2714">2714</a> <em class="jxr_javadoccomment"> * @return The index of the first occurrence, or <c>-1</c> if not found or if either parameter is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2715" href="#L2715">2715</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2716" href="#L2716">2716</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> indexOfIgnoreCase(String str, String search) {
+<a class="jxr_linenumber" name="L2717" href="#L2717">2717</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2718" href="#L2718">2718</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L2719" href="#L2719">2719</a> <strong class="jxr_keyword">return</strong> str.toLowerCase().indexOf(search.toLowerCase());
+<a class="jxr_linenumber" name="L2720" href="#L2720">2720</a> }
+<a class="jxr_linenumber" name="L2721" href="#L2721">2721</a>
+<a class="jxr_linenumber" name="L2722" href="#L2722">2722</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2723" href="#L2723">2723</a> <em class="jxr_javadoccomment"> * Interns a string, returning the canonical representation.</em>
+<a class="jxr_linenumber" name="L2724" href="#L2724">2724</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2725" href="#L2725">2725</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2726" href="#L2726">2726</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2727" href="#L2727">2727</a> <em class="jxr_javadoccomment"> * This method provides a null-safe wrapper around {@link String#intern()}.</em>
<a class="jxr_linenumber" name="L2728" href="#L2728">2728</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2729" href="#L2729">2729</a> <em class="jxr_javadoccomment"> * String <jv>i1</jv> = intern(<jv>s1</jv>);</em>
-<a class="jxr_linenumber" name="L2730" href="#L2730">2730</a> <em class="jxr_javadoccomment"> * String <jv>i2</jv> = intern(<jv>s2</jv>);</em>
-<a class="jxr_linenumber" name="L2731" href="#L2731">2731</a> <em class="jxr_javadoccomment"> * assertTrue(<jv>i1</jv> == <jv>i2</jv>); <jc>// Same interned object</jc></em>
-<a class="jxr_linenumber" name="L2732" href="#L2732">2732</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2733" href="#L2733">2733</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2734" href="#L2734">2734</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Performance Note:</h5></em>
-<a class="jxr_linenumber" name="L2735" href="#L2735">2735</a> <em class="jxr_javadoccomment"> * <p>String interning stores strings in a special pool, which can save memory when the same string</em>
-<a class="jxr_linenumber" name="L2736" href="#L2736">2736</a> <em class="jxr_javadoccomment"> * values are used repeatedly. However, the intern pool has limited size and interning can be slow,</em>
-<a class="jxr_linenumber" name="L2737" href="#L2737">2737</a> <em class="jxr_javadoccomment"> * so use judiciously for strings that are known to be repeated frequently.</p></em>
-<a class="jxr_linenumber" name="L2738" href="#L2738">2738</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2739" href="#L2739">2739</a> <em class="jxr_javadoccomment"> * @param str The string to intern. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2740" href="#L2740">2740</a> <em class="jxr_javadoccomment"> * @return The interned string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L2741" href="#L2741">2741</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2742" href="#L2742">2742</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String intern(String str) {
-<a class="jxr_linenumber" name="L2743" href="#L2743">2743</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : str.intern();
-<a class="jxr_linenumber" name="L2744" href="#L2744">2744</a> }
-<a class="jxr_linenumber" name="L2745" href="#L2745">2745</a>
-<a class="jxr_linenumber" name="L2746" href="#L2746">2746</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2747" href="#L2747">2747</a> <em class="jxr_javadoccomment"> * Interpolates variables in a template string using <js>"${name}"</js> syntax.</em>
-<a class="jxr_linenumber" name="L2748" href="#L2748">2748</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2749" href="#L2749">2749</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2750" href="#L2750">2750</a> <em class="jxr_javadoccomment"> * Replaces variables of the form <js>"${name}"</js> with values from the map.</em>
-<a class="jxr_linenumber" name="L2751" href="#L2751">2751</a> <em class="jxr_javadoccomment"> * This is similar to shell variable interpolation syntax.</em>
-<a class="jxr_linenumber" name="L2752" href="#L2752">2752</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2753" href="#L2753">2753</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2754" href="#L2754">2754</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2755" href="#L2755">2755</a> <em class="jxr_javadoccomment"> * var vars = Map.of(<js>"name"</js>, <js>"John"</js>, <js>"city"</js>, <js>"New York"</js>);</em>
-<a class="jxr_linenumber" name="L2756" href="#L2756">2756</a> <em class="jxr_javadoccomment"> * interpolate(<js>"Hello ${name}, welcome to ${city}"</js>, vars);</em>
-<a class="jxr_linenumber" name="L2757" href="#L2757">2757</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, welcome to New York"</jc></em>
-<a class="jxr_linenumber" name="L2758" href="#L2758">2758</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2759" href="#L2759">2759</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2760" href="#L2760">2760</a> <em class="jxr_javadoccomment"> * @param template The template string with <js>"${name}"</js> variables.</em>
-<a class="jxr_linenumber" name="L2761" href="#L2761">2761</a> <em class="jxr_javadoccomment"> * @param variables The map containing the variable values.</em>
-<a class="jxr_linenumber" name="L2762" href="#L2762">2762</a> <em class="jxr_javadoccomment"> * @return The interpolated string with variables replaced, or the original template if variables is null or empty.</em>
-<a class="jxr_linenumber" name="L2763" href="#L2763">2763</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2764" href="#L2764">2764</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String interpolate(String template, Map<String,Object> variables) {
-<a class="jxr_linenumber" name="L2765" href="#L2765">2765</a> <strong class="jxr_keyword">if</strong> (template == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2766" href="#L2766">2766</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L2767" href="#L2767">2767</a> <strong class="jxr_keyword">if</strong> (variables == <strong class="jxr_keyword">null</strong> || variables.isEmpty())
-<a class="jxr_linenumber" name="L2768" href="#L2768">2768</a> <strong class="jxr_keyword">return</strong> template;
-<a class="jxr_linenumber" name="L2769" href="#L2769">2769</a>
-<a class="jxr_linenumber" name="L2770" href="#L2770">2770</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L2771" href="#L2771">2771</a> <strong class="jxr_keyword">var</strong> i = 0;
-<a class="jxr_linenumber" name="L2772" href="#L2772">2772</a> <strong class="jxr_keyword">var</strong> length = template.length();
-<a class="jxr_linenumber" name="L2773" href="#L2773">2773</a>
-<a class="jxr_linenumber" name="L2774" href="#L2774">2774</a> <strong class="jxr_keyword">while</strong> (i < length) {
-<a class="jxr_linenumber" name="L2775" href="#L2775">2775</a> <strong class="jxr_keyword">var</strong> dollarIndex = template.indexOf(<span class="jxr_string">"${"</span>, i);
-<a class="jxr_linenumber" name="L2776" href="#L2776">2776</a> <strong class="jxr_keyword">if</strong> (dollarIndex == -1) {
-<a class="jxr_linenumber" name="L2777" href="#L2777">2777</a> <em class="jxr_comment">// No more variables, append the rest</em>
-<a class="jxr_linenumber" name="L2778" href="#L2778">2778</a> result.append(template.substring(i));
-<a class="jxr_linenumber" name="L2779" href="#L2779">2779</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L2780" href="#L2780">2780</a> }
-<a class="jxr_linenumber" name="L2781" href="#L2781">2781</a>
-<a class="jxr_linenumber" name="L2782" href="#L2782">2782</a> <em class="jxr_comment">// Append text before the variable</em>
-<a class="jxr_linenumber" name="L2783" href="#L2783">2783</a> result.append(template.substring(i, dollarIndex));
-<a class="jxr_linenumber" name="L2784" href="#L2784">2784</a>
-<a class="jxr_linenumber" name="L2785" href="#L2785">2785</a> <em class="jxr_comment">// Find the closing brace</em>
-<a class="jxr_linenumber" name="L2786" href="#L2786">2786</a> <strong class="jxr_keyword">var</strong> braceIndex = template.indexOf('}', dollarIndex + 2);
-<a class="jxr_linenumber" name="L2787" href="#L2787">2787</a> <strong class="jxr_keyword">if</strong> (braceIndex == -1) {
-<a class="jxr_linenumber" name="L2788" href="#L2788">2788</a> <em class="jxr_comment">// No closing brace, append the rest as-is</em>
-<a class="jxr_linenumber" name="L2789" href="#L2789">2789</a> result.append(template.substring(dollarIndex));
-<a class="jxr_linenumber" name="L2790" href="#L2790">2790</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L2791" href="#L2791">2791</a> }
-<a class="jxr_linenumber" name="L2792" href="#L2792">2792</a>
-<a class="jxr_linenumber" name="L2793" href="#L2793">2793</a> <em class="jxr_comment">// Extract variable name</em>
-<a class="jxr_linenumber" name="L2794" href="#L2794">2794</a> <strong class="jxr_keyword">var</strong> varName = template.substring(dollarIndex + 2, braceIndex);
-<a class="jxr_linenumber" name="L2795" href="#L2795">2795</a> <strong class="jxr_keyword">var</strong> value = variables.get(varName);
-<a class="jxr_linenumber" name="L2796" href="#L2796">2796</a>
-<a class="jxr_linenumber" name="L2797" href="#L2797">2797</a> <strong class="jxr_keyword">if</strong> (variables.containsKey(varName)) {
-<a class="jxr_linenumber" name="L2798" href="#L2798">2798</a> <em class="jxr_comment">// Variable exists in map (even if null)</em>
-<a class="jxr_linenumber" name="L2799" href="#L2799">2799</a> result.append(value != <strong class="jxr_keyword">null</strong> ? value.toString() : <span class="jxr_string">"null"</span>);
-<a class="jxr_linenumber" name="L2800" href="#L2800">2800</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L2801" href="#L2801">2801</a> <em class="jxr_comment">// Variable not found, keep the original placeholder</em>
-<a class="jxr_linenumber" name="L2802" href="#L2802">2802</a> result.append(<span class="jxr_string">"${"</span>).append(varName).append(<span class="jxr_string">"}"</span>);
-<a class="jxr_linenumber" name="L2803" href="#L2803">2803</a> }
-<a class="jxr_linenumber" name="L2804" href="#L2804">2804</a>
-<a class="jxr_linenumber" name="L2805" href="#L2805">2805</a> i = braceIndex + 1;
-<a class="jxr_linenumber" name="L2806" href="#L2806">2806</a> }
-<a class="jxr_linenumber" name="L2807" href="#L2807">2807</a>
-<a class="jxr_linenumber" name="L2808" href="#L2808">2808</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L2809" href="#L2809">2809</a> }
+<a class="jxr_linenumber" name="L2729" href="#L2729">2729</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L2730" href="#L2730">2730</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2731" href="#L2731">2731</a> <em class="jxr_javadoccomment"> * String <jv>s1</jv> = <jk>new</jk> String(<js>"test"</js>);</em>
+<a class="jxr_linenumber" name="L2732" href="#L2732">2732</a> <em class="jxr_javadoccomment"> * String <jv>s2</jv> = <jk>new</jk> String(<js>"test"</js>);</em>
+<a class="jxr_linenumber" name="L2733" href="#L2733">2733</a> <em class="jxr_javadoccomment"> * assertTrue(<jv>s1</jv> != <jv>s2</jv>); <jc>// Different objects</jc></em>
+<a class="jxr_linenumber" name="L2734" href="#L2734">2734</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2735" href="#L2735">2735</a> <em class="jxr_javadoccomment"> * String <jv>i1</jv> = intern(<jv>s1</jv>);</em>
+<a class="jxr_linenumber" name="L2736" href="#L2736">2736</a> <em class="jxr_javadoccomment"> * String <jv>i2</jv> = intern(<jv>s2</jv>);</em>
+<a class="jxr_linenumber" name="L2737" href="#L2737">2737</a> <em class="jxr_javadoccomment"> * assertTrue(<jv>i1</jv> == <jv>i2</jv>); <jc>// Same interned object</jc></em>
+<a class="jxr_linenumber" name="L2738" href="#L2738">2738</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2739" href="#L2739">2739</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2740" href="#L2740">2740</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Performance Note:</h5></em>
+<a class="jxr_linenumber" name="L2741" href="#L2741">2741</a> <em class="jxr_javadoccomment"> * <p>String interning stores strings in a special pool, which can save memory when the same string</em>
+<a class="jxr_linenumber" name="L2742" href="#L2742">2742</a> <em class="jxr_javadoccomment"> * values are used repeatedly. However, the intern pool has limited size and interning can be slow,</em>
+<a class="jxr_linenumber" name="L2743" href="#L2743">2743</a> <em class="jxr_javadoccomment"> * so use judiciously for strings that are known to be repeated frequently.</p></em>
+<a class="jxr_linenumber" name="L2744" href="#L2744">2744</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2745" href="#L2745">2745</a> <em class="jxr_javadoccomment"> * @param str The string to intern. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2746" href="#L2746">2746</a> <em class="jxr_javadoccomment"> * @return The interned string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L2747" href="#L2747">2747</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2748" href="#L2748">2748</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String intern(String str) {
+<a class="jxr_linenumber" name="L2749" href="#L2749">2749</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : str.intern();
+<a class="jxr_linenumber" name="L2750" href="#L2750">2750</a> }
+<a class="jxr_linenumber" name="L2751" href="#L2751">2751</a>
+<a class="jxr_linenumber" name="L2752" href="#L2752">2752</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2753" href="#L2753">2753</a> <em class="jxr_javadoccomment"> * Interpolates variables in a template string using <js>"${name}"</js> syntax.</em>
+<a class="jxr_linenumber" name="L2754" href="#L2754">2754</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2755" href="#L2755">2755</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2756" href="#L2756">2756</a> <em class="jxr_javadoccomment"> * Replaces variables of the form <js>"${name}"</js> with values from the map.</em>
+<a class="jxr_linenumber" name="L2757" href="#L2757">2757</a> <em class="jxr_javadoccomment"> * This is similar to shell variable interpolation syntax.</em>
+<a class="jxr_linenumber" name="L2758" href="#L2758">2758</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2759" href="#L2759">2759</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2760" href="#L2760">2760</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2761" href="#L2761">2761</a> <em class="jxr_javadoccomment"> * var vars = Map.of(<js>"name"</js>, <js>"John"</js>, <js>"city"</js>, <js>"New York"</js>);</em>
+<a class="jxr_linenumber" name="L2762" href="#L2762">2762</a> <em class="jxr_javadoccomment"> * interpolate(<js>"Hello ${name}, welcome to ${city}"</js>, vars);</em>
+<a class="jxr_linenumber" name="L2763" href="#L2763">2763</a> <em class="jxr_javadoccomment"> * <jc>// Returns: "Hello John, welcome to New York"</jc></em>
+<a class="jxr_linenumber" name="L2764" href="#L2764">2764</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2765" href="#L2765">2765</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2766" href="#L2766">2766</a> <em class="jxr_javadoccomment"> * @param template The template string with <js>"${name}"</js> variables.</em>
+<a class="jxr_linenumber" name="L2767" href="#L2767">2767</a> <em class="jxr_javadoccomment"> * @param variables The map containing the variable values.</em>
+<a class="jxr_linenumber" name="L2768" href="#L2768">2768</a> <em class="jxr_javadoccomment"> * @return The interpolated string with variables replaced, or the original template if variables is null or empty.</em>
+<a class="jxr_linenumber" name="L2769" href="#L2769">2769</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2770" href="#L2770">2770</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String interpolate(String template, Map<String,Object> variables) {
+<a class="jxr_linenumber" name="L2771" href="#L2771">2771</a> <strong class="jxr_keyword">if</strong> (template == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L2772" href="#L2772">2772</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L2773" href="#L2773">2773</a> <strong class="jxr_keyword">if</strong> (variables == <strong class="jxr_keyword">null</strong> || variables.isEmpty())
+<a class="jxr_linenumber" name="L2774" href="#L2774">2774</a> <strong class="jxr_keyword">return</strong> template;
+<a class="jxr_linenumber" name="L2775" href="#L2775">2775</a>
+<a class="jxr_linenumber" name="L2776" href="#L2776">2776</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L2777" href="#L2777">2777</a> <strong class="jxr_keyword">var</strong> i = 0;
+<a class="jxr_linenumber" name="L2778" href="#L2778">2778</a> <strong class="jxr_keyword">var</strong> length = template.length();
+<a class="jxr_linenumber" name="L2779" href="#L2779">2779</a>
+<a class="jxr_linenumber" name="L2780" href="#L2780">2780</a> <strong class="jxr_keyword">while</strong> (i < length) {
+<a class="jxr_linenumber" name="L2781" href="#L2781">2781</a> <strong class="jxr_keyword">var</strong> dollarIndex = template.indexOf(<span class="jxr_string">"${"</span>, i);
+<a class="jxr_linenumber" name="L2782" href="#L2782">2782</a> <strong class="jxr_keyword">if</strong> (dollarIndex == -1) {
+<a class="jxr_linenumber" name="L2783" href="#L2783">2783</a> <em class="jxr_comment">// No more variables, append the rest</em>
+<a class="jxr_linenumber" name="L2784" href="#L2784">2784</a> result.append(template.substring(i));
+<a class="jxr_linenumber" name="L2785" href="#L2785">2785</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L2786" href="#L2786">2786</a> }
+<a class="jxr_linenumber" name="L2787" href="#L2787">2787</a>
+<a class="jxr_linenumber" name="L2788" href="#L2788">2788</a> <em class="jxr_comment">// Append text before the variable</em>
+<a class="jxr_linenumber" name="L2789" href="#L2789">2789</a> result.append(template.substring(i, dollarIndex));
+<a class="jxr_linenumber" name="L2790" href="#L2790">2790</a>
+<a class="jxr_linenumber" name="L2791" href="#L2791">2791</a> <em class="jxr_comment">// Find the closing brace</em>
+<a class="jxr_linenumber" name="L2792" href="#L2792">2792</a> <strong class="jxr_keyword">var</strong> braceIndex = template.indexOf('}', dollarIndex + 2);
+<a class="jxr_linenumber" name="L2793" href="#L2793">2793</a> <strong class="jxr_keyword">if</strong> (braceIndex == -1) {
+<a class="jxr_linenumber" name="L2794" href="#L2794">2794</a> <em class="jxr_comment">// No closing brace, append the rest as-is</em>
+<a class="jxr_linenumber" name="L2795" href="#L2795">2795</a> result.append(template.substring(dollarIndex));
+<a class="jxr_linenumber" name="L2796" href="#L2796">2796</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L2797" href="#L2797">2797</a> }
+<a class="jxr_linenumber" name="L2798" href="#L2798">2798</a>
+<a class="jxr_linenumber" name="L2799" href="#L2799">2799</a> <em class="jxr_comment">// Extract variable name</em>
+<a class="jxr_linenumber" name="L2800" href="#L2800">2800</a> <strong class="jxr_keyword">var</strong> varName = template.substring(dollarIndex + 2, braceIndex);
+<a class="jxr_linenumber" name="L2801" href="#L2801">2801</a> <strong class="jxr_keyword">var</strong> value = variables.get(varName);
+<a class="jxr_linenumber" name="L2802" href="#L2802">2802</a>
+<a class="jxr_linenumber" name="L2803" href="#L2803">2803</a> <strong class="jxr_keyword">if</strong> (variables.containsKey(varName)) {
+<a class="jxr_linenumber" name="L2804" href="#L2804">2804</a> <em class="jxr_comment">// Variable exists in map (even if null)</em>
+<a class="jxr_linenumber" name="L2805" href="#L2805">2805</a> result.append(value != <strong class="jxr_keyword">null</strong> ? value.toString() : <span class="jxr_string">"null"</span>);
+<a class="jxr_linenumber" name="L2806" href="#L2806">2806</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L2807" href="#L2807">2807</a> <em class="jxr_comment">// Variable not found, keep the original placeholder</em>
+<a class="jxr_linenumber" name="L2808" href="#L2808">2808</a> result.append(<span class="jxr_string">"${"</span>).append(varName).append(<span class="jxr_string">"}"</span>);
+<a class="jxr_linenumber" name="L2809" href="#L2809">2809</a> }
<a class="jxr_linenumber" name="L2810" href="#L2810">2810</a>
-<a class="jxr_linenumber" name="L2811" href="#L2811">2811</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2812" href="#L2812">2812</a> <em class="jxr_javadoccomment"> * Efficiently determines whether a URL is of the pattern "xxx://xxx"</em>
-<a class="jxr_linenumber" name="L2813" href="#L2813">2813</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2814" href="#L2814">2814</a> <em class="jxr_javadoccomment"> * @param s The string to test.</em>
-<a class="jxr_linenumber" name="L2815" href="#L2815">2815</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if it's an absolute path.</em>
-<a class="jxr_linenumber" name="L2816" href="#L2816">2816</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2817" href="#L2817">2817</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAbsoluteUri(String s) { <em class="jxr_comment">// NOSONAR - False positive.</em>
-<a class="jxr_linenumber" name="L2818" href="#L2818">2818</a>
-<a class="jxr_linenumber" name="L2819" href="#L2819">2819</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L2820" href="#L2820">2820</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2821" href="#L2821">2821</a>
-<a class="jxr_linenumber" name="L2822" href="#L2822">2822</a> <em class="jxr_comment">// Use a state machine for maximum performance.</em>
-<a class="jxr_linenumber" name="L2823" href="#L2823">2823</a>
-<a class="jxr_linenumber" name="L2824" href="#L2824">2824</a> <em class="jxr_comment">// S1: Looking for http</em>
-<a class="jxr_linenumber" name="L2825" href="#L2825">2825</a> <em class="jxr_comment">// S2: Found http, looking for :</em>
-<a class="jxr_linenumber" name="L2826" href="#L2826">2826</a> <em class="jxr_comment">// S3: Found :, looking for /</em>
-<a class="jxr_linenumber" name="L2827" href="#L2827">2827</a> <em class="jxr_comment">// S4: Found /, looking for /</em>
-<a class="jxr_linenumber" name="L2828" href="#L2828">2828</a> <em class="jxr_comment">// S5: Found /, looking for x</em>
+<a class="jxr_linenumber" name="L2811" href="#L2811">2811</a> i = braceIndex + 1;
+<a class="jxr_linenumber" name="L2812" href="#L2812">2812</a> }
+<a class="jxr_linenumber" name="L2813" href="#L2813">2813</a>
+<a class="jxr_linenumber" name="L2814" href="#L2814">2814</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L2815" href="#L2815">2815</a> }
+<a class="jxr_linenumber" name="L2816" href="#L2816">2816</a>
+<a class="jxr_linenumber" name="L2817" href="#L2817">2817</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2818" href="#L2818">2818</a> <em class="jxr_javadoccomment"> * Efficiently determines whether a URL is of the pattern "xxx://xxx"</em>
+<a class="jxr_linenumber" name="L2819" href="#L2819">2819</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2820" href="#L2820">2820</a> <em class="jxr_javadoccomment"> * @param s The string to test.</em>
+<a class="jxr_linenumber" name="L2821" href="#L2821">2821</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if it's an absolute path.</em>
+<a class="jxr_linenumber" name="L2822" href="#L2822">2822</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2823" href="#L2823">2823</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAbsoluteUri(String s) { <em class="jxr_comment">// NOSONAR - False positive.</em>
+<a class="jxr_linenumber" name="L2824" href="#L2824">2824</a>
+<a class="jxr_linenumber" name="L2825" href="#L2825">2825</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L2826" href="#L2826">2826</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2827" href="#L2827">2827</a>
+<a class="jxr_linenumber" name="L2828" href="#L2828">2828</a> <em class="jxr_comment">// Use a state machine for maximum performance.</em>
<a class="jxr_linenumber" name="L2829" href="#L2829">2829</a>
-<a class="jxr_linenumber" name="L2830" href="#L2830">2830</a> <strong class="jxr_keyword">var</strong> state = S1;
-<a class="jxr_linenumber" name="L2831" href="#L2831">2831</a>
-<a class="jxr_linenumber" name="L2832" href="#L2832">2832</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L2833" href="#L2833">2833</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L2834" href="#L2834">2834</a> <strong class="jxr_keyword">if</strong> (state == S1) {
-<a class="jxr_linenumber" name="L2835" href="#L2835">2835</a> <strong class="jxr_keyword">if</strong> (c >= 'a' && c <= 'z')
-<a class="jxr_linenumber" name="L2836" href="#L2836">2836</a> state = S2;
-<a class="jxr_linenumber" name="L2837" href="#L2837">2837</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2838" href="#L2838">2838</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2839" href="#L2839">2839</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2) {
-<a class="jxr_linenumber" name="L2840" href="#L2840">2840</a> <strong class="jxr_keyword">if</strong> (c == ':')
-<a class="jxr_linenumber" name="L2841" href="#L2841">2841</a> state = S3;
-<a class="jxr_linenumber" name="L2842" href="#L2842">2842</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c < 'a' || c > 'z')
-<a class="jxr_linenumber" name="L2843" href="#L2843">2843</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2844" href="#L2844">2844</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S3) { <em class="jxr_comment">// NOSONAR - False positive.</em>
-<a class="jxr_linenumber" name="L2845" href="#L2845">2845</a> <strong class="jxr_keyword">if</strong> (c == '/')
-<a class="jxr_linenumber" name="L2846" href="#L2846">2846</a> state = S4;
-<a class="jxr_linenumber" name="L2847" href="#L2847">2847</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2848" href="#L2848">2848</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2849" href="#L2849">2849</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S4) {
-<a class="jxr_linenumber" name="L2850" href="#L2850">2850</a> <strong class="jxr_keyword">if</strong> (c == '/')
-<a class="jxr_linenumber" name="L2851" href="#L2851">2851</a> state = S5;
-<a class="jxr_linenumber" name="L2852" href="#L2852">2852</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L2853" href="#L2853">2853</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2854" href="#L2854">2854</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S5) {
-<a class="jxr_linenumber" name="L2855" href="#L2855">2855</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L2856" href="#L2856">2856</a> }
-<a class="jxr_linenumber" name="L2857" href="#L2857">2857</a> }
-<a class="jxr_linenumber" name="L2858" href="#L2858">2858</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2859" href="#L2859">2859</a> }
-<a class="jxr_linenumber" name="L2860" href="#L2860">2860</a>
-<a class="jxr_linenumber" name="L2861" href="#L2861">2861</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2862" href="#L2862">2862</a> <em class="jxr_javadoccomment"> * Checks if all of the provided strings are not blank (not null, not empty, and not whitespace only).</em>
-<a class="jxr_linenumber" name="L2863" href="#L2863">2863</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2864" href="#L2864">2864</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2865" href="#L2865">2865</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> only if all strings are not null, not empty, and contain non-whitespace characters.</em>
-<a class="jxr_linenumber" name="L2866" href="#L2866">2866</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the array is null or empty, or if any string is null, empty, or whitespace only.</em>
-<a class="jxr_linenumber" name="L2867" href="#L2867">2867</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2868" href="#L2868">2868</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2869" href="#L2869">2869</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2870" href="#L2870">2870</a> <em class="jxr_javadoccomment"> * isAllNotBlank(); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2871" href="#L2871">2871</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2872" href="#L2872">2872</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<jk>null</jk>, <jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2873" href="#L2873">2873</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>""</js>, <js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2874" href="#L2874">2874</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>" "</js>, <js>" "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2875" href="#L2875">2875</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<jk>null</jk>, <js>"hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2876" href="#L2876">2876</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>""</js>, <js>" "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2877" href="#L2877">2877</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>"hello"</js>, <js>" "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2878" href="#L2878">2878</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>"hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2879" href="#L2879">2879</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>"hello"</js>, <js>"world"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2880" href="#L2880">2880</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2881" href="#L2881">2881</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2882" href="#L2882">2882</a> <em class="jxr_javadoccomment"> * @param values The strings to check.</em>
-<a class="jxr_linenumber" name="L2883" href="#L2883">2883</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if all strings are not null, not empty, and not whitespace only, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L2884" href="#L2884">2884</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2885" href="#L2885">2885</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAllNotBlank(CharSequence...values) {
-<a class="jxr_linenumber" name="L2886" href="#L2886">2886</a> <strong class="jxr_keyword">if</strong> (values == <strong class="jxr_keyword">null</strong> || values.length == 0)
-<a class="jxr_linenumber" name="L2887" href="#L2887">2887</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2888" href="#L2888">2888</a> <strong class="jxr_keyword">for</strong> (CharSequence value : values)
-<a class="jxr_linenumber" name="L2889" href="#L2889">2889</a> <strong class="jxr_keyword">if</strong> (! isNotBlank(value))
-<a class="jxr_linenumber" name="L2890" href="#L2890">2890</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2891" href="#L2891">2891</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L2892" href="#L2892">2892</a> }
-<a class="jxr_linenumber" name="L2893" href="#L2893">2893</a>
-<a class="jxr_linenumber" name="L2894" href="#L2894">2894</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2895" href="#L2895">2895</a> <em class="jxr_javadoccomment"> * Checks if all of the provided strings are not empty (not null and not zero-length).</em>
-<a class="jxr_linenumber" name="L2896" href="#L2896">2896</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2897" href="#L2897">2897</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2898" href="#L2898">2898</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> only if all strings are not null and have a length greater than zero.</em>
-<a class="jxr_linenumber" name="L2899" href="#L2899">2899</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the array is null or empty, or if any string is null or empty.</em>
-<a class="jxr_linenumber" name="L2900" href="#L2900">2900</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2901" href="#L2901">2901</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2902" href="#L2902">2902</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2903" href="#L2903">2903</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2904" href="#L2904">2904</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2905" href="#L2905">2905</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<jk>null</jk>, <jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2906" href="#L2906">2906</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>""</js>, <js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2907" href="#L2907">2907</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<jk>null</jk>, <js>"hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2908" href="#L2908">2908</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>""</js>, <js>" "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2909" href="#L2909">2909</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>"hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2910" href="#L2910">2910</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>"hello"</js>, <js>"world"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2911" href="#L2911">2911</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>"hello"</js>, <js>" "</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2912" href="#L2912">2912</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2913" href="#L2913">2913</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2914" href="#L2914">2914</a> <em class="jxr_javadoccomment"> * @param values The strings to check.</em>
-<a class="jxr_linenumber" name="L2915" href="#L2915">2915</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if all strings are not null and not empty, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L2916" href="#L2916">2916</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2917" href="#L2917">2917</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAllNotEmpty(CharSequence...values) {
-<a class="jxr_linenumber" name="L2918" href="#L2918">2918</a> <strong class="jxr_keyword">if</strong> (values == <strong class="jxr_keyword">null</strong> || values.length == 0)
-<a class="jxr_linenumber" name="L2919" href="#L2919">2919</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2920" href="#L2920">2920</a> <strong class="jxr_keyword">for</strong> (CharSequence value : values)
-<a class="jxr_linenumber" name="L2921" href="#L2921">2921</a> <strong class="jxr_keyword">if</strong> (value == <strong class="jxr_keyword">null</strong> || value.isEmpty())
-<a class="jxr_linenumber" name="L2922" href="#L2922">2922</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2923" href="#L2923">2923</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L2924" href="#L2924">2924</a> }
-<a class="jxr_linenumber" name="L2925" href="#L2925">2925</a>
-<a class="jxr_linenumber" name="L2926" href="#L2926">2926</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2927" href="#L2927">2927</a> <em class="jxr_javadoccomment"> * Checks if a string contains only alphabetic characters (a-z, A-Z).</em>
-<a class="jxr_linenumber" name="L2928" href="#L2928">2928</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2929" href="#L2929">2929</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2930" href="#L2930">2930</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2931" href="#L2931">2931</a> <em class="jxr_javadoccomment"> * isAlpha(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2932" href="#L2932">2932</a> <em class="jxr_javadoccomment"> * isAlpha(<js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2933" href="#L2933">2933</a> <em class="jxr_javadoccomment"> * isAlpha(<js>"abc"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2934" href="#L2934">2934</a> <em class="jxr_javadoccomment"> * isAlpha(<js>"abc123"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2935" href="#L2935">2935</a> <em class="jxr_javadoccomment"> * isAlpha(<js>"abc def"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2936" href="#L2936">2936</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2937" href="#L2937">2937</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2938" href="#L2938">2938</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L2939" href="#L2939">2939</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains only alphabetic characters.</em>
-<a class="jxr_linenumber" name="L2940" href="#L2940">2940</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2941" href="#L2941">2941</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAlpha(String str) {
-<a class="jxr_linenumber" name="L2942" href="#L2942">2942</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L2943" href="#L2943">2943</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2944" href="#L2944">2944</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L2945" href="#L2945">2945</a> <strong class="jxr_keyword">if</strong> (! Character.isLetter(str.charAt(i)))
-<a class="jxr_linenumber" name="L2946" href="#L2946">2946</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2947" href="#L2947">2947</a> }
-<a class="jxr_linenumber" name="L2948" href="#L2948">2948</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L2949" href="#L2949">2949</a> }
-<a class="jxr_linenumber" name="L2950" href="#L2950">2950</a>
-<a class="jxr_linenumber" name="L2951" href="#L2951">2951</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2952" href="#L2952">2952</a> <em class="jxr_javadoccomment"> * Checks if a string contains only alphanumeric characters (a-z, A-Z, 0-9).</em>
-<a class="jxr_linenumber" name="L2953" href="#L2953">2953</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2954" href="#L2954">2954</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2955" href="#L2955">2955</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2956" href="#L2956">2956</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2957" href="#L2957">2957</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2958" href="#L2958">2958</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>"abc"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2959" href="#L2959">2959</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>"abc123"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2960" href="#L2960">2960</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>"abc def"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2961" href="#L2961">2961</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>"abc-123"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2962" href="#L2962">2962</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2963" href="#L2963">2963</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2964" href="#L2964">2964</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L2965" href="#L2965">2965</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains only alphanumeric characters.</em>
-<a class="jxr_linenumber" name="L2966" href="#L2966">2966</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2967" href="#L2967">2967</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAlphaNumeric(String str) {
-<a class="jxr_linenumber" name="L2968" href="#L2968">2968</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L2969" href="#L2969">2969</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2970" href="#L2970">2970</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L2971" href="#L2971">2971</a> <strong class="jxr_keyword">if</strong> (! Character.isLetterOrDigit(str.charAt(i)))
-<a class="jxr_linenumber" name="L2972" href="#L2972">2972</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2973" href="#L2973">2973</a> }
-<a class="jxr_linenumber" name="L2974" href="#L2974">2974</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L2975" href="#L2975">2975</a> }
-<a class="jxr_linenumber" name="L2976" href="#L2976">2976</a>
-<a class="jxr_linenumber" name="L2977" href="#L2977">2977</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L2978" href="#L2978">2978</a> <em class="jxr_javadoccomment"> * Checks if any of the provided strings are not blank (not null, not empty, and not whitespace only).</em>
-<a class="jxr_linenumber" name="L2979" href="#L2979">2979</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2980" href="#L2980">2980</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L2981" href="#L2981">2981</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if at least one string is not null, not empty, and contains non-whitespace characters.</em>
-<a class="jxr_linenumber" name="L2982" href="#L2982">2982</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2983" href="#L2983">2983</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L2984" href="#L2984">2984</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L2985" href="#L2985">2985</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<jk>null</jk>, <jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2986" href="#L2986">2986</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<js>""</js>, <js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2987" href="#L2987">2987</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<js>" "</js>, <js>" "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L2988" href="#L2988">2988</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<jk>null</jk>, <js>"hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2989" href="#L2989">2989</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<js>""</js>, <js>" "</js>, <js>"x"</js>);<jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2990" href="#L2990">2990</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<js>"hello"</js>, <js>"world"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L2991" href="#L2991">2991</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L2992" href="#L2992">2992</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L2993" href="#L2993">2993</a> <em class="jxr_javadoccomment"> * @param values The strings to check.</em>
-<a class="jxr_linenumber" name="L2994" href="#L2994">2994</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if at least one string is not null, not empty, and contains non-whitespace characters.</em>
-<a class="jxr_linenumber" name="L2995" href="#L2995">2995</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L2996" href="#L2996">2996</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAnyNotBlank(CharSequence...values) {
-<a class="jxr_linenumber" name="L2997" href="#L2997">2997</a> <strong class="jxr_keyword">if</strong> (values == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L2998" href="#L2998">2998</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L2999" href="#L2999">2999</a> <strong class="jxr_keyword">for</strong> (CharSequence value : values)
-<a class="jxr_linenumber" name="L3000" href="#L3000">3000</a> <strong class="jxr_keyword">if</strong> (isNotBlank(value))
-<a class="jxr_linenumber" name="L3001" href="#L3001">3001</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3002" href="#L3002">3002</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3003" href="#L3003">3003</a> }
-<a class="jxr_linenumber" name="L3004" href="#L3004">3004</a>
-<a class="jxr_linenumber" name="L3005" href="#L3005">3005</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3006" href="#L3006">3006</a> <em class="jxr_javadoccomment"> * Checks if any of the provided strings are not empty (not null and not zero-length).</em>
-<a class="jxr_linenumber" name="L3007" href="#L3007">3007</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3008" href="#L3008">3008</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3009" href="#L3009">3009</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if at least one string is not null and has a length greater than zero.</em>
-<a class="jxr_linenumber" name="L3010" href="#L3010">3010</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3011" href="#L3011">3011</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3012" href="#L3012">3012</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3013" href="#L3013">3013</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<jk>null</jk>, <jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3014" href="#L3014">3014</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<js>""</js>, <js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3015" href="#L3015">3015</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<jk>null</jk>, <js>"hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3016" href="#L3016">3016</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<js>""</js>, <js>" "</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3017" href="#L3017">3017</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<js>"hello"</js>, <js>"world"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3018" href="#L3018">3018</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3019" href="#L3019">3019</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3020" href="#L3020">3020</a> <em class="jxr_javadoccomment"> * @param values The strings to check.</em>
-<a class="jxr_linenumber" name="L3021" href="#L3021">3021</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if at least one string is not null and not empty.</em>
-<a class="jxr_linenumber" name="L3022" href="#L3022">3022</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3023" href="#L3023">3023</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAnyNotEmpty(CharSequence...values) {
-<a class="jxr_linenumber" name="L3024" href="#L3024">3024</a> <strong class="jxr_keyword">if</strong> (values == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3025" href="#L3025">3025</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3026" href="#L3026">3026</a> <strong class="jxr_keyword">for</strong> (CharSequence value : values)
-<a class="jxr_linenumber" name="L3027" href="#L3027">3027</a> <strong class="jxr_keyword">if</strong> (value != <strong class="jxr_keyword">null</strong> && ! value.isEmpty())
-<a class="jxr_linenumber" name="L3028" href="#L3028">3028</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3029" href="#L3029">3029</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3030" href="#L3030">3030</a> }
-<a class="jxr_linenumber" name="L3031" href="#L3031">3031</a>
-<a class="jxr_linenumber" name="L3032" href="#L3032">3032</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3033" href="#L3033">3033</a> <em class="jxr_javadoccomment"> * Checks if a string is blank (null, empty, or whitespace only).</em>
-<a class="jxr_linenumber" name="L3034" href="#L3034">3034</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3035" href="#L3035">3035</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3036" href="#L3036">3036</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3037" href="#L3037">3037</a> <em class="jxr_javadoccomment"> * isBlank(<jk>null</jk>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3038" href="#L3038">3038</a> <em class="jxr_javadoccomment"> * isBlank(<js>""</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3039" href="#L3039">3039</a> <em class="jxr_javadoccomment"> * isBlank(<js>" "</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3040" href="#L3040">3040</a> <em class="jxr_javadoccomment"> * isBlank(<js>"hello"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3041" href="#L3041">3041</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3042" href="#L3042">3042</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3043" href="#L3043">3043</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L3044" href="#L3044">3044</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is null, empty, or contains only whitespace characters.</em>
-<a class="jxr_linenumber" name="L3045" href="#L3045">3045</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3046" href="#L3046">3046</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isBlank(CharSequence str) {
-<a class="jxr_linenumber" name="L3047" href="#L3047">3047</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> || str.toString().isBlank();
-<a class="jxr_linenumber" name="L3048" href="#L3048">3048</a> }
-<a class="jxr_linenumber" name="L3049" href="#L3049">3049</a>
-<a class="jxr_linenumber" name="L3050" href="#L3050">3050</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3051" href="#L3051">3051</a> <em class="jxr_javadoccomment"> * Checks if a string is a valid credit card number using the Luhn algorithm.</em>
-<a class="jxr_linenumber" name="L3052" href="#L3052">3052</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3053" href="#L3053">3053</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3054" href="#L3054">3054</a> <em class="jxr_javadoccomment"> * Validates credit card numbers by:</em>
-<a class="jxr_linenumber" name="L3055" href="#L3055">3055</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L3056" href="#L3056">3056</a> <em class="jxr_javadoccomment"> * <li>Removing spaces and hyphens</li></em>
-<a class="jxr_linenumber" name="L3057" href="#L3057">3057</a> <em class="jxr_javadoccomment"> * <li>Checking that all remaining characters are digits</li></em>
-<a class="jxr_linenumber" name="L3058" href="#L3058">3058</a> <em class="jxr_javadoccomment"> * <li>Verifying the number passes the Luhn algorithm check</li></em>
-<a class="jxr_linenumber" name="L3059" href="#L3059">3059</a> <em class="jxr_javadoccomment"> * <li>Ensuring the number is between 13-19 digits (standard credit card length)</li></em>
-<a class="jxr_linenumber" name="L3060" href="#L3060">3060</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L3061" href="#L3061">3061</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3062" href="#L3062">3062</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3063" href="#L3063">3063</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3064" href="#L3064">3064</a> <em class="jxr_javadoccomment"> * isCreditCard(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3065" href="#L3065">3065</a> <em class="jxr_javadoccomment"> * isCreditCard(<js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3066" href="#L3066">3066</a> <em class="jxr_javadoccomment"> * isCreditCard(<js>"4532015112830366"</js>); <jc>// true (Visa test card)</jc></em>
-<a class="jxr_linenumber" name="L3067" href="#L3067">3067</a> <em class="jxr_javadoccomment"> * isCreditCard(<js>"4532-0151-1283-0366"</js>); <jc>// true (with separators)</jc></em>
-<a class="jxr_linenumber" name="L3068" href="#L3068">3068</a> <em class="jxr_javadoccomment"> * isCreditCard(<js>"1234567890"</js>); <jc>// false (invalid Luhn)</jc></em>
-<a class="jxr_linenumber" name="L3069" href="#L3069">3069</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3070" href="#L3070">3070</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3071" href="#L3071">3071</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L3072" href="#L3072">3072</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid credit card number.</em>
-<a class="jxr_linenumber" name="L3073" href="#L3073">3073</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3074" href="#L3074">3074</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isCreditCard(String str) {
-<a class="jxr_linenumber" name="L3075" href="#L3075">3075</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L3076" href="#L3076">3076</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3077" href="#L3077">3077</a> <em class="jxr_comment">// Remove spaces and hyphens</em>
-<a class="jxr_linenumber" name="L3078" href="#L3078">3078</a> <strong class="jxr_keyword">var</strong> cleaned = str.replaceAll(<span class="jxr_string">"[\\s\\-]"</span>, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L3079" href="#L3079">3079</a> <em class="jxr_comment">// Must be all digits and 13-19 digits long</em>
-<a class="jxr_linenumber" name="L3080" href="#L3080">3080</a> <strong class="jxr_keyword">if</strong> (! cleaned.matches(<span class="jxr_string">"^\\d{13,19}$"</span>))
-<a class="jxr_linenumber" name="L3081" href="#L3081">3081</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3082" href="#L3082">3082</a> <em class="jxr_comment">// Apply Luhn algorithm</em>
-<a class="jxr_linenumber" name="L3083" href="#L3083">3083</a> <strong class="jxr_keyword">var</strong> sum = 0;
-<a class="jxr_linenumber" name="L3084" href="#L3084">3084</a> <strong class="jxr_keyword">var</strong> alternate = false;
-<a class="jxr_linenumber" name="L3085" href="#L3085">3085</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = cleaned.length() - 1; i >= 0; i--) {
-<a class="jxr_linenumber" name="L3086" href="#L3086">3086</a> <strong class="jxr_keyword">var</strong> digit = Character.getNumericValue(cleaned.charAt(i));
-<a class="jxr_linenumber" name="L3087" href="#L3087">3087</a> <strong class="jxr_keyword">if</strong> (alternate) {
-<a class="jxr_linenumber" name="L3088" href="#L3088">3088</a> digit *= 2;
-<a class="jxr_linenumber" name="L3089" href="#L3089">3089</a> <strong class="jxr_keyword">if</strong> (digit > 9)
-<a class="jxr_linenumber" name="L3090" href="#L3090">3090</a> digit = (digit % 10) + 1;
-<a class="jxr_linenumber" name="L3091" href="#L3091">3091</a> }
-<a class="jxr_linenumber" name="L3092" href="#L3092">3092</a> sum += digit;
-<a class="jxr_linenumber" name="L3093" href="#L3093">3093</a> alternate = ! alternate;
-<a class="jxr_linenumber" name="L3094" href="#L3094">3094</a> }
-<a class="jxr_linenumber" name="L3095" href="#L3095">3095</a> <strong class="jxr_keyword">return</strong> (sum % 10) == 0;
-<a class="jxr_linenumber" name="L3096" href="#L3096">3096</a> }
-<a class="jxr_linenumber" name="L3097" href="#L3097">3097</a>
-<a class="jxr_linenumber" name="L3098" href="#L3098">3098</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3099" href="#L3099">3099</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string is numeric.</em>
-<a class="jxr_linenumber" name="L3100" href="#L3100">3100</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3101" href="#L3101">3101</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L3102" href="#L3102">3102</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is numeric.</em>
-<a class="jxr_linenumber" name="L3103" href="#L3103">3103</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3104" href="#L3104">3104</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isDecimal(String s) {
-<a class="jxr_linenumber" name="L3105" href="#L3105">3105</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty() || ! FIRST_NUMBER_CHARS.contains(s.charAt(0)))
-<a class="jxr_linenumber" name="L3106" href="#L3106">3106</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3107" href="#L3107">3107</a> <strong class="jxr_keyword">var</strong> i = 0;
-<a class="jxr_linenumber" name="L3108" href="#L3108">3108</a> <strong class="jxr_keyword">var</strong> length = s.length();
-<a class="jxr_linenumber" name="L3109" href="#L3109">3109</a> <strong class="jxr_keyword">var</strong> c = s.charAt(0);
-<a class="jxr_linenumber" name="L3110" href="#L3110">3110</a> <strong class="jxr_keyword">var</strong> isPrefixed = false;
-<a class="jxr_linenumber" name="L3111" href="#L3111">3111</a> <strong class="jxr_keyword">if</strong> (c == '+' || c == '-') {
-<a class="jxr_linenumber" name="L3112" href="#L3112">3112</a> isPrefixed = <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3113" href="#L3113">3113</a> i++;
-<a class="jxr_linenumber" name="L3114" href="#L3114">3114</a> }
-<a class="jxr_linenumber" name="L3115" href="#L3115">3115</a> <strong class="jxr_keyword">if</strong> (i == length)
-<a class="jxr_linenumber" name="L3116" href="#L3116">3116</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3117" href="#L3117">3117</a> c = s.charAt(i++);
-<a class="jxr_linenumber" name="L3118" href="#L3118">3118</a> <strong class="jxr_keyword">if</strong> (c == '0' && length > (isPrefixed ? 2 : 1)) {
-<a class="jxr_linenumber" name="L3119" href="#L3119">3119</a> c = s.charAt(i++);
-<a class="jxr_linenumber" name="L3120" href="#L3120">3120</a> <strong class="jxr_keyword">if</strong> (c == 'x' || c == 'X') {
-<a class="jxr_linenumber" name="L3121" href="#L3121">3121</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = i; j < length; j++) {
-<a class="jxr_linenumber" name="L3122" href="#L3122">3122</a> <strong class="jxr_keyword">if</strong> (! HEXADECIMAL_CHARS.contains(s.charAt(j)))
-<a class="jxr_linenumber" name="L3123" href="#L3123">3123</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3124" href="#L3124">3124</a> }
-<a class="jxr_linenumber" name="L3125" href="#L3125">3125</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (OCTAL_CHARS.contains(c)) {
-<a class="jxr_linenumber" name="L3126" href="#L3126">3126</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = i; j < length; j++)
-<a class="jxr_linenumber" name="L3127" href="#L3127">3127</a> <strong class="jxr_keyword">if</strong> (! OCTAL_CHARS.contains(s.charAt(j)))
-<a class="jxr_linenumber" name="L3128" href="#L3128">3128</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3129" href="#L3129">3129</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L3130" href="#L3130">3130</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3131" href="#L3131">3131</a> }
-<a class="jxr_linenumber" name="L3132" href="#L3132">3132</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '#') {
-<a class="jxr_linenumber" name="L3133" href="#L3133">3133</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = i; j < length; j++) {
-<a class="jxr_linenumber" name="L3134" href="#L3134">3134</a> <strong class="jxr_keyword">if</strong> (! HEXADECIMAL_CHARS.contains(s.charAt(j)))
-<a class="jxr_linenumber" name="L3135" href="#L3135">3135</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3136" href="#L3136">3136</a> }
-<a class="jxr_linenumber" name="L3137" href="#L3137">3137</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (DECIMAL_CHARS.contains(c)) {
-<a class="jxr_linenumber" name="L3138" href="#L3138">3138</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = i; j < length; j++)
-<a class="jxr_linenumber" name="L3139" href="#L3139">3139</a> <strong class="jxr_keyword">if</strong> (! DECIMAL_CHARS.contains(s.charAt(j)))
-<a class="jxr_linenumber" name="L3140" href="#L3140">3140</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3141" href="#L3141">3141</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L3142" href="#L3142">3142</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3143" href="#L3143">3143</a> }
-<a class="jxr_linenumber" name="L3144" href="#L3144">3144</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3145" href="#L3145">3145</a> }
-<a class="jxr_linenumber" name="L3146" href="#L3146">3146</a>
-<a class="jxr_linenumber" name="L3147" href="#L3147">3147</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3148" href="#L3148">3148</a> <em class="jxr_javadoccomment"> * Checks if a string contains only digit characters (0-9).</em>
-<a class="jxr_linenumber" name="L3149" href="#L3149">3149</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3150" href="#L3150">3150</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3151" href="#L3151">3151</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3152" href="#L3152">3152</a> <em class="jxr_javadoccomment"> * isDigit(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3153" href="#L3153">3153</a> <em class="jxr_javadoccomment"> * isDigit(<js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3154" href="#L3154">3154</a> <em class="jxr_javadoccomment"> * isDigit(<js>"123"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3155" href="#L3155">3155</a> <em class="jxr_javadoccomment"> * isDigit(<js>"abc123"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3156" href="#L3156">3156</a> <em class="jxr_javadoccomment"> * isDigit(<js>"12.3"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3157" href="#L3157">3157</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3158" href="#L3158">3158</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3159" href="#L3159">3159</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L3160" href="#L3160">3160</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains only digit characters.</em>
-<a class="jxr_linenumber" name="L3161" href="#L3161">3161</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3162" href="#L3162">3162</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isDigit(String str) {
-<a class="jxr_linenumber" name="L3163" href="#L3163">3163</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L3164" href="#L3164">3164</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3165" href="#L3165">3165</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L3166" href="#L3166">3166</a> <strong class="jxr_keyword">if</strong> (! Character.isDigit(str.charAt(i)))
-<a class="jxr_linenumber" name="L3167" href="#L3167">3167</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3168" href="#L3168">3168</a> }
-<a class="jxr_linenumber" name="L3169" href="#L3169">3169</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3170" href="#L3170">3170</a> }
-<a class="jxr_linenumber" name="L3171" href="#L3171">3171</a>
-<a class="jxr_linenumber" name="L3172" href="#L3172">3172</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3173" href="#L3173">3173</a> <em class="jxr_javadoccomment"> * Checks if a string is a valid email address.</em>
-<a class="jxr_linenumber" name="L3174" href="#L3174">3174</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3175" href="#L3175">3175</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3176" href="#L3176">3176</a> <em class="jxr_javadoccomment"> * Performs basic email validation using a simple regex pattern.</em>
-<a class="jxr_linenumber" name="L3177" href="#L3177">3177</a> <em class="jxr_javadoccomment"> * This is not a complete RFC 5321/5322 validation, but covers most common email formats.</em>
-<a class="jxr_linenumber" name="L3178" href="#L3178">3178</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3179" href="#L3179">3179</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3180" href="#L3180">3180</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3181" href="#L3181">3181</a> <em class="jxr_javadoccomment"> * isEmail(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3182" href="#L3182">3182</a> <em class="jxr_javadoccomment"> * isEmail(<js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3183" href="#L3183">3183</a> <em class="jxr_javadoccomment"> * isEmail(<js>"user@example.com"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3184" href="#L3184">3184</a> <em class="jxr_javadoccomment"> * isEmail(<js>"invalid.email"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3185" href="#L3185">3185</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3186" href="#L3186">3186</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3187" href="#L3187">3187</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L3188" href="#L3188">3188</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid email address.</em>
-<a class="jxr_linenumber" name="L3189" href="#L3189">3189</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3190" href="#L3190">3190</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmail(String str) {
-<a class="jxr_linenumber" name="L3191" href="#L3191">3191</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L3192" href="#L3192">3192</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3193" href="#L3193">3193</a> <em class="jxr_comment">// Basic email regex: local@domain</em>
-<a class="jxr_linenumber" name="L3194" href="#L3194">3194</a> <em class="jxr_comment">// Allows letters, digits, dots, underscores, hyphens, and plus signs in local part</em>
-<a class="jxr_linenumber" name="L3195" href="#L3195">3195</a> <em class="jxr_comment">// Domain must have at least one dot and valid TLD</em>
-<a class="jxr_linenumber" name="L3196" href="#L3196">3196</a> <strong class="jxr_keyword">return</strong> str.matches(<span class="jxr_string">"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"</span>);
-<a class="jxr_linenumber" name="L3197" href="#L3197">3197</a> }
-<a class="jxr_linenumber" name="L3198" href="#L3198">3198</a>
-<a class="jxr_linenumber" name="L3199" href="#L3199">3199</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3200" href="#L3200">3200</a> <em class="jxr_javadoccomment"> * Checks if a string is null or empty.</em>
-<a class="jxr_linenumber" name="L3201" href="#L3201">3201</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3202" href="#L3202">3202</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3203" href="#L3203">3203</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3204" href="#L3204">3204</a> <em class="jxr_javadoccomment"> * isEmpty(<jk>null</jk>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3205" href="#L3205">3205</a> <em class="jxr_javadoccomment"> * isEmpty(<js>""</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3206" href="#L3206">3206</a> <em class="jxr_javadoccomment"> * isEmpty(<js>"abc"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3207" href="#L3207">3207</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3208" href="#L3208">3208</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3209" href="#L3209">3209</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L3210" href="#L3210">3210</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is null or empty.</em>
-<a class="jxr_linenumber" name="L3211" href="#L3211">3211</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3212" href="#L3212">3212</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(String str) {
-<a class="jxr_linenumber" name="L3213" href="#L3213">3213</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> || str.isEmpty();
-<a class="jxr_linenumber" name="L3214" href="#L3214">3214</a> }
-<a class="jxr_linenumber" name="L3215" href="#L3215">3215</a>
-<a class="jxr_linenumber" name="L3216" href="#L3216">3216</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3217" href="#L3217">3217</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified character is a valid first character for a number.</em>
-<a class="jxr_linenumber" name="L3218" href="#L3218">3218</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3219" href="#L3219">3219</a> <em class="jxr_javadoccomment"> * @param c The character to test.</em>
-<a class="jxr_linenumber" name="L3220" href="#L3220">3220</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified character is a valid first character for a number.</em>
-<a class="jxr_linenumber" name="L3221" href="#L3221">3221</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3222" href="#L3222">3222</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isFirstNumberChar(<strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L3223" href="#L3223">3223</a> <strong class="jxr_keyword">return</strong> FIRST_NUMBER_CHARS.contains(c);
-<a class="jxr_linenumber" name="L3224" href="#L3224">3224</a> }
-<a class="jxr_linenumber" name="L3225" href="#L3225">3225</a>
-<a class="jxr_linenumber" name="L3226" href="#L3226">3226</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3227" href="#L3227">3227</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string is a floating point number.</em>
-<a class="jxr_linenumber" name="L3228" href="#L3228">3228</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3229" href="#L3229">3229</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L3230" href="#L3230">3230</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is a floating point number.</em>
-<a class="jxr_linenumber" name="L3231" href="#L3231">3231</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3232" href="#L3232">3232</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isFloat(String s) {
-<a class="jxr_linenumber" name="L3233" href="#L3233">3233</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty())
-<a class="jxr_linenumber" name="L3234" href="#L3234">3234</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3235" href="#L3235">3235</a> <strong class="jxr_keyword">if</strong> (! FIRST_NUMBER_CHARS.contains(s.charAt(0)))
-<a class="jxr_linenumber" name="L3236" href="#L3236">3236</a> <strong class="jxr_keyword">return</strong> (s.equals(<span class="jxr_string">"NaN"</span>) || s.equals(<span class="jxr_string">"Infinity"</span>));
-<a class="jxr_linenumber" name="L3237" href="#L3237">3237</a> <strong class="jxr_keyword">var</strong> i = 0;
-<a class="jxr_linenumber" name="L3238" href="#L3238">3238</a> <strong class="jxr_keyword">var</strong> length = s.length();
-<a class="jxr_linenumber" name="L3239" href="#L3239">3239</a> <strong class="jxr_keyword">var</strong> c = s.charAt(0);
-<a class="jxr_linenumber" name="L3240" href="#L3240">3240</a> <strong class="jxr_keyword">if</strong> (c == '+' || c == '-')
-<a class="jxr_linenumber" name="L3241" href="#L3241">3241</a> i++;
-<a class="jxr_linenumber" name="L3242" href="#L3242">3242</a> <strong class="jxr_keyword">if</strong> (i == length)
-<a class="jxr_linenumber" name="L3243" href="#L3243">3243</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3244" href="#L3244">3244</a> c = s.charAt(i);
-<a class="jxr_linenumber" name="L3245" href="#L3245">3245</a> <strong class="jxr_keyword">if</strong> (c == '.' || DECIMAL_CHARS.contains(c)) {
-<a class="jxr_linenumber" name="L3246" href="#L3246">3246</a> <strong class="jxr_keyword">return</strong> FP_REGEX.matcher(s).matches();
-<a class="jxr_linenumber" name="L3247" href="#L3247">3247</a> }
-<a class="jxr_linenumber" name="L3248" href="#L3248">3248</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3249" href="#L3249">3249</a> }
-<a class="jxr_linenumber" name="L3250" href="#L3250">3250</a>
-<a class="jxr_linenumber" name="L3251" href="#L3251">3251</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3252" href="#L3252">3252</a> <em class="jxr_javadoccomment"> * Checks if a string is already interned.</em>
-<a class="jxr_linenumber" name="L3253" href="#L3253">3253</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3254" href="#L3254">3254</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3255" href="#L3255">3255</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the input string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3256" href="#L3256">3256</a> <em class="jxr_javadoccomment"> * A string is considered interned if it is the same object reference as its interned version.</em>
-<a class="jxr_linenumber" name="L3257" href="#L3257">3257</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3258" href="#L3258">3258</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L3259" href="#L3259">3259</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3260" href="#L3260">3260</a> <em class="jxr_javadoccomment"> * String <jv>s1</jv> = <js>"test"</js>; <jc>// String literal is automatically interned</jc></em>
-<a class="jxr_linenumber" name="L3261" href="#L3261">3261</a> <em class="jxr_javadoccomment"> * assertTrue(isInterned(<jv>s1</jv>));</em>
-<a class="jxr_linenumber" name="L3262" href="#L3262">3262</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3263" href="#L3263">3263</a> <em class="jxr_javadoccomment"> * String <jv>s2</jv> = <jk>new</jk> String(<js>"test"</js>); <jc>// New object, not interned</jc></em>
-<a class="jxr_linenumber" name="L3264" href="#L3264">3264</a> <em class="jxr_javadoccomment"> * assertFalse(isInterned(<jv>s2</jv>));</em>
-<a class="jxr_linenumber" name="L3265" href="#L3265">3265</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3266" href="#L3266">3266</a> <em class="jxr_javadoccomment"> * String <jv>s3</jv> = intern(<jv>s2</jv>); <jc>// Now interned</jc></em>
-<a class="jxr_linenumber" name="L3267" href="#L3267">3267</a> <em class="jxr_javadoccomment"> * assertTrue(isInterned(<jv>s3</jv>));</em>
-<a class="jxr_linenumber" name="L3268" href="#L3268">3268</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3269" href="#L3269">3269</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3270" href="#L3270">3270</a> <em class="jxr_javadoccomment"> * @param str The string to check. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3271" href="#L3271">3271</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is interned, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L3272" href="#L3272">3272</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3273" href="#L3273">3273</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isInterned(String str) {
-<a class="jxr_linenumber" name="L3274" href="#L3274">3274</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3275" href="#L3275">3275</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3276" href="#L3276">3276</a> <strong class="jxr_keyword">return</strong> str == str.intern();
-<a class="jxr_linenumber" name="L3277" href="#L3277">3277</a> }
-<a class="jxr_linenumber" name="L3278" href="#L3278">3278</a>
-<a class="jxr_linenumber" name="L3279" href="#L3279">3279</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3280" href="#L3280">3280</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string is valid JSON.</em>
-<a class="jxr_linenumber" name="L3281" href="#L3281">3281</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3282" href="#L3282">3282</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3283" href="#L3283">3283</a> <em class="jxr_javadoccomment"> * Leading and trailing spaces are ignored.</em>
-<a class="jxr_linenumber" name="L3284" href="#L3284">3284</a> <em class="jxr_javadoccomment"> * <br>Leading and trailing comments are not allowed.</em>
-<a class="jxr_linenumber" name="L3285" href="#L3285">3285</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3286" href="#L3286">3286</a> <em class="jxr_javadoccomment"> * @param s The string to test.</em>
-<a class="jxr_linenumber" name="L3287" href="#L3287">3287</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is valid JSON.</em>
-<a class="jxr_linenumber" name="L3288" href="#L3288">3288</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3289" href="#L3289">3289</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isJson(String s) {
-<a class="jxr_linenumber" name="L3290" href="#L3290">3290</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3291" href="#L3291">3291</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3292" href="#L3292">3292</a> <strong class="jxr_keyword">var</strong> c1 = firstNonWhitespaceChar(s);
-<a class="jxr_linenumber" name="L3293" href="#L3293">3293</a> <strong class="jxr_keyword">var</strong> c2 = lastNonWhitespaceChar(s);
-<a class="jxr_linenumber" name="L3294" href="#L3294">3294</a> <strong class="jxr_keyword">if</strong> (c1 == '{' && c2 == '}' || c1 == '[' && c2 == ']' || c1 == '\'' && c2 == '\'')
-<a class="jxr_linenumber" name="L3295" href="#L3295">3295</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3296" href="#L3296">3296</a> <strong class="jxr_keyword">return</strong> (isOneOf(s, <span class="jxr_string">"true"</span>, <span class="jxr_string">"false"</span>, <span class="jxr_string">"null"</span>) || isNumeric(s));
-<a class="jxr_linenumber" name="L3297" href="#L3297">3297</a> }
-<a class="jxr_linenumber" name="L3298" href="#L3298">3298</a>
-<a class="jxr_linenumber" name="L3299" href="#L3299">3299</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3300" href="#L3300">3300</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string appears to be an JSON array.</em>
-<a class="jxr_linenumber" name="L3301" href="#L3301">3301</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3302" href="#L3302">3302</a> <em class="jxr_javadoccomment"> * @param o The object to test.</em>
-<a class="jxr_linenumber" name="L3303" href="#L3303">3303</a> <em class="jxr_javadoccomment"> * @param ignoreWhitespaceAndComments If <jk>true</jk>, leading and trailing whitespace and comments will be ignored.</em>
-<a class="jxr_linenumber" name="L3304" href="#L3304">3304</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string appears to be a JSON array.</em>
-<a class="jxr_linenumber" name="L3305" href="#L3305">3305</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3306" href="#L3306">3306</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isJsonArray(Object o, <strong class="jxr_keyword">boolean</strong> ignoreWhitespaceAndComments) {
-<a class="jxr_linenumber" name="L3307" href="#L3307">3307</a> <strong class="jxr_keyword">if</strong> (o instanceof CharSequence o2) {
-<a class="jxr_linenumber" name="L3308" href="#L3308">3308</a> <strong class="jxr_keyword">var</strong> s = o2.toString();
-<a class="jxr_linenumber" name="L3309" href="#L3309">3309</a> <strong class="jxr_keyword">if</strong> (! ignoreWhitespaceAndComments)
-<a class="jxr_linenumber" name="L3310" href="#L3310">3310</a> <strong class="jxr_keyword">return</strong> (s.startsWith(<span class="jxr_string">"["</span>) && s.endsWith(<span class="jxr_string">"]"</span>));
-<a class="jxr_linenumber" name="L3311" href="#L3311">3311</a> <strong class="jxr_keyword">if</strong> (firstRealCharacter(s) != '[')
-<a class="jxr_linenumber" name="L3312" href="#L3312">3312</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3313" href="#L3313">3313</a> <strong class="jxr_keyword">var</strong> i = s.lastIndexOf(']');
-<a class="jxr_linenumber" name="L3314" href="#L3314">3314</a> <strong class="jxr_keyword">if</strong> (i == -1)
-<a class="jxr_linenumber" name="L3315" href="#L3315">3315</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3316" href="#L3316">3316</a> s = s.substring(i + 1);
-<a class="jxr_linenumber" name="L3317" href="#L3317">3317</a> <strong class="jxr_keyword">return</strong> firstRealCharacter(s) == -1;
-<a class="jxr_linenumber" name="L3318" href="#L3318">3318</a> }
-<a class="jxr_linenumber" name="L3319" href="#L3319">3319</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3320" href="#L3320">3320</a> }
-<a class="jxr_linenumber" name="L3321" href="#L3321">3321</a>
-<a class="jxr_linenumber" name="L3322" href="#L3322">3322</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3323" href="#L3323">3323</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string appears to be a JSON object.</em>
-<a class="jxr_linenumber" name="L3324" href="#L3324">3324</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3325" href="#L3325">3325</a> <em class="jxr_javadoccomment"> * @param o The object to test.</em>
-<a class="jxr_linenumber" name="L3326" href="#L3326">3326</a> <em class="jxr_javadoccomment"> * @param ignoreWhitespaceAndComments If <jk>true</jk>, leading and trailing whitespace and comments will be ignored.</em>
-<a class="jxr_linenumber" name="L3327" href="#L3327">3327</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string appears to be a JSON object.</em>
-<a class="jxr_linenumber" name="L3328" href="#L3328">3328</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3329" href="#L3329">3329</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isJsonObject(Object o, <strong class="jxr_keyword">boolean</strong> ignoreWhitespaceAndComments) {
-<a class="jxr_linenumber" name="L3330" href="#L3330">3330</a> <strong class="jxr_keyword">if</strong> (o instanceof CharSequence o2) {
-<a class="jxr_linenumber" name="L3331" href="#L3331">3331</a> <strong class="jxr_keyword">var</strong> s = o2.toString();
-<a class="jxr_linenumber" name="L3332" href="#L3332">3332</a> <strong class="jxr_keyword">if</strong> (! ignoreWhitespaceAndComments)
-<a class="jxr_linenumber" name="L3333" href="#L3333">3333</a> <strong class="jxr_keyword">return</strong> (s.startsWith(<span class="jxr_string">"{"</span>) && s.endsWith(<span class="jxr_string">"}"</span>));
-<a class="jxr_linenumber" name="L3334" href="#L3334">3334</a> <strong class="jxr_keyword">if</strong> (firstRealCharacter(s) != '{')
-<a class="jxr_linenumber" name="L3335" href="#L3335">3335</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3336" href="#L3336">3336</a> <strong class="jxr_keyword">var</strong> i = s.lastIndexOf('}');
-<a class="jxr_linenumber" name="L3337" href="#L3337">3337</a> <strong class="jxr_keyword">if</strong> (i == -1)
-<a class="jxr_linenumber" name="L3338" href="#L3338">3338</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3339" href="#L3339">3339</a> s = s.substring(i + 1);
-<a class="jxr_linenumber" name="L3340" href="#L3340">3340</a> <strong class="jxr_keyword">return</strong> firstRealCharacter(s) == -1;
-<a class="jxr_linenumber" name="L3341" href="#L3341">3341</a> }
-<a class="jxr_linenumber" name="L3342" href="#L3342">3342</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3343" href="#L3343">3343</a> }
-<a class="jxr_linenumber" name="L3344" href="#L3344">3344</a>
-<a class="jxr_linenumber" name="L3345" href="#L3345">3345</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3346" href="#L3346">3346</a> <em class="jxr_javadoccomment"> * Checks if a string is not blank (not null, not empty, and not whitespace only).</em>
-<a class="jxr_linenumber" name="L3347" href="#L3347">3347</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3348" href="#L3348">3348</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3349" href="#L3349">3349</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3350" href="#L3350">3350</a> <em class="jxr_javadoccomment"> * isNotBlank(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3351" href="#L3351">3351</a> <em class="jxr_javadoccomment"> * isNotBlank(<js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3352" href="#L3352">3352</a> <em class="jxr_javadoccomment"> * isNotBlank(<js>" "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3353" href="#L3353">3353</a> <em class="jxr_javadoccomment"> * isNotBlank(<js>"hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3354" href="#L3354">3354</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3355" href="#L3355">3355</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3356" href="#L3356">3356</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L3357" href="#L3357">3357</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains non-whitespace characters.</em>
-<a class="jxr_linenumber" name="L3358" href="#L3358">3358</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3359" href="#L3359">3359</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotBlank(CharSequence str) {
-<a class="jxr_linenumber" name="L3360" href="#L3360">3360</a> <strong class="jxr_keyword">return</strong> ! isBlank(str);
-<a class="jxr_linenumber" name="L3361" href="#L3361">3361</a> }
-<a class="jxr_linenumber" name="L3362" href="#L3362">3362</a>
-<a class="jxr_linenumber" name="L3363" href="#L3363">3363</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3364" href="#L3364">3364</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified character is a valid number character.</em>
-<a class="jxr_linenumber" name="L3365" href="#L3365">3365</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3366" href="#L3366">3366</a> <em class="jxr_javadoccomment"> * @param c The character to check.</em>
-<a class="jxr_linenumber" name="L3367" href="#L3367">3367</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified character is a valid number character.</em>
-<a class="jxr_linenumber" name="L3368" href="#L3368">3368</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3369" href="#L3369">3369</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNumberChar(<strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L3370" href="#L3370">3370</a> <strong class="jxr_keyword">return</strong> NUMBER_CHARS.contains(c);
-<a class="jxr_linenumber" name="L3371" href="#L3371">3371</a> }
-<a class="jxr_linenumber" name="L3372" href="#L3372">3372</a>
-<a class="jxr_linenumber" name="L3373" href="#L3373">3373</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3374" href="#L3374">3374</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if this string can be parsed by {@link #parseNumber(String, Class)}.</em>
-<a class="jxr_linenumber" name="L3375" href="#L3375">3375</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3376" href="#L3376">3376</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L3377" href="#L3377">3377</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if this string can be parsed without causing an exception.</em>
-<a class="jxr_linenumber" name="L3378" href="#L3378">3378</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3379" href="#L3379">3379</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNumeric(String s) {
-<a class="jxr_linenumber" name="L3380" href="#L3380">3380</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty() || ! isFirstNumberChar(s.charAt(0)))
-<a class="jxr_linenumber" name="L3381" href="#L3381">3381</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3382" href="#L3382">3382</a> <strong class="jxr_keyword">return</strong> isDecimal(s) || isFloat(s);
-<a class="jxr_linenumber" name="L3383" href="#L3383">3383</a> }
-<a class="jxr_linenumber" name="L3384" href="#L3384">3384</a>
-<a class="jxr_linenumber" name="L3385" href="#L3385">3385</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3386" href="#L3386">3386</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string is one of the specified values.</em>
-<a class="jxr_linenumber" name="L3387" href="#L3387">3387</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3388" href="#L3388">3388</a> <em class="jxr_javadoccomment"> * @param s</em>
-<a class="jxr_linenumber" name="L3389" href="#L3389">3389</a> <em class="jxr_javadoccomment"> * The string to test.</em>
-<a class="jxr_linenumber" name="L3390" href="#L3390">3390</a> <em class="jxr_javadoccomment"> * Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3391" href="#L3391">3391</a> <em class="jxr_javadoccomment"> * @param values</em>
-<a class="jxr_linenumber" name="L3392" href="#L3392">3392</a> <em class="jxr_javadoccomment"> * The values to test.</em>
-<a class="jxr_linenumber" name="L3393" href="#L3393">3393</a> <em class="jxr_javadoccomment"> * Can contain <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3394" href="#L3394">3394</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is one of the specified values.</em>
-<a class="jxr_linenumber" name="L3395" href="#L3395">3395</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3396" href="#L3396">3396</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isOneOf(String s, String...values) {
-<a class="jxr_linenumber" name="L3397" href="#L3397">3397</a> assertArgNotNull(<span class="jxr_string">"values"</span>, values);
-<a class="jxr_linenumber" name="L3398" href="#L3398">3398</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> value : values)
-<a class="jxr_linenumber" name="L3399" href="#L3399">3399</a> <strong class="jxr_keyword">if</strong> (eq(s, value))
-<a class="jxr_linenumber" name="L3400" href="#L3400">3400</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3401" href="#L3401">3401</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3402" href="#L3402">3402</a> }
-<a class="jxr_linenumber" name="L3403" href="#L3403">3403</a>
-<a class="jxr_linenumber" name="L3404" href="#L3404">3404</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3405" href="#L3405">3405</a> <em class="jxr_javadoccomment"> * Checks if a string is a valid phone number.</em>
-<a class="jxr_linenumber" name="L3406" href="#L3406">3406</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3407" href="#L3407">3407</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3408" href="#L3408">3408</a> <em class="jxr_javadoccomment"> * Performs basic phone number validation.</em>
-<a class="jxr_linenumber" name="L3409" href="#L3409">3409</a> <em class="jxr_javadoccomment"> * Accepts various formats including:</em>
-<a class="jxr_linenumber" name="L3410" href="#L3410">3410</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L3411" href="#L3411">3411</a> <em class="jxr_javadoccomment"> * <li>Digits only: <js>"1234567890"</js></li></em>
-<a class="jxr_linenumber" name="L3412" href="#L3412">3412</a> <em class="jxr_javadoccomment"> * <li>With separators: <js>"(123) 456-7890"</js>, <js>"123-456-7890"</js>, <js>"123.456.7890"</js></li></em>
-<a class="jxr_linenumber" name="L3413" href="#L3413">3413</a> <em class="jxr_javadoccomment"> * <li>With country code: <js>"+1 123-456-7890"</js></li></em>
-<a class="jxr_linenumber" name="L3414" href="#L3414">3414</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L3415" href="#L3415">3415</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3416" href="#L3416">3416</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3417" href="#L3417">3417</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3418" href="#L3418">3418</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3419" href="#L3419">3419</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<js>""</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3420" href="#L3420">3420</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<js>"1234567890"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3421" href="#L3421">3421</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<js>"(123) 456-7890"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3422" href="#L3422">3422</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<js>"123"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3423" href="#L3423">3423</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3424" href="#L3424">3424</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3425" href="#L3425">3425</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L3426" href="#L3426">3426</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid phone number.</em>
-<a class="jxr_linenumber" name="L3427" href="#L3427">3427</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3428" href="#L3428">3428</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isPhoneNumber(String str) {
-<a class="jxr_linenumber" name="L3429" href="#L3429">3429</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L3430" href="#L3430">3430</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3431" href="#L3431">3431</a> <em class="jxr_comment">// Remove common phone number separators and check if remaining is 10-15 digits</em>
-<a class="jxr_linenumber" name="L3432" href="#L3432">3432</a> <em class="jxr_comment">// Allows: digits, spaces, parentheses, hyphens, dots, plus sign (for country code)</em>
-<a class="jxr_linenumber" name="L3433" href="#L3433">3433</a> <strong class="jxr_keyword">var</strong> cleaned = str.replaceAll(<span class="jxr_string">"[\\s()\\-\\.]"</span>, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L3434" href="#L3434">3434</a> <strong class="jxr_keyword">if</strong> (cleaned.startsWith(<span class="jxr_string">"+"</span>))
-<a class="jxr_linenumber" name="L3435" href="#L3435">3435</a> cleaned = cleaned.substring(1);
-<a class="jxr_linenumber" name="L3436" href="#L3436">3436</a> <em class="jxr_comment">// Phone numbers should have 10-15 digits (10 for US, up to 15 for international)</em>
-<a class="jxr_linenumber" name="L3437" href="#L3437">3437</a> <strong class="jxr_keyword">return</strong> cleaned.matches(<span class="jxr_string">"^\\d{10,15}$"</span>);
-<a class="jxr_linenumber" name="L3438" href="#L3438">3438</a> }
-<a class="jxr_linenumber" name="L3439" href="#L3439">3439</a>
-<a class="jxr_linenumber" name="L3440" href="#L3440">3440</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3441" href="#L3441">3441</a> <em class="jxr_javadoccomment"> * Checks if two strings are similar based on a similarity threshold.</em>
-<a class="jxr_linenumber" name="L3442" href="#L3442">3442</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3443" href="#L3443">3443</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3444" href="#L3444">3444</a> <em class="jxr_javadoccomment"> * Uses the {@link #similarity(String, String)} method to calculate similarity and compares it to the threshold.</em>
-<a class="jxr_linenumber" name="L3445" href="#L3445">3445</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3446" href="#L3446">3446</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3447" href="#L3447">3447</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3448" href="#L3448">3448</a> <em class="jxr_javadoccomment"> * isSimilar(<js>"hello"</js>, <js>"hello"</js>, <js>0.8</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3449" href="#L3449">3449</a> <em class="jxr_javadoccomment"> * isSimilar(<js>"kitten"</js>, <js>"sitting"</js>, <js>0.8</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3450" href="#L3450">3450</a> <em class="jxr_javadoccomment"> * isSimilar(<js>"kitten"</js>, <js>"sitting"</js>, <js>0.5</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3451" href="#L3451">3451</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3452" href="#L3452">3452</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3453" href="#L3453">3453</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
-<a class="jxr_linenumber" name="L3454" href="#L3454">3454</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
-<a class="jxr_linenumber" name="L3455" href="#L3455">3455</a> <em class="jxr_javadoccomment"> * @param threshold The similarity threshold (0.0 to 1.0).</em>
-<a class="jxr_linenumber" name="L3456" href="#L3456">3456</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the similarity is greater than or equal to the threshold, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L3457" href="#L3457">3457</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3458" href="#L3458">3458</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isSimilar(String str1, String str2, <strong class="jxr_keyword">double</strong> threshold) {
-<a class="jxr_linenumber" name="L3459" href="#L3459">3459</a> <strong class="jxr_keyword">return</strong> similarity(str1, str2) >= threshold;
-<a class="jxr_linenumber" name="L3460" href="#L3460">3460</a> }
-<a class="jxr_linenumber" name="L3461" href="#L3461">3461</a>
-<a class="jxr_linenumber" name="L3462" href="#L3462">3462</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3463" href="#L3463">3463</a> <em class="jxr_javadoccomment"> * Efficiently determines whether a URL is of the pattern "xxx:/xxx".</em>
-<a class="jxr_linenumber" name="L3464" href="#L3464">3464</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3465" href="#L3465">3465</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3466" href="#L3466">3466</a> <em class="jxr_javadoccomment"> * The pattern matched is: <c>[a-z]{2,}\:\/.*</c></em>
-<a class="jxr_linenumber" name="L3467" href="#L3467">3467</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3468" href="#L3468">3468</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3469" href="#L3469">3469</a> <em class="jxr_javadoccomment"> * Note that this excludes filesystem paths such as <js>"C:/temp"</js>.</em>
+<a class="jxr_linenumber" name="L2830" href="#L2830">2830</a> <em class="jxr_comment">// S1: Looking for http</em>
+<a class="jxr_linenumber" name="L2831" href="#L2831">2831</a> <em class="jxr_comment">// S2: Found http, looking for :</em>
+<a class="jxr_linenumber" name="L2832" href="#L2832">2832</a> <em class="jxr_comment">// S3: Found :, looking for /</em>
+<a class="jxr_linenumber" name="L2833" href="#L2833">2833</a> <em class="jxr_comment">// S4: Found /, looking for /</em>
+<a class="jxr_linenumber" name="L2834" href="#L2834">2834</a> <em class="jxr_comment">// S5: Found /, looking for x</em>
+<a class="jxr_linenumber" name="L2835" href="#L2835">2835</a>
+<a class="jxr_linenumber" name="L2836" href="#L2836">2836</a> <strong class="jxr_keyword">var</strong> state = S1;
+<a class="jxr_linenumber" name="L2837" href="#L2837">2837</a>
+<a class="jxr_linenumber" name="L2838" href="#L2838">2838</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L2839" href="#L2839">2839</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L2840" href="#L2840">2840</a> <strong class="jxr_keyword">if</strong> (state == S1) {
+<a class="jxr_linenumber" name="L2841" href="#L2841">2841</a> <strong class="jxr_keyword">if</strong> (c >= 'a' && c <= 'z')
+<a class="jxr_linenumber" name="L2842" href="#L2842">2842</a> state = S2;
+<a class="jxr_linenumber" name="L2843" href="#L2843">2843</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2844" href="#L2844">2844</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2845" href="#L2845">2845</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2) {
+<a class="jxr_linenumber" name="L2846" href="#L2846">2846</a> <strong class="jxr_keyword">if</strong> (c == ':')
+<a class="jxr_linenumber" name="L2847" href="#L2847">2847</a> state = S3;
+<a class="jxr_linenumber" name="L2848" href="#L2848">2848</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c < 'a' || c > 'z')
+<a class="jxr_linenumber" name="L2849" href="#L2849">2849</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2850" href="#L2850">2850</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S3) { <em class="jxr_comment">// NOSONAR - False positive.</em>
+<a class="jxr_linenumber" name="L2851" href="#L2851">2851</a> <strong class="jxr_keyword">if</strong> (c == '/')
+<a class="jxr_linenumber" name="L2852" href="#L2852">2852</a> state = S4;
+<a class="jxr_linenumber" name="L2853" href="#L2853">2853</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2854" href="#L2854">2854</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2855" href="#L2855">2855</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S4) {
+<a class="jxr_linenumber" name="L2856" href="#L2856">2856</a> <strong class="jxr_keyword">if</strong> (c == '/')
+<a class="jxr_linenumber" name="L2857" href="#L2857">2857</a> state = S5;
+<a class="jxr_linenumber" name="L2858" href="#L2858">2858</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L2859" href="#L2859">2859</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2860" href="#L2860">2860</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S5) {
+<a class="jxr_linenumber" name="L2861" href="#L2861">2861</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L2862" href="#L2862">2862</a> }
+<a class="jxr_linenumber" name="L2863" href="#L2863">2863</a> }
+<a class="jxr_linenumber" name="L2864" href="#L2864">2864</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2865" href="#L2865">2865</a> }
+<a class="jxr_linenumber" name="L2866" href="#L2866">2866</a>
+<a class="jxr_linenumber" name="L2867" href="#L2867">2867</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2868" href="#L2868">2868</a> <em class="jxr_javadoccomment"> * Checks if all of the provided strings are not blank (not null, not empty, and not whitespace only).</em>
+<a class="jxr_linenumber" name="L2869" href="#L2869">2869</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2870" href="#L2870">2870</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2871" href="#L2871">2871</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> only if all strings are not null, not empty, and contain non-whitespace characters.</em>
+<a class="jxr_linenumber" name="L2872" href="#L2872">2872</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the array is null or empty, or if any string is null, empty, or whitespace only.</em>
+<a class="jxr_linenumber" name="L2873" href="#L2873">2873</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2874" href="#L2874">2874</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2875" href="#L2875">2875</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2876" href="#L2876">2876</a> <em class="jxr_javadoccomment"> * isAllNotBlank(); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2877" href="#L2877">2877</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2878" href="#L2878">2878</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<jk>null</jk>, <jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2879" href="#L2879">2879</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>""</js>, <js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2880" href="#L2880">2880</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>" "</js>, <js>" "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2881" href="#L2881">2881</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<jk>null</jk>, <js>"hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2882" href="#L2882">2882</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>""</js>, <js>" "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2883" href="#L2883">2883</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>"hello"</js>, <js>" "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2884" href="#L2884">2884</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>"hello"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2885" href="#L2885">2885</a> <em class="jxr_javadoccomment"> * isAllNotBlank(<js>"hello"</js>, <js>"world"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2886" href="#L2886">2886</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2887" href="#L2887">2887</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2888" href="#L2888">2888</a> <em class="jxr_javadoccomment"> * @param values The strings to check.</em>
+<a class="jxr_linenumber" name="L2889" href="#L2889">2889</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if all strings are not null, not empty, and not whitespace only, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L2890" href="#L2890">2890</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2891" href="#L2891">2891</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAllNotBlank(CharSequence...values) {
+<a class="jxr_linenumber" name="L2892" href="#L2892">2892</a> <strong class="jxr_keyword">if</strong> (values == <strong class="jxr_keyword">null</strong> || values.length == 0)
+<a class="jxr_linenumber" name="L2893" href="#L2893">2893</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2894" href="#L2894">2894</a> <strong class="jxr_keyword">for</strong> (CharSequence value : values)
+<a class="jxr_linenumber" name="L2895" href="#L2895">2895</a> <strong class="jxr_keyword">if</strong> (! isNotBlank(value))
+<a class="jxr_linenumber" name="L2896" href="#L2896">2896</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2897" href="#L2897">2897</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L2898" href="#L2898">2898</a> }
+<a class="jxr_linenumber" name="L2899" href="#L2899">2899</a>
+<a class="jxr_linenumber" name="L2900" href="#L2900">2900</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2901" href="#L2901">2901</a> <em class="jxr_javadoccomment"> * Checks if all of the provided strings are not empty (not null and not zero-length).</em>
+<a class="jxr_linenumber" name="L2902" href="#L2902">2902</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2903" href="#L2903">2903</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2904" href="#L2904">2904</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> only if all strings are not null and have a length greater than zero.</em>
+<a class="jxr_linenumber" name="L2905" href="#L2905">2905</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the array is null or empty, or if any string is null or empty.</em>
+<a class="jxr_linenumber" name="L2906" href="#L2906">2906</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2907" href="#L2907">2907</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2908" href="#L2908">2908</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2909" href="#L2909">2909</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2910" href="#L2910">2910</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2911" href="#L2911">2911</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<jk>null</jk>, <jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2912" href="#L2912">2912</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>""</js>, <js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2913" href="#L2913">2913</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<jk>null</jk>, <js>"hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2914" href="#L2914">2914</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>""</js>, <js>" "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2915" href="#L2915">2915</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>"hello"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2916" href="#L2916">2916</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>"hello"</js>, <js>"world"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2917" href="#L2917">2917</a> <em class="jxr_javadoccomment"> * isAllNotEmpty(<js>"hello"</js>, <js>" "</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2918" href="#L2918">2918</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2919" href="#L2919">2919</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2920" href="#L2920">2920</a> <em class="jxr_javadoccomment"> * @param values The strings to check.</em>
+<a class="jxr_linenumber" name="L2921" href="#L2921">2921</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if all strings are not null and not empty, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L2922" href="#L2922">2922</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2923" href="#L2923">2923</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAllNotEmpty(CharSequence...values) {
+<a class="jxr_linenumber" name="L2924" href="#L2924">2924</a> <strong class="jxr_keyword">if</strong> (values == <strong class="jxr_keyword">null</strong> || values.length == 0)
+<a class="jxr_linenumber" name="L2925" href="#L2925">2925</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2926" href="#L2926">2926</a> <strong class="jxr_keyword">for</strong> (CharSequence value : values)
+<a class="jxr_linenumber" name="L2927" href="#L2927">2927</a> <strong class="jxr_keyword">if</strong> (value == <strong class="jxr_keyword">null</strong> || value.isEmpty())
+<a class="jxr_linenumber" name="L2928" href="#L2928">2928</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2929" href="#L2929">2929</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L2930" href="#L2930">2930</a> }
+<a class="jxr_linenumber" name="L2931" href="#L2931">2931</a>
+<a class="jxr_linenumber" name="L2932" href="#L2932">2932</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2933" href="#L2933">2933</a> <em class="jxr_javadoccomment"> * Checks if a string contains only alphabetic characters (a-z, A-Z).</em>
+<a class="jxr_linenumber" name="L2934" href="#L2934">2934</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2935" href="#L2935">2935</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2936" href="#L2936">2936</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2937" href="#L2937">2937</a> <em class="jxr_javadoccomment"> * isAlpha(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2938" href="#L2938">2938</a> <em class="jxr_javadoccomment"> * isAlpha(<js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2939" href="#L2939">2939</a> <em class="jxr_javadoccomment"> * isAlpha(<js>"abc"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2940" href="#L2940">2940</a> <em class="jxr_javadoccomment"> * isAlpha(<js>"abc123"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2941" href="#L2941">2941</a> <em class="jxr_javadoccomment"> * isAlpha(<js>"abc def"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2942" href="#L2942">2942</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2943" href="#L2943">2943</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2944" href="#L2944">2944</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L2945" href="#L2945">2945</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains only alphabetic characters.</em>
+<a class="jxr_linenumber" name="L2946" href="#L2946">2946</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2947" href="#L2947">2947</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAlpha(String str) {
+<a class="jxr_linenumber" name="L2948" href="#L2948">2948</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L2949" href="#L2949">2949</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2950" href="#L2950">2950</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L2951" href="#L2951">2951</a> <strong class="jxr_keyword">if</strong> (! Character.isLetter(str.charAt(i)))
+<a class="jxr_linenumber" name="L2952" href="#L2952">2952</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2953" href="#L2953">2953</a> }
+<a class="jxr_linenumber" name="L2954" href="#L2954">2954</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L2955" href="#L2955">2955</a> }
+<a class="jxr_linenumber" name="L2956" href="#L2956">2956</a>
+<a class="jxr_linenumber" name="L2957" href="#L2957">2957</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2958" href="#L2958">2958</a> <em class="jxr_javadoccomment"> * Checks if a string contains only alphanumeric characters (a-z, A-Z, 0-9).</em>
+<a class="jxr_linenumber" name="L2959" href="#L2959">2959</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2960" href="#L2960">2960</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2961" href="#L2961">2961</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2962" href="#L2962">2962</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2963" href="#L2963">2963</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2964" href="#L2964">2964</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>"abc"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2965" href="#L2965">2965</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>"abc123"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2966" href="#L2966">2966</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>"abc def"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2967" href="#L2967">2967</a> <em class="jxr_javadoccomment"> * isAlphaNumeric(<js>"abc-123"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2968" href="#L2968">2968</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2969" href="#L2969">2969</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2970" href="#L2970">2970</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L2971" href="#L2971">2971</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains only alphanumeric characters.</em>
+<a class="jxr_linenumber" name="L2972" href="#L2972">2972</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L2973" href="#L2973">2973</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAlphaNumeric(String str) {
+<a class="jxr_linenumber" name="L2974" href="#L2974">2974</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L2975" href="#L2975">2975</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2976" href="#L2976">2976</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L2977" href="#L2977">2977</a> <strong class="jxr_keyword">if</strong> (! Character.isLetterOrDigit(str.charAt(i)))
+<a class="jxr_linenumber" name="L2978" href="#L2978">2978</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L2979" href="#L2979">2979</a> }
+<a class="jxr_linenumber" name="L2980" href="#L2980">2980</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L2981" href="#L2981">2981</a> }
+<a class="jxr_linenumber" name="L2982" href="#L2982">2982</a>
+<a class="jxr_linenumber" name="L2983" href="#L2983">2983</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L2984" href="#L2984">2984</a> <em class="jxr_javadoccomment"> * Checks if any of the provided strings are not blank (not null, not empty, and not whitespace only).</em>
+<a class="jxr_linenumber" name="L2985" href="#L2985">2985</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2986" href="#L2986">2986</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L2987" href="#L2987">2987</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if at least one string is not null, not empty, and contains non-whitespace characters.</em>
+<a class="jxr_linenumber" name="L2988" href="#L2988">2988</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2989" href="#L2989">2989</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L2990" href="#L2990">2990</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L2991" href="#L2991">2991</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<jk>null</jk>, <jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2992" href="#L2992">2992</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<js>""</js>, <js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2993" href="#L2993">2993</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<js>" "</js>, <js>" "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L2994" href="#L2994">2994</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<jk>null</jk>, <js>"hello"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2995" href="#L2995">2995</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<js>""</js>, <js>" "</js>, <js>"x"</js>);<jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2996" href="#L2996">2996</a> <em class="jxr_javadoccomment"> * isAnyNotBlank(<js>"hello"</js>, <js>"world"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L2997" href="#L2997">2997</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L2998" href="#L2998">2998</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L2999" href="#L2999">2999</a> <em class="jxr_javadoccomment"> * @param values The strings to check.</em>
+<a class="jxr_linenumber" name="L3000" href="#L3000">3000</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if at least one string is not null, not empty, and contains non-whitespace characters.</em>
+<a class="jxr_linenumber" name="L3001" href="#L3001">3001</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3002" href="#L3002">3002</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAnyNotBlank(CharSequence...values) {
+<a class="jxr_linenumber" name="L3003" href="#L3003">3003</a> <strong class="jxr_keyword">if</strong> (values == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3004" href="#L3004">3004</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3005" href="#L3005">3005</a> <strong class="jxr_keyword">for</strong> (CharSequence value : values)
+<a class="jxr_linenumber" name="L3006" href="#L3006">3006</a> <strong class="jxr_keyword">if</strong> (isNotBlank(value))
+<a class="jxr_linenumber" name="L3007" href="#L3007">3007</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3008" href="#L3008">3008</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3009" href="#L3009">3009</a> }
+<a class="jxr_linenumber" name="L3010" href="#L3010">3010</a>
+<a class="jxr_linenumber" name="L3011" href="#L3011">3011</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3012" href="#L3012">3012</a> <em class="jxr_javadoccomment"> * Checks if any of the provided strings are not empty (not null and not zero-length).</em>
+<a class="jxr_linenumber" name="L3013" href="#L3013">3013</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3014" href="#L3014">3014</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3015" href="#L3015">3015</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if at least one string is not null and has a length greater than zero.</em>
+<a class="jxr_linenumber" name="L3016" href="#L3016">3016</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3017" href="#L3017">3017</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3018" href="#L3018">3018</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3019" href="#L3019">3019</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<jk>null</jk>, <jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3020" href="#L3020">3020</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<js>""</js>, <js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3021" href="#L3021">3021</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<jk>null</jk>, <js>"hello"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3022" href="#L3022">3022</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<js>""</js>, <js>" "</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3023" href="#L3023">3023</a> <em class="jxr_javadoccomment"> * isAnyNotEmpty(<js>"hello"</js>, <js>"world"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3024" href="#L3024">3024</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3025" href="#L3025">3025</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3026" href="#L3026">3026</a> <em class="jxr_javadoccomment"> * @param values The strings to check.</em>
+<a class="jxr_linenumber" name="L3027" href="#L3027">3027</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if at least one string is not null and not empty.</em>
+<a class="jxr_linenumber" name="L3028" href="#L3028">3028</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3029" href="#L3029">3029</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isAnyNotEmpty(CharSequence...values) {
+<a class="jxr_linenumber" name="L3030" href="#L3030">3030</a> <strong class="jxr_keyword">if</strong> (values == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3031" href="#L3031">3031</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3032" href="#L3032">3032</a> <strong class="jxr_keyword">for</strong> (CharSequence value : values)
+<a class="jxr_linenumber" name="L3033" href="#L3033">3033</a> <strong class="jxr_keyword">if</strong> (value != <strong class="jxr_keyword">null</strong> && ! value.isEmpty())
+<a class="jxr_linenumber" name="L3034" href="#L3034">3034</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3035" href="#L3035">3035</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3036" href="#L3036">3036</a> }
+<a class="jxr_linenumber" name="L3037" href="#L3037">3037</a>
+<a class="jxr_linenumber" name="L3038" href="#L3038">3038</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3039" href="#L3039">3039</a> <em class="jxr_javadoccomment"> * Checks if a string is blank (null, empty, or whitespace only).</em>
+<a class="jxr_linenumber" name="L3040" href="#L3040">3040</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3041" href="#L3041">3041</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3042" href="#L3042">3042</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3043" href="#L3043">3043</a> <em class="jxr_javadoccomment"> * isBlank(<jk>null</jk>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3044" href="#L3044">3044</a> <em class="jxr_javadoccomment"> * isBlank(<js>""</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3045" href="#L3045">3045</a> <em class="jxr_javadoccomment"> * isBlank(<js>" "</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3046" href="#L3046">3046</a> <em class="jxr_javadoccomment"> * isBlank(<js>"hello"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3047" href="#L3047">3047</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3048" href="#L3048">3048</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3049" href="#L3049">3049</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L3050" href="#L3050">3050</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is null, empty, or contains only whitespace characters.</em>
+<a class="jxr_linenumber" name="L3051" href="#L3051">3051</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3052" href="#L3052">3052</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isBlank(CharSequence str) {
+<a class="jxr_linenumber" name="L3053" href="#L3053">3053</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> || str.toString().isBlank();
+<a class="jxr_linenumber" name="L3054" href="#L3054">3054</a> }
+<a class="jxr_linenumber" name="L3055" href="#L3055">3055</a>
+<a class="jxr_linenumber" name="L3056" href="#L3056">3056</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3057" href="#L3057">3057</a> <em class="jxr_javadoccomment"> * Checks if a string is a valid credit card number using the Luhn algorithm.</em>
+<a class="jxr_linenumber" name="L3058" href="#L3058">3058</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3059" href="#L3059">3059</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3060" href="#L3060">3060</a> <em class="jxr_javadoccomment"> * Validates credit card numbers by:</em>
+<a class="jxr_linenumber" name="L3061" href="#L3061">3061</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L3062" href="#L3062">3062</a> <em class="jxr_javadoccomment"> * <li>Removing spaces and hyphens</li></em>
+<a class="jxr_linenumber" name="L3063" href="#L3063">3063</a> <em class="jxr_javadoccomment"> * <li>Checking that all remaining characters are digits</li></em>
+<a class="jxr_linenumber" name="L3064" href="#L3064">3064</a> <em class="jxr_javadoccomment"> * <li>Verifying the number passes the Luhn algorithm check</li></em>
+<a class="jxr_linenumber" name="L3065" href="#L3065">3065</a> <em class="jxr_javadoccomment"> * <li>Ensuring the number is between 13-19 digits (standard credit card length)</li></em>
+<a class="jxr_linenumber" name="L3066" href="#L3066">3066</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L3067" href="#L3067">3067</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3068" href="#L3068">3068</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3069" href="#L3069">3069</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3070" href="#L3070">3070</a> <em class="jxr_javadoccomment"> * isCreditCard(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3071" href="#L3071">3071</a> <em class="jxr_javadoccomment"> * isCreditCard(<js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3072" href="#L3072">3072</a> <em class="jxr_javadoccomment"> * isCreditCard(<js>"4532015112830366"</js>); <jc>// true (Visa test card)</jc></em>
+<a class="jxr_linenumber" name="L3073" href="#L3073">3073</a> <em class="jxr_javadoccomment"> * isCreditCard(<js>"4532-0151-1283-0366"</js>); <jc>// true (with separators)</jc></em>
+<a class="jxr_linenumber" name="L3074" href="#L3074">3074</a> <em class="jxr_javadoccomment"> * isCreditCard(<js>"1234567890"</js>); <jc>// false (invalid Luhn)</jc></em>
+<a class="jxr_linenumber" name="L3075" href="#L3075">3075</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3076" href="#L3076">3076</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3077" href="#L3077">3077</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L3078" href="#L3078">3078</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid credit card number.</em>
+<a class="jxr_linenumber" name="L3079" href="#L3079">3079</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3080" href="#L3080">3080</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isCreditCard(String str) {
+<a class="jxr_linenumber" name="L3081" href="#L3081">3081</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L3082" href="#L3082">3082</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3083" href="#L3083">3083</a> <em class="jxr_comment">// Remove spaces and hyphens</em>
+<a class="jxr_linenumber" name="L3084" href="#L3084">3084</a> <strong class="jxr_keyword">var</strong> cleaned = str.replaceAll(<span class="jxr_string">"[\\s\\-]"</span>, <span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L3085" href="#L3085">3085</a> <em class="jxr_comment">// Must be all digits and 13-19 digits long</em>
+<a class="jxr_linenumber" name="L3086" href="#L3086">3086</a> <strong class="jxr_keyword">if</strong> (! cleaned.matches(<span class="jxr_string">"^\\d{13,19}$"</span>))
+<a class="jxr_linenumber" name="L3087" href="#L3087">3087</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3088" href="#L3088">3088</a> <em class="jxr_comment">// Apply Luhn algorithm</em>
+<a class="jxr_linenumber" name="L3089" href="#L3089">3089</a> <strong class="jxr_keyword">var</strong> sum = 0;
+<a class="jxr_linenumber" name="L3090" href="#L3090">3090</a> <strong class="jxr_keyword">var</strong> alternate = false;
+<a class="jxr_linenumber" name="L3091" href="#L3091">3091</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = cleaned.length() - 1; i >= 0; i--) {
+<a class="jxr_linenumber" name="L3092" href="#L3092">3092</a> <strong class="jxr_keyword">var</strong> digit = Character.getNumericValue(cleaned.charAt(i));
+<a class="jxr_linenumber" name="L3093" href="#L3093">3093</a> <strong class="jxr_keyword">if</strong> (alternate) {
+<a class="jxr_linenumber" name="L3094" href="#L3094">3094</a> digit *= 2;
+<a class="jxr_linenumber" name="L3095" href="#L3095">3095</a> <strong class="jxr_keyword">if</strong> (digit > 9)
+<a class="jxr_linenumber" name="L3096" href="#L3096">3096</a> digit = (digit % 10) + 1;
+<a class="jxr_linenumber" name="L3097" href="#L3097">3097</a> }
+<a class="jxr_linenumber" name="L3098" href="#L3098">3098</a> sum += digit;
+<a class="jxr_linenumber" name="L3099" href="#L3099">3099</a> alternate = ! alternate;
+<a class="jxr_linenumber" name="L3100" href="#L3100">3100</a> }
+<a class="jxr_linenumber" name="L3101" href="#L3101">3101</a> <strong class="jxr_keyword">return</strong> (sum % 10) == 0;
+<a class="jxr_linenumber" name="L3102" href="#L3102">3102</a> }
+<a class="jxr_linenumber" name="L3103" href="#L3103">3103</a>
+<a class="jxr_linenumber" name="L3104" href="#L3104">3104</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3105" href="#L3105">3105</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string is numeric.</em>
+<a class="jxr_linenumber" name="L3106" href="#L3106">3106</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3107" href="#L3107">3107</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L3108" href="#L3108">3108</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is numeric.</em>
+<a class="jxr_linenumber" name="L3109" href="#L3109">3109</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3110" href="#L3110">3110</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isDecimal(String s) {
+<a class="jxr_linenumber" name="L3111" href="#L3111">3111</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty() || ! FIRST_NUMBER_CHARS.contains(s.charAt(0)))
+<a class="jxr_linenumber" name="L3112" href="#L3112">3112</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3113" href="#L3113">3113</a> <strong class="jxr_keyword">var</strong> i = 0;
+<a class="jxr_linenumber" name="L3114" href="#L3114">3114</a> <strong class="jxr_keyword">var</strong> length = s.length();
+<a class="jxr_linenumber" name="L3115" href="#L3115">3115</a> <strong class="jxr_keyword">var</strong> c = s.charAt(0);
+<a class="jxr_linenumber" name="L3116" href="#L3116">3116</a> <strong class="jxr_keyword">var</strong> isPrefixed = false;
+<a class="jxr_linenumber" name="L3117" href="#L3117">3117</a> <strong class="jxr_keyword">if</strong> (c == '+' || c == '-') {
+<a class="jxr_linenumber" name="L3118" href="#L3118">3118</a> isPrefixed = <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3119" href="#L3119">3119</a> i++;
+<a class="jxr_linenumber" name="L3120" href="#L3120">3120</a> }
+<a class="jxr_linenumber" name="L3121" href="#L3121">3121</a> <strong class="jxr_keyword">if</strong> (i == length)
+<a class="jxr_linenumber" name="L3122" href="#L3122">3122</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3123" href="#L3123">3123</a> c = s.charAt(i++);
+<a class="jxr_linenumber" name="L3124" href="#L3124">3124</a> <strong class="jxr_keyword">if</strong> (c == '0' && length > (isPrefixed ? 2 : 1)) {
+<a class="jxr_linenumber" name="L3125" href="#L3125">3125</a> c = s.charAt(i++);
+<a class="jxr_linenumber" name="L3126" href="#L3126">3126</a> <strong class="jxr_keyword">if</strong> (c == 'x' || c == 'X') {
+<a class="jxr_linenumber" name="L3127" href="#L3127">3127</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = i; j < length; j++) {
+<a class="jxr_linenumber" name="L3128" href="#L3128">3128</a> <strong class="jxr_keyword">if</strong> (! HEXADECIMAL_CHARS.contains(s.charAt(j)))
+<a class="jxr_linenumber" name="L3129" href="#L3129">3129</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3130" href="#L3130">3130</a> }
+<a class="jxr_linenumber" name="L3131" href="#L3131">3131</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (OCTAL_CHARS.contains(c)) {
+<a class="jxr_linenumber" name="L3132" href="#L3132">3132</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = i; j < length; j++)
+<a class="jxr_linenumber" name="L3133" href="#L3133">3133</a> <strong class="jxr_keyword">if</strong> (! OCTAL_CHARS.contains(s.charAt(j)))
+<a class="jxr_linenumber" name="L3134" href="#L3134">3134</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3135" href="#L3135">3135</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L3136" href="#L3136">3136</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3137" href="#L3137">3137</a> }
+<a class="jxr_linenumber" name="L3138" href="#L3138">3138</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '#') {
+<a class="jxr_linenumber" name="L3139" href="#L3139">3139</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = i; j < length; j++) {
+<a class="jxr_linenumber" name="L3140" href="#L3140">3140</a> <strong class="jxr_keyword">if</strong> (! HEXADECIMAL_CHARS.contains(s.charAt(j)))
+<a class="jxr_linenumber" name="L3141" href="#L3141">3141</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3142" href="#L3142">3142</a> }
+<a class="jxr_linenumber" name="L3143" href="#L3143">3143</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (DECIMAL_CHARS.contains(c)) {
+<a class="jxr_linenumber" name="L3144" href="#L3144">3144</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = i; j < length; j++)
+<a class="jxr_linenumber" name="L3145" href="#L3145">3145</a> <strong class="jxr_keyword">if</strong> (! DECIMAL_CHARS.contains(s.charAt(j)))
+<a class="jxr_linenumber" name="L3146" href="#L3146">3146</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3147" href="#L3147">3147</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L3148" href="#L3148">3148</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3149" href="#L3149">3149</a> }
+<a class="jxr_linenumber" name="L3150" href="#L3150">3150</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3151" href="#L3151">3151</a> }
+<a class="jxr_linenumber" name="L3152" href="#L3152">3152</a>
+<a class="jxr_linenumber" name="L3153" href="#L3153">3153</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3154" href="#L3154">3154</a> <em class="jxr_javadoccomment"> * Checks if a string contains only digit characters (0-9).</em>
+<a class="jxr_linenumber" name="L3155" href="#L3155">3155</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3156" href="#L3156">3156</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3157" href="#L3157">3157</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3158" href="#L3158">3158</a> <em class="jxr_javadoccomment"> * isDigit(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3159" href="#L3159">3159</a> <em class="jxr_javadoccomment"> * isDigit(<js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3160" href="#L3160">3160</a> <em class="jxr_javadoccomment"> * isDigit(<js>"123"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3161" href="#L3161">3161</a> <em class="jxr_javadoccomment"> * isDigit(<js>"abc123"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3162" href="#L3162">3162</a> <em class="jxr_javadoccomment"> * isDigit(<js>"12.3"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3163" href="#L3163">3163</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3164" href="#L3164">3164</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3165" href="#L3165">3165</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L3166" href="#L3166">3166</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains only digit characters.</em>
+<a class="jxr_linenumber" name="L3167" href="#L3167">3167</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3168" href="#L3168">3168</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isDigit(String str) {
+<a class="jxr_linenumber" name="L3169" href="#L3169">3169</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L3170" href="#L3170">3170</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3171" href="#L3171">3171</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L3172" href="#L3172">3172</a> <strong class="jxr_keyword">if</strong> (! Character.isDigit(str.charAt(i)))
+<a class="jxr_linenumber" name="L3173" href="#L3173">3173</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3174" href="#L3174">3174</a> }
+<a class="jxr_linenumber" name="L3175" href="#L3175">3175</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3176" href="#L3176">3176</a> }
+<a class="jxr_linenumber" name="L3177" href="#L3177">3177</a>
+<a class="jxr_linenumber" name="L3178" href="#L3178">3178</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3179" href="#L3179">3179</a> <em class="jxr_javadoccomment"> * Checks if a string is a valid email address.</em>
+<a class="jxr_linenumber" name="L3180" href="#L3180">3180</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3181" href="#L3181">3181</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3182" href="#L3182">3182</a> <em class="jxr_javadoccomment"> * Performs basic email validation using a simple regex pattern.</em>
+<a class="jxr_linenumber" name="L3183" href="#L3183">3183</a> <em class="jxr_javadoccomment"> * This is not a complete RFC 5321/5322 validation, but covers most common email formats.</em>
+<a class="jxr_linenumber" name="L3184" href="#L3184">3184</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3185" href="#L3185">3185</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3186" href="#L3186">3186</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3187" href="#L3187">3187</a> <em class="jxr_javadoccomment"> * isEmail(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3188" href="#L3188">3188</a> <em class="jxr_javadoccomment"> * isEmail(<js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3189" href="#L3189">3189</a> <em class="jxr_javadoccomment"> * isEmail(<js>"user@example.com"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3190" href="#L3190">3190</a> <em class="jxr_javadoccomment"> * isEmail(<js>"invalid.email"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3191" href="#L3191">3191</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3192" href="#L3192">3192</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3193" href="#L3193">3193</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L3194" href="#L3194">3194</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid email address.</em>
+<a class="jxr_linenumber" name="L3195" href="#L3195">3195</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3196" href="#L3196">3196</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmail(String str) {
+<a class="jxr_linenumber" name="L3197" href="#L3197">3197</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L3198" href="#L3198">3198</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3199" href="#L3199">3199</a> <em class="jxr_comment">// Basic email regex: local@domain</em>
+<a class="jxr_linenumber" name="L3200" href="#L3200">3200</a> <em class="jxr_comment">// Allows letters, digits, dots, underscores, hyphens, and plus signs in local part</em>
+<a class="jxr_linenumber" name="L3201" href="#L3201">3201</a> <em class="jxr_comment">// Domain must have at least one dot and valid TLD</em>
+<a class="jxr_linenumber" name="L3202" href="#L3202">3202</a> <strong class="jxr_keyword">return</strong> str.matches(<span class="jxr_string">"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"</span>);
+<a class="jxr_linenumber" name="L3203" href="#L3203">3203</a> }
+<a class="jxr_linenumber" name="L3204" href="#L3204">3204</a>
+<a class="jxr_linenumber" name="L3205" href="#L3205">3205</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3206" href="#L3206">3206</a> <em class="jxr_javadoccomment"> * Checks if a string is null or empty.</em>
+<a class="jxr_linenumber" name="L3207" href="#L3207">3207</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3208" href="#L3208">3208</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3209" href="#L3209">3209</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3210" href="#L3210">3210</a> <em class="jxr_javadoccomment"> * isEmpty(<jk>null</jk>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3211" href="#L3211">3211</a> <em class="jxr_javadoccomment"> * isEmpty(<js>""</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3212" href="#L3212">3212</a> <em class="jxr_javadoccomment"> * isEmpty(<js>"abc"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3213" href="#L3213">3213</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3214" href="#L3214">3214</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3215" href="#L3215">3215</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L3216" href="#L3216">3216</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is null or empty.</em>
+<a class="jxr_linenumber" name="L3217" href="#L3217">3217</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3218" href="#L3218">3218</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isEmpty(String str) {
+<a class="jxr_linenumber" name="L3219" href="#L3219">3219</a> <strong class="jxr_keyword">return</strong> str == <strong class="jxr_keyword">null</strong> || str.isEmpty();
+<a class="jxr_linenumber" name="L3220" href="#L3220">3220</a> }
+<a class="jxr_linenumber" name="L3221" href="#L3221">3221</a>
+<a class="jxr_linenumber" name="L3222" href="#L3222">3222</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3223" href="#L3223">3223</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified character is a valid first character for a number.</em>
+<a class="jxr_linenumber" name="L3224" href="#L3224">3224</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3225" href="#L3225">3225</a> <em class="jxr_javadoccomment"> * @param c The character to test.</em>
+<a class="jxr_linenumber" name="L3226" href="#L3226">3226</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified character is a valid first character for a number.</em>
+<a class="jxr_linenumber" name="L3227" href="#L3227">3227</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3228" href="#L3228">3228</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isFirstNumberChar(<strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L3229" href="#L3229">3229</a> <strong class="jxr_keyword">return</strong> FIRST_NUMBER_CHARS.contains(c);
+<a class="jxr_linenumber" name="L3230" href="#L3230">3230</a> }
+<a class="jxr_linenumber" name="L3231" href="#L3231">3231</a>
+<a class="jxr_linenumber" name="L3232" href="#L3232">3232</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3233" href="#L3233">3233</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string is a floating point number.</em>
+<a class="jxr_linenumber" name="L3234" href="#L3234">3234</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3235" href="#L3235">3235</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L3236" href="#L3236">3236</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is a floating point number.</em>
+<a class="jxr_linenumber" name="L3237" href="#L3237">3237</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3238" href="#L3238">3238</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isFloat(String s) {
+<a class="jxr_linenumber" name="L3239" href="#L3239">3239</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty())
+<a class="jxr_linenumber" name="L3240" href="#L3240">3240</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3241" href="#L3241">3241</a> <strong class="jxr_keyword">if</strong> (! FIRST_NUMBER_CHARS.contains(s.charAt(0)))
+<a class="jxr_linenumber" name="L3242" href="#L3242">3242</a> <strong class="jxr_keyword">return</strong> (s.equals(<span class="jxr_string">"NaN"</span>) || s.equals(<span class="jxr_string">"Infinity"</span>));
+<a class="jxr_linenumber" name="L3243" href="#L3243">3243</a> <strong class="jxr_keyword">var</strong> i = 0;
+<a class="jxr_linenumber" name="L3244" href="#L3244">3244</a> <strong class="jxr_keyword">var</strong> length = s.length();
+<a class="jxr_linenumber" name="L3245" href="#L3245">3245</a> <strong class="jxr_keyword">var</strong> c = s.charAt(0);
+<a class="jxr_linenumber" name="L3246" href="#L3246">3246</a> <strong class="jxr_keyword">if</strong> (c == '+' || c == '-')
+<a class="jxr_linenumber" name="L3247" href="#L3247">3247</a> i++;
+<a class="jxr_linenumber" name="L3248" href="#L3248">3248</a> <strong class="jxr_keyword">if</strong> (i == length)
+<a class="jxr_linenumber" name="L3249" href="#L3249">3249</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3250" href="#L3250">3250</a> c = s.charAt(i);
+<a class="jxr_linenumber" name="L3251" href="#L3251">3251</a> <strong class="jxr_keyword">if</strong> (c == '.' || DECIMAL_CHARS.contains(c)) {
+<a class="jxr_linenumber" name="L3252" href="#L3252">3252</a> <strong class="jxr_keyword">return</strong> FP_REGEX.matcher(s).matches();
+<a class="jxr_linenumber" name="L3253" href="#L3253">3253</a> }
+<a class="jxr_linenumber" name="L3254" href="#L3254">3254</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3255" href="#L3255">3255</a> }
+<a class="jxr_linenumber" name="L3256" href="#L3256">3256</a>
+<a class="jxr_linenumber" name="L3257" href="#L3257">3257</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3258" href="#L3258">3258</a> <em class="jxr_javadoccomment"> * Checks if a string is already interned.</em>
+<a class="jxr_linenumber" name="L3259" href="#L3259">3259</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3260" href="#L3260">3260</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3261" href="#L3261">3261</a> <em class="jxr_javadoccomment"> * Returns <jk>false</jk> if the input string is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3262" href="#L3262">3262</a> <em class="jxr_javadoccomment"> * A string is considered interned if it is the same object reference as its interned version.</em>
+<a class="jxr_linenumber" name="L3263" href="#L3263">3263</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3264" href="#L3264">3264</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L3265" href="#L3265">3265</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3266" href="#L3266">3266</a> <em class="jxr_javadoccomment"> * String <jv>s1</jv> = <js>"test"</js>; <jc>// String literal is automatically interned</jc></em>
+<a class="jxr_linenumber" name="L3267" href="#L3267">3267</a> <em class="jxr_javadoccomment"> * assertTrue(isInterned(<jv>s1</jv>));</em>
+<a class="jxr_linenumber" name="L3268" href="#L3268">3268</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3269" href="#L3269">3269</a> <em class="jxr_javadoccomment"> * String <jv>s2</jv> = <jk>new</jk> String(<js>"test"</js>); <jc>// New object, not interned</jc></em>
+<a class="jxr_linenumber" name="L3270" href="#L3270">3270</a> <em class="jxr_javadoccomment"> * assertFalse(isInterned(<jv>s2</jv>));</em>
+<a class="jxr_linenumber" name="L3271" href="#L3271">3271</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3272" href="#L3272">3272</a> <em class="jxr_javadoccomment"> * String <jv>s3</jv> = intern(<jv>s2</jv>); <jc>// Now interned</jc></em>
+<a class="jxr_linenumber" name="L3273" href="#L3273">3273</a> <em class="jxr_javadoccomment"> * assertTrue(isInterned(<jv>s3</jv>));</em>
+<a class="jxr_linenumber" name="L3274" href="#L3274">3274</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3275" href="#L3275">3275</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3276" href="#L3276">3276</a> <em class="jxr_javadoccomment"> * @param str The string to check. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3277" href="#L3277">3277</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is interned, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L3278" href="#L3278">3278</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3279" href="#L3279">3279</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isInterned(String str) {
+<a class="jxr_linenumber" name="L3280" href="#L3280">3280</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3281" href="#L3281">3281</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3282" href="#L3282">3282</a> <strong class="jxr_keyword">return</strong> str == str.intern();
+<a class="jxr_linenumber" name="L3283" href="#L3283">3283</a> }
+<a class="jxr_linenumber" name="L3284" href="#L3284">3284</a>
+<a class="jxr_linenumber" name="L3285" href="#L3285">3285</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3286" href="#L3286">3286</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string is valid JSON.</em>
+<a class="jxr_linenumber" name="L3287" href="#L3287">3287</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3288" href="#L3288">3288</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3289" href="#L3289">3289</a> <em class="jxr_javadoccomment"> * Leading and trailing spaces are ignored.</em>
+<a class="jxr_linenumber" name="L3290" href="#L3290">3290</a> <em class="jxr_javadoccomment"> * <br>Leading and trailing comments are not allowed.</em>
+<a class="jxr_linenumber" name="L3291" href="#L3291">3291</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3292" href="#L3292">3292</a> <em class="jxr_javadoccomment"> * @param s The string to test.</em>
+<a class="jxr_linenumber" name="L3293" href="#L3293">3293</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is valid JSON.</em>
+<a class="jxr_linenumber" name="L3294" href="#L3294">3294</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3295" href="#L3295">3295</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isJson(String s) {
+<a class="jxr_linenumber" name="L3296" href="#L3296">3296</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3297" href="#L3297">3297</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3298" href="#L3298">3298</a> <strong class="jxr_keyword">var</strong> c1 = firstNonWhitespaceChar(s);
+<a class="jxr_linenumber" name="L3299" href="#L3299">3299</a> <strong class="jxr_keyword">var</strong> c2 = lastNonWhitespaceChar(s);
+<a class="jxr_linenumber" name="L3300" href="#L3300">3300</a> <strong class="jxr_keyword">if</strong> (c1 == '{' && c2 == '}' || c1 == '[' && c2 == ']' || c1 == '\'' && c2 == '\'')
+<a class="jxr_linenumber" name="L3301" href="#L3301">3301</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3302" href="#L3302">3302</a> <strong class="jxr_keyword">return</strong> (isOneOf(s, <span class="jxr_string">"true"</span>, <span class="jxr_string">"false"</span>, <span class="jxr_string">"null"</span>) || isNumeric(s));
+<a class="jxr_linenumber" name="L3303" href="#L3303">3303</a> }
+<a class="jxr_linenumber" name="L3304" href="#L3304">3304</a>
+<a class="jxr_linenumber" name="L3305" href="#L3305">3305</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3306" href="#L3306">3306</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string appears to be an JSON array.</em>
+<a class="jxr_linenumber" name="L3307" href="#L3307">3307</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3308" href="#L3308">3308</a> <em class="jxr_javadoccomment"> * @param o The object to test.</em>
+<a class="jxr_linenumber" name="L3309" href="#L3309">3309</a> <em class="jxr_javadoccomment"> * @param ignoreWhitespaceAndComments If <jk>true</jk>, leading and trailing whitespace and comments will be ignored.</em>
+<a class="jxr_linenumber" name="L3310" href="#L3310">3310</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string appears to be a JSON array.</em>
+<a class="jxr_linenumber" name="L3311" href="#L3311">3311</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3312" href="#L3312">3312</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isJsonArray(Object o, <strong class="jxr_keyword">boolean</strong> ignoreWhitespaceAndComments) {
+<a class="jxr_linenumber" name="L3313" href="#L3313">3313</a> <strong class="jxr_keyword">if</strong> (o instanceof CharSequence o2) {
+<a class="jxr_linenumber" name="L3314" href="#L3314">3314</a> <strong class="jxr_keyword">var</strong> s = o2.toString();
+<a class="jxr_linenumber" name="L3315" href="#L3315">3315</a> <strong class="jxr_keyword">if</strong> (! ignoreWhitespaceAndComments)
+<a class="jxr_linenumber" name="L3316" href="#L3316">3316</a> <strong class="jxr_keyword">return</strong> (s.startsWith(<span class="jxr_string">"["</span>) && s.endsWith(<span class="jxr_string">"]"</span>));
+<a class="jxr_linenumber" name="L3317" href="#L3317">3317</a> <strong class="jxr_keyword">if</strong> (firstRealCharacter(s) != '[')
+<a class="jxr_linenumber" name="L3318" href="#L3318">3318</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3319" href="#L3319">3319</a> <strong class="jxr_keyword">var</strong> i = s.lastIndexOf(']');
+<a class="jxr_linenumber" name="L3320" href="#L3320">3320</a> <strong class="jxr_keyword">if</strong> (i == -1)
+<a class="jxr_linenumber" name="L3321" href="#L3321">3321</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3322" href="#L3322">3322</a> s = s.substring(i + 1);
+<a class="jxr_linenumber" name="L3323" href="#L3323">3323</a> <strong class="jxr_keyword">return</strong> firstRealCharacter(s) == -1;
+<a class="jxr_linenumber" name="L3324" href="#L3324">3324</a> }
+<a class="jxr_linenumber" name="L3325" href="#L3325">3325</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3326" href="#L3326">3326</a> }
+<a class="jxr_linenumber" name="L3327" href="#L3327">3327</a>
+<a class="jxr_linenumber" name="L3328" href="#L3328">3328</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3329" href="#L3329">3329</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string appears to be a JSON object.</em>
+<a class="jxr_linenumber" name="L3330" href="#L3330">3330</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3331" href="#L3331">3331</a> <em class="jxr_javadoccomment"> * @param o The object to test.</em>
+<a class="jxr_linenumber" name="L3332" href="#L3332">3332</a> <em class="jxr_javadoccomment"> * @param ignoreWhitespaceAndComments If <jk>true</jk>, leading and trailing whitespace and comments will be ignored.</em>
+<a class="jxr_linenumber" name="L3333" href="#L3333">3333</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string appears to be a JSON object.</em>
+<a class="jxr_linenumber" name="L3334" href="#L3334">3334</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3335" href="#L3335">3335</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isJsonObject(Object o, <strong class="jxr_keyword">boolean</strong> ignoreWhitespaceAndComments) {
+<a class="jxr_linenumber" name="L3336" href="#L3336">3336</a> <strong class="jxr_keyword">if</strong> (o instanceof CharSequence o2) {
+<a class="jxr_linenumber" name="L3337" href="#L3337">3337</a> <strong class="jxr_keyword">var</strong> s = o2.toString();
+<a class="jxr_linenumber" name="L3338" href="#L3338">3338</a> <strong class="jxr_keyword">if</strong> (! ignoreWhitespaceAndComments)
+<a class="jxr_linenumber" name="L3339" href="#L3339">3339</a> <strong class="jxr_keyword">return</strong> (s.startsWith(<span class="jxr_string">"{"</span>) && s.endsWith(<span class="jxr_string">"}"</span>));
+<a class="jxr_linenumber" name="L3340" href="#L3340">3340</a> <strong class="jxr_keyword">if</strong> (firstRealCharacter(s) != '{')
+<a class="jxr_linenumber" name="L3341" href="#L3341">3341</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3342" href="#L3342">3342</a> <strong class="jxr_keyword">var</strong> i = s.lastIndexOf('}');
+<a class="jxr_linenumber" name="L3343" href="#L3343">3343</a> <strong class="jxr_keyword">if</strong> (i == -1)
+<a class="jxr_linenumber" name="L3344" href="#L3344">3344</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3345" href="#L3345">3345</a> s = s.substring(i + 1);
+<a class="jxr_linenumber" name="L3346" href="#L3346">3346</a> <strong class="jxr_keyword">return</strong> firstRealCharacter(s) == -1;
+<a class="jxr_linenumber" name="L3347" href="#L3347">3347</a> }
+<a class="jxr_linenumber" name="L3348" href="#L3348">3348</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3349" href="#L3349">3349</a> }
+<a class="jxr_linenumber" name="L3350" href="#L3350">3350</a>
+<a class="jxr_linenumber" name="L3351" href="#L3351">3351</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3352" href="#L3352">3352</a> <em class="jxr_javadoccomment"> * Checks if a string is not blank (not null, not empty, and not whitespace only).</em>
+<a class="jxr_linenumber" name="L3353" href="#L3353">3353</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3354" href="#L3354">3354</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3355" href="#L3355">3355</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3356" href="#L3356">3356</a> <em class="jxr_javadoccomment"> * isNotBlank(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3357" href="#L3357">3357</a> <em class="jxr_javadoccomment"> * isNotBlank(<js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3358" href="#L3358">3358</a> <em class="jxr_javadoccomment"> * isNotBlank(<js>" "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3359" href="#L3359">3359</a> <em class="jxr_javadoccomment"> * isNotBlank(<js>"hello"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3360" href="#L3360">3360</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3361" href="#L3361">3361</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3362" href="#L3362">3362</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L3363" href="#L3363">3363</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null, not empty, and contains non-whitespace characters.</em>
+<a class="jxr_linenumber" name="L3364" href="#L3364">3364</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3365" href="#L3365">3365</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNotBlank(CharSequence str) {
+<a class="jxr_linenumber" name="L3366" href="#L3366">3366</a> <strong class="jxr_keyword">return</strong> ! isBlank(str);
+<a class="jxr_linenumber" name="L3367" href="#L3367">3367</a> }
+<a class="jxr_linenumber" name="L3368" href="#L3368">3368</a>
+<a class="jxr_linenumber" name="L3369" href="#L3369">3369</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3370" href="#L3370">3370</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified character is a valid number character.</em>
+<a class="jxr_linenumber" name="L3371" href="#L3371">3371</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3372" href="#L3372">3372</a> <em class="jxr_javadoccomment"> * @param c The character to check.</em>
+<a class="jxr_linenumber" name="L3373" href="#L3373">3373</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified character is a valid number character.</em>
+<a class="jxr_linenumber" name="L3374" href="#L3374">3374</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3375" href="#L3375">3375</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNumberChar(<strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L3376" href="#L3376">3376</a> <strong class="jxr_keyword">return</strong> NUMBER_CHARS.contains(c);
+<a class="jxr_linenumber" name="L3377" href="#L3377">3377</a> }
+<a class="jxr_linenumber" name="L3378" href="#L3378">3378</a>
+<a class="jxr_linenumber" name="L3379" href="#L3379">3379</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3380" href="#L3380">3380</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if this string can be parsed by {@link #parseNumber(String, Class)}.</em>
+<a class="jxr_linenumber" name="L3381" href="#L3381">3381</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3382" href="#L3382">3382</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L3383" href="#L3383">3383</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if this string can be parsed without causing an exception.</em>
+<a class="jxr_linenumber" name="L3384" href="#L3384">3384</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3385" href="#L3385">3385</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isNumeric(String s) {
+<a class="jxr_linenumber" name="L3386" href="#L3386">3386</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.isEmpty() || ! isFirstNumberChar(s.charAt(0)))
+<a class="jxr_linenumber" name="L3387" href="#L3387">3387</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3388" href="#L3388">3388</a> <strong class="jxr_keyword">return</strong> isDecimal(s) || isFloat(s);
+<a class="jxr_linenumber" name="L3389" href="#L3389">3389</a> }
+<a class="jxr_linenumber" name="L3390" href="#L3390">3390</a>
+<a class="jxr_linenumber" name="L3391" href="#L3391">3391</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3392" href="#L3392">3392</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the specified string is one of the specified values.</em>
+<a class="jxr_linenumber" name="L3393" href="#L3393">3393</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3394" href="#L3394">3394</a> <em class="jxr_javadoccomment"> * @param s</em>
+<a class="jxr_linenumber" name="L3395" href="#L3395">3395</a> <em class="jxr_javadoccomment"> * The string to test.</em>
+<a class="jxr_linenumber" name="L3396" href="#L3396">3396</a> <em class="jxr_javadoccomment"> * Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3397" href="#L3397">3397</a> <em class="jxr_javadoccomment"> * @param values</em>
+<a class="jxr_linenumber" name="L3398" href="#L3398">3398</a> <em class="jxr_javadoccomment"> * The values to test.</em>
+<a class="jxr_linenumber" name="L3399" href="#L3399">3399</a> <em class="jxr_javadoccomment"> * Can contain <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3400" href="#L3400">3400</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the specified string is one of the specified values.</em>
+<a class="jxr_linenumber" name="L3401" href="#L3401">3401</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3402" href="#L3402">3402</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isOneOf(String s, String...values) {
+<a class="jxr_linenumber" name="L3403" href="#L3403">3403</a> assertArgNotNull(<span class="jxr_string">"values"</span>, values);
+<a class="jxr_linenumber" name="L3404" href="#L3404">3404</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> value : values)
+<a class="jxr_linenumber" name="L3405" href="#L3405">3405</a> <strong class="jxr_keyword">if</strong> (eq(s, value))
+<a class="jxr_linenumber" name="L3406" href="#L3406">3406</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3407" href="#L3407">3407</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3408" href="#L3408">3408</a> }
+<a class="jxr_linenumber" name="L3409" href="#L3409">3409</a>
+<a class="jxr_linenumber" name="L3410" href="#L3410">3410</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3411" href="#L3411">3411</a> <em class="jxr_javadoccomment"> * Checks if a string is a valid phone number.</em>
+<a class="jxr_linenumber" name="L3412" href="#L3412">3412</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3413" href="#L3413">3413</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3414" href="#L3414">3414</a> <em class="jxr_javadoccomment"> * Performs basic phone number validation.</em>
+<a class="jxr_linenumber" name="L3415" href="#L3415">3415</a> <em class="jxr_javadoccomment"> * Accepts various formats including:</em>
+<a class="jxr_linenumber" name="L3416" href="#L3416">3416</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L3417" href="#L3417">3417</a> <em class="jxr_javadoccomment"> * <li>Digits only: <js>"1234567890"</js></li></em>
+<a class="jxr_linenumber" name="L3418" href="#L3418">3418</a> <em class="jxr_javadoccomment"> * <li>With separators: <js>"(123) 456-7890"</js>, <js>"123-456-7890"</js>, <js>"123.456.7890"</js></li></em>
+<a class="jxr_linenumber" name="L3419" href="#L3419">3419</a> <em class="jxr_javadoccomment"> * <li>With country code: <js>"+1 123-456-7890"</js></li></em>
+<a class="jxr_linenumber" name="L3420" href="#L3420">3420</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L3421" href="#L3421">3421</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3422" href="#L3422">3422</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3423" href="#L3423">3423</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3424" href="#L3424">3424</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3425" href="#L3425">3425</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<js>""</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3426" href="#L3426">3426</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<js>"1234567890"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3427" href="#L3427">3427</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<js>"(123) 456-7890"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3428" href="#L3428">3428</a> <em class="jxr_javadoccomment"> * isPhoneNumber(<js>"123"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3429" href="#L3429">3429</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3430" href="#L3430">3430</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3431" href="#L3431">3431</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L3432" href="#L3432">3432</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid phone number.</em>
+<a class="jxr_linenumber" name="L3433" href="#L3433">3433</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3434" href="#L3434">3434</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isPhoneNumber(String str) {
+<a class="jxr_linenumber" name="L3435" href="#L3435">3435</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L3436" href="#L3436">3436</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3437" href="#L3437">3437</a> <em class="jxr_comment">// Remove common phone number separators and check if remaining is 10-15 digits</em>
+<a class="jxr_linenumber" name="L3438" href="#L3438">3438</a> <em class="jxr_comment">// Allows: digits, spaces, parentheses, hyphens, dots, plus sign (for country code)</em>
+<a class="jxr_linenumber" name="L3439" href="#L3439">3439</a> <strong class="jxr_keyword">var</strong> cleaned = str.replaceAll(<span class="jxr_string">"[\\s()\\-\\.]"</span>, <span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L3440" href="#L3440">3440</a> <strong class="jxr_keyword">if</strong> (cleaned.startsWith(<span class="jxr_string">"+"</span>))
+<a class="jxr_linenumber" name="L3441" href="#L3441">3441</a> cleaned = cleaned.substring(1);
+<a class="jxr_linenumber" name="L3442" href="#L3442">3442</a> <em class="jxr_comment">// Phone numbers should have 10-15 digits (10 for US, up to 15 for international)</em>
+<a class="jxr_linenumber" name="L3443" href="#L3443">3443</a> <strong class="jxr_keyword">return</strong> cleaned.matches(<span class="jxr_string">"^\\d{10,15}$"</span>);
+<a class="jxr_linenumber" name="L3444" href="#L3444">3444</a> }
+<a class="jxr_linenumber" name="L3445" href="#L3445">3445</a>
+<a class="jxr_linenumber" name="L3446" href="#L3446">3446</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3447" href="#L3447">3447</a> <em class="jxr_javadoccomment"> * Checks if two strings are similar based on a similarity threshold.</em>
+<a class="jxr_linenumber" name="L3448" href="#L3448">3448</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3449" href="#L3449">3449</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3450" href="#L3450">3450</a> <em class="jxr_javadoccomment"> * Uses the {@link #similarity(String, String)} method to calculate similarity and compares it to the threshold.</em>
+<a class="jxr_linenumber" name="L3451" href="#L3451">3451</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3452" href="#L3452">3452</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3453" href="#L3453">3453</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3454" href="#L3454">3454</a> <em class="jxr_javadoccomment"> * isSimilar(<js>"hello"</js>, <js>"hello"</js>, <js>0.8</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3455" href="#L3455">3455</a> <em class="jxr_javadoccomment"> * isSimilar(<js>"kitten"</js>, <js>"sitting"</js>, <js>0.8</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3456" href="#L3456">3456</a> <em class="jxr_javadoccomment"> * isSimilar(<js>"kitten"</js>, <js>"sitting"</js>, <js>0.5</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3457" href="#L3457">3457</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3458" href="#L3458">3458</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3459" href="#L3459">3459</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
+<a class="jxr_linenumber" name="L3460" href="#L3460">3460</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
+<a class="jxr_linenumber" name="L3461" href="#L3461">3461</a> <em class="jxr_javadoccomment"> * @param threshold The similarity threshold (0.0 to 1.0).</em>
+<a class="jxr_linenumber" name="L3462" href="#L3462">3462</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the similarity is greater than or equal to the threshold, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L3463" href="#L3463">3463</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3464" href="#L3464">3464</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isSimilar(String str1, String str2, <strong class="jxr_keyword">double</strong> threshold) {
+<a class="jxr_linenumber" name="L3465" href="#L3465">3465</a> <strong class="jxr_keyword">return</strong> similarity(str1, str2) >= threshold;
+<a class="jxr_linenumber" name="L3466" href="#L3466">3466</a> }
+<a class="jxr_linenumber" name="L3467" href="#L3467">3467</a>
+<a class="jxr_linenumber" name="L3468" href="#L3468">3468</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3469" href="#L3469">3469</a> <em class="jxr_javadoccomment"> * Efficiently determines whether a URL is of the pattern "xxx:/xxx".</em>
<a class="jxr_linenumber" name="L3470" href="#L3470">3470</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3471" href="#L3471">3471</a> <em class="jxr_javadoccomment"> * @param s The string to test.</em>
-<a class="jxr_linenumber" name="L3472" href="#L3472">3472</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if it's an absolute path.</em>
-<a class="jxr_linenumber" name="L3473" href="#L3473">3473</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3474" href="#L3474">3474</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isUri(String s) { <em class="jxr_comment">// NOSONAR - False positive.</em>
-<a class="jxr_linenumber" name="L3475" href="#L3475">3475</a>
-<a class="jxr_linenumber" name="L3476" href="#L3476">3476</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
-<a class="jxr_linenumber" name="L3477" href="#L3477">3477</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3478" href="#L3478">3478</a>
-<a class="jxr_linenumber" name="L3479" href="#L3479">3479</a> <em class="jxr_comment">// Use a state machine for maximum performance.</em>
-<a class="jxr_linenumber" name="L3480" href="#L3480">3480</a>
-<a class="jxr_linenumber" name="L3481" href="#L3481">3481</a> <em class="jxr_comment">// S1: Looking for protocol char 1</em>
-<a class="jxr_linenumber" name="L3482" href="#L3482">3482</a> <em class="jxr_comment">// S2: Found protocol char 1, looking for protocol char 2</em>
-<a class="jxr_linenumber" name="L3483" href="#L3483">3483</a> <em class="jxr_comment">// S3: Found protocol char 2, looking for :</em>
-<a class="jxr_linenumber" name="L3484" href="#L3484">3484</a> <em class="jxr_comment">// S4: Found :, looking for /</em>
-<a class="jxr_linenumber" name="L3485" href="#L3485">3485</a>
-<a class="jxr_linenumber" name="L3486" href="#L3486">3486</a> <strong class="jxr_keyword">var</strong> state = S1;
-<a class="jxr_linenumber" name="L3487" href="#L3487">3487</a>
-<a class="jxr_linenumber" name="L3488" href="#L3488">3488</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
-<a class="jxr_linenumber" name="L3489" href="#L3489">3489</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
-<a class="jxr_linenumber" name="L3490" href="#L3490">3490</a> <strong class="jxr_keyword">if</strong> (state == S1) {
-<a class="jxr_linenumber" name="L3491" href="#L3491">3491</a> <strong class="jxr_keyword">if</strong> (c >= 'a' && c <= 'z')
-<a class="jxr_linenumber" name="L3492" href="#L3492">3492</a> state = S2;
-<a class="jxr_linenumber" name="L3493" href="#L3493">3493</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L3494" href="#L3494">3494</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3495" href="#L3495">3495</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2) {
-<a class="jxr_linenumber" name="L3496" href="#L3496">3496</a> <strong class="jxr_keyword">if</strong> (c >= 'a' && c <= 'z')
-<a class="jxr_linenumber" name="L3497" href="#L3497">3497</a> state = S3;
-<a class="jxr_linenumber" name="L3498" href="#L3498">3498</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L3499" href="#L3499">3499</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3500" href="#L3500">3500</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S3) { <em class="jxr_comment">// NOSONAR - False positive.</em>
-<a class="jxr_linenumber" name="L3501" href="#L3501">3501</a> <strong class="jxr_keyword">if</strong> (c == ':')
-<a class="jxr_linenumber" name="L3502" href="#L3502">3502</a> state = S4;
-<a class="jxr_linenumber" name="L3503" href="#L3503">3503</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c < 'a' || c > 'z')
-<a class="jxr_linenumber" name="L3504" href="#L3504">3504</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3505" href="#L3505">3505</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S4) {
-<a class="jxr_linenumber" name="L3506" href="#L3506">3506</a> <strong class="jxr_keyword">return</strong> c == '/';
-<a class="jxr_linenumber" name="L3507" href="#L3507">3507</a> }
-<a class="jxr_linenumber" name="L3508" href="#L3508">3508</a> }
-<a class="jxr_linenumber" name="L3509" href="#L3509">3509</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3510" href="#L3510">3510</a> }
-<a class="jxr_linenumber" name="L3511" href="#L3511">3511</a>
-<a class="jxr_linenumber" name="L3512" href="#L3512">3512</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3513" href="#L3513">3513</a> <em class="jxr_javadoccomment"> * Validates if a date string matches the specified date format.</em>
-<a class="jxr_linenumber" name="L3514" href="#L3514">3514</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3515" href="#L3515">3515</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3516" href="#L3516">3516</a> <em class="jxr_javadoccomment"> * Uses {@link SimpleDateFormat} to parse the date string according to the format pattern.</em>
-<a class="jxr_linenumber" name="L3517" href="#L3517">3517</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3518" href="#L3518">3518</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3519" href="#L3519">3519</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3520" href="#L3520">3520</a> <em class="jxr_javadoccomment"> * isValidDateFormat(<js>"2023-12-25"</js>, <js>"yyyy-MM-dd"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3521" href="#L3521">3521</a> <em class="jxr_javadoccomment"> * isValidDateFormat(<js>"25/12/2023"</js>, <js>"dd/MM/yyyy"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3522" href="#L3522">3522</a> <em class="jxr_javadoccomment"> * isValidDateFormat(<js>"2023-13-25"</js>, <js>"yyyy-MM-dd"</js>); <jc>// false (invalid month)</jc></em>
-<a class="jxr_linenumber" name="L3523" href="#L3523">3523</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3524" href="#L3524">3524</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3525" href="#L3525">3525</a> <em class="jxr_javadoccomment"> * @param dateStr The date string to validate. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3526" href="#L3526">3526</a> <em class="jxr_javadoccomment"> * @param format The date format pattern (e.g., "yyyy-MM-dd"). Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3527" href="#L3527">3527</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the date string matches the format, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L3528" href="#L3528">3528</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3529" href="#L3529">3529</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidDateFormat(String dateStr, String format) {
-<a class="jxr_linenumber" name="L3530" href="#L3530">3530</a> <strong class="jxr_keyword">if</strong> (isEmpty(dateStr) || isEmpty(format))
-<a class="jxr_linenumber" name="L3531" href="#L3531">3531</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3532" href="#L3532">3532</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L3533" href="#L3533">3533</a> <strong class="jxr_keyword">var</strong> sdf = <strong class="jxr_keyword">new</strong> SimpleDateFormat(format);
-<a class="jxr_linenumber" name="L3534" href="#L3534">3534</a> sdf.setLenient(false); <em class="jxr_comment">// Strict parsing</em>
-<a class="jxr_linenumber" name="L3535" href="#L3535">3535</a> sdf.parse(dateStr);
-<a class="jxr_linenumber" name="L3536" href="#L3536">3536</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3537" href="#L3537">3537</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) ParseException | IllegalArgumentException e) {
-<a class="jxr_linenumber" name="L3538" href="#L3538">3538</a> <em class="jxr_comment">// IllegalArgumentException thrown for invalid format patterns</em>
-<a class="jxr_linenumber" name="L3539" href="#L3539">3539</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3540" href="#L3540">3540</a> }
-<a class="jxr_linenumber" name="L3541" href="#L3541">3541</a> }
-<a class="jxr_linenumber" name="L3542" href="#L3542">3542</a>
-<a class="jxr_linenumber" name="L3543" href="#L3543">3543</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3544" href="#L3544">3544</a> <em class="jxr_javadoccomment"> * Validates if a string is a valid hostname.</em>
-<a class="jxr_linenumber" name="L3545" href="#L3545">3545</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3546" href="#L3546">3546</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3547" href="#L3547">3547</a> <em class="jxr_javadoccomment"> * Validates hostnames according to RFC 1123. A valid hostname:</em>
-<a class="jxr_linenumber" name="L3548" href="#L3548">3548</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L3549" href="#L3549">3549</a> <em class="jxr_javadoccomment"> * <li>Can contain letters, digits, and hyphens</li></em>
-<a class="jxr_linenumber" name="L3550" href="#L3550">3550</a> <em class="jxr_javadoccomment"> * <li>Cannot start or end with a hyphen</li></em>
-<a class="jxr_linenumber" name="L3551" href="#L3551">3551</a> <em class="jxr_javadoccomment"> * <li>Each label (dot-separated part) can be up to 63 characters</li></em>
-<a class="jxr_linenumber" name="L3552" href="#L3552">3552</a> <em class="jxr_javadoccomment"> * <li>Total length can be up to 253 characters</li></em>
-<a class="jxr_linenumber" name="L3553" href="#L3553">3553</a> <em class="jxr_javadoccomment"> * <li>Labels cannot be empty</li></em>
-<a class="jxr_linenumber" name="L3554" href="#L3554">3554</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L3555" href="#L3555">3555</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3556" href="#L3556">3556</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3557" href="#L3557">3557</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3558" href="#L3558">3558</a> <em class="jxr_javadoccomment"> * isValidHostname(<js>"example.com"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3559" href="#L3559">3559</a> <em class="jxr_javadoccomment"> * isValidHostname(<js>"sub.example.com"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3560" href="#L3560">3560</a> <em class="jxr_javadoccomment"> * isValidHostname(<js>"-invalid.com"</js>); <jc>// false (starts with hyphen)</jc></em>
-<a class="jxr_linenumber" name="L3561" href="#L3561">3561</a> <em class="jxr_javadoccomment"> * isValidHostname(<js>"example..com"</js>); <jc>// false (empty label)</jc></em>
-<a class="jxr_linenumber" name="L3562" href="#L3562">3562</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3563" href="#L3563">3563</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3564" href="#L3564">3564</a> <em class="jxr_javadoccomment"> * @param hostname The hostname string to validate. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3565" href="#L3565">3565</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid hostname, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L3566" href="#L3566">3566</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3567" href="#L3567">3567</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidHostname(String hostname) {
-<a class="jxr_linenumber" name="L3568" href="#L3568">3568</a> <strong class="jxr_keyword">if</strong> (isEmpty(hostname))
-<a class="jxr_linenumber" name="L3569" href="#L3569">3569</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3570" href="#L3570">3570</a>
-<a class="jxr_linenumber" name="L3571" href="#L3571">3571</a> <em class="jxr_comment">// Cannot start or end with a dot</em>
-<a class="jxr_linenumber" name="L3572" href="#L3572">3572</a> <strong class="jxr_keyword">if</strong> (hostname.startsWith(<span class="jxr_string">"."</span>) || hostname.endsWith(<span class="jxr_string">"."</span>))
-<a class="jxr_linenumber" name="L3573" href="#L3573">3573</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3574" href="#L3574">3574</a>
-<a class="jxr_linenumber" name="L3575" href="#L3575">3575</a> <em class="jxr_comment">// Total length cannot exceed 253 characters</em>
-<a class="jxr_linenumber" name="L3576" href="#L3576">3576</a> <strong class="jxr_keyword">if</strong> (hostname.length() > 253)
-<a class="jxr_linenumber" name="L3577" href="#L3577">3577</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3578" href="#L3578">3578</a>
-<a class="jxr_linenumber" name="L3579" href="#L3579">3579</a> <em class="jxr_comment">// Split by dots (use -1 to preserve trailing empty strings)</em>
-<a class="jxr_linenumber" name="L3580" href="#L3580">3580</a> <strong class="jxr_keyword">var</strong> labels = hostname.split(<span class="jxr_string">"\\."</span>, -1);
-<a class="jxr_linenumber" name="L3581" href="#L3581">3581</a>
-<a class="jxr_linenumber" name="L3582" href="#L3582">3582</a> <em class="jxr_comment">// Must have at least one label</em>
-<a class="jxr_linenumber" name="L3583" href="#L3583">3583</a> <strong class="jxr_keyword">if</strong> (labels.length == 0)
-<a class="jxr_linenumber" name="L3584" href="#L3584">3584</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3585" href="#L3585">3585</a>
-<a class="jxr_linenumber" name="L3586" href="#L3586">3586</a> <em class="jxr_comment">// Check each label</em>
-<a class="jxr_linenumber" name="L3587" href="#L3587">3587</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> label : labels) {
-<a class="jxr_linenumber" name="L3588" href="#L3588">3588</a> <em class="jxr_comment">// Label cannot be empty</em>
-<a class="jxr_linenumber" name="L3589" href="#L3589">3589</a> <strong class="jxr_keyword">if</strong> (label.isEmpty())
-<a class="jxr_linenumber" name="L3590" href="#L3590">3590</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3471" href="#L3471">3471</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3472" href="#L3472">3472</a> <em class="jxr_javadoccomment"> * The pattern matched is: <c>[a-z]{2,}\:\/.*</c></em>
+<a class="jxr_linenumber" name="L3473" href="#L3473">3473</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3474" href="#L3474">3474</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3475" href="#L3475">3475</a> <em class="jxr_javadoccomment"> * Note that this excludes filesystem paths such as <js>"C:/temp"</js>.</em>
+<a class="jxr_linenumber" name="L3476" href="#L3476">3476</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3477" href="#L3477">3477</a> <em class="jxr_javadoccomment"> * @param s The string to test.</em>
+<a class="jxr_linenumber" name="L3478" href="#L3478">3478</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if it's an absolute path.</em>
+<a class="jxr_linenumber" name="L3479" href="#L3479">3479</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3480" href="#L3480">3480</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isUri(String s) { <em class="jxr_comment">// NOSONAR - False positive.</em>
+<a class="jxr_linenumber" name="L3481" href="#L3481">3481</a>
+<a class="jxr_linenumber" name="L3482" href="#L3482">3482</a> <strong class="jxr_keyword">if</strong> (isEmpty(s))
+<a class="jxr_linenumber" name="L3483" href="#L3483">3483</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3484" href="#L3484">3484</a>
+<a class="jxr_linenumber" name="L3485" href="#L3485">3485</a> <em class="jxr_comment">// Use a state machine for maximum performance.</em>
+<a class="jxr_linenumber" name="L3486" href="#L3486">3486</a>
+<a class="jxr_linenumber" name="L3487" href="#L3487">3487</a> <em class="jxr_comment">// S1: Looking for protocol char 1</em>
+<a class="jxr_linenumber" name="L3488" href="#L3488">3488</a> <em class="jxr_comment">// S2: Found protocol char 1, looking for protocol char 2</em>
+<a class="jxr_linenumber" name="L3489" href="#L3489">3489</a> <em class="jxr_comment">// S3: Found protocol char 2, looking for :</em>
+<a class="jxr_linenumber" name="L3490" href="#L3490">3490</a> <em class="jxr_comment">// S4: Found :, looking for /</em>
+<a class="jxr_linenumber" name="L3491" href="#L3491">3491</a>
+<a class="jxr_linenumber" name="L3492" href="#L3492">3492</a> <strong class="jxr_keyword">var</strong> state = S1;
+<a class="jxr_linenumber" name="L3493" href="#L3493">3493</a>
+<a class="jxr_linenumber" name="L3494" href="#L3494">3494</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < s.length(); i++) {
+<a class="jxr_linenumber" name="L3495" href="#L3495">3495</a> <strong class="jxr_keyword">var</strong> c = s.charAt(i);
+<a class="jxr_linenumber" name="L3496" href="#L3496">3496</a> <strong class="jxr_keyword">if</strong> (state == S1) {
+<a class="jxr_linenumber" name="L3497" href="#L3497">3497</a> <strong class="jxr_keyword">if</strong> (c >= 'a' && c <= 'z')
+<a class="jxr_linenumber" name="L3498" href="#L3498">3498</a> state = S2;
+<a class="jxr_linenumber" name="L3499" href="#L3499">3499</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L3500" href="#L3500">3500</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3501" href="#L3501">3501</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S2) {
+<a class="jxr_linenumber" name="L3502" href="#L3502">3502</a> <strong class="jxr_keyword">if</strong> (c >= 'a' && c <= 'z')
+<a class="jxr_linenumber" name="L3503" href="#L3503">3503</a> state = S3;
+<a class="jxr_linenumber" name="L3504" href="#L3504">3504</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L3505" href="#L3505">3505</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3506" href="#L3506">3506</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S3) { <em class="jxr_comment">// NOSONAR - False positive.</em>
+<a class="jxr_linenumber" name="L3507" href="#L3507">3507</a> <strong class="jxr_keyword">if</strong> (c == ':')
+<a class="jxr_linenumber" name="L3508" href="#L3508">3508</a> state = S4;
+<a class="jxr_linenumber" name="L3509" href="#L3509">3509</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c < 'a' || c > 'z')
+<a class="jxr_linenumber" name="L3510" href="#L3510">3510</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3511" href="#L3511">3511</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (state == S4) {
+<a class="jxr_linenumber" name="L3512" href="#L3512">3512</a> <strong class="jxr_keyword">return</strong> c == '/';
+<a class="jxr_linenumber" name="L3513" href="#L3513">3513</a> }
+<a class="jxr_linenumber" name="L3514" href="#L3514">3514</a> }
+<a class="jxr_linenumber" name="L3515" href="#L3515">3515</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3516" href="#L3516">3516</a> }
+<a class="jxr_linenumber" name="L3517" href="#L3517">3517</a>
+<a class="jxr_linenumber" name="L3518" href="#L3518">3518</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3519" href="#L3519">3519</a> <em class="jxr_javadoccomment"> * Validates if a date string matches the specified date format.</em>
+<a class="jxr_linenumber" name="L3520" href="#L3520">3520</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3521" href="#L3521">3521</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3522" href="#L3522">3522</a> <em class="jxr_javadoccomment"> * Uses {@link SimpleDateFormat} to parse the date string according to the format pattern.</em>
+<a class="jxr_linenumber" name="L3523" href="#L3523">3523</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3524" href="#L3524">3524</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3525" href="#L3525">3525</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3526" href="#L3526">3526</a> <em class="jxr_javadoccomment"> * isValidDateFormat(<js>"2023-12-25"</js>, <js>"yyyy-MM-dd"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3527" href="#L3527">3527</a> <em class="jxr_javadoccomment"> * isValidDateFormat(<js>"25/12/2023"</js>, <js>"dd/MM/yyyy"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3528" href="#L3528">3528</a> <em class="jxr_javadoccomment"> * isValidDateFormat(<js>"2023-13-25"</js>, <js>"yyyy-MM-dd"</js>); <jc>// false (invalid month)</jc></em>
+<a class="jxr_linenumber" name="L3529" href="#L3529">3529</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3530" href="#L3530">3530</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3531" href="#L3531">3531</a> <em class="jxr_javadoccomment"> * @param dateStr The date string to validate. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3532" href="#L3532">3532</a> <em class="jxr_javadoccomment"> * @param format The date format pattern (e.g., "yyyy-MM-dd"). Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3533" href="#L3533">3533</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the date string matches the format, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L3534" href="#L3534">3534</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3535" href="#L3535">3535</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidDateFormat(String dateStr, String format) {
+<a class="jxr_linenumber" name="L3536" href="#L3536">3536</a> <strong class="jxr_keyword">if</strong> (isEmpty(dateStr) || isEmpty(format))
+<a class="jxr_linenumber" name="L3537" href="#L3537">3537</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3538" href="#L3538">3538</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L3539" href="#L3539">3539</a> <strong class="jxr_keyword">var</strong> sdf = <strong class="jxr_keyword">new</strong> SimpleDateFormat(format);
+<a class="jxr_linenumber" name="L3540" href="#L3540">3540</a> sdf.setLenient(false); <em class="jxr_comment">// Strict parsing</em>
+<a class="jxr_linenumber" name="L3541" href="#L3541">3541</a> sdf.parse(dateStr);
+<a class="jxr_linenumber" name="L3542" href="#L3542">3542</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3543" href="#L3543">3543</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) ParseException | IllegalArgumentException e) {
+<a class="jxr_linenumber" name="L3544" href="#L3544">3544</a> <em class="jxr_comment">// IllegalArgumentException thrown for invalid format patterns</em>
+<a class="jxr_linenumber" name="L3545" href="#L3545">3545</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3546" href="#L3546">3546</a> }
+<a class="jxr_linenumber" name="L3547" href="#L3547">3547</a> }
+<a class="jxr_linenumber" name="L3548" href="#L3548">3548</a>
+<a class="jxr_linenumber" name="L3549" href="#L3549">3549</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3550" href="#L3550">3550</a> <em class="jxr_javadoccomment"> * Validates if a string is a valid hostname.</em>
+<a class="jxr_linenumber" name="L3551" href="#L3551">3551</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3552" href="#L3552">3552</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3553" href="#L3553">3553</a> <em class="jxr_javadoccomment"> * Validates hostnames according to RFC 1123. A valid hostname:</em>
+<a class="jxr_linenumber" name="L3554" href="#L3554">3554</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L3555" href="#L3555">3555</a> <em class="jxr_javadoccomment"> * <li>Can contain letters, digits, and hyphens</li></em>
+<a class="jxr_linenumber" name="L3556" href="#L3556">3556</a> <em class="jxr_javadoccomment"> * <li>Cannot start or end with a hyphen</li></em>
+<a class="jxr_linenumber" name="L3557" href="#L3557">3557</a> <em class="jxr_javadoccomment"> * <li>Each label (dot-separated part) can be up to 63 characters</li></em>
+<a class="jxr_linenumber" name="L3558" href="#L3558">3558</a> <em class="jxr_javadoccomment"> * <li>Total length can be up to 253 characters</li></em>
+<a class="jxr_linenumber" name="L3559" href="#L3559">3559</a> <em class="jxr_javadoccomment"> * <li>Labels cannot be empty</li></em>
+<a class="jxr_linenumber" name="L3560" href="#L3560">3560</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L3561" href="#L3561">3561</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3562" href="#L3562">3562</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3563" href="#L3563">3563</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3564" href="#L3564">3564</a> <em class="jxr_javadoccomment"> * isValidHostname(<js>"example.com"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3565" href="#L3565">3565</a> <em class="jxr_javadoccomment"> * isValidHostname(<js>"sub.example.com"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3566" href="#L3566">3566</a> <em class="jxr_javadoccomment"> * isValidHostname(<js>"-invalid.com"</js>); <jc>// false (starts with hyphen)</jc></em>
+<a class="jxr_linenumber" name="L3567" href="#L3567">3567</a> <em class="jxr_javadoccomment"> * isValidHostname(<js>"example..com"</js>); <jc>// false (empty label)</jc></em>
+<a class="jxr_linenumber" name="L3568" href="#L3568">3568</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3569" href="#L3569">3569</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3570" href="#L3570">3570</a> <em class="jxr_javadoccomment"> * @param hostname The hostname string to validate. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3571" href="#L3571">3571</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid hostname, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L3572" href="#L3572">3572</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3573" href="#L3573">3573</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidHostname(String hostname) {
+<a class="jxr_linenumber" name="L3574" href="#L3574">3574</a> <strong class="jxr_keyword">if</strong> (isEmpty(hostname))
+<a class="jxr_linenumber" name="L3575" href="#L3575">3575</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3576" href="#L3576">3576</a>
+<a class="jxr_linenumber" name="L3577" href="#L3577">3577</a> <em class="jxr_comment">// Cannot start or end with a dot</em>
+<a class="jxr_linenumber" name="L3578" href="#L3578">3578</a> <strong class="jxr_keyword">if</strong> (hostname.startsWith(<span class="jxr_string">"."</span>) || hostname.endsWith(<span class="jxr_string">"."</span>))
+<a class="jxr_linenumber" name="L3579" href="#L3579">3579</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3580" href="#L3580">3580</a>
+<a class="jxr_linenumber" name="L3581" href="#L3581">3581</a> <em class="jxr_comment">// Total length cannot exceed 253 characters</em>
+<a class="jxr_linenumber" name="L3582" href="#L3582">3582</a> <strong class="jxr_keyword">if</strong> (hostname.length() > 253)
+<a class="jxr_linenumber" name="L3583" href="#L3583">3583</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3584" href="#L3584">3584</a>
+<a class="jxr_linenumber" name="L3585" href="#L3585">3585</a> <em class="jxr_comment">// Split by dots (use -1 to preserve trailing empty strings)</em>
+<a class="jxr_linenumber" name="L3586" href="#L3586">3586</a> <strong class="jxr_keyword">var</strong> labels = hostname.split(<span class="jxr_string">"\\."</span>, -1);
+<a class="jxr_linenumber" name="L3587" href="#L3587">3587</a>
+<a class="jxr_linenumber" name="L3588" href="#L3588">3588</a> <em class="jxr_comment">// Must have at least one label</em>
+<a class="jxr_linenumber" name="L3589" href="#L3589">3589</a> <strong class="jxr_keyword">if</strong> (labels.length == 0)
+<a class="jxr_linenumber" name="L3590" href="#L3590">3590</a> <strong class="jxr_keyword">return</strong> false;
<a class="jxr_linenumber" name="L3591" href="#L3591">3591</a>
-<a class="jxr_linenumber" name="L3592" href="#L3592">3592</a> <em class="jxr_comment">// Label cannot exceed 63 characters</em>
-<a class="jxr_linenumber" name="L3593" href="#L3593">3593</a> <strong class="jxr_keyword">if</strong> (label.length() > 63)
-<a class="jxr_linenumber" name="L3594" href="#L3594">3594</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3595" href="#L3595">3595</a>
-<a class="jxr_linenumber" name="L3596" href="#L3596">3596</a> <em class="jxr_comment">// Label cannot start or end with hyphen</em>
-<a class="jxr_linenumber" name="L3597" href="#L3597">3597</a> <strong class="jxr_keyword">if</strong> (label.startsWith(<span class="jxr_string">"-"</span>) || label.endsWith(<span class="jxr_string">"-"</span>))
-<a class="jxr_linenumber" name="L3598" href="#L3598">3598</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3599" href="#L3599">3599</a>
-<a class="jxr_linenumber" name="L3600" href="#L3600">3600</a> <em class="jxr_comment">// Label can only contain letters, digits, and hyphens</em>
-<a class="jxr_linenumber" name="L3601" href="#L3601">3601</a> <strong class="jxr_keyword">if</strong> (! label.matches(<span class="jxr_string">"^[a-zA-Z0-9-]+$"</span>))
-<a class="jxr_linenumber" name="L3602" href="#L3602">3602</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3603" href="#L3603">3603</a> }
-<a class="jxr_linenumber" name="L3604" href="#L3604">3604</a>
-<a class="jxr_linenumber" name="L3605" href="#L3605">3605</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3606" href="#L3606">3606</a> }
-<a class="jxr_linenumber" name="L3607" href="#L3607">3607</a>
-<a class="jxr_linenumber" name="L3608" href="#L3608">3608</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3609" href="#L3609">3609</a> <em class="jxr_javadoccomment"> * Validates if a string is a valid IP address (IPv4 or IPv6).</em>
-<a class="jxr_linenumber" name="L3610" href="#L3610">3610</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3611" href="#L3611">3611</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3612" href="#L3612">3612</a> <em class="jxr_javadoccomment"> * Supports both IPv4 (e.g., "192.168.1.1") and IPv6 (e.g., "2001:0db8:85a3:0000:0000:8a2e:0370:7334") formats.</em>
-<a class="jxr_linenumber" name="L3613" href="#L3613">3613</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3614" href="#L3614">3614</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3615" href="#L3615">3615</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3616" href="#L3616">3616</a> <em class="jxr_javadoccomment"> * isValidIpAddress(<js>"192.168.1.1"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3617" href="#L3617">3617</a> <em class="jxr_javadoccomment"> * isValidIpAddress(<js>"2001:0db8:85a3::8a2e:0370:7334"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3618" href="#L3618">3618</a> <em class="jxr_javadoccomment"> * isValidIpAddress(<js>"256.1.1.1"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3619" href="#L3619">3619</a> <em class="jxr_javadoccomment"> * isValidIpAddress(<js>"not.an.ip"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3620" href="#L3620">3620</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3621" href="#L3621">3621</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3622" href="#L3622">3622</a> <em class="jxr_javadoccomment"> * @param ip The IP address string to validate. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3623" href="#L3623">3623</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid IP address, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L3624" href="#L3624">3624</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3625" href="#L3625">3625</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidIpAddress(String ip) {
-<a class="jxr_linenumber" name="L3626" href="#L3626">3626</a> <strong class="jxr_keyword">if</strong> (isEmpty(ip))
-<a class="jxr_linenumber" name="L3627" href="#L3627">3627</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3628" href="#L3628">3628</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L3629" href="#L3629">3629</a> <em class="jxr_comment">// Try IPv4 first</em>
-<a class="jxr_linenumber" name="L3630" href="#L3630">3630</a> <strong class="jxr_keyword">if</strong> (ip.contains(<span class="jxr_string">"."</span>) && ! ip.contains(<span class="jxr_string">":"</span>)) {
-<a class="jxr_linenumber" name="L3631" href="#L3631">3631</a> <strong class="jxr_keyword">var</strong> parts = ip.split(<span class="jxr_string">"\\."</span>);
-<a class="jxr_linenumber" name="L3632" href="#L3632">3632</a> <strong class="jxr_keyword">if</strong> (parts.length != 4)
-<a class="jxr_linenumber" name="L3633" href="#L3633">3633</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3634" href="#L3634">3634</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> part : parts) {
-<a class="jxr_linenumber" name="L3635" href="#L3635">3635</a> <strong class="jxr_keyword">var</strong> num = Integer.parseInt(part);
-<a class="jxr_linenumber" name="L3636" href="#L3636">3636</a> <strong class="jxr_keyword">if</strong> (num < 0 || num > 255)
-<a class="jxr_linenumber" name="L3637" href="#L3637">3637</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3638" href="#L3638">3638</a> }
-<a class="jxr_linenumber" name="L3639" href="#L3639">3639</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3640" href="#L3640">3640</a> }
-<a class="jxr_linenumber" name="L3641" href="#L3641">3641</a> <em class="jxr_comment">// Try IPv6 - validate format without network operations</em>
-<a class="jxr_linenumber" name="L3642" href="#L3642">3642</a> <strong class="jxr_keyword">if</strong> (ip.contains(<span class="jxr_string">":"</span>)) {
-<a class="jxr_linenumber" name="L3643" href="#L3643">3643</a> <strong class="jxr_keyword">return</strong> isValidIPv6Address(ip);
-<a class="jxr_linenumber" name="L3644" href="#L3644">3644</a> }
-<a class="jxr_linenumber" name="L3645" href="#L3645">3645</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3646" href="#L3646">3646</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) NumberFormatException e) {
-<a class="jxr_linenumber" name="L3647" href="#L3647">3647</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3648" href="#L3648">3648</a> }
-<a class="jxr_linenumber" name="L3649" href="#L3649">3649</a> }
-<a class="jxr_linenumber" name="L3650" href="#L3650">3650</a>
-<a class="jxr_linenumber" name="L3651" href="#L3651">3651</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3652" href="#L3652">3652</a> <em class="jxr_javadoccomment"> * Validates if a string is a valid MAC address.</em>
-<a class="jxr_linenumber" name="L3653" href="#L3653">3653</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3654" href="#L3654">3654</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3655" href="#L3655">3655</a> <em class="jxr_javadoccomment"> * Supports common MAC address formats:</em>
-<a class="jxr_linenumber" name="L3656" href="#L3656">3656</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L3657" href="#L3657">3657</a> <em class="jxr_javadoccomment"> * <li>Colon-separated: <js>"00:1B:44:11:3A:B7"</js></li></em>
-<a class="jxr_linenumber" name="L3658" href="#L3658">3658</a> <em class="jxr_javadoccomment"> * <li>Hyphen-separated: <js>"00-1B-44-11-3A-B7"</js></li></em>
-<a class="jxr_linenumber" name="L3659" href="#L3659">3659</a> <em class="jxr_javadoccomment"> * <li>No separators: <js>"001B44113AB7"</js></li></em>
-<a class="jxr_linenumber" name="L3660" href="#L3660">3660</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L3661" href="#L3661">3661</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3662" href="#L3662">3662</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3663" href="#L3663">3663</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3664" href="#L3664">3664</a> <em class="jxr_javadoccomment"> * isValidMacAddress(<js>"00:1B:44:11:3A:B7"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3665" href="#L3665">3665</a> <em class="jxr_javadoccomment"> * isValidMacAddress(<js>"00-1B-44-11-3A-B7"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3666" href="#L3666">3666</a> <em class="jxr_javadoccomment"> * isValidMacAddress(<js>"001B44113AB7"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3667" href="#L3667">3667</a> <em class="jxr_javadoccomment"> * isValidMacAddress(<js>"00:1B:44:11:3A"</js>); <jc>// false (too short)</jc></em>
-<a class="jxr_linenumber" name="L3668" href="#L3668">3668</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3669" href="#L3669">3669</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3670" href="#L3670">3670</a> <em class="jxr_javadoccomment"> * @param mac The MAC address string to validate. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3671" href="#L3671">3671</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid MAC address, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L3672" href="#L3672">3672</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3673" href="#L3673">3673</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidMacAddress(String mac) {
-<a class="jxr_linenumber" name="L3674" href="#L3674">3674</a> <strong class="jxr_keyword">if</strong> (isEmpty(mac))
-<a class="jxr_linenumber" name="L3675" href="#L3675">3675</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3676" href="#L3676">3676</a>
-<a class="jxr_linenumber" name="L3677" href="#L3677">3677</a> <em class="jxr_comment">// Remove separators and check if it's 12 hex digits</em>
-<a class="jxr_linenumber" name="L3678" href="#L3678">3678</a> <strong class="jxr_keyword">var</strong> cleaned = mac.replaceAll(<span class="jxr_string">"[:-]"</span>, <span class="jxr_string">""</span>).toUpperCase();
-<a class="jxr_linenumber" name="L3679" href="#L3679">3679</a> <strong class="jxr_keyword">if</strong> (cleaned.length() != 12)
-<a class="jxr_linenumber" name="L3680" href="#L3680">3680</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3681" href="#L3681">3681</a>
-<a class="jxr_linenumber" name="L3682" href="#L3682">3682</a> <em class="jxr_comment">// Check if all characters are valid hex digits</em>
-<a class="jxr_linenumber" name="L3683" href="#L3683">3683</a> <strong class="jxr_keyword">return</strong> cleaned.matches(<span class="jxr_string">"^[0-9A-F]{12}$"</span>);
-<a class="jxr_linenumber" name="L3684" href="#L3684">3684</a> }
-<a class="jxr_linenumber" name="L3685" href="#L3685">3685</a>
-<a class="jxr_linenumber" name="L3686" href="#L3686">3686</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3687" href="#L3687">3687</a> <em class="jxr_javadoccomment"> * Validates if a string is a valid regular expression pattern.</em>
-<a class="jxr_linenumber" name="L3688" href="#L3688">3688</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3689" href="#L3689">3689</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3690" href="#L3690">3690</a> <em class="jxr_javadoccomment"> * Attempts to compile the regex pattern to verify it's syntactically correct.</em>
-<a class="jxr_linenumber" name="L3691" href="#L3691">3691</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3692" href="#L3692">3692</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3693" href="#L3693">3693</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3694" href="#L3694">3694</a> <em class="jxr_javadoccomment"> * isValidRegex(<js>"[a-z]+"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3695" href="#L3695">3695</a> <em class="jxr_javadoccomment"> * isValidRegex(<js>"[a-z"</js>); <jc>// false (unclosed bracket)</jc></em>
-<a class="jxr_linenumber" name="L3696" href="#L3696">3696</a> <em class="jxr_javadoccomment"> * isValidRegex(<js>"(test"</js>); <jc>// false (unclosed parenthesis)</jc></em>
-<a class="jxr_linenumber" name="L3697" href="#L3697">3697</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3698" href="#L3698">3698</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3699" href="#L3699">3699</a> <em class="jxr_javadoccomment"> * @param regex The regex pattern to validate. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3700" href="#L3700">3700</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid regex pattern, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L3701" href="#L3701">3701</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3702" href="#L3702">3702</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidRegex(String regex) {
-<a class="jxr_linenumber" name="L3703" href="#L3703">3703</a> <strong class="jxr_keyword">if</strong> (isEmpty(regex))
-<a class="jxr_linenumber" name="L3704" href="#L3704">3704</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3705" href="#L3705">3705</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L3706" href="#L3706">3706</a> Pattern.compile(regex);
-<a class="jxr_linenumber" name="L3707" href="#L3707">3707</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3708" href="#L3708">3708</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) PatternSyntaxException e) {
-<a class="jxr_linenumber" name="L3709" href="#L3709">3709</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3710" href="#L3710">3710</a> }
-<a class="jxr_linenumber" name="L3711" href="#L3711">3711</a> }
-<a class="jxr_linenumber" name="L3712" href="#L3712">3712</a>
-<a class="jxr_linenumber" name="L3713" href="#L3713">3713</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3714" href="#L3714">3714</a> <em class="jxr_javadoccomment"> * Validates if a time string matches the specified time format.</em>
-<a class="jxr_linenumber" name="L3715" href="#L3715">3715</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3716" href="#L3716">3716</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L3717" href="#L3717">3717</a> <em class="jxr_javadoccomment"> * Uses {@link SimpleDateFormat} to parse the time string according to the format pattern.</em>
-<a class="jxr_linenumber" name="L3718" href="#L3718">3718</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3719" href="#L3719">3719</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3720" href="#L3720">3720</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3721" href="#L3721">3721</a> <em class="jxr_javadoccomment"> * isValidTimeFormat(<js>"14:30:00"</js>, <js>"HH:mm:ss"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3722" href="#L3722">3722</a> <em class="jxr_javadoccomment"> * isValidTimeFormat(<js>"2:30 PM"</js>, <js>"h:mm a"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3723" href="#L3723">3723</a> <em class="jxr_javadoccomment"> * isValidTimeFormat(<js>"25:00:00"</js>, <js>"HH:mm:ss"</js>); <jc>// false (invalid hour)</jc></em>
-<a class="jxr_linenumber" name="L3724" href="#L3724">3724</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3725" href="#L3725">3725</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3726" href="#L3726">3726</a> <em class="jxr_javadoccomment"> * @param timeStr The time string to validate. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3727" href="#L3727">3727</a> <em class="jxr_javadoccomment"> * @param format The time format pattern (e.g., "HH:mm:ss"). Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3728" href="#L3728">3728</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the time string matches the format, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L3729" href="#L3729">3729</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3730" href="#L3730">3730</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidTimeFormat(String timeStr, String format) {
-<a class="jxr_linenumber" name="L3731" href="#L3731">3731</a> <strong class="jxr_keyword">if</strong> (isEmpty(timeStr) || isEmpty(format))
-<a class="jxr_linenumber" name="L3732" href="#L3732">3732</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3733" href="#L3733">3733</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L3734" href="#L3734">3734</a> <strong class="jxr_keyword">var</strong> sdf = <strong class="jxr_keyword">new</strong> SimpleDateFormat(format);
-<a class="jxr_linenumber" name="L3735" href="#L3735">3735</a> sdf.setLenient(false); <em class="jxr_comment">// Strict parsing</em>
-<a class="jxr_linenumber" name="L3736" href="#L3736">3736</a> sdf.parse(timeStr);
-<a class="jxr_linenumber" name="L3737" href="#L3737">3737</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3738" href="#L3738">3738</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) ParseException | IllegalArgumentException e) {
-<a class="jxr_linenumber" name="L3739" href="#L3739">3739</a> <em class="jxr_comment">// IllegalArgumentException thrown for invalid format patterns</em>
-<a class="jxr_linenumber" name="L3740" href="#L3740">3740</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3741" href="#L3741">3741</a> }
-<a class="jxr_linenumber" name="L3742" href="#L3742">3742</a> }
-<a class="jxr_linenumber" name="L3743" href="#L3743">3743</a>
-<a class="jxr_linenumber" name="L3744" href="#L3744">3744</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3745" href="#L3745">3745</a> <em class="jxr_javadoccomment"> * Checks if a character is whitespace.</em>
-<a class="jxr_linenumber" name="L3746" href="#L3746">3746</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3747" href="#L3747">3747</a> <em class="jxr_javadoccomment"> * @param c The character to check.</em>
-<a class="jxr_linenumber" name="L3748" href="#L3748">3748</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the character is whitespace.</em>
-<a class="jxr_linenumber" name="L3749" href="#L3749">3749</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3750" href="#L3750">3750</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isWhitespace(<strong class="jxr_keyword">int</strong> c) {
-<a class="jxr_linenumber" name="L3751" href="#L3751">3751</a> <strong class="jxr_keyword">return</strong> Character.isWhitespace(c);
-<a class="jxr_linenumber" name="L3752" href="#L3752">3752</a> }
-<a class="jxr_linenumber" name="L3753" href="#L3753">3753</a>
-<a class="jxr_linenumber" name="L3754" href="#L3754">3754</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3755" href="#L3755">3755</a> <em class="jxr_javadoccomment"> * Checks if a string contains only whitespace characters.</em>
-<a class="jxr_linenumber" name="L3756" href="#L3756">3756</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3757" href="#L3757">3757</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3758" href="#L3758">3758</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3759" href="#L3759">3759</a> <em class="jxr_javadoccomment"> * isWhitespace(<jk>null</jk>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3760" href="#L3760">3760</a> <em class="jxr_javadoccomment"> * isWhitespace(<js>""</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3761" href="#L3761">3761</a> <em class="jxr_javadoccomment"> * isWhitespace(<js>" "</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3762" href="#L3762">3762</a> <em class="jxr_javadoccomment"> * isWhitespace(<js>"\t\n"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L3763" href="#L3763">3763</a> <em class="jxr_javadoccomment"> * isWhitespace(<js>" a "</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L3764" href="#L3764">3764</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L3765" href="#L3765">3765</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3766" href="#L3766">3766</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L3767" href="#L3767">3767</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null and contains only whitespace characters (or is empty).</em>
-<a class="jxr_linenumber" name="L3768" href="#L3768">3768</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3769" href="#L3769">3769</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isWhitespace(String str) {
-<a class="jxr_linenumber" name="L3770" href="#L3770">3770</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3771" href="#L3771">3771</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3772" href="#L3772">3772</a> <strong class="jxr_keyword">if</strong> (str.isEmpty())
-<a class="jxr_linenumber" name="L3773" href="#L3773">3773</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3774" href="#L3774">3774</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L3775" href="#L3775">3775</a> <strong class="jxr_keyword">if</strong> (! isWhitespace(str.charAt(i)))
-<a class="jxr_linenumber" name="L3776" href="#L3776">3776</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L3777" href="#L3777">3777</a> }
-<a class="jxr_linenumber" name="L3778" href="#L3778">3778</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
-<a class="jxr_linenumber" name="L3779" href="#L3779">3779</a> }
-<a class="jxr_linenumber" name="L3780" href="#L3780">3780</a>
-<a class="jxr_linenumber" name="L3781" href="#L3781">3781</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3782" href="#L3782">3782</a> <em class="jxr_javadoccomment"> * Combines collection values into a simple comma-delimited string.</em>
-<a class="jxr_linenumber" name="L3783" href="#L3783">3783</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3784" href="#L3784">3784</a> <em class="jxr_javadoccomment"> * @param values The values to join.</em>
-<a class="jxr_linenumber" name="L3785" href="#L3785">3785</a> <em class="jxr_javadoccomment"> * @return A comma-delimited string.</em>
-<a class="jxr_linenumber" name="L3786" href="#L3786">3786</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3787" href="#L3787">3787</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Collection<?> values) {
-<a class="jxr_linenumber" name="L3788" href="#L3788">3788</a> <strong class="jxr_keyword">return</strong> joine(toList(values), ',');
-<a class="jxr_linenumber" name="L3789" href="#L3789">3789</a> }
-<a class="jxr_linenumber" name="L3790" href="#L3790">3790</a>
-<a class="jxr_linenumber" name="L3791" href="#L3791">3791</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3792" href="#L3792">3792</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
-<a class="jxr_linenumber" name="L3793" href="#L3793">3793</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3794" href="#L3794">3794</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3795" href="#L3795">3795</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3796" href="#L3796">3796</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3797" href="#L3797">3797</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3798" href="#L3798">3798</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Collection<?> tokens, <strong class="jxr_keyword">char</strong> d) {
-<a class="jxr_linenumber" name="L3799" href="#L3799">3799</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3800" href="#L3800">3800</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L3801" href="#L3801">3801</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3802" href="#L3802">3802</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> iter = tokens.iterator(); iter.hasNext();) {
-<a class="jxr_linenumber" name="L3803" href="#L3803">3803</a> sb.append(iter.next());
-<a class="jxr_linenumber" name="L3804" href="#L3804">3804</a> <strong class="jxr_keyword">if</strong> (iter.hasNext())
-<a class="jxr_linenumber" name="L3805" href="#L3805">3805</a> sb.append(d);
-<a class="jxr_linenumber" name="L3806" href="#L3806">3806</a> }
-<a class="jxr_linenumber" name="L3807" href="#L3807">3807</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L3808" href="#L3808">3808</a> }
-<a class="jxr_linenumber" name="L3809" href="#L3809">3809</a>
-<a class="jxr_linenumber" name="L3810" href="#L3810">3810</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3811" href="#L3811">3811</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
-<a class="jxr_linenumber" name="L3812" href="#L3812">3812</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3813" href="#L3813">3813</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3814" href="#L3814">3814</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3815" href="#L3815">3815</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3816" href="#L3816">3816</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3817" href="#L3817">3817</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Collection<?> tokens, String d) {
-<a class="jxr_linenumber" name="L3818" href="#L3818">3818</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3819" href="#L3819">3819</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L3820" href="#L3820">3820</a> <strong class="jxr_keyword">return</strong> StringUtils.join(tokens, d, <strong class="jxr_keyword">new</strong> StringBuilder()).toString();
-<a class="jxr_linenumber" name="L3821" href="#L3821">3821</a> }
-<a class="jxr_linenumber" name="L3822" href="#L3822">3822</a>
-<a class="jxr_linenumber" name="L3823" href="#L3823">3823</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3824" href="#L3824">3824</a> <em class="jxr_javadoccomment"> * Joins the specified tokens into a delimited string and writes the output to the specified string builder.</em>
-<a class="jxr_linenumber" name="L3825" href="#L3825">3825</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3826" href="#L3826">3826</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3827" href="#L3827">3827</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3828" href="#L3828">3828</a> <em class="jxr_javadoccomment"> * @param sb The string builder to append the response to.</em>
-<a class="jxr_linenumber" name="L3829" href="#L3829">3829</a> <em class="jxr_javadoccomment"> * @return The same string builder passed in as <c>sb</c>.</em>
-<a class="jxr_linenumber" name="L3830" href="#L3830">3830</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3831" href="#L3831">3831</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder join(Collection<?> tokens, String d, StringBuilder sb) {
-<a class="jxr_linenumber" name="L3832" href="#L3832">3832</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3833" href="#L3833">3833</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L3834" href="#L3834">3834</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> iter = tokens.iterator(); iter.hasNext();) {
-<a class="jxr_linenumber" name="L3835" href="#L3835">3835</a> sb.append(iter.next());
-<a class="jxr_linenumber" name="L3836" href="#L3836">3836</a> <strong class="jxr_keyword">if</strong> (iter.hasNext())
-<a class="jxr_linenumber" name="L3837" href="#L3837">3837</a> sb.append(d);
-<a class="jxr_linenumber" name="L3838" href="#L3838">3838</a> }
-<a class="jxr_linenumber" name="L3839" href="#L3839">3839</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L3840" href="#L3840">3840</a> }
-<a class="jxr_linenumber" name="L3841" href="#L3841">3841</a>
-<a class="jxr_linenumber" name="L3842" href="#L3842">3842</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3843" href="#L3843">3843</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
-<a class="jxr_linenumber" name="L3844" href="#L3844">3844</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3845" href="#L3845">3845</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3846" href="#L3846">3846</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3847" href="#L3847">3847</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3848" href="#L3848">3848</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3849" href="#L3849">3849</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(<strong class="jxr_keyword">int</strong>[] tokens, <strong class="jxr_keyword">char</strong> d) {
-<a class="jxr_linenumber" name="L3850" href="#L3850">3850</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3851" href="#L3851">3851</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L3852" href="#L3852">3852</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3853" href="#L3853">3853</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < tokens.length; i++) {
-<a class="jxr_linenumber" name="L3854" href="#L3854">3854</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L3855" href="#L3855">3855</a> sb.append(d);
-<a class="jxr_linenumber" name="L3856" href="#L3856">3856</a> sb.append(tokens[i]);
-<a class="jxr_linenumber" name="L3857" href="#L3857">3857</a> }
-<a class="jxr_linenumber" name="L3858" href="#L3858">3858</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L3859" href="#L3859">3859</a> }
-<a class="jxr_linenumber" name="L3860" href="#L3860">3860</a>
-<a class="jxr_linenumber" name="L3861" href="#L3861">3861</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3862" href="#L3862">3862</a> <em class="jxr_javadoccomment"> * Joins an array of integers with a delimiter.</em>
-<a class="jxr_linenumber" name="L3863" href="#L3863">3863</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3864" href="#L3864">3864</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L3865" href="#L3865">3865</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L3866" href="#L3866">3866</a> <em class="jxr_javadoccomment"> * join(<jk>new int</jk>[]{1, 2, 3}, <js>","</js>); <jc>// "1,2,3"</jc></em>
-<a class="jxr_linenumber" name="L3867" href="#L3867">3867</a> <em class="jxr_javadoccomment"> * join(<jk>new int</jk>[]{}, <js>","</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L3868" href="#L3868">3868</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3592" href="#L3592">3592</a> <em class="jxr_comment">// Check each label</em>
+<a class="jxr_linenumber" name="L3593" href="#L3593">3593</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> label : labels) {
+<a class="jxr_linenumber" name="L3594" href="#L3594">3594</a> <em class="jxr_comment">// Label cannot be empty</em>
+<a class="jxr_linenumber" name="L3595" href="#L3595">3595</a> <strong class="jxr_keyword">if</strong> (label.isEmpty())
+<a class="jxr_linenumber" name="L3596" href="#L3596">3596</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3597" href="#L3597">3597</a>
+<a class="jxr_linenumber" name="L3598" href="#L3598">3598</a> <em class="jxr_comment">// Label cannot exceed 63 characters</em>
+<a class="jxr_linenumber" name="L3599" href="#L3599">3599</a> <strong class="jxr_keyword">if</strong> (label.length() > 63)
+<a class="jxr_linenumber" name="L3600" href="#L3600">3600</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3601" href="#L3601">3601</a>
+<a class="jxr_linenumber" name="L3602" href="#L3602">3602</a> <em class="jxr_comment">// Label cannot start or end with hyphen</em>
+<a class="jxr_linenumber" name="L3603" href="#L3603">3603</a> <strong class="jxr_keyword">if</strong> (label.startsWith(<span class="jxr_string">"-"</span>) || label.endsWith(<span class="jxr_string">"-"</span>))
+<a class="jxr_linenumber" name="L3604" href="#L3604">3604</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3605" href="#L3605">3605</a>
+<a class="jxr_linenumber" name="L3606" href="#L3606">3606</a> <em class="jxr_comment">// Label can only contain letters, digits, and hyphens</em>
+<a class="jxr_linenumber" name="L3607" href="#L3607">3607</a> <strong class="jxr_keyword">if</strong> (! label.matches(<span class="jxr_string">"^[a-zA-Z0-9-]+$"</span>))
+<a class="jxr_linenumber" name="L3608" href="#L3608">3608</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3609" href="#L3609">3609</a> }
+<a class="jxr_linenumber" name="L3610" href="#L3610">3610</a>
+<a class="jxr_linenumber" name="L3611" href="#L3611">3611</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3612" href="#L3612">3612</a> }
+<a class="jxr_linenumber" name="L3613" href="#L3613">3613</a>
+<a class="jxr_linenumber" name="L3614" href="#L3614">3614</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3615" href="#L3615">3615</a> <em class="jxr_javadoccomment"> * Validates if a string is a valid IP address (IPv4 or IPv6).</em>
+<a class="jxr_linenumber" name="L3616" href="#L3616">3616</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3617" href="#L3617">3617</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3618" href="#L3618">3618</a> <em class="jxr_javadoccomment"> * Supports both IPv4 (e.g., "192.168.1.1") and IPv6 (e.g., "2001:0db8:85a3:0000:0000:8a2e:0370:7334") formats.</em>
+<a class="jxr_linenumber" name="L3619" href="#L3619">3619</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3620" href="#L3620">3620</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3621" href="#L3621">3621</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3622" href="#L3622">3622</a> <em class="jxr_javadoccomment"> * isValidIpAddress(<js>"192.168.1.1"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3623" href="#L3623">3623</a> <em class="jxr_javadoccomment"> * isValidIpAddress(<js>"2001:0db8:85a3::8a2e:0370:7334"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3624" href="#L3624">3624</a> <em class="jxr_javadoccomment"> * isValidIpAddress(<js>"256.1.1.1"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3625" href="#L3625">3625</a> <em class="jxr_javadoccomment"> * isValidIpAddress(<js>"not.an.ip"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3626" href="#L3626">3626</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3627" href="#L3627">3627</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3628" href="#L3628">3628</a> <em class="jxr_javadoccomment"> * @param ip The IP address string to validate. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3629" href="#L3629">3629</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid IP address, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L3630" href="#L3630">3630</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3631" href="#L3631">3631</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidIpAddress(String ip) {
+<a class="jxr_linenumber" name="L3632" href="#L3632">3632</a> <strong class="jxr_keyword">if</strong> (isEmpty(ip))
+<a class="jxr_linenumber" name="L3633" href="#L3633">3633</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3634" href="#L3634">3634</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L3635" href="#L3635">3635</a> <em class="jxr_comment">// Try IPv4 first</em>
+<a class="jxr_linenumber" name="L3636" href="#L3636">3636</a> <strong class="jxr_keyword">if</strong> (ip.contains(<span class="jxr_string">"."</span>) && ! ip.contains(<span class="jxr_string">":"</span>)) {
+<a class="jxr_linenumber" name="L3637" href="#L3637">3637</a> <strong class="jxr_keyword">var</strong> parts = ip.split(<span class="jxr_string">"\\."</span>);
+<a class="jxr_linenumber" name="L3638" href="#L3638">3638</a> <strong class="jxr_keyword">if</strong> (parts.length != 4)
+<a class="jxr_linenumber" name="L3639" href="#L3639">3639</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3640" href="#L3640">3640</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> part : parts) {
+<a class="jxr_linenumber" name="L3641" href="#L3641">3641</a> <strong class="jxr_keyword">var</strong> num = Integer.parseInt(part);
+<a class="jxr_linenumber" name="L3642" href="#L3642">3642</a> <strong class="jxr_keyword">if</strong> (num < 0 || num > 255)
+<a class="jxr_linenumber" name="L3643" href="#L3643">3643</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3644" href="#L3644">3644</a> }
+<a class="jxr_linenumber" name="L3645" href="#L3645">3645</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3646" href="#L3646">3646</a> }
+<a class="jxr_linenumber" name="L3647" href="#L3647">3647</a> <em class="jxr_comment">// Try IPv6 - validate format without network operations</em>
+<a class="jxr_linenumber" name="L3648" href="#L3648">3648</a> <strong class="jxr_keyword">if</strong> (ip.contains(<span class="jxr_string">":"</span>)) {
+<a class="jxr_linenumber" name="L3649" href="#L3649">3649</a> <strong class="jxr_keyword">return</strong> isValidIPv6Address(ip);
+<a class="jxr_linenumber" name="L3650" href="#L3650">3650</a> }
+<a class="jxr_linenumber" name="L3651" href="#L3651">3651</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3652" href="#L3652">3652</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) NumberFormatException e) {
+<a class="jxr_linenumber" name="L3653" href="#L3653">3653</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3654" href="#L3654">3654</a> }
+<a class="jxr_linenumber" name="L3655" href="#L3655">3655</a> }
+<a class="jxr_linenumber" name="L3656" href="#L3656">3656</a>
+<a class="jxr_linenumber" name="L3657" href="#L3657">3657</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3658" href="#L3658">3658</a> <em class="jxr_javadoccomment"> * Validates if a string is a valid MAC address.</em>
+<a class="jxr_linenumber" name="L3659" href="#L3659">3659</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3660" href="#L3660">3660</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3661" href="#L3661">3661</a> <em class="jxr_javadoccomment"> * Supports common MAC address formats:</em>
+<a class="jxr_linenumber" name="L3662" href="#L3662">3662</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L3663" href="#L3663">3663</a> <em class="jxr_javadoccomment"> * <li>Colon-separated: <js>"00:1B:44:11:3A:B7"</js></li></em>
+<a class="jxr_linenumber" name="L3664" href="#L3664">3664</a> <em class="jxr_javadoccomment"> * <li>Hyphen-separated: <js>"00-1B-44-11-3A-B7"</js></li></em>
+<a class="jxr_linenumber" name="L3665" href="#L3665">3665</a> <em class="jxr_javadoccomment"> * <li>No separators: <js>"001B44113AB7"</js></li></em>
+<a class="jxr_linenumber" name="L3666" href="#L3666">3666</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L3667" href="#L3667">3667</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3668" href="#L3668">3668</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3669" href="#L3669">3669</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3670" href="#L3670">3670</a> <em class="jxr_javadoccomment"> * isValidMacAddress(<js>"00:1B:44:11:3A:B7"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3671" href="#L3671">3671</a> <em class="jxr_javadoccomment"> * isValidMacAddress(<js>"00-1B-44-11-3A-B7"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3672" href="#L3672">3672</a> <em class="jxr_javadoccomment"> * isValidMacAddress(<js>"001B44113AB7"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3673" href="#L3673">3673</a> <em class="jxr_javadoccomment"> * isValidMacAddress(<js>"00:1B:44:11:3A"</js>); <jc>// false (too short)</jc></em>
+<a class="jxr_linenumber" name="L3674" href="#L3674">3674</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3675" href="#L3675">3675</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3676" href="#L3676">3676</a> <em class="jxr_javadoccomment"> * @param mac The MAC address string to validate. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3677" href="#L3677">3677</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid MAC address, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L3678" href="#L3678">3678</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3679" href="#L3679">3679</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidMacAddress(String mac) {
+<a class="jxr_linenumber" name="L3680" href="#L3680">3680</a> <strong class="jxr_keyword">if</strong> (isEmpty(mac))
+<a class="jxr_linenumber" name="L3681" href="#L3681">3681</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3682" href="#L3682">3682</a>
+<a class="jxr_linenumber" name="L3683" href="#L3683">3683</a> <em class="jxr_comment">// Remove separators and check if it's 12 hex digits</em>
+<a class="jxr_linenumber" name="L3684" href="#L3684">3684</a> <strong class="jxr_keyword">var</strong> cleaned = mac.replaceAll(<span class="jxr_string">"[:-]"</span>, <span class="jxr_string">""</span>).toUpperCase();
+<a class="jxr_linenumber" name="L3685" href="#L3685">3685</a> <strong class="jxr_keyword">if</strong> (cleaned.length() != 12)
+<a class="jxr_linenumber" name="L3686" href="#L3686">3686</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3687" href="#L3687">3687</a>
+<a class="jxr_linenumber" name="L3688" href="#L3688">3688</a> <em class="jxr_comment">// Check if all characters are valid hex digits</em>
+<a class="jxr_linenumber" name="L3689" href="#L3689">3689</a> <strong class="jxr_keyword">return</strong> cleaned.matches(<span class="jxr_string">"^[0-9A-F]{12}$"</span>);
+<a class="jxr_linenumber" name="L3690" href="#L3690">3690</a> }
+<a class="jxr_linenumber" name="L3691" href="#L3691">3691</a>
+<a class="jxr_linenumber" name="L3692" href="#L3692">3692</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3693" href="#L3693">3693</a> <em class="jxr_javadoccomment"> * Validates if a string is a valid regular expression pattern.</em>
+<a class="jxr_linenumber" name="L3694" href="#L3694">3694</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3695" href="#L3695">3695</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3696" href="#L3696">3696</a> <em class="jxr_javadoccomment"> * Attempts to compile the regex pattern to verify it's syntactically correct.</em>
+<a class="jxr_linenumber" name="L3697" href="#L3697">3697</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3698" href="#L3698">3698</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3699" href="#L3699">3699</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3700" href="#L3700">3700</a> <em class="jxr_javadoccomment"> * isValidRegex(<js>"[a-z]+"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3701" href="#L3701">3701</a> <em class="jxr_javadoccomment"> * isValidRegex(<js>"[a-z"</js>); <jc>// false (unclosed bracket)</jc></em>
+<a class="jxr_linenumber" name="L3702" href="#L3702">3702</a> <em class="jxr_javadoccomment"> * isValidRegex(<js>"(test"</js>); <jc>// false (unclosed parenthesis)</jc></em>
+<a class="jxr_linenumber" name="L3703" href="#L3703">3703</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3704" href="#L3704">3704</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3705" href="#L3705">3705</a> <em class="jxr_javadoccomment"> * @param regex The regex pattern to validate. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3706" href="#L3706">3706</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is a valid regex pattern, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L3707" href="#L3707">3707</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3708" href="#L3708">3708</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidRegex(String regex) {
+<a class="jxr_linenumber" name="L3709" href="#L3709">3709</a> <strong class="jxr_keyword">if</strong> (isEmpty(regex))
+<a class="jxr_linenumber" name="L3710" href="#L3710">3710</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3711" href="#L3711">3711</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L3712" href="#L3712">3712</a> Pattern.compile(regex);
+<a class="jxr_linenumber" name="L3713" href="#L3713">3713</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3714" href="#L3714">3714</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) PatternSyntaxException e) {
+<a class="jxr_linenumber" name="L3715" href="#L3715">3715</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3716" href="#L3716">3716</a> }
+<a class="jxr_linenumber" name="L3717" href="#L3717">3717</a> }
+<a class="jxr_linenumber" name="L3718" href="#L3718">3718</a>
+<a class="jxr_linenumber" name="L3719" href="#L3719">3719</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3720" href="#L3720">3720</a> <em class="jxr_javadoccomment"> * Validates if a time string matches the specified time format.</em>
+<a class="jxr_linenumber" name="L3721" href="#L3721">3721</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3722" href="#L3722">3722</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L3723" href="#L3723">3723</a> <em class="jxr_javadoccomment"> * Uses {@link SimpleDateFormat} to parse the time string according to the format pattern.</em>
+<a class="jxr_linenumber" name="L3724" href="#L3724">3724</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3725" href="#L3725">3725</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3726" href="#L3726">3726</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3727" href="#L3727">3727</a> <em class="jxr_javadoccomment"> * isValidTimeFormat(<js>"14:30:00"</js>, <js>"HH:mm:ss"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3728" href="#L3728">3728</a> <em class="jxr_javadoccomment"> * isValidTimeFormat(<js>"2:30 PM"</js>, <js>"h:mm a"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3729" href="#L3729">3729</a> <em class="jxr_javadoccomment"> * isValidTimeFormat(<js>"25:00:00"</js>, <js>"HH:mm:ss"</js>); <jc>// false (invalid hour)</jc></em>
+<a class="jxr_linenumber" name="L3730" href="#L3730">3730</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3731" href="#L3731">3731</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3732" href="#L3732">3732</a> <em class="jxr_javadoccomment"> * @param timeStr The time string to validate. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3733" href="#L3733">3733</a> <em class="jxr_javadoccomment"> * @param format The time format pattern (e.g., "HH:mm:ss"). Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3734" href="#L3734">3734</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the time string matches the format, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L3735" href="#L3735">3735</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3736" href="#L3736">3736</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isValidTimeFormat(String timeStr, String format) {
+<a class="jxr_linenumber" name="L3737" href="#L3737">3737</a> <strong class="jxr_keyword">if</strong> (isEmpty(timeStr) || isEmpty(format))
+<a class="jxr_linenumber" name="L3738" href="#L3738">3738</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3739" href="#L3739">3739</a> <strong class="jxr_keyword">try</strong> {
+<a class="jxr_linenumber" name="L3740" href="#L3740">3740</a> <strong class="jxr_keyword">var</strong> sdf = <strong class="jxr_keyword">new</strong> SimpleDateFormat(format);
+<a class="jxr_linenumber" name="L3741" href="#L3741">3741</a> sdf.setLenient(false); <em class="jxr_comment">// Strict parsing</em>
+<a class="jxr_linenumber" name="L3742" href="#L3742">3742</a> sdf.parse(timeStr);
+<a class="jxr_linenumber" name="L3743" href="#L3743">3743</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3744" href="#L3744">3744</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) ParseException | IllegalArgumentException e) {
+<a class="jxr_linenumber" name="L3745" href="#L3745">3745</a> <em class="jxr_comment">// IllegalArgumentException thrown for invalid format patterns</em>
+<a class="jxr_linenumber" name="L3746" href="#L3746">3746</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3747" href="#L3747">3747</a> }
+<a class="jxr_linenumber" name="L3748" href="#L3748">3748</a> }
+<a class="jxr_linenumber" name="L3749" href="#L3749">3749</a>
+<a class="jxr_linenumber" name="L3750" href="#L3750">3750</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3751" href="#L3751">3751</a> <em class="jxr_javadoccomment"> * Checks if a character is whitespace.</em>
+<a class="jxr_linenumber" name="L3752" href="#L3752">3752</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3753" href="#L3753">3753</a> <em class="jxr_javadoccomment"> * @param c The character to check.</em>
+<a class="jxr_linenumber" name="L3754" href="#L3754">3754</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the character is whitespace.</em>
+<a class="jxr_linenumber" name="L3755" href="#L3755">3755</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3756" href="#L3756">3756</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isWhitespace(<strong class="jxr_keyword">int</strong> c) {
+<a class="jxr_linenumber" name="L3757" href="#L3757">3757</a> <strong class="jxr_keyword">return</strong> Character.isWhitespace(c);
+<a class="jxr_linenumber" name="L3758" href="#L3758">3758</a> }
+<a class="jxr_linenumber" name="L3759" href="#L3759">3759</a>
+<a class="jxr_linenumber" name="L3760" href="#L3760">3760</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3761" href="#L3761">3761</a> <em class="jxr_javadoccomment"> * Checks if a string contains only whitespace characters.</em>
+<a class="jxr_linenumber" name="L3762" href="#L3762">3762</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3763" href="#L3763">3763</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3764" href="#L3764">3764</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3765" href="#L3765">3765</a> <em class="jxr_javadoccomment"> * isWhitespace(<jk>null</jk>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3766" href="#L3766">3766</a> <em class="jxr_javadoccomment"> * isWhitespace(<js>""</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3767" href="#L3767">3767</a> <em class="jxr_javadoccomment"> * isWhitespace(<js>" "</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3768" href="#L3768">3768</a> <em class="jxr_javadoccomment"> * isWhitespace(<js>"\t\n"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L3769" href="#L3769">3769</a> <em class="jxr_javadoccomment"> * isWhitespace(<js>" a "</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L3770" href="#L3770">3770</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3771" href="#L3771">3771</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3772" href="#L3772">3772</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L3773" href="#L3773">3773</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string is not null and contains only whitespace characters (or is empty).</em>
+<a class="jxr_linenumber" name="L3774" href="#L3774">3774</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3775" href="#L3775">3775</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> isWhitespace(String str) {
+<a class="jxr_linenumber" name="L3776" href="#L3776">3776</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3777" href="#L3777">3777</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3778" href="#L3778">3778</a> <strong class="jxr_keyword">if</strong> (str.isEmpty())
+<a class="jxr_linenumber" name="L3779" href="#L3779">3779</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3780" href="#L3780">3780</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L3781" href="#L3781">3781</a> <strong class="jxr_keyword">if</strong> (! isWhitespace(str.charAt(i)))
+<a class="jxr_linenumber" name="L3782" href="#L3782">3782</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L3783" href="#L3783">3783</a> }
+<a class="jxr_linenumber" name="L3784" href="#L3784">3784</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">true</strong>;
+<a class="jxr_linenumber" name="L3785" href="#L3785">3785</a> }
+<a class="jxr_linenumber" name="L3786" href="#L3786">3786</a>
+<a class="jxr_linenumber" name="L3787" href="#L3787">3787</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3788" href="#L3788">3788</a> <em class="jxr_javadoccomment"> * Combines collection values into a simple comma-delimited string.</em>
+<a class="jxr_linenumber" name="L3789" href="#L3789">3789</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3790" href="#L3790">3790</a> <em class="jxr_javadoccomment"> * @param values The values to join.</em>
+<a class="jxr_linenumber" name="L3791" href="#L3791">3791</a> <em class="jxr_javadoccomment"> * @return A comma-delimited string.</em>
+<a class="jxr_linenumber" name="L3792" href="#L3792">3792</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3793" href="#L3793">3793</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Collection<?> values) {
+<a class="jxr_linenumber" name="L3794" href="#L3794">3794</a> <strong class="jxr_keyword">return</strong> joine(toList(values), ',');
+<a class="jxr_linenumber" name="L3795" href="#L3795">3795</a> }
+<a class="jxr_linenumber" name="L3796" href="#L3796">3796</a>
+<a class="jxr_linenumber" name="L3797" href="#L3797">3797</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3798" href="#L3798">3798</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
+<a class="jxr_linenumber" name="L3799" href="#L3799">3799</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3800" href="#L3800">3800</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3801" href="#L3801">3801</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3802" href="#L3802">3802</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3803" href="#L3803">3803</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3804" href="#L3804">3804</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Collection<?> tokens, <strong class="jxr_keyword">char</strong> d) {
+<a class="jxr_linenumber" name="L3805" href="#L3805">3805</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3806" href="#L3806">3806</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L3807" href="#L3807">3807</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3808" href="#L3808">3808</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> iter = tokens.iterator(); iter.hasNext();) {
+<a class="jxr_linenumber" name="L3809" href="#L3809">3809</a> sb.append(iter.next());
+<a class="jxr_linenumber" name="L3810" href="#L3810">3810</a> <strong class="jxr_keyword">if</strong> (iter.hasNext())
+<a class="jxr_linenumber" name="L3811" href="#L3811">3811</a> sb.append(d);
+<a class="jxr_linenumber" name="L3812" href="#L3812">3812</a> }
+<a class="jxr_linenumber" name="L3813" href="#L3813">3813</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L3814" href="#L3814">3814</a> }
+<a class="jxr_linenumber" name="L3815" href="#L3815">3815</a>
+<a class="jxr_linenumber" name="L3816" href="#L3816">3816</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3817" href="#L3817">3817</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
+<a class="jxr_linenumber" name="L3818" href="#L3818">3818</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3819" href="#L3819">3819</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3820" href="#L3820">3820</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3821" href="#L3821">3821</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3822" href="#L3822">3822</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3823" href="#L3823">3823</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Collection<?> tokens, String d) {
+<a class="jxr_linenumber" name="L3824" href="#L3824">3824</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3825" href="#L3825">3825</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L3826" href="#L3826">3826</a> <strong class="jxr_keyword">return</strong> StringUtils.join(tokens, d, <strong class="jxr_keyword">new</strong> StringBuilder()).toString();
+<a class="jxr_linenumber" name="L3827" href="#L3827">3827</a> }
+<a class="jxr_linenumber" name="L3828" href="#L3828">3828</a>
+<a class="jxr_linenumber" name="L3829" href="#L3829">3829</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3830" href="#L3830">3830</a> <em class="jxr_javadoccomment"> * Joins the specified tokens into a delimited string and writes the output to the specified string builder.</em>
+<a class="jxr_linenumber" name="L3831" href="#L3831">3831</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3832" href="#L3832">3832</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3833" href="#L3833">3833</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3834" href="#L3834">3834</a> <em class="jxr_javadoccomment"> * @param sb The string builder to append the response to.</em>
+<a class="jxr_linenumber" name="L3835" href="#L3835">3835</a> <em class="jxr_javadoccomment"> * @return The same string builder passed in as <c>sb</c>.</em>
+<a class="jxr_linenumber" name="L3836" href="#L3836">3836</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3837" href="#L3837">3837</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder join(Collection<?> tokens, String d, StringBuilder sb) {
+<a class="jxr_linenumber" name="L3838" href="#L3838">3838</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3839" href="#L3839">3839</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L3840" href="#L3840">3840</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> iter = tokens.iterator(); iter.hasNext();) {
+<a class="jxr_linenumber" name="L3841" href="#L3841">3841</a> sb.append(iter.next());
+<a class="jxr_linenumber" name="L3842" href="#L3842">3842</a> <strong class="jxr_keyword">if</strong> (iter.hasNext())
+<a class="jxr_linenumber" name="L3843" href="#L3843">3843</a> sb.append(d);
+<a class="jxr_linenumber" name="L3844" href="#L3844">3844</a> }
+<a class="jxr_linenumber" name="L3845" href="#L3845">3845</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L3846" href="#L3846">3846</a> }
+<a class="jxr_linenumber" name="L3847" href="#L3847">3847</a>
+<a class="jxr_linenumber" name="L3848" href="#L3848">3848</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3849" href="#L3849">3849</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
+<a class="jxr_linenumber" name="L3850" href="#L3850">3850</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3851" href="#L3851">3851</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3852" href="#L3852">3852</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3853" href="#L3853">3853</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3854" href="#L3854">3854</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3855" href="#L3855">3855</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(<strong class="jxr_keyword">int</strong>[] tokens, <strong class="jxr_keyword">char</strong> d) {
+<a class="jxr_linenumber" name="L3856" href="#L3856">3856</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3857" href="#L3857">3857</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L3858" href="#L3858">3858</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3859" href="#L3859">3859</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < tokens.length; i++) {
+<a class="jxr_linenumber" name="L3860" href="#L3860">3860</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L3861" href="#L3861">3861</a> sb.append(d);
+<a class="jxr_linenumber" name="L3862" href="#L3862">3862</a> sb.append(tokens[i]);
+<a class="jxr_linenumber" name="L3863" href="#L3863">3863</a> }
+<a class="jxr_linenumber" name="L3864" href="#L3864">3864</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L3865" href="#L3865">3865</a> }
+<a class="jxr_linenumber" name="L3866" href="#L3866">3866</a>
+<a class="jxr_linenumber" name="L3867" href="#L3867">3867</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3868" href="#L3868">3868</a> <em class="jxr_javadoccomment"> * Joins an array of integers with a delimiter.</em>
<a class="jxr_linenumber" name="L3869" href="#L3869">3869</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3870" href="#L3870">3870</a> <em class="jxr_javadoccomment"> * @param array The array to join.</em>
-<a class="jxr_linenumber" name="L3871" href="#L3871">3871</a> <em class="jxr_javadoccomment"> * @param delimiter The delimiter string.</em>
-<a class="jxr_linenumber" name="L3872" href="#L3872">3872</a> <em class="jxr_javadoccomment"> * @return The joined string.</em>
-<a class="jxr_linenumber" name="L3873" href="#L3873">3873</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3874" href="#L3874">3874</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(<strong class="jxr_keyword">int</strong>[] array, String delimiter) {
-<a class="jxr_linenumber" name="L3875" href="#L3875">3875</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong> || array.length == 0)
-<a class="jxr_linenumber" name="L3876" href="#L3876">3876</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L3877" href="#L3877">3877</a> <strong class="jxr_keyword">if</strong> (delimiter == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3878" href="#L3878">3878</a> delimiter = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L3879" href="#L3879">3879</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).mapToObj(String::valueOf).collect(Collectors.joining(delimiter));
-<a class="jxr_linenumber" name="L3880" href="#L3880">3880</a> }
-<a class="jxr_linenumber" name="L3881" href="#L3881">3881</a>
-<a class="jxr_linenumber" name="L3882" href="#L3882">3882</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3883" href="#L3883">3883</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
-<a class="jxr_linenumber" name="L3884" href="#L3884">3884</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3885" href="#L3885">3885</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3886" href="#L3886">3886</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3887" href="#L3887">3887</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3888" href="#L3888">3888</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3889" href="#L3889">3889</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(List<?> tokens, <strong class="jxr_keyword">char</strong> d) {
-<a class="jxr_linenumber" name="L3890" href="#L3890">3890</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3891" href="#L3891">3891</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L3892" href="#L3892">3892</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3893" href="#L3893">3893</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0, j = tokens.size(); i < j; i++) {
-<a class="jxr_linenumber" name="L3894" href="#L3894">3894</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L3895" href="#L3895">3895</a> sb.append(d);
-<a class="jxr_linenumber" name="L3896" href="#L3896">3896</a> sb.append(tokens.get(i));
-<a class="jxr_linenumber" name="L3897" href="#L3897">3897</a> }
-<a class="jxr_linenumber" name="L3898" href="#L3898">3898</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L3899" href="#L3899">3899</a> }
-<a class="jxr_linenumber" name="L3900" href="#L3900">3900</a>
-<a class="jxr_linenumber" name="L3901" href="#L3901">3901</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3902" href="#L3902">3902</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
-<a class="jxr_linenumber" name="L3903" href="#L3903">3903</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3904" href="#L3904">3904</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3905" href="#L3905">3905</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3906" href="#L3906">3906</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3907" href="#L3907">3907</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3908" href="#L3908">3908</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(List<?> tokens, String d) {
-<a class="jxr_linenumber" name="L3909" href="#L3909">3909</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3910" href="#L3910">3910</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L3911" href="#L3911">3911</a> <strong class="jxr_keyword">return</strong> StringUtils.join(tokens, d, <strong class="jxr_keyword">new</strong> StringBuilder()).toString();
-<a class="jxr_linenumber" name="L3912" href="#L3912">3912</a> }
-<a class="jxr_linenumber" name="L3913" href="#L3913">3913</a>
-<a class="jxr_linenumber" name="L3914" href="#L3914">3914</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3915" href="#L3915">3915</a> <em class="jxr_javadoccomment"> * Joins the specified tokens into a delimited string and writes the output to the specified string builder.</em>
-<a class="jxr_linenumber" name="L3916" href="#L3916">3916</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3917" href="#L3917">3917</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3918" href="#L3918">3918</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3919" href="#L3919">3919</a> <em class="jxr_javadoccomment"> * @param sb The string builder to append the response to.</em>
-<a class="jxr_linenumber" name="L3920" href="#L3920">3920</a> <em class="jxr_javadoccomment"> * @return The same string builder passed in as <c>sb</c>.</em>
-<a class="jxr_linenumber" name="L3921" href="#L3921">3921</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3922" href="#L3922">3922</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder join(List<?> tokens, String d, StringBuilder sb) {
-<a class="jxr_linenumber" name="L3923" href="#L3923">3923</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3924" href="#L3924">3924</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L3925" href="#L3925">3925</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0, j = tokens.size(); i < j; i++) {
-<a class="jxr_linenumber" name="L3926" href="#L3926">3926</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L3927" href="#L3927">3927</a> sb.append(d);
-<a class="jxr_linenumber" name="L3928" href="#L3928">3928</a> sb.append(tokens.get(i));
-<a class="jxr_linenumber" name="L3929" href="#L3929">3929</a> }
-<a class="jxr_linenumber" name="L3930" href="#L3930">3930</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L3931" href="#L3931">3931</a> }
-<a class="jxr_linenumber" name="L3932" href="#L3932">3932</a>
-<a class="jxr_linenumber" name="L3933" href="#L3933">3933</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3934" href="#L3934">3934</a> <em class="jxr_javadoccomment"> * Joins the specified tokens into a delimited string.</em>
-<a class="jxr_linenumber" name="L3935" href="#L3935">3935</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3936" href="#L3936">3936</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3937" href="#L3937">3937</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3938" href="#L3938">3938</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3939" href="#L3939">3939</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3940" href="#L3940">3940</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Object[] tokens, <strong class="jxr_keyword">char</strong> d) {
-<a class="jxr_linenumber" name="L3941" href="#L3941">3941</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3942" href="#L3942">3942</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L3943" href="#L3943">3943</a> <strong class="jxr_keyword">if</strong> (tokens.length == 1)
-<a class="jxr_linenumber" name="L3944" href="#L3944">3944</a> <strong class="jxr_keyword">return</strong> emptyIfNull(s(tokens[0]));
-<a class="jxr_linenumber" name="L3945" href="#L3945">3945</a> <strong class="jxr_keyword">return</strong> StringUtils.join(tokens, d, <strong class="jxr_keyword">new</strong> StringBuilder()).toString();
-<a class="jxr_linenumber" name="L3946" href="#L3946">3946</a> }
-<a class="jxr_linenumber" name="L3947" href="#L3947">3947</a>
-<a class="jxr_linenumber" name="L3948" href="#L3948">3948</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3949" href="#L3949">3949</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string and writes the output to the specified string builder.</em>
-<a class="jxr_linenumber" name="L3950" href="#L3950">3950</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3951" href="#L3951">3951</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3952" href="#L3952">3952</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L3953" href="#L3953">3953</a> <em class="jxr_javadoccomment"> * @param sb The string builder to append the response to.</em>
-<a class="jxr_linenumber" name="L3954" href="#L3954">3954</a> <em class="jxr_javadoccomment"> * @return The same string builder passed in as <c>sb</c>.</em>
-<a class="jxr_linenumber" name="L3955" href="#L3955">3955</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3956" href="#L3956">3956</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder join(Object[] tokens, <strong class="jxr_keyword">char</strong> d, StringBuilder sb) {
-<a class="jxr_linenumber" name="L3957" href="#L3957">3957</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3958" href="#L3958">3958</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L3959" href="#L3959">3959</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < tokens.length; i++) {
-<a class="jxr_linenumber" name="L3960" href="#L3960">3960</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L3961" href="#L3961">3961</a> sb.append(d);
-<a class="jxr_linenumber" name="L3962" href="#L3962">3962</a> sb.append(tokens[i]);
-<a class="jxr_linenumber" name="L3963" href="#L3963">3963</a> }
-<a class="jxr_linenumber" name="L3964" href="#L3964">3964</a> <strong class="jxr_keyword">return</strong> sb;
-<a class="jxr_linenumber" name="L3965" href="#L3965">3965</a> }
-<a class="jxr_linenumber" name="L3966" href="#L3966">3966</a>
-<a class="jxr_linenumber" name="L3967" href="#L3967">3967</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3968" href="#L3968">3968</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
-<a class="jxr_linenumber" name="L3969" href="#L3969">3969</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3970" href="#L3970">3970</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L3971" href="#L3971">3971</a> <em class="jxr_javadoccomment"> * @param separator The delimiter.</em>
-<a class="jxr_linenumber" name="L3972" href="#L3972">3972</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L3973" href="#L3973">3973</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3974" href="#L3974">3974</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Object[] tokens, String separator) {
-<a class="jxr_linenumber" name="L3975" href="#L3975">3975</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L3976" href="#L3976">3976</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L3977" href="#L3977">3977</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L3978" href="#L3978">3978</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < tokens.length; i++) {
-<a class="jxr_linenumber" name="L3979" href="#L3979">3979</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L3980" href="#L3980">3980</a> sb.append(separator);
-<a class="jxr_linenumber" name="L3981" href="#L3981">3981</a> sb.append(tokens[i]);
-<a class="jxr_linenumber" name="L3982" href="#L3982">3982</a> }
-<a class="jxr_linenumber" name="L3983" href="#L3983">3983</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L3984" href="#L3984">3984</a> }
-<a class="jxr_linenumber" name="L3985" href="#L3985">3985</a>
-<a class="jxr_linenumber" name="L3986" href="#L3986">3986</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3987" href="#L3987">3987</a> <em class="jxr_javadoccomment"> * Combines values into a simple comma-delimited string.</em>
-<a class="jxr_linenumber" name="L3988" href="#L3988">3988</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3989" href="#L3989">3989</a> <em class="jxr_javadoccomment"> * @param values The values to join.</em>
-<a class="jxr_linenumber" name="L3990" href="#L3990">3990</a> <em class="jxr_javadoccomment"> * @return A comma-delimited string.</em>
-<a class="jxr_linenumber" name="L3991" href="#L3991">3991</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L3992" href="#L3992">3992</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(String...values) {
-<a class="jxr_linenumber" name="L3993" href="#L3993">3993</a> <strong class="jxr_keyword">return</strong> join(values, ',');
-<a class="jxr_linenumber" name="L3994" href="#L3994">3994</a> }
-<a class="jxr_linenumber" name="L3995" href="#L3995">3995</a>
-<a class="jxr_linenumber" name="L3996" href="#L3996">3996</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L3997" href="#L3997">3997</a> <em class="jxr_javadoccomment"> * Same as {@link StringUtils#join(Collection, char)} but escapes the delimiter if found in the tokens.</em>
-<a class="jxr_linenumber" name="L3998" href="#L3998">3998</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L3999" href="#L3999">3999</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
-<a class="jxr_linenumber" name="L4000" href="#L4000">4000</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
-<a class="jxr_linenumber" name="L4001" href="#L4001">4001</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4002" href="#L4002">4002</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4003" href="#L4003">4003</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String joine(List<?> tokens, <strong class="jxr_keyword">char</strong> d) {
-<a class="jxr_linenumber" name="L4004" href="#L4004">4004</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4005" href="#L4005">4005</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4006" href="#L4006">4006</a> <strong class="jxr_keyword">var</strong> as = getEscapeSet(d);
-<a class="jxr_linenumber" name="L4007" href="#L4007">4007</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L4008" href="#L4008">4008</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0, j = tokens.size(); i < j; i++) {
-<a class="jxr_linenumber" name="L4009" href="#L4009">4009</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L4010" href="#L4010">4010</a> sb.append(d);
-<a class="jxr_linenumber" name="L4011" href="#L4011">4011</a> sb.append(escapeChars(s(tokens.get(i)), as));
-<a class="jxr_linenumber" name="L4012" href="#L4012">4012</a> }
-<a class="jxr_linenumber" name="L4013" href="#L4013">4013</a> <strong class="jxr_keyword">return</strong> sb.toString();
-<a class="jxr_linenumber" name="L4014" href="#L4014">4014</a> }
-<a class="jxr_linenumber" name="L4015" href="#L4015">4015</a>
-<a class="jxr_linenumber" name="L4016" href="#L4016">4016</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4017" href="#L4017">4017</a> <em class="jxr_javadoccomment"> * Joins tokens with newlines.</em>
-<a class="jxr_linenumber" name="L4018" href="#L4018">4018</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4019" href="#L4019">4019</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to concatenate.</em>
-<a class="jxr_linenumber" name="L4020" href="#L4020">4020</a> <em class="jxr_javadoccomment"> * @return A string with the specified tokens contatenated with newlines.</em>
-<a class="jxr_linenumber" name="L4021" href="#L4021">4021</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4022" href="#L4022">4022</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String joinnl(Object[] tokens) {
-<a class="jxr_linenumber" name="L4023" href="#L4023">4023</a> <strong class="jxr_keyword">return</strong> join(tokens, '\n');
-<a class="jxr_linenumber" name="L4024" href="#L4024">4024</a> }
-<a class="jxr_linenumber" name="L4025" href="#L4025">4025</a>
-<a class="jxr_linenumber" name="L4026" href="#L4026">4026</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4027" href="#L4027">4027</a> <em class="jxr_javadoccomment"> * Converts a string to kebab-case format.</em>
-<a class="jxr_linenumber" name="L4028" href="#L4028">4028</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4029" href="#L4029">4029</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4030" href="#L4030">4030</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
-<a class="jxr_linenumber" name="L4031" href="#L4031">4031</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4032" href="#L4032">4032</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "hello-world"</li></em>
-<a class="jxr_linenumber" name="L4033" href="#L4033">4033</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "hello-world"</li></em>
-<a class="jxr_linenumber" name="L4034" href="#L4034">4034</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "hello-world"</li></em>
-<a class="jxr_linenumber" name="L4035" href="#L4035">4035</a> <em class="jxr_javadoccomment"> * <li>Snake_case: "hello_world" → "hello-world"</li></em>
-<a class="jxr_linenumber" name="L4036" href="#L4036">4036</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4037" href="#L4037">4037</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4038" href="#L4038">4038</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4039" href="#L4039">4039</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4040" href="#L4040">4040</a> <em class="jxr_javadoccomment"> * kebabCase(<jk>null</jk>); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L4041" href="#L4041">4041</a> <em class="jxr_javadoccomment"> * kebabCase(<js>""</js>); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L4042" href="#L4042">4042</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"hello world"</js>); <jc>// "hello-world"</jc></em>
-<a class="jxr_linenumber" name="L4043" href="#L4043">4043</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"helloWorld"</js>); <jc>// "hello-world"</jc></em>
-<a class="jxr_linenumber" name="L4044" href="#L4044">4044</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"HelloWorld"</js>); <jc>// "hello-world"</jc></em>
-<a class="jxr_linenumber" name="L4045" href="#L4045">4045</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"hello_world"</js>); <jc>// "hello-world"</jc></em>
-<a class="jxr_linenumber" name="L4046" href="#L4046">4046</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4047" href="#L4047">4047</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4048" href="#L4048">4048</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
-<a class="jxr_linenumber" name="L4049" href="#L4049">4049</a> <em class="jxr_javadoccomment"> * @return The kebab-case string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4050" href="#L4050">4050</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4051" href="#L4051">4051</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String kebabCase(String str) {
-<a class="jxr_linenumber" name="L4052" href="#L4052">4052</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L4053" href="#L4053">4053</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L4054" href="#L4054">4054</a>
-<a class="jxr_linenumber" name="L4055" href="#L4055">4055</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
-<a class="jxr_linenumber" name="L4056" href="#L4056">4056</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
-<a class="jxr_linenumber" name="L4057" href="#L4057">4057</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4058" href="#L4058">4058</a>
-<a class="jxr_linenumber" name="L4059" href="#L4059">4059</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L4060" href="#L4060">4060</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
-<a class="jxr_linenumber" name="L4061" href="#L4061">4061</a> <strong class="jxr_keyword">if</strong> (i > 0)
-<a class="jxr_linenumber" name="L4062" href="#L4062">4062</a> result.append('-');
-<a class="jxr_linenumber" name="L4063" href="#L4063">4063</a> result.append(words.get(i).toLowerCase());
-<a class="jxr_linenumber" name="L4064" href="#L4064">4064</a> }
-<a class="jxr_linenumber" name="L4065" href="#L4065">4065</a>
-<a class="jxr_linenumber" name="L4066" href="#L4066">4066</a> <strong class="jxr_keyword">return</strong> result.toString();
-<a class="jxr_linenumber" name="L4067" href="#L4067">4067</a> }
-<a class="jxr_linenumber" name="L4068" href="#L4068">4068</a>
-<a class="jxr_linenumber" name="L4069" href="#L4069">4069</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4070" href="#L4070">4070</a> <em class="jxr_javadoccomment"> * Finds the index of the last occurrence of a substring within a string.</em>
-<a class="jxr_linenumber" name="L4071" href="#L4071">4071</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4072" href="#L4072">4072</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4073" href="#L4073">4073</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4074" href="#L4074">4074</a> <em class="jxr_javadoccomment"> * lastIndexOf(<js>"hello world world"</js>, <js>"world"</js>); <jc>// 12</jc></em>
-<a class="jxr_linenumber" name="L4075" href="#L4075">4075</a> <em class="jxr_javadoccomment"> * lastIndexOf(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// -1</jc></em>
-<a class="jxr_linenumber" name="L4076" href="#L4076">4076</a> <em class="jxr_javadoccomment"> * lastIndexOf(<jk>null</jk>, <js>"test"</js>); <jc>// -1</jc></em>
-<a class="jxr_linenumber" name="L4077" href="#L4077">4077</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4078" href="#L4078">4078</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4079" href="#L4079">4079</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
-<a class="jxr_linenumber" name="L4080" href="#L4080">4080</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
-<a class="jxr_linenumber" name="L4081" href="#L4081">4081</a> <em class="jxr_javadoccomment"> * @return The index of the last occurrence, or <c>-1</c> if not found or if either parameter is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4082" href="#L4082">4082</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4083" href="#L4083">4083</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> lastIndexOf(String str, String search) {
-<a class="jxr_linenumber" name="L4084" href="#L4084">4084</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4085" href="#L4085">4085</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L4086" href="#L4086">4086</a> <strong class="jxr_keyword">return</strong> str.lastIndexOf(search);
-<a class="jxr_linenumber" name="L4087" href="#L4087">4087</a> }
-<a class="jxr_linenumber" name="L4088" href="#L4088">4088</a>
-<a class="jxr_linenumber" name="L4089" href="#L4089">4089</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4090" href="#L4090">4090</a> <em class="jxr_javadoccomment"> * Finds the index of the last occurrence of a substring within a string, ignoring case.</em>
-<a class="jxr_linenumber" name="L4091" href="#L4091">4091</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4092" href="#L4092">4092</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4093" href="#L4093">4093</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4094" href="#L4094">4094</a> <em class="jxr_javadoccomment"> * lastIndexOfIgnoreCase(<js>"Hello World World"</js>, <js>"world"</js>); <jc>// 12</jc></em>
-<a class="jxr_linenumber" name="L4095" href="#L4095">4095</a> <em class="jxr_javadoccomment"> * lastIndexOfIgnoreCase(<js>"Hello World"</js>, <js>"WORLD"</js>); <jc>// 6</jc></em>
-<a class="jxr_linenumber" name="L4096" href="#L4096">4096</a> <em class="jxr_javadoccomment"> * lastIndexOfIgnoreCase(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// -1</jc></em>
-<a class="jxr_linenumber" name="L4097" href="#L4097">4097</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4098" href="#L4098">4098</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4099" href="#L4099">4099</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
-<a class="jxr_linenumber" name="L4100" href="#L4100">4100</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
-<a class="jxr_linenumber" name="L4101" href="#L4101">4101</a> <em class="jxr_javadoccomment"> * @return The index of the last occurrence, or <c>-1</c> if not found or if either parameter is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4102" href="#L4102">4102</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4103" href="#L4103">4103</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> lastIndexOfIgnoreCase(String str, String search) {
-<a class="jxr_linenumber" name="L4104" href="#L4104">4104</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4105" href="#L4105">4105</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L4106" href="#L4106">4106</a> <strong class="jxr_keyword">return</strong> str.toLowerCase().lastIndexOf(search.toLowerCase());
-<a class="jxr_linenumber" name="L4107" href="#L4107">4107</a> }
-<a class="jxr_linenumber" name="L4108" href="#L4108">4108</a>
-<a class="jxr_linenumber" name="L4109" href="#L4109">4109</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4110" href="#L4110">4110</a> <em class="jxr_javadoccomment"> * Returns the last non-whitespace character in the string.</em>
-<a class="jxr_linenumber" name="L4111" href="#L4111">4111</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4112" href="#L4112">4112</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4113" href="#L4113">4113</a> <em class="jxr_javadoccomment"> * @return</em>
-<a class="jxr_linenumber" name="L4114" href="#L4114">4114</a> <em class="jxr_javadoccomment"> * The last non-whitespace character, or <c>0</c> if the string is <jk>null</jk>, empty, or composed</em>
-<a class="jxr_linenumber" name="L4115" href="#L4115">4115</a> <em class="jxr_javadoccomment"> * of only whitespace.</em>
-<a class="jxr_linenumber" name="L4116" href="#L4116">4116</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4117" href="#L4117">4117</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> lastNonWhitespaceChar(String s) {
-<a class="jxr_linenumber" name="L4118" href="#L4118">4118</a> <strong class="jxr_keyword">if</strong> (nn(s))
-<a class="jxr_linenumber" name="L4119" href="#L4119">4119</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = s.length() - 1; i >= 0; i--)
-<a class="jxr_linenumber" name="L4120" href="#L4120">4120</a> <strong class="jxr_keyword">if</strong> (! isWhitespace(s.charAt(i)))
-<a class="jxr_linenumber" name="L4121" href="#L4121">4121</a> <strong class="jxr_keyword">return</strong> s.charAt(i);
-<a class="jxr_linenumber" name="L4122" href="#L4122">4122</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L4123" href="#L4123">4123</a> }
-<a class="jxr_linenumber" name="L4124" href="#L4124">4124</a>
-<a class="jxr_linenumber" name="L4125" href="#L4125">4125</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4126" href="#L4126">4126</a> <em class="jxr_javadoccomment"> * Returns the leftmost characters of a string.</em>
-<a class="jxr_linenumber" name="L4127" href="#L4127">4127</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4128" href="#L4128">4128</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4129" href="#L4129">4129</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4130" href="#L4130">4130</a> <em class="jxr_javadoccomment"> * left(<jk>null</jk>, 3); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L4131" href="#L4131">4131</a> <em class="jxr_javadoccomment"> * left(<js>""</js>, 3); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L4132" href="#L4132">4132</a> <em class="jxr_javadoccomment"> * left(<js>"hello"</js>, 3); <jc>// "hel"</jc></em>
-<a class="jxr_linenumber" name="L4133" href="#L4133">4133</a> <em class="jxr_javadoccomment"> * left(<js>"hello"</js>, 10); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L4134" href="#L4134">4134</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4135" href="#L4135">4135</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4136" href="#L4136">4136</a> <em class="jxr_javadoccomment"> * @param str The string to get characters from.</em>
-<a class="jxr_linenumber" name="L4137" href="#L4137">4137</a> <em class="jxr_javadoccomment"> * @param len The number of characters to get.</em>
-<a class="jxr_linenumber" name="L4138" href="#L4138">4138</a> <em class="jxr_javadoccomment"> * @return The leftmost characters, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4139" href="#L4139">4139</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4140" href="#L4140">4140</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String left(String str, <strong class="jxr_keyword">int</strong> len) {
-<a class="jxr_linenumber" name="L4141" href="#L4141">4141</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4142" href="#L4142">4142</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4143" href="#L4143">4143</a> <strong class="jxr_keyword">if</strong> (len < 0)
-<a class="jxr_linenumber" name="L4144" href="#L4144">4144</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4145" href="#L4145">4145</a> <strong class="jxr_keyword">if</strong> (len >= str.length())
-<a class="jxr_linenumber" name="L4146" href="#L4146">4146</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L4147" href="#L4147">4147</a> <strong class="jxr_keyword">return</strong> str.substring(0, len);
-<a class="jxr_linenumber" name="L4148" href="#L4148">4148</a> }
-<a class="jxr_linenumber" name="L4149" href="#L4149">4149</a>
-<a class="jxr_linenumber" name="L4150" href="#L4150">4150</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4151" href="#L4151">4151</a> <em class="jxr_javadoccomment"> * Calculates the Levenshtein distance (edit distance) between two strings.</em>
-<a class="jxr_linenumber" name="L4152" href="#L4152">4152</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4153" href="#L4153">4153</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4154" href="#L4154">4154</a> <em class="jxr_javadoccomment"> * The Levenshtein distance is the minimum number of single-character edits (insertions, deletions, or substitutions) required to change one string into another.</em>
-<a class="jxr_linenumber" name="L4155" href="#L4155">4155</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4156" href="#L4156">4156</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4157" href="#L4157">4157</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4158" href="#L4158">4158</a> <em class="jxr_javadoccomment"> * levenshteinDistance(<js>"kitten"</js>, <js>"sitting"</js>); <jc>// 3</jc></em>
-<a class="jxr_linenumber" name="L4159" href="#L4159">4159</a> <em class="jxr_javadoccomment"> * levenshteinDistance(<js>"hello"</js>, <js>"hello"</js>); <jc>// 0</jc></em>
-<a class="jxr_linenumber" name="L4160" href="#L4160">4160</a> <em class="jxr_javadoccomment"> * levenshteinDistance(<js>"abc"</js>, <js>""</js>); <jc>// 3</jc></em>
-<a class="jxr_linenumber" name="L4161" href="#L4161">4161</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4162" href="#L4162">4162</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4163" href="#L4163">4163</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
-<a class="jxr_linenumber" name="L4164" href="#L4164">4164</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
-<a class="jxr_linenumber" name="L4165" href="#L4165">4165</a> <em class="jxr_javadoccomment"> * @return The Levenshtein distance between the two strings.</em>
-<a class="jxr_linenumber" name="L4166" href="#L4166">4166</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4167" href="#L4167">4167</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> levenshteinDistance(String str1, String str2) {
-<a class="jxr_linenumber" name="L4168" href="#L4168">4168</a> <strong class="jxr_keyword">if</strong> (str1 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4169" href="#L4169">4169</a> str1 = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4170" href="#L4170">4170</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4171" href="#L4171">4171</a> str2 = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4172" href="#L4172">4172</a>
-<a class="jxr_linenumber" name="L4173" href="#L4173">4173</a> <strong class="jxr_keyword">var</strong> len1 = str1.length();
-<a class="jxr_linenumber" name="L4174" href="#L4174">4174</a> <strong class="jxr_keyword">var</strong> len2 = str2.length();
-<a class="jxr_linenumber" name="L4175" href="#L4175">4175</a>
-<a class="jxr_linenumber" name="L4176" href="#L4176">4176</a> <em class="jxr_comment">// Use dynamic programming with optimized space (only need previous row)</em>
-<a class="jxr_linenumber" name="L4177" href="#L4177">4177</a> <strong class="jxr_keyword">var</strong> prev = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[len2 + 1];
-<a class="jxr_linenumber" name="L4178" href="#L4178">4178</a> <strong class="jxr_keyword">var</strong> curr = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[len2 + 1];
-<a class="jxr_linenumber" name="L4179" href="#L4179">4179</a>
-<a class="jxr_linenumber" name="L4180" href="#L4180">4180</a> <em class="jxr_comment">// Initialize first row</em>
-<a class="jxr_linenumber" name="L4181" href="#L4181">4181</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 0; j <= len2; j++)
-<a class="jxr_linenumber" name="L4182" href="#L4182">4182</a> prev[j] = j;
-<a class="jxr_linenumber" name="L4183" href="#L4183">4183</a>
-<a class="jxr_linenumber" name="L4184" href="#L4184">4184</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i <= len1; i++) {
-<a class="jxr_linenumber" name="L4185" href="#L4185">4185</a> curr[0] = i;
-<a class="jxr_linenumber" name="L4186" href="#L4186">4186</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 1; j <= len2; j++) {
-<a class="jxr_linenumber" name="L4187" href="#L4187">4187</a> <strong class="jxr_keyword">if</strong> (str1.charAt(i - 1) == str2.charAt(j - 1)) {
-<a class="jxr_linenumber" name="L4188" href="#L4188">4188</a> curr[j] = prev[j - 1];
-<a class="jxr_linenumber" name="L4189" href="#L4189">4189</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4190" href="#L4190">4190</a> curr[j] = 1 + Math.min(Math.min(prev[j], curr[j - 1]), prev[j - 1]);
-<a class="jxr_linenumber" name="L4191" href="#L4191">4191</a> }
-<a class="jxr_linenumber" name="L4192" href="#L4192">4192</a> }
-<a class="jxr_linenumber" name="L4193" href="#L4193">4193</a> <em class="jxr_comment">// Swap arrays</em>
-<a class="jxr_linenumber" name="L4194" href="#L4194">4194</a> <strong class="jxr_keyword">var</strong> temp = prev;
-<a class="jxr_linenumber" name="L4195" href="#L4195">4195</a> prev = curr;
-<a class="jxr_linenumber" name="L4196" href="#L4196">4196</a> curr = temp;
-<a class="jxr_linenumber" name="L4197" href="#L4197">4197</a> }
-<a class="jxr_linenumber" name="L4198" href="#L4198">4198</a>
-<a class="jxr_linenumber" name="L4199" href="#L4199">4199</a> <strong class="jxr_keyword">return</strong> prev[len2];
-<a class="jxr_linenumber" name="L4200" href="#L4200">4200</a> }
-<a class="jxr_linenumber" name="L4201" href="#L4201">4201</a>
-<a class="jxr_linenumber" name="L4202" href="#L4202">4202</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4203" href="#L4203">4203</a> <em class="jxr_javadoccomment"> * Counts the number of lines in a string.</em>
-<a class="jxr_linenumber" name="L4204" href="#L4204">4204</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4205" href="#L4205">4205</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4206" href="#L4206">4206</a> <em class="jxr_javadoccomment"> * Counts newline characters. A string ending without a newline is counted as one line.</em>
-<a class="jxr_linenumber" name="L4207" href="#L4207">4207</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4208" href="#L4208">4208</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4209" href="#L4209">4209</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4210" href="#L4210">4210</a> <em class="jxr_javadoccomment"> * lineCount(<js>"line1\nline2\nline3"</js>); <jc>// 3</jc></em>
-<a class="jxr_linenumber" name="L4211" href="#L4211">4211</a> <em class="jxr_javadoccomment"> * lineCount(<js>"single line"</js>); <jc>// 1</jc></em>
-<a class="jxr_linenumber" name="L4212" href="#L4212">4212</a> <em class="jxr_javadoccomment"> * lineCount(<js>"line1\r\nline2"</js>); <jc>// 2</jc></em>
-<a class="jxr_linenumber" name="L4213" href="#L4213">4213</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4214" href="#L4214">4214</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4215" href="#L4215">4215</a> <em class="jxr_javadoccomment"> * @param str The string to count lines in. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4216" href="#L4216">4216</a> <em class="jxr_javadoccomment"> * @return The number of lines, or <c>0</c> if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L4217" href="#L4217">4217</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4218" href="#L4218">4218</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> lineCount(String str) {
-<a class="jxr_linenumber" name="L4219" href="#L4219">4219</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L4220" href="#L4220">4220</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L4221" href="#L4221">4221</a>
-<a class="jxr_linenumber" name="L4222" href="#L4222">4222</a> <strong class="jxr_keyword">var</strong> count = 1; <em class="jxr_comment">// At least one line</em>
-<a class="jxr_linenumber" name="L4223" href="#L4223">4223</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L4224" href="#L4224">4224</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
-<a class="jxr_linenumber" name="L4225" href="#L4225">4225</a> <strong class="jxr_keyword">if</strong> (c == '\n') {
-<a class="jxr_linenumber" name="L4226" href="#L4226">4226</a> count++;
-<a class="jxr_linenumber" name="L4227" href="#L4227">4227</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '\r') {
-<a class="jxr_linenumber" name="L4228" href="#L4228">4228</a> <em class="jxr_comment">// Handle \r\n as a single line break</em>
-<a class="jxr_linenumber" name="L4229" href="#L4229">4229</a> <strong class="jxr_keyword">if</strong> (i + 1 < str.length() && str.charAt(i + 1) == '\n') {
-<a class="jxr_linenumber" name="L4230" href="#L4230">4230</a> i++; <em class="jxr_comment">// Skip the \n</em>
-<a class="jxr_linenumber" name="L4231" href="#L4231">4231</a> }
+<a class="jxr_linenumber" name="L3870" href="#L3870">3870</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L3871" href="#L3871">3871</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L3872" href="#L3872">3872</a> <em class="jxr_javadoccomment"> * join(<jk>new int</jk>[]{1, 2, 3}, <js>","</js>); <jc>// "1,2,3"</jc></em>
+<a class="jxr_linenumber" name="L3873" href="#L3873">3873</a> <em class="jxr_javadoccomment"> * join(<jk>new int</jk>[]{}, <js>","</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L3874" href="#L3874">3874</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L3875" href="#L3875">3875</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3876" href="#L3876">3876</a> <em class="jxr_javadoccomment"> * @param array The array to join.</em>
+<a class="jxr_linenumber" name="L3877" href="#L3877">3877</a> <em class="jxr_javadoccomment"> * @param delimiter The delimiter string.</em>
+<a class="jxr_linenumber" name="L3878" href="#L3878">3878</a> <em class="jxr_javadoccomment"> * @return The joined string.</em>
+<a class="jxr_linenumber" name="L3879" href="#L3879">3879</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3880" href="#L3880">3880</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(<strong class="jxr_keyword">int</strong>[] array, String delimiter) {
+<a class="jxr_linenumber" name="L3881" href="#L3881">3881</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong> || array.length == 0)
+<a class="jxr_linenumber" name="L3882" href="#L3882">3882</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L3883" href="#L3883">3883</a> <strong class="jxr_keyword">if</strong> (delimiter == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3884" href="#L3884">3884</a> delimiter = <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L3885" href="#L3885">3885</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).mapToObj(String::valueOf).collect(Collectors.joining(delimiter));
+<a class="jxr_linenumber" name="L3886" href="#L3886">3886</a> }
+<a class="jxr_linenumber" name="L3887" href="#L3887">3887</a>
+<a class="jxr_linenumber" name="L3888" href="#L3888">3888</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3889" href="#L3889">3889</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
+<a class="jxr_linenumber" name="L3890" href="#L3890">3890</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3891" href="#L3891">3891</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3892" href="#L3892">3892</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3893" href="#L3893">3893</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3894" href="#L3894">3894</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3895" href="#L3895">3895</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(List<?> tokens, <strong class="jxr_keyword">char</strong> d) {
+<a class="jxr_linenumber" name="L3896" href="#L3896">3896</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3897" href="#L3897">3897</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L3898" href="#L3898">3898</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3899" href="#L3899">3899</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0, j = tokens.size(); i < j; i++) {
+<a class="jxr_linenumber" name="L3900" href="#L3900">3900</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L3901" href="#L3901">3901</a> sb.append(d);
+<a class="jxr_linenumber" name="L3902" href="#L3902">3902</a> sb.append(tokens.get(i));
+<a class="jxr_linenumber" name="L3903" href="#L3903">3903</a> }
+<a class="jxr_linenumber" name="L3904" href="#L3904">3904</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L3905" href="#L3905">3905</a> }
+<a class="jxr_linenumber" name="L3906" href="#L3906">3906</a>
+<a class="jxr_linenumber" name="L3907" href="#L3907">3907</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3908" href="#L3908">3908</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
+<a class="jxr_linenumber" name="L3909" href="#L3909">3909</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3910" href="#L3910">3910</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3911" href="#L3911">3911</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3912" href="#L3912">3912</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3913" href="#L3913">3913</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3914" href="#L3914">3914</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(List<?> tokens, String d) {
+<a class="jxr_linenumber" name="L3915" href="#L3915">3915</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3916" href="#L3916">3916</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L3917" href="#L3917">3917</a> <strong class="jxr_keyword">return</strong> StringUtils.join(tokens, d, <strong class="jxr_keyword">new</strong> StringBuilder()).toString();
+<a class="jxr_linenumber" name="L3918" href="#L3918">3918</a> }
+<a class="jxr_linenumber" name="L3919" href="#L3919">3919</a>
+<a class="jxr_linenumber" name="L3920" href="#L3920">3920</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3921" href="#L3921">3921</a> <em class="jxr_javadoccomment"> * Joins the specified tokens into a delimited string and writes the output to the specified string builder.</em>
+<a class="jxr_linenumber" name="L3922" href="#L3922">3922</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3923" href="#L3923">3923</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3924" href="#L3924">3924</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3925" href="#L3925">3925</a> <em class="jxr_javadoccomment"> * @param sb The string builder to append the response to.</em>
+<a class="jxr_linenumber" name="L3926" href="#L3926">3926</a> <em class="jxr_javadoccomment"> * @return The same string builder passed in as <c>sb</c>.</em>
+<a class="jxr_linenumber" name="L3927" href="#L3927">3927</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3928" href="#L3928">3928</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder join(List<?> tokens, String d, StringBuilder sb) {
+<a class="jxr_linenumber" name="L3929" href="#L3929">3929</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3930" href="#L3930">3930</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L3931" href="#L3931">3931</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0, j = tokens.size(); i < j; i++) {
+<a class="jxr_linenumber" name="L3932" href="#L3932">3932</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L3933" href="#L3933">3933</a> sb.append(d);
+<a class="jxr_linenumber" name="L3934" href="#L3934">3934</a> sb.append(tokens.get(i));
+<a class="jxr_linenumber" name="L3935" href="#L3935">3935</a> }
+<a class="jxr_linenumber" name="L3936" href="#L3936">3936</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L3937" href="#L3937">3937</a> }
+<a class="jxr_linenumber" name="L3938" href="#L3938">3938</a>
+<a class="jxr_linenumber" name="L3939" href="#L3939">3939</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3940" href="#L3940">3940</a> <em class="jxr_javadoccomment"> * Joins the specified tokens into a delimited string.</em>
+<a class="jxr_linenumber" name="L3941" href="#L3941">3941</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3942" href="#L3942">3942</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3943" href="#L3943">3943</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3944" href="#L3944">3944</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3945" href="#L3945">3945</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3946" href="#L3946">3946</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Object[] tokens, <strong class="jxr_keyword">char</strong> d) {
+<a class="jxr_linenumber" name="L3947" href="#L3947">3947</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3948" href="#L3948">3948</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L3949" href="#L3949">3949</a> <strong class="jxr_keyword">if</strong> (tokens.length == 1)
+<a class="jxr_linenumber" name="L3950" href="#L3950">3950</a> <strong class="jxr_keyword">return</strong> emptyIfNull(s(tokens[0]));
+<a class="jxr_linenumber" name="L3951" href="#L3951">3951</a> <strong class="jxr_keyword">return</strong> StringUtils.join(tokens, d, <strong class="jxr_keyword">new</strong> StringBuilder()).toString();
+<a class="jxr_linenumber" name="L3952" href="#L3952">3952</a> }
+<a class="jxr_linenumber" name="L3953" href="#L3953">3953</a>
+<a class="jxr_linenumber" name="L3954" href="#L3954">3954</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3955" href="#L3955">3955</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string and writes the output to the specified string builder.</em>
+<a class="jxr_linenumber" name="L3956" href="#L3956">3956</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3957" href="#L3957">3957</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3958" href="#L3958">3958</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L3959" href="#L3959">3959</a> <em class="jxr_javadoccomment"> * @param sb The string builder to append the response to.</em>
+<a class="jxr_linenumber" name="L3960" href="#L3960">3960</a> <em class="jxr_javadoccomment"> * @return The same string builder passed in as <c>sb</c>.</em>
+<a class="jxr_linenumber" name="L3961" href="#L3961">3961</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3962" href="#L3962">3962</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> StringBuilder join(Object[] tokens, <strong class="jxr_keyword">char</strong> d, StringBuilder sb) {
+<a class="jxr_linenumber" name="L3963" href="#L3963">3963</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3964" href="#L3964">3964</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L3965" href="#L3965">3965</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < tokens.length; i++) {
+<a class="jxr_linenumber" name="L3966" href="#L3966">3966</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L3967" href="#L3967">3967</a> sb.append(d);
+<a class="jxr_linenumber" name="L3968" href="#L3968">3968</a> sb.append(tokens[i]);
+<a class="jxr_linenumber" name="L3969" href="#L3969">3969</a> }
+<a class="jxr_linenumber" name="L3970" href="#L3970">3970</a> <strong class="jxr_keyword">return</strong> sb;
+<a class="jxr_linenumber" name="L3971" href="#L3971">3971</a> }
+<a class="jxr_linenumber" name="L3972" href="#L3972">3972</a>
+<a class="jxr_linenumber" name="L3973" href="#L3973">3973</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3974" href="#L3974">3974</a> <em class="jxr_javadoccomment"> * Join the specified tokens into a delimited string.</em>
+<a class="jxr_linenumber" name="L3975" href="#L3975">3975</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3976" href="#L3976">3976</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L3977" href="#L3977">3977</a> <em class="jxr_javadoccomment"> * @param separator The delimiter.</em>
+<a class="jxr_linenumber" name="L3978" href="#L3978">3978</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L3979" href="#L3979">3979</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3980" href="#L3980">3980</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(Object[] tokens, String separator) {
+<a class="jxr_linenumber" name="L3981" href="#L3981">3981</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L3982" href="#L3982">3982</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L3983" href="#L3983">3983</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L3984" href="#L3984">3984</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < tokens.length; i++) {
+<a class="jxr_linenumber" name="L3985" href="#L3985">3985</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L3986" href="#L3986">3986</a> sb.append(separator);
+<a class="jxr_linenumber" name="L3987" href="#L3987">3987</a> sb.append(tokens[i]);
+<a class="jxr_linenumber" name="L3988" href="#L3988">3988</a> }
+<a class="jxr_linenumber" name="L3989" href="#L3989">3989</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L3990" href="#L3990">3990</a> }
+<a class="jxr_linenumber" name="L3991" href="#L3991">3991</a>
+<a class="jxr_linenumber" name="L3992" href="#L3992">3992</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L3993" href="#L3993">3993</a> <em class="jxr_javadoccomment"> * Combines values into a simple comma-delimited string.</em>
+<a class="jxr_linenumber" name="L3994" href="#L3994">3994</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L3995" href="#L3995">3995</a> <em class="jxr_javadoccomment"> * @param values The values to join.</em>
+<a class="jxr_linenumber" name="L3996" href="#L3996">3996</a> <em class="jxr_javadoccomment"> * @return A comma-delimited string.</em>
+<a class="jxr_linenumber" name="L3997" href="#L3997">3997</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L3998" href="#L3998">3998</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String join(String...values) {
+<a class="jxr_linenumber" name="L3999" href="#L3999">3999</a> <strong class="jxr_keyword">return</strong> join(values, ',');
+<a class="jxr_linenumber" name="L4000" href="#L4000">4000</a> }
+<a class="jxr_linenumber" name="L4001" href="#L4001">4001</a>
+<a class="jxr_linenumber" name="L4002" href="#L4002">4002</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4003" href="#L4003">4003</a> <em class="jxr_javadoccomment"> * Same as {@link StringUtils#join(Collection, char)} but escapes the delimiter if found in the tokens.</em>
+<a class="jxr_linenumber" name="L4004" href="#L4004">4004</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4005" href="#L4005">4005</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to join.</em>
+<a class="jxr_linenumber" name="L4006" href="#L4006">4006</a> <em class="jxr_javadoccomment"> * @param d The delimiter.</em>
+<a class="jxr_linenumber" name="L4007" href="#L4007">4007</a> <em class="jxr_javadoccomment"> * @return The delimited string. If <c>tokens</c> is <jk>null</jk>, returns <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4008" href="#L4008">4008</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4009" href="#L4009">4009</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String joine(List<?> tokens, <strong class="jxr_keyword">char</strong> d) {
+<a class="jxr_linenumber" name="L4010" href="#L4010">4010</a> <strong class="jxr_keyword">if</strong> (tokens == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4011" href="#L4011">4011</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4012" href="#L4012">4012</a> <strong class="jxr_keyword">var</strong> as = getEscapeSet(d);
+<a class="jxr_linenumber" name="L4013" href="#L4013">4013</a> <strong class="jxr_keyword">var</strong> sb = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L4014" href="#L4014">4014</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">int</strong> i = 0, j = tokens.size(); i < j; i++) {
+<a class="jxr_linenumber" name="L4015" href="#L4015">4015</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L4016" href="#L4016">4016</a> sb.append(d);
+<a class="jxr_linenumber" name="L4017" href="#L4017">4017</a> sb.append(escapeChars(s(tokens.get(i)), as));
+<a class="jxr_linenumber" name="L4018" href="#L4018">4018</a> }
+<a class="jxr_linenumber" name="L4019" href="#L4019">4019</a> <strong class="jxr_keyword">return</strong> sb.toString();
+<a class="jxr_linenumber" name="L4020" href="#L4020">4020</a> }
+<a class="jxr_linenumber" name="L4021" href="#L4021">4021</a>
+<a class="jxr_linenumber" name="L4022" href="#L4022">4022</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4023" href="#L4023">4023</a> <em class="jxr_javadoccomment"> * Joins tokens with newlines.</em>
+<a class="jxr_linenumber" name="L4024" href="#L4024">4024</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4025" href="#L4025">4025</a> <em class="jxr_javadoccomment"> * @param tokens The tokens to concatenate.</em>
+<a class="jxr_linenumber" name="L4026" href="#L4026">4026</a> <em class="jxr_javadoccomment"> * @return A string with the specified tokens contatenated with newlines.</em>
+<a class="jxr_linenumber" name="L4027" href="#L4027">4027</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4028" href="#L4028">4028</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String joinnl(Object[] tokens) {
+<a class="jxr_linenumber" name="L4029" href="#L4029">4029</a> <strong class="jxr_keyword">return</strong> join(tokens, '\n');
+<a class="jxr_linenumber" name="L4030" href="#L4030">4030</a> }
+<a class="jxr_linenumber" name="L4031" href="#L4031">4031</a>
+<a class="jxr_linenumber" name="L4032" href="#L4032">4032</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4033" href="#L4033">4033</a> <em class="jxr_javadoccomment"> * Converts a string to kebab-case format.</em>
+<a class="jxr_linenumber" name="L4034" href="#L4034">4034</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4035" href="#L4035">4035</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4036" href="#L4036">4036</a> <em class="jxr_javadoccomment"> * Handles various input formats:</em>
+<a class="jxr_linenumber" name="L4037" href="#L4037">4037</a> <em class="jxr_javadoccomment"> * <ul></em>
+<a class="jxr_linenumber" name="L4038" href="#L4038">4038</a> <em class="jxr_javadoccomment"> * <li>Space-separated: "hello world" → "hello-world"</li></em>
+<a class="jxr_linenumber" name="L4039" href="#L4039">4039</a> <em class="jxr_javadoccomment"> * <li>CamelCase: "helloWorld" → "hello-world"</li></em>
+<a class="jxr_linenumber" name="L4040" href="#L4040">4040</a> <em class="jxr_javadoccomment"> * <li>PascalCase: "HelloWorld" → "hello-world"</li></em>
+<a class="jxr_linenumber" name="L4041" href="#L4041">4041</a> <em class="jxr_javadoccomment"> * <li>Snake_case: "hello_world" → "hello-world"</li></em>
+<a class="jxr_linenumber" name="L4042" href="#L4042">4042</a> <em class="jxr_javadoccomment"> * </ul></em>
+<a class="jxr_linenumber" name="L4043" href="#L4043">4043</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4044" href="#L4044">4044</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4045" href="#L4045">4045</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4046" href="#L4046">4046</a> <em class="jxr_javadoccomment"> * kebabCase(<jk>null</jk>); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L4047" href="#L4047">4047</a> <em class="jxr_javadoccomment"> * kebabCase(<js>""</js>); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L4048" href="#L4048">4048</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"hello world"</js>); <jc>// "hello-world"</jc></em>
+<a class="jxr_linenumber" name="L4049" href="#L4049">4049</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"helloWorld"</js>); <jc>// "hello-world"</jc></em>
+<a class="jxr_linenumber" name="L4050" href="#L4050">4050</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"HelloWorld"</js>); <jc>// "hello-world"</jc></em>
+<a class="jxr_linenumber" name="L4051" href="#L4051">4051</a> <em class="jxr_javadoccomment"> * kebabCase(<js>"hello_world"</js>); <jc>// "hello-world"</jc></em>
+<a class="jxr_linenumber" name="L4052" href="#L4052">4052</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4053" href="#L4053">4053</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4054" href="#L4054">4054</a> <em class="jxr_javadoccomment"> * @param str The string to convert.</em>
+<a class="jxr_linenumber" name="L4055" href="#L4055">4055</a> <em class="jxr_javadoccomment"> * @return The kebab-case string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4056" href="#L4056">4056</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4057" href="#L4057">4057</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String kebabCase(String str) {
+<a class="jxr_linenumber" name="L4058" href="#L4058">4058</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L4059" href="#L4059">4059</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L4060" href="#L4060">4060</a>
+<a class="jxr_linenumber" name="L4061" href="#L4061">4061</a> <strong class="jxr_keyword">var</strong> words = splitWords(str);
+<a class="jxr_linenumber" name="L4062" href="#L4062">4062</a> <strong class="jxr_keyword">if</strong> (words.isEmpty())
+<a class="jxr_linenumber" name="L4063" href="#L4063">4063</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4064" href="#L4064">4064</a>
+<a class="jxr_linenumber" name="L4065" href="#L4065">4065</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L4066" href="#L4066">4066</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < words.size(); i++) {
+<a class="jxr_linenumber" name="L4067" href="#L4067">4067</a> <strong class="jxr_keyword">if</strong> (i > 0)
+<a class="jxr_linenumber" name="L4068" href="#L4068">4068</a> result.append('-');
+<a class="jxr_linenumber" name="L4069" href="#L4069">4069</a> result.append(words.get(i).toLowerCase());
+<a class="jxr_linenumber" name="L4070" href="#L4070">4070</a> }
+<a class="jxr_linenumber" name="L4071" href="#L4071">4071</a>
+<a class="jxr_linenumber" name="L4072" href="#L4072">4072</a> <strong class="jxr_keyword">return</strong> result.toString();
+<a class="jxr_linenumber" name="L4073" href="#L4073">4073</a> }
+<a class="jxr_linenumber" name="L4074" href="#L4074">4074</a>
+<a class="jxr_linenumber" name="L4075" href="#L4075">4075</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4076" href="#L4076">4076</a> <em class="jxr_javadoccomment"> * Finds the index of the last occurrence of a substring within a string.</em>
+<a class="jxr_linenumber" name="L4077" href="#L4077">4077</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4078" href="#L4078">4078</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4079" href="#L4079">4079</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4080" href="#L4080">4080</a> <em class="jxr_javadoccomment"> * lastIndexOf(<js>"hello world world"</js>, <js>"world"</js>); <jc>// 12</jc></em>
+<a class="jxr_linenumber" name="L4081" href="#L4081">4081</a> <em class="jxr_javadoccomment"> * lastIndexOf(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// -1</jc></em>
+<a class="jxr_linenumber" name="L4082" href="#L4082">4082</a> <em class="jxr_javadoccomment"> * lastIndexOf(<jk>null</jk>, <js>"test"</js>); <jc>// -1</jc></em>
+<a class="jxr_linenumber" name="L4083" href="#L4083">4083</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4084" href="#L4084">4084</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4085" href="#L4085">4085</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
+<a class="jxr_linenumber" name="L4086" href="#L4086">4086</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
+<a class="jxr_linenumber" name="L4087" href="#L4087">4087</a> <em class="jxr_javadoccomment"> * @return The index of the last occurrence, or <c>-1</c> if not found or if either parameter is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4088" href="#L4088">4088</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4089" href="#L4089">4089</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> lastIndexOf(String str, String search) {
+<a class="jxr_linenumber" name="L4090" href="#L4090">4090</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4091" href="#L4091">4091</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L4092" href="#L4092">4092</a> <strong class="jxr_keyword">return</strong> str.lastIndexOf(search);
+<a class="jxr_linenumber" name="L4093" href="#L4093">4093</a> }
+<a class="jxr_linenumber" name="L4094" href="#L4094">4094</a>
+<a class="jxr_linenumber" name="L4095" href="#L4095">4095</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4096" href="#L4096">4096</a> <em class="jxr_javadoccomment"> * Finds the index of the last occurrence of a substring within a string, ignoring case.</em>
+<a class="jxr_linenumber" name="L4097" href="#L4097">4097</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4098" href="#L4098">4098</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4099" href="#L4099">4099</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4100" href="#L4100">4100</a> <em class="jxr_javadoccomment"> * lastIndexOfIgnoreCase(<js>"Hello World World"</js>, <js>"world"</js>); <jc>// 12</jc></em>
+<a class="jxr_linenumber" name="L4101" href="#L4101">4101</a> <em class="jxr_javadoccomment"> * lastIndexOfIgnoreCase(<js>"Hello World"</js>, <js>"WORLD"</js>); <jc>// 6</jc></em>
+<a class="jxr_linenumber" name="L4102" href="#L4102">4102</a> <em class="jxr_javadoccomment"> * lastIndexOfIgnoreCase(<js>"hello world"</js>, <js>"xyz"</js>); <jc>// -1</jc></em>
+<a class="jxr_linenumber" name="L4103" href="#L4103">4103</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4104" href="#L4104">4104</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4105" href="#L4105">4105</a> <em class="jxr_javadoccomment"> * @param str The string to search in.</em>
+<a class="jxr_linenumber" name="L4106" href="#L4106">4106</a> <em class="jxr_javadoccomment"> * @param search The substring to search for.</em>
+<a class="jxr_linenumber" name="L4107" href="#L4107">4107</a> <em class="jxr_javadoccomment"> * @return The index of the last occurrence, or <c>-1</c> if not found or if either parameter is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4108" href="#L4108">4108</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4109" href="#L4109">4109</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> lastIndexOfIgnoreCase(String str, String search) {
+<a class="jxr_linenumber" name="L4110" href="#L4110">4110</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || search == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4111" href="#L4111">4111</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L4112" href="#L4112">4112</a> <strong class="jxr_keyword">return</strong> str.toLowerCase().lastIndexOf(search.toLowerCase());
+<a class="jxr_linenumber" name="L4113" href="#L4113">4113</a> }
+<a class="jxr_linenumber" name="L4114" href="#L4114">4114</a>
+<a class="jxr_linenumber" name="L4115" href="#L4115">4115</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4116" href="#L4116">4116</a> <em class="jxr_javadoccomment"> * Returns the last non-whitespace character in the string.</em>
+<a class="jxr_linenumber" name="L4117" href="#L4117">4117</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4118" href="#L4118">4118</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L4119" href="#L4119">4119</a> <em class="jxr_javadoccomment"> * @return</em>
+<a class="jxr_linenumber" name="L4120" href="#L4120">4120</a> <em class="jxr_javadoccomment"> * The last non-whitespace character, or <c>0</c> if the string is <jk>null</jk>, empty, or composed</em>
+<a class="jxr_linenumber" name="L4121" href="#L4121">4121</a> <em class="jxr_javadoccomment"> * of only whitespace.</em>
+<a class="jxr_linenumber" name="L4122" href="#L4122">4122</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4123" href="#L4123">4123</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> lastNonWhitespaceChar(String s) {
+<a class="jxr_linenumber" name="L4124" href="#L4124">4124</a> <strong class="jxr_keyword">if</strong> (nn(s))
+<a class="jxr_linenumber" name="L4125" href="#L4125">4125</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = s.length() - 1; i >= 0; i--)
+<a class="jxr_linenumber" name="L4126" href="#L4126">4126</a> <strong class="jxr_keyword">if</strong> (! isWhitespace(s.charAt(i)))
+<a class="jxr_linenumber" name="L4127" href="#L4127">4127</a> <strong class="jxr_keyword">return</strong> s.charAt(i);
+<a class="jxr_linenumber" name="L4128" href="#L4128">4128</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L4129" href="#L4129">4129</a> }
+<a class="jxr_linenumber" name="L4130" href="#L4130">4130</a>
+<a class="jxr_linenumber" name="L4131" href="#L4131">4131</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4132" href="#L4132">4132</a> <em class="jxr_javadoccomment"> * Returns the leftmost characters of a string.</em>
+<a class="jxr_linenumber" name="L4133" href="#L4133">4133</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4134" href="#L4134">4134</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4135" href="#L4135">4135</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4136" href="#L4136">4136</a> <em class="jxr_javadoccomment"> * left(<jk>null</jk>, 3); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L4137" href="#L4137">4137</a> <em class="jxr_javadoccomment"> * left(<js>""</js>, 3); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L4138" href="#L4138">4138</a> <em class="jxr_javadoccomment"> * left(<js>"hello"</js>, 3); <jc>// "hel"</jc></em>
+<a class="jxr_linenumber" name="L4139" href="#L4139">4139</a> <em class="jxr_javadoccomment"> * left(<js>"hello"</js>, 10); <jc>// "hello"</jc></em>
+<a class="jxr_linenumber" name="L4140" href="#L4140">4140</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4141" href="#L4141">4141</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4142" href="#L4142">4142</a> <em class="jxr_javadoccomment"> * @param str The string to get characters from.</em>
+<a class="jxr_linenumber" name="L4143" href="#L4143">4143</a> <em class="jxr_javadoccomment"> * @param len The number of characters to get.</em>
+<a class="jxr_linenumber" name="L4144" href="#L4144">4144</a> <em class="jxr_javadoccomment"> * @return The leftmost characters, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4145" href="#L4145">4145</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4146" href="#L4146">4146</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String left(String str, <strong class="jxr_keyword">int</strong> len) {
+<a class="jxr_linenumber" name="L4147" href="#L4147">4147</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4148" href="#L4148">4148</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4149" href="#L4149">4149</a> <strong class="jxr_keyword">if</strong> (len < 0)
+<a class="jxr_linenumber" name="L4150" href="#L4150">4150</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4151" href="#L4151">4151</a> <strong class="jxr_keyword">if</strong> (len >= str.length())
+<a class="jxr_linenumber" name="L4152" href="#L4152">4152</a> <strong class="jxr_keyword">return</strong> str;
+<a class="jxr_linenumber" name="L4153" href="#L4153">4153</a> <strong class="jxr_keyword">return</strong> str.substring(0, len);
+<a class="jxr_linenumber" name="L4154" href="#L4154">4154</a> }
+<a class="jxr_linenumber" name="L4155" href="#L4155">4155</a>
+<a class="jxr_linenumber" name="L4156" href="#L4156">4156</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4157" href="#L4157">4157</a> <em class="jxr_javadoccomment"> * Calculates the Levenshtein distance (edit distance) between two strings.</em>
+<a class="jxr_linenumber" name="L4158" href="#L4158">4158</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4159" href="#L4159">4159</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4160" href="#L4160">4160</a> <em class="jxr_javadoccomment"> * The Levenshtein distance is the minimum number of single-character edits (insertions, deletions, or substitutions) required to change one string into another.</em>
+<a class="jxr_linenumber" name="L4161" href="#L4161">4161</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4162" href="#L4162">4162</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4163" href="#L4163">4163</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4164" href="#L4164">4164</a> <em class="jxr_javadoccomment"> * levenshteinDistance(<js>"kitten"</js>, <js>"sitting"</js>); <jc>// 3</jc></em>
+<a class="jxr_linenumber" name="L4165" href="#L4165">4165</a> <em class="jxr_javadoccomment"> * levenshteinDistance(<js>"hello"</js>, <js>"hello"</js>); <jc>// 0</jc></em>
+<a class="jxr_linenumber" name="L4166" href="#L4166">4166</a> <em class="jxr_javadoccomment"> * levenshteinDistance(<js>"abc"</js>, <js>""</js>); <jc>// 3</jc></em>
+<a class="jxr_linenumber" name="L4167" href="#L4167">4167</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4168" href="#L4168">4168</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4169" href="#L4169">4169</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
+<a class="jxr_linenumber" name="L4170" href="#L4170">4170</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
+<a class="jxr_linenumber" name="L4171" href="#L4171">4171</a> <em class="jxr_javadoccomment"> * @return The Levenshtein distance between the two strings.</em>
+<a class="jxr_linenumber" name="L4172" href="#L4172">4172</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4173" href="#L4173">4173</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> levenshteinDistance(String str1, String str2) {
+<a class="jxr_linenumber" name="L4174" href="#L4174">4174</a> <strong class="jxr_keyword">if</strong> (str1 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4175" href="#L4175">4175</a> str1 = <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4176" href="#L4176">4176</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4177" href="#L4177">4177</a> str2 = <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4178" href="#L4178">4178</a>
+<a class="jxr_linenumber" name="L4179" href="#L4179">4179</a> <strong class="jxr_keyword">var</strong> len1 = str1.length();
+<a class="jxr_linenumber" name="L4180" href="#L4180">4180</a> <strong class="jxr_keyword">var</strong> len2 = str2.length();
+<a class="jxr_linenumber" name="L4181" href="#L4181">4181</a>
+<a class="jxr_linenumber" name="L4182" href="#L4182">4182</a> <em class="jxr_comment">// Use dynamic programming with optimized space (only need previous row)</em>
+<a class="jxr_linenumber" name="L4183" href="#L4183">4183</a> <strong class="jxr_keyword">var</strong> prev = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[len2 + 1];
+<a class="jxr_linenumber" name="L4184" href="#L4184">4184</a> <strong class="jxr_keyword">var</strong> curr = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[len2 + 1];
+<a class="jxr_linenumber" name="L4185" href="#L4185">4185</a>
+<a class="jxr_linenumber" name="L4186" href="#L4186">4186</a> <em class="jxr_comment">// Initialize first row</em>
+<a class="jxr_linenumber" name="L4187" href="#L4187">4187</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 0; j <= len2; j++)
+<a class="jxr_linenumber" name="L4188" href="#L4188">4188</a> prev[j] = j;
+<a class="jxr_linenumber" name="L4189" href="#L4189">4189</a>
+<a class="jxr_linenumber" name="L4190" href="#L4190">4190</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 1; i <= len1; i++) {
+<a class="jxr_linenumber" name="L4191" href="#L4191">4191</a> curr[0] = i;
+<a class="jxr_linenumber" name="L4192" href="#L4192">4192</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 1; j <= len2; j++) {
+<a class="jxr_linenumber" name="L4193" href="#L4193">4193</a> <strong class="jxr_keyword">if</strong> (str1.charAt(i - 1) == str2.charAt(j - 1)) {
+<a class="jxr_linenumber" name="L4194" href="#L4194">4194</a> curr[j] = prev[j - 1];
+<a class="jxr_linenumber" name="L4195" href="#L4195">4195</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4196" href="#L4196">4196</a> curr[j] = 1 + Math.min(Math.min(prev[j], curr[j - 1]), prev[j - 1]);
+<a class="jxr_linenumber" name="L4197" href="#L4197">4197</a> }
+<a class="jxr_linenumber" name="L4198" href="#L4198">4198</a> }
+<a class="jxr_linenumber" name="L4199" href="#L4199">4199</a> <em class="jxr_comment">// Swap arrays</em>
+<a class="jxr_linenumber" name="L4200" href="#L4200">4200</a> <strong class="jxr_keyword">var</strong> temp = prev;
+<a class="jxr_linenumber" name="L4201" href="#L4201">4201</a> prev = curr;
+<a class="jxr_linenumber" name="L4202" href="#L4202">4202</a> curr = temp;
+<a class="jxr_linenumber" name="L4203" href="#L4203">4203</a> }
+<a class="jxr_linenumber" name="L4204" href="#L4204">4204</a>
+<a class="jxr_linenumber" name="L4205" href="#L4205">4205</a> <strong class="jxr_keyword">return</strong> prev[len2];
+<a class="jxr_linenumber" name="L4206" href="#L4206">4206</a> }
+<a class="jxr_linenumber" name="L4207" href="#L4207">4207</a>
+<a class="jxr_linenumber" name="L4208" href="#L4208">4208</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4209" href="#L4209">4209</a> <em class="jxr_javadoccomment"> * Counts the number of lines in a string.</em>
+<a class="jxr_linenumber" name="L4210" href="#L4210">4210</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4211" href="#L4211">4211</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4212" href="#L4212">4212</a> <em class="jxr_javadoccomment"> * Counts newline characters. A string ending without a newline is counted as one line.</em>
+<a class="jxr_linenumber" name="L4213" href="#L4213">4213</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4214" href="#L4214">4214</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4215" href="#L4215">4215</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4216" href="#L4216">4216</a> <em class="jxr_javadoccomment"> * lineCount(<js>"line1\nline2\nline3"</js>); <jc>// 3</jc></em>
+<a class="jxr_linenumber" name="L4217" href="#L4217">4217</a> <em class="jxr_javadoccomment"> * lineCount(<js>"single line"</js>); <jc>// 1</jc></em>
+<a class="jxr_linenumber" name="L4218" href="#L4218">4218</a> <em class="jxr_javadoccomment"> * lineCount(<js>"line1\r\nline2"</js>); <jc>// 2</jc></em>
+<a class="jxr_linenumber" name="L4219" href="#L4219">4219</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4220" href="#L4220">4220</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4221" href="#L4221">4221</a> <em class="jxr_javadoccomment"> * @param str The string to count lines in. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4222" href="#L4222">4222</a> <em class="jxr_javadoccomment"> * @return The number of lines, or <c>0</c> if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L4223" href="#L4223">4223</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4224" href="#L4224">4224</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> lineCount(String str) {
+<a class="jxr_linenumber" name="L4225" href="#L4225">4225</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L4226" href="#L4226">4226</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L4227" href="#L4227">4227</a>
+<a class="jxr_linenumber" name="L4228" href="#L4228">4228</a> <strong class="jxr_keyword">var</strong> count = 1; <em class="jxr_comment">// At least one line</em>
+<a class="jxr_linenumber" name="L4229" href="#L4229">4229</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L4230" href="#L4230">4230</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
+<a class="jxr_linenumber" name="L4231" href="#L4231">4231</a> <strong class="jxr_keyword">if</strong> (c == '\n') {
<a class="jxr_linenumber" name="L4232" href="#L4232">4232</a> count++;
-<a class="jxr_linenumber" name="L4233" href="#L4233">4233</a> }
-<a class="jxr_linenumber" name="L4234" href="#L4234">4234</a> }
-<a class="jxr_linenumber" name="L4235" href="#L4235">4235</a>
-<a class="jxr_linenumber" name="L4236" href="#L4236">4236</a> <strong class="jxr_keyword">return</strong> count;
-<a class="jxr_linenumber" name="L4237" href="#L4237">4237</a> }
-<a class="jxr_linenumber" name="L4238" href="#L4238">4238</a>
-<a class="jxr_linenumber" name="L4239" href="#L4239">4239</a> <em class="jxr_comment">// TODO: See if we can remove StringUtils.parseIsoCalendar.</em>
-<a class="jxr_linenumber" name="L4240" href="#L4240">4240</a> <em class="jxr_comment">// Currently used by:</em>
-<a class="jxr_linenumber" name="L4241" href="#L4241">4241</a> <em class="jxr_comment">// - OpenApiParserSession.java for DATE/DATE_TIME format parsing</em>
-<a class="jxr_linenumber" name="L4242" href="#L4242">4242</a> <em class="jxr_comment">// - StringUtils.parseIsoDate() (which wraps this method)</em>
-<a class="jxr_linenumber" name="L4243" href="#L4243">4243</a> <em class="jxr_comment">// Investigation needed: Can we replace this with java.time APIs or other standard date parsing?</em>
+<a class="jxr_linenumber" name="L4233" href="#L4233">4233</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (c == '\r') {
+<a class="jxr_linenumber" name="L4234" href="#L4234">4234</a> <em class="jxr_comment">// Handle \r\n as a single line break</em>
+<a class="jxr_linenumber" name="L4235" href="#L4235">4235</a> <strong class="jxr_keyword">if</strong> (i + 1 < str.length() && str.charAt(i + 1) == '\n') {
+<a class="jxr_linenumber" name="L4236" href="#L4236">4236</a> i++; <em class="jxr_comment">// Skip the \n</em>
+<a class="jxr_linenumber" name="L4237" href="#L4237">4237</a> }
+<a class="jxr_linenumber" name="L4238" href="#L4238">4238</a> count++;
+<a class="jxr_linenumber" name="L4239" href="#L4239">4239</a> }
+<a class="jxr_linenumber" name="L4240" href="#L4240">4240</a> }
+<a class="jxr_linenumber" name="L4241" href="#L4241">4241</a>
+<a class="jxr_linenumber" name="L4242" href="#L4242">4242</a> <strong class="jxr_keyword">return</strong> count;
+<a class="jxr_linenumber" name="L4243" href="#L4243">4243</a> }
<a class="jxr_linenumber" name="L4244" href="#L4244">4244</a>
-<a class="jxr_linenumber" name="L4245" href="#L4245">4245</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4246" href="#L4246">4246</a> <em class="jxr_javadoccomment"> * Null-safe convenience method for {@link String#toLowerCase()}.</em>
-<a class="jxr_linenumber" name="L4247" href="#L4247">4247</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4248" href="#L4248">4248</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4249" href="#L4249">4249</a> <em class="jxr_javadoccomment"> * Converts the string to lowercase if not null.</em>
-<a class="jxr_linenumber" name="L4250" href="#L4250">4250</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4251" href="#L4251">4251</a> <em class="jxr_javadoccomment"> * @param s The string to convert.</em>
-<a class="jxr_linenumber" name="L4252" href="#L4252">4252</a> <em class="jxr_javadoccomment"> * @return The lowercase string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4253" href="#L4253">4253</a> <em class="jxr_javadoccomment"> * @see #upperCase(String)</em>
-<a class="jxr_linenumber" name="L4254" href="#L4254">4254</a> <em class="jxr_javadoccomment"> * @see Utils#lc(String)</em>
-<a class="jxr_linenumber" name="L4255" href="#L4255">4255</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4256" href="#L4256">4256</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String lowerCase(String s) {
-<a class="jxr_linenumber" name="L4257" href="#L4257">4257</a> <strong class="jxr_keyword">return</strong> s == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : s.toLowerCase();
-<a class="jxr_linenumber" name="L4258" href="#L4258">4258</a> }
-<a class="jxr_linenumber" name="L4259" href="#L4259">4259</a>
-<a class="jxr_linenumber" name="L4260" href="#L4260">4260</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4261" href="#L4261">4261</a> <em class="jxr_javadoccomment"> * Maps each element of a string array using the specified function.</em>
-<a class="jxr_linenumber" name="L4262" href="#L4262">4262</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4263" href="#L4263">4263</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4264" href="#L4264">4264</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4265" href="#L4265">4265</a> <em class="jxr_javadoccomment"> * Returns an array with <jk>null</jk> elements if the function is <jk>null</jk> or returns <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4266" href="#L4266">4266</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4267" href="#L4267">4267</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L4268" href="#L4268">4268</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4269" href="#L4269">4269</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>"bar"</js>, <js>"baz"</js>};</em>
-<a class="jxr_linenumber" name="L4270" href="#L4270">4270</a> <em class="jxr_javadoccomment"> * String[] <jv>uppercased</jv> = map(<jv>array</jv>, String::toUpperCase);</em>
-<a class="jxr_linenumber" name="L4271" href="#L4271">4271</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["FOO", "BAR", "BAZ"]</jc></em>
+<a class="jxr_linenumber" name="L4245" href="#L4245">4245</a> <em class="jxr_comment">// TODO: See if we can remove StringUtils.parseIsoCalendar.</em>
+<a class="jxr_linenumber" name="L4246" href="#L4246">4246</a> <em class="jxr_comment">// Currently used by:</em>
+<a class="jxr_linenumber" name="L4247" href="#L4247">4247</a> <em class="jxr_comment">// - OpenApiParserSession.java for DATE/DATE_TIME format parsing</em>
+<a class="jxr_linenumber" name="L4248" href="#L4248">4248</a> <em class="jxr_comment">// - StringUtils.parseIsoDate() (which wraps this method)</em>
+<a class="jxr_linenumber" name="L4249" href="#L4249">4249</a> <em class="jxr_comment">// Investigation needed: Can we replace this with java.time APIs or other standard date parsing?</em>
+<a class="jxr_linenumber" name="L4250" href="#L4250">4250</a>
+<a class="jxr_linenumber" name="L4251" href="#L4251">4251</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4252" href="#L4252">4252</a> <em class="jxr_javadoccomment"> * Null-safe convenience method for {@link String#toLowerCase()}.</em>
+<a class="jxr_linenumber" name="L4253" href="#L4253">4253</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4254" href="#L4254">4254</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4255" href="#L4255">4255</a> <em class="jxr_javadoccomment"> * Converts the string to lowercase if not null.</em>
+<a class="jxr_linenumber" name="L4256" href="#L4256">4256</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4257" href="#L4257">4257</a> <em class="jxr_javadoccomment"> * @param s The string to convert.</em>
+<a class="jxr_linenumber" name="L4258" href="#L4258">4258</a> <em class="jxr_javadoccomment"> * @return The lowercase string, or <jk>null</jk> if the input was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4259" href="#L4259">4259</a> <em class="jxr_javadoccomment"> * @see #upperCase(String)</em>
+<a class="jxr_linenumber" name="L4260" href="#L4260">4260</a> <em class="jxr_javadoccomment"> * @see Utils#lc(String)</em>
+<a class="jxr_linenumber" name="L4261" href="#L4261">4261</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4262" href="#L4262">4262</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String lowerCase(String s) {
+<a class="jxr_linenumber" name="L4263" href="#L4263">4263</a> <strong class="jxr_keyword">return</strong> s == <strong class="jxr_keyword">null</strong> ? <strong class="jxr_keyword">null</strong> : s.toLowerCase();
+<a class="jxr_linenumber" name="L4264" href="#L4264">4264</a> }
+<a class="jxr_linenumber" name="L4265" href="#L4265">4265</a>
+<a class="jxr_linenumber" name="L4266" href="#L4266">4266</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4267" href="#L4267">4267</a> <em class="jxr_javadoccomment"> * Maps each element of a string array using the specified function.</em>
+<a class="jxr_linenumber" name="L4268" href="#L4268">4268</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4269" href="#L4269">4269</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4270" href="#L4270">4270</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the array is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4271" href="#L4271">4271</a> <em class="jxr_javadoccomment"> * Returns an array with <jk>null</jk> elements if the function is <jk>null</jk> or returns <jk>null</jk>.</em>
<a class="jxr_linenumber" name="L4272" href="#L4272">4272</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4273" href="#L4273">4273</a> <em class="jxr_javadoccomment"> * String[] <jv>prefixed</jv> = map(<jv>array</jv>, s -&gt; <js>"prefix-"</js> + s);</em>
-<a class="jxr_linenumber" name="L4274" href="#L4274">4274</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["prefix-foo", "prefix-bar", "prefix-baz"]</jc></em>
-<a class="jxr_linenumber" name="L4275" href="#L4275">4275</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4276" href="#L4276">4276</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4277" href="#L4277">4277</a> <em class="jxr_javadoccomment"> * @param array The array to map. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4278" href="#L4278">4278</a> <em class="jxr_javadoccomment"> * @param mapper The function to apply to each element. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4279" href="#L4279">4279</a> <em class="jxr_javadoccomment"> * @return A new array with the mapped elements, or <jk>null</jk> if the array was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4280" href="#L4280">4280</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4281" href="#L4281">4281</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] mapped(String[] array, Function<String,String> mapper) {
-<a class="jxr_linenumber" name="L4282" href="#L4282">4282</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4283" href="#L4283">4283</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
-<a class="jxr_linenumber" name="L4284" href="#L4284">4284</a> <strong class="jxr_keyword">if</strong> (mapper == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4285" href="#L4285">4285</a> <strong class="jxr_keyword">return</strong> Arrays.copyOf(array, array.length);
-<a class="jxr_linenumber" name="L4286" href="#L4286">4286</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).map(mapper).toArray(String[]::<strong class="jxr_keyword">new</strong>);
-<a class="jxr_linenumber" name="L4287" href="#L4287">4287</a> }
-<a class="jxr_linenumber" name="L4288" href="#L4288">4288</a>
-<a class="jxr_linenumber" name="L4289" href="#L4289">4289</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4290" href="#L4290">4290</a> <em class="jxr_javadoccomment"> * Checks if a string matches a regular expression pattern.</em>
-<a class="jxr_linenumber" name="L4291" href="#L4291">4291</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4292" href="#L4292">4292</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4293" href="#L4293">4293</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4294" href="#L4294">4294</a> <em class="jxr_javadoccomment"> * matches(<js>"12345"</js>, <js>"\\d+"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4295" href="#L4295">4295</a> <em class="jxr_javadoccomment"> * matches(<js>"abc123"</js>, <js>"^[a-z]+\\d+$"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4296" href="#L4296">4296</a> <em class="jxr_javadoccomment"> * matches(<js>"abc"</js>, <js>"\\d+"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L4297" href="#L4297">4297</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4298" href="#L4298">4298</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4299" href="#L4299">4299</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
-<a class="jxr_linenumber" name="L4300" href="#L4300">4300</a> <em class="jxr_javadoccomment"> * @param regex The regular expression pattern.</em>
-<a class="jxr_linenumber" name="L4301" href="#L4301">4301</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string matches the pattern, <jk>false</jk> otherwise.</em>
-<a class="jxr_linenumber" name="L4302" href="#L4302">4302</a> <em class="jxr_javadoccomment"> * @throws PatternSyntaxException If the regex pattern is invalid.</em>
-<a class="jxr_linenumber" name="L4303" href="#L4303">4303</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4304" href="#L4304">4304</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> matches(String str, String regex) {
-<a class="jxr_linenumber" name="L4305" href="#L4305">4305</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || regex == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4306" href="#L4306">4306</a> <strong class="jxr_keyword">return</strong> false;
-<a class="jxr_linenumber" name="L4307" href="#L4307">4307</a> <strong class="jxr_keyword">return</strong> str.matches(regex);
-<a class="jxr_linenumber" name="L4308" href="#L4308">4308</a> }
-<a class="jxr_linenumber" name="L4309" href="#L4309">4309</a>
-<a class="jxr_linenumber" name="L4310" href="#L4310">4310</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4311" href="#L4311">4311</a> <em class="jxr_javadoccomment"> * Generates a Metaphone code for a string.</em>
-<a class="jxr_linenumber" name="L4312" href="#L4312">4312</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4313" href="#L4313">4313</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4314" href="#L4314">4314</a> <em class="jxr_javadoccomment"> * Metaphone is a phonetic algorithm that produces codes representing how words sound.</em>
-<a class="jxr_linenumber" name="L4315" href="#L4315">4315</a> <em class="jxr_javadoccomment"> * It's more accurate than Soundex for English words.</em>
-<a class="jxr_linenumber" name="L4316" href="#L4316">4316</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4317" href="#L4317">4317</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4318" href="#L4318">4318</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4319" href="#L4319">4319</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Smith"</js>); <jc>// "SM0"</jc></em>
-<a class="jxr_linenumber" name="L4320" href="#L4320">4320</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Smythe"</js>); <jc>// "SM0"</jc></em>
-<a class="jxr_linenumber" name="L4321" href="#L4321">4321</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Robert"</js>); <jc>// "RBRT"</jc></em>
-<a class="jxr_linenumber" name="L4322" href="#L4322">4322</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4323" href="#L4323">4323</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4324" href="#L4324">4324</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Metaphone code for. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4325" href="#L4325">4325</a> <em class="jxr_javadoccomment"> * @return The Metaphone code, or <jk>null</jk> if input is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L4326" href="#L4326">4326</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4327" href="#L4327">4327</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String metaphone(String str) {
-<a class="jxr_linenumber" name="L4328" href="#L4328">4328</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L4329" href="#L4329">4329</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4330" href="#L4330">4330</a>
-<a class="jxr_linenumber" name="L4331" href="#L4331">4331</a> <strong class="jxr_keyword">var</strong> upper = str.toUpperCase().replaceAll(<span class="jxr_string">"[^A-Z]"</span>, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L4332" href="#L4332">4332</a> <strong class="jxr_keyword">if</strong> (upper.isEmpty())
-<a class="jxr_linenumber" name="L4333" href="#L4333">4333</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4334" href="#L4334">4334</a>
-<a class="jxr_linenumber" name="L4335" href="#L4335">4335</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
-<a class="jxr_linenumber" name="L4336" href="#L4336">4336</a> <strong class="jxr_keyword">var</strong> i = 0;
-<a class="jxr_linenumber" name="L4337" href="#L4337">4337</a> <strong class="jxr_keyword">var</strong> len = upper.length();
-<a class="jxr_linenumber" name="L4338" href="#L4338">4338</a>
-<a class="jxr_linenumber" name="L4339" href="#L4339">4339</a> <em class="jxr_comment">// Handle initial characters</em>
-<a class="jxr_linenumber" name="L4340" href="#L4340">4340</a> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"KN"</span>) || upper.startsWith(<span class="jxr_string">"GN"</span>) || upper.startsWith(<span class="jxr_string">"PN"</span>) || upper.startsWith(<span class="jxr_string">"AE"</span>) || upper.startsWith(<span class="jxr_string">"WR"</span>)) {
-<a class="jxr_linenumber" name="L4341" href="#L4341">4341</a> i = 1;
-<a class="jxr_linenumber" name="L4342" href="#L4342">4342</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"X"</span>)) {
-<a class="jxr_linenumber" name="L4343" href="#L4343">4343</a> result.append('S');
-<a class="jxr_linenumber" name="L4344" href="#L4344">4344</a> i = 1;
-<a class="jxr_linenumber" name="L4345" href="#L4345">4345</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"WH"</span>)) {
-<a class="jxr_linenumber" name="L4346" href="#L4346">4346</a> result.append('W');
-<a class="jxr_linenumber" name="L4347" href="#L4347">4347</a> i = 2;
-<a class="jxr_linenumber" name="L4348" href="#L4348">4348</a> }
-<a class="jxr_linenumber" name="L4349" href="#L4349">4349</a>
-<a class="jxr_linenumber" name="L4350" href="#L4350">4350</a> <em class="jxr_comment">// Process remaining characters</em>
-<a class="jxr_linenumber" name="L4351" href="#L4351">4351</a> <strong class="jxr_keyword">while</strong> (i < len && result.length() < 4) {
-<a class="jxr_linenumber" name="L4352" href="#L4352">4352</a> <strong class="jxr_keyword">var</strong> c = upper.charAt(i);
-<a class="jxr_linenumber" name="L4353" href="#L4353">4353</a> <strong class="jxr_keyword">var</strong> prev = i > 0 ? upper.charAt(i - 1) : '\0';
-<a class="jxr_linenumber" name="L4354" href="#L4354">4354</a> <strong class="jxr_keyword">var</strong> next = i < len - 1 ? upper.charAt(i + 1) : '\0';
-<a class="jxr_linenumber" name="L4355" href="#L4355">4355</a> <strong class="jxr_keyword">var</strong> next2 = i < len - 2 ? upper.charAt(i + 2) : '\0';
-<a class="jxr_linenumber" name="L4356" href="#L4356">4356</a>
-<a class="jxr_linenumber" name="L4357" href="#L4357">4357</a> <em class="jxr_comment">// Skip duplicates (except C)</em>
-<a class="jxr_linenumber" name="L4358" href="#L4358">4358</a> <strong class="jxr_keyword">if</strong> (c == prev && c != 'C') {
-<a class="jxr_linenumber" name="L4359" href="#L4359">4359</a> i++;
-<a class="jxr_linenumber" name="L4360" href="#L4360">4360</a> <strong class="jxr_keyword">continue</strong>;
-<a class="jxr_linenumber" name="L4361" href="#L4361">4361</a> }
+<a class="jxr_linenumber" name="L4273" href="#L4273">4273</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
+<a class="jxr_linenumber" name="L4274" href="#L4274">4274</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4275" href="#L4275">4275</a> <em class="jxr_javadoccomment"> * String[] <jv>array</jv> = {<js>"foo"</js>, <js>"bar"</js>, <js>"baz"</js>};</em>
+<a class="jxr_linenumber" name="L4276" href="#L4276">4276</a> <em class="jxr_javadoccomment"> * String[] <jv>uppercased</jv> = map(<jv>array</jv>, String::toUpperCase);</em>
+<a class="jxr_linenumber" name="L4277" href="#L4277">4277</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["FOO", "BAR", "BAZ"]</jc></em>
+<a class="jxr_linenumber" name="L4278" href="#L4278">4278</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4279" href="#L4279">4279</a> <em class="jxr_javadoccomment"> * String[] <jv>prefixed</jv> = map(<jv>array</jv>, s -&gt; <js>"prefix-"</js> + s);</em>
+<a class="jxr_linenumber" name="L4280" href="#L4280">4280</a> <em class="jxr_javadoccomment"> * <jc>// Returns: ["prefix-foo", "prefix-bar", "prefix-baz"]</jc></em>
+<a class="jxr_linenumber" name="L4281" href="#L4281">4281</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4282" href="#L4282">4282</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4283" href="#L4283">4283</a> <em class="jxr_javadoccomment"> * @param array The array to map. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4284" href="#L4284">4284</a> <em class="jxr_javadoccomment"> * @param mapper The function to apply to each element. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4285" href="#L4285">4285</a> <em class="jxr_javadoccomment"> * @return A new array with the mapped elements, or <jk>null</jk> if the array was <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4286" href="#L4286">4286</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4287" href="#L4287">4287</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String[] mapped(String[] array, Function<String,String> mapper) {
+<a class="jxr_linenumber" name="L4288" href="#L4288">4288</a> <strong class="jxr_keyword">if</strong> (array == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4289" href="#L4289">4289</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>; <em class="jxr_comment">// NOSONAR - Intentional.</em>
+<a class="jxr_linenumber" name="L4290" href="#L4290">4290</a> <strong class="jxr_keyword">if</strong> (mapper == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4291" href="#L4291">4291</a> <strong class="jxr_keyword">return</strong> Arrays.copyOf(array, array.length);
+<a class="jxr_linenumber" name="L4292" href="#L4292">4292</a> <strong class="jxr_keyword">return</strong> Arrays.stream(array).map(mapper).toArray(String[]::<strong class="jxr_keyword">new</strong>);
+<a class="jxr_linenumber" name="L4293" href="#L4293">4293</a> }
+<a class="jxr_linenumber" name="L4294" href="#L4294">4294</a>
+<a class="jxr_linenumber" name="L4295" href="#L4295">4295</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4296" href="#L4296">4296</a> <em class="jxr_javadoccomment"> * Checks if a string matches a regular expression pattern.</em>
+<a class="jxr_linenumber" name="L4297" href="#L4297">4297</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4298" href="#L4298">4298</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4299" href="#L4299">4299</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4300" href="#L4300">4300</a> <em class="jxr_javadoccomment"> * matches(<js>"12345"</js>, <js>"\\d+"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L4301" href="#L4301">4301</a> <em class="jxr_javadoccomment"> * matches(<js>"abc123"</js>, <js>"^[a-z]+\\d+$"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L4302" href="#L4302">4302</a> <em class="jxr_javadoccomment"> * matches(<js>"abc"</js>, <js>"\\d+"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L4303" href="#L4303">4303</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4304" href="#L4304">4304</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4305" href="#L4305">4305</a> <em class="jxr_javadoccomment"> * @param str The string to check.</em>
+<a class="jxr_linenumber" name="L4306" href="#L4306">4306</a> <em class="jxr_javadoccomment"> * @param regex The regular expression pattern.</em>
+<a class="jxr_linenumber" name="L4307" href="#L4307">4307</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string matches the pattern, <jk>false</jk> otherwise.</em>
+<a class="jxr_linenumber" name="L4308" href="#L4308">4308</a> <em class="jxr_javadoccomment"> * @throws PatternSyntaxException If the regex pattern is invalid.</em>
+<a class="jxr_linenumber" name="L4309" href="#L4309">4309</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4310" href="#L4310">4310</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> matches(String str, String regex) {
+<a class="jxr_linenumber" name="L4311" href="#L4311">4311</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong> || regex == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4312" href="#L4312">4312</a> <strong class="jxr_keyword">return</strong> false;
+<a class="jxr_linenumber" name="L4313" href="#L4313">4313</a> <strong class="jxr_keyword">return</strong> str.matches(regex);
+<a class="jxr_linenumber" name="L4314" href="#L4314">4314</a> }
+<a class="jxr_linenumber" name="L4315" href="#L4315">4315</a>
+<a class="jxr_linenumber" name="L4316" href="#L4316">4316</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4317" href="#L4317">4317</a> <em class="jxr_javadoccomment"> * Generates a Metaphone code for a string.</em>
+<a class="jxr_linenumber" name="L4318" href="#L4318">4318</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4319" href="#L4319">4319</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4320" href="#L4320">4320</a> <em class="jxr_javadoccomment"> * Metaphone is a phonetic algorithm that produces codes representing how words sound.</em>
+<a class="jxr_linenumber" name="L4321" href="#L4321">4321</a> <em class="jxr_javadoccomment"> * It's more accurate than Soundex for English words.</em>
+<a class="jxr_linenumber" name="L4322" href="#L4322">4322</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4323" href="#L4323">4323</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4324" href="#L4324">4324</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4325" href="#L4325">4325</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Smith"</js>); <jc>// "SM0"</jc></em>
+<a class="jxr_linenumber" name="L4326" href="#L4326">4326</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Smythe"</js>); <jc>// "SM0"</jc></em>
+<a class="jxr_linenumber" name="L4327" href="#L4327">4327</a> <em class="jxr_javadoccomment"> * metaphone(<js>"Robert"</js>); <jc>// "RBRT"</jc></em>
+<a class="jxr_linenumber" name="L4328" href="#L4328">4328</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4329" href="#L4329">4329</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4330" href="#L4330">4330</a> <em class="jxr_javadoccomment"> * @param str The string to generate a Metaphone code for. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4331" href="#L4331">4331</a> <em class="jxr_javadoccomment"> * @return The Metaphone code, or <jk>null</jk> if input is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L4332" href="#L4332">4332</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4333" href="#L4333">4333</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String metaphone(String str) {
+<a class="jxr_linenumber" name="L4334" href="#L4334">4334</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L4335" href="#L4335">4335</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4336" href="#L4336">4336</a>
+<a class="jxr_linenumber" name="L4337" href="#L4337">4337</a> <strong class="jxr_keyword">var</strong> upper = str.toUpperCase().replaceAll(<span class="jxr_string">"[^A-Z]"</span>, <span class="jxr_string">""</span>);
+<a class="jxr_linenumber" name="L4338" href="#L4338">4338</a> <strong class="jxr_keyword">if</strong> (upper.isEmpty())
+<a class="jxr_linenumber" name="L4339" href="#L4339">4339</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4340" href="#L4340">4340</a>
+<a class="jxr_linenumber" name="L4341" href="#L4341">4341</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> StringBuilder();
+<a class="jxr_linenumber" name="L4342" href="#L4342">4342</a> <strong class="jxr_keyword">var</strong> i = 0;
+<a class="jxr_linenumber" name="L4343" href="#L4343">4343</a> <strong class="jxr_keyword">var</strong> len = upper.length();
+<a class="jxr_linenumber" name="L4344" href="#L4344">4344</a>
+<a class="jxr_linenumber" name="L4345" href="#L4345">4345</a> <em class="jxr_comment">// Handle initial characters</em>
+<a class="jxr_linenumber" name="L4346" href="#L4346">4346</a> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"KN"</span>) || upper.startsWith(<span class="jxr_string">"GN"</span>) || upper.startsWith(<span class="jxr_string">"PN"</span>) || upper.startsWith(<span class="jxr_string">"AE"</span>) || upper.startsWith(<span class="jxr_string">"WR"</span>)) {
+<a class="jxr_linenumber" name="L4347" href="#L4347">4347</a> i = 1;
+<a class="jxr_linenumber" name="L4348" href="#L4348">4348</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"X"</span>)) {
+<a class="jxr_linenumber" name="L4349" href="#L4349">4349</a> result.append('S');
+<a class="jxr_linenumber" name="L4350" href="#L4350">4350</a> i = 1;
+<a class="jxr_linenumber" name="L4351" href="#L4351">4351</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (upper.startsWith(<span class="jxr_string">"WH"</span>)) {
+<a class="jxr_linenumber" name="L4352" href="#L4352">4352</a> result.append('W');
+<a class="jxr_linenumber" name="L4353" href="#L4353">4353</a> i = 2;
+<a class="jxr_linenumber" name="L4354" href="#L4354">4354</a> }
+<a class="jxr_linenumber" name="L4355" href="#L4355">4355</a>
+<a class="jxr_linenumber" name="L4356" href="#L4356">4356</a> <em class="jxr_comment">// Process remaining characters</em>
+<a class="jxr_linenumber" name="L4357" href="#L4357">4357</a> <strong class="jxr_keyword">while</strong> (i < len && result.length() < 4) {
+<a class="jxr_linenumber" name="L4358" href="#L4358">4358</a> <strong class="jxr_keyword">var</strong> c = upper.charAt(i);
+<a class="jxr_linenumber" name="L4359" href="#L4359">4359</a> <strong class="jxr_keyword">var</strong> prev = i > 0 ? upper.charAt(i - 1) : '\0';
+<a class="jxr_linenumber" name="L4360" href="#L4360">4360</a> <strong class="jxr_keyword">var</strong> next = i < len - 1 ? upper.charAt(i + 1) : '\0';
+<a class="jxr_linenumber" name="L4361" href="#L4361">4361</a> <strong class="jxr_keyword">var</strong> next2 = i < len - 2 ? upper.charAt(i + 2) : '\0';
<a class="jxr_linenumber" name="L4362" href="#L4362">4362</a>
-<a class="jxr_linenumber" name="L4363" href="#L4363">4363</a> <strong class="jxr_keyword">switch</strong> (c) {
-<a class="jxr_linenumber" name="L4364" href="#L4364">4364</a> <strong class="jxr_keyword">case</strong> 'B':
-<a class="jxr_linenumber" name="L4365" href="#L4365">4365</a> <strong class="jxr_keyword">if</strong> (prev != 'M' || next != '\0')
-<a class="jxr_linenumber" name="L4366" href="#L4366">4366</a> result.append('B');
-<a class="jxr_linenumber" name="L4367" href="#L4367">4367</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4368" href="#L4368">4368</a> <strong class="jxr_keyword">case</strong> 'C':
-<a class="jxr_linenumber" name="L4369" href="#L4369">4369</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
-<a class="jxr_linenumber" name="L4370" href="#L4370">4370</a> <strong class="jxr_keyword">if</strong> (prev == 'S')
-<a class="jxr_linenumber" name="L4371" href="#L4371">4371</a> result.append('K');
-<a class="jxr_linenumber" name="L4372" href="#L4372">4372</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L4373" href="#L4373">4373</a> result.append('X');
-<a class="jxr_linenumber" name="L4374" href="#L4374">4374</a> i++;
-<a class="jxr_linenumber" name="L4375" href="#L4375">4375</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' || next == 'E' || next == 'Y') {
-<a class="jxr_linenumber" name="L4376" href="#L4376">4376</a> result.append('S');
-<a class="jxr_linenumber" name="L4377" href="#L4377">4377</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4378" href="#L4378">4378</a> result.append('K');
-<a class="jxr_linenumber" name="L4379" href="#L4379">4379</a> }
-<a class="jxr_linenumber" name="L4380" href="#L4380">4380</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4381" href="#L4381">4381</a> <strong class="jxr_keyword">case</strong> 'D':
-<a class="jxr_linenumber" name="L4382" href="#L4382">4382</a> <strong class="jxr_keyword">if</strong> (next == 'G' && (next2 == 'E' || next2 == 'I' || next2 == 'Y')) {
-<a class="jxr_linenumber" name="L4383" href="#L4383">4383</a> result.append('J');
-<a class="jxr_linenumber" name="L4384" href="#L4384">4384</a> i++;
-<a class="jxr_linenumber" name="L4385" href="#L4385">4385</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4386" href="#L4386">4386</a> result.append('T');
-<a class="jxr_linenumber" name="L4387" href="#L4387">4387</a> }
-<a class="jxr_linenumber" name="L4388" href="#L4388">4388</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4389" href="#L4389">4389</a> <strong class="jxr_keyword">case</strong> 'F':
-<a class="jxr_linenumber" name="L4390" href="#L4390">4390</a> <strong class="jxr_keyword">case</strong> 'J':
-<a class="jxr_linenumber" name="L4391" href="#L4391">4391</a> <strong class="jxr_keyword">case</strong> 'L':
-<a class="jxr_linenumber" name="L4392" href="#L4392">4392</a> <strong class="jxr_keyword">case</strong> 'M':
-<a class="jxr_linenumber" name="L4393" href="#L4393">4393</a> <strong class="jxr_keyword">case</strong> 'N':
-<a class="jxr_linenumber" name="L4394" href="#L4394">4394</a> <strong class="jxr_keyword">case</strong> 'R':
-<a class="jxr_linenumber" name="L4395" href="#L4395">4395</a> result.append(c);
-<a class="jxr_linenumber" name="L4396" href="#L4396">4396</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4397" href="#L4397">4397</a> <strong class="jxr_keyword">case</strong> 'G':
-<a class="jxr_linenumber" name="L4398" href="#L4398">4398</a> <strong class="jxr_keyword">if</strong> (next == 'H' && (next2 == 'A' || next2 == 'E' || next2 == 'I' || next2 == 'O' || next2 == 'U')) {
-<a class="jxr_linenumber" name="L4399" href="#L4399">4399</a> <em class="jxr_comment">// Silent GH</em>
-<a class="jxr_linenumber" name="L4400" href="#L4400">4400</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'N' && (next2 == 'E' || next2 == 'D')) {
-<a class="jxr_linenumber" name="L4401" href="#L4401">4401</a> <em class="jxr_comment">// Silent GN</em>
-<a class="jxr_linenumber" name="L4402" href="#L4402">4402</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> ((next == 'E' || next == 'I' || next == 'Y') && prev != 'G') {
-<a class="jxr_linenumber" name="L4403" href="#L4403">4403</a> result.append('J');
-<a class="jxr_linenumber" name="L4404" href="#L4404">4404</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4405" href="#L4405">4405</a> result.append('K');
-<a class="jxr_linenumber" name="L4406" href="#L4406">4406</a> }
-<a class="jxr_linenumber" name="L4407" href="#L4407">4407</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4408" href="#L4408">4408</a> <strong class="jxr_keyword">case</strong> 'H':
-<a class="jxr_linenumber" name="L4409" href="#L4409">4409</a> <strong class="jxr_keyword">if</strong> (! isVowel(prev) || ! isVowel(next))
-<a class="jxr_linenumber" name="L4410" href="#L4410">4410</a> result.append('H');
-<a class="jxr_linenumber" name="L4411" href="#L4411">4411</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4412" href="#L4412">4412</a> <strong class="jxr_keyword">case</strong> 'K':
-<a class="jxr_linenumber" name="L4413" href="#L4413">4413</a> <strong class="jxr_keyword">if</strong> (prev != 'C')
-<a class="jxr_linenumber" name="L4414" href="#L4414">4414</a> result.append('K');
-<a class="jxr_linenumber" name="L4415" href="#L4415">4415</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4416" href="#L4416">4416</a> <strong class="jxr_keyword">case</strong> 'P':
-<a class="jxr_linenumber" name="L4417" href="#L4417">4417</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
-<a class="jxr_linenumber" name="L4418" href="#L4418">4418</a> result.append('F');
-<a class="jxr_linenumber" name="L4419" href="#L4419">4419</a> i++;
-<a class="jxr_linenumber" name="L4420" href="#L4420">4420</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4421" href="#L4421">4421</a> result.append('P');
-<a class="jxr_linenumber" name="L4422" href="#L4422">4422</a> }
-<a class="jxr_linenumber" name="L4423" href="#L4423">4423</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4424" href="#L4424">4424</a> <strong class="jxr_keyword">case</strong> 'Q':
-<a class="jxr_linenumber" name="L4425" href="#L4425">4425</a> result.append('K');
-<a class="jxr_linenumber" name="L4426" href="#L4426">4426</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4427" href="#L4427">4427</a> <strong class="jxr_keyword">case</strong> 'S':
-<a class="jxr_linenumber" name="L4428" href="#L4428">4428</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
-<a class="jxr_linenumber" name="L4429" href="#L4429">4429</a> result.append('X');
-<a class="jxr_linenumber" name="L4430" href="#L4430">4430</a> i++;
-<a class="jxr_linenumber" name="L4431" href="#L4431">4431</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' && (next2 == 'O' || next2 == 'A')) {
-<a class="jxr_linenumber" name="L4432" href="#L4432">4432</a> result.append('X');
-<a class="jxr_linenumber" name="L4433" href="#L4433">4433</a> i++;
-<a class="jxr_linenumber" name="L4434" href="#L4434">4434</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4435" href="#L4435">4435</a> result.append('S');
-<a class="jxr_linenumber" name="L4436" href="#L4436">4436</a> }
-<a class="jxr_linenumber" name="L4437" href="#L4437">4437</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4438" href="#L4438">4438</a> <strong class="jxr_keyword">case</strong> 'T':
-<a class="jxr_linenumber" name="L4439" href="#L4439">4439</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
-<a class="jxr_linenumber" name="L4440" href="#L4440">4440</a> result.append('0'); <em class="jxr_comment">// TH sound</em>
-<a class="jxr_linenumber" name="L4441" href="#L4441">4441</a> i++;
-<a class="jxr_linenumber" name="L4442" href="#L4442">4442</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' && (next2 == 'O' || next2 == 'A')) {
-<a class="jxr_linenumber" name="L4443" href="#L4443">4443</a> result.append('X');
-<a class="jxr_linenumber" name="L4444" href="#L4444">4444</a> i++;
-<a class="jxr_linenumber" name="L4445" href="#L4445">4445</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4446" href="#L4446">4446</a> result.append('T');
-<a class="jxr_linenumber" name="L4447" href="#L4447">4447</a> }
-<a class="jxr_linenumber" name="L4448" href="#L4448">4448</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4449" href="#L4449">4449</a> <strong class="jxr_keyword">case</strong> 'V':
-<a class="jxr_linenumber" name="L4450" href="#L4450">4450</a> result.append('F');
-<a class="jxr_linenumber" name="L4451" href="#L4451">4451</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4452" href="#L4452">4452</a> <strong class="jxr_keyword">case</strong> 'W', 'Y':
-<a class="jxr_linenumber" name="L4453" href="#L4453">4453</a> <strong class="jxr_keyword">if</strong> (isVowel(next))
-<a class="jxr_linenumber" name="L4454" href="#L4454">4454</a> result.append(c);
-<a class="jxr_linenumber" name="L4455" href="#L4455">4455</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4456" href="#L4456">4456</a> <strong class="jxr_keyword">case</strong> 'X':
-<a class="jxr_linenumber" name="L4457" href="#L4457">4457</a> <strong class="jxr_keyword">if</strong> (i == 0)
-<a class="jxr_linenumber" name="L4458" href="#L4458">4458</a> result.append('S');
-<a class="jxr_linenumber" name="L4459" href="#L4459">4459</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L4460" href="#L4460">4460</a> result.append(<span class="jxr_string">"KS"</span>);
+<a class="jxr_linenumber" name="L4363" href="#L4363">4363</a> <em class="jxr_comment">// Skip duplicates (except C)</em>
+<a class="jxr_linenumber" name="L4364" href="#L4364">4364</a> <strong class="jxr_keyword">if</strong> (c == prev && c != 'C') {
+<a class="jxr_linenumber" name="L4365" href="#L4365">4365</a> i++;
+<a class="jxr_linenumber" name="L4366" href="#L4366">4366</a> <strong class="jxr_keyword">continue</strong>;
+<a class="jxr_linenumber" name="L4367" href="#L4367">4367</a> }
+<a class="jxr_linenumber" name="L4368" href="#L4368">4368</a>
+<a class="jxr_linenumber" name="L4369" href="#L4369">4369</a> <strong class="jxr_keyword">switch</strong> (c) {
+<a class="jxr_linenumber" name="L4370" href="#L4370">4370</a> <strong class="jxr_keyword">case</strong> 'B':
+<a class="jxr_linenumber" name="L4371" href="#L4371">4371</a> <strong class="jxr_keyword">if</strong> (prev != 'M' || next != '\0')
+<a class="jxr_linenumber" name="L4372" href="#L4372">4372</a> result.append('B');
+<a class="jxr_linenumber" name="L4373" href="#L4373">4373</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4374" href="#L4374">4374</a> <strong class="jxr_keyword">case</strong> 'C':
+<a class="jxr_linenumber" name="L4375" href="#L4375">4375</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
+<a class="jxr_linenumber" name="L4376" href="#L4376">4376</a> <strong class="jxr_keyword">if</strong> (prev == 'S')
+<a class="jxr_linenumber" name="L4377" href="#L4377">4377</a> result.append('K');
+<a class="jxr_linenumber" name="L4378" href="#L4378">4378</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L4379" href="#L4379">4379</a> result.append('X');
+<a class="jxr_linenumber" name="L4380" href="#L4380">4380</a> i++;
+<a class="jxr_linenumber" name="L4381" href="#L4381">4381</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' || next == 'E' || next == 'Y') {
+<a class="jxr_linenumber" name="L4382" href="#L4382">4382</a> result.append('S');
+<a class="jxr_linenumber" name="L4383" href="#L4383">4383</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4384" href="#L4384">4384</a> result.append('K');
+<a class="jxr_linenumber" name="L4385" href="#L4385">4385</a> }
+<a class="jxr_linenumber" name="L4386" href="#L4386">4386</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4387" href="#L4387">4387</a> <strong class="jxr_keyword">case</strong> 'D':
+<a class="jxr_linenumber" name="L4388" href="#L4388">4388</a> <strong class="jxr_keyword">if</strong> (next == 'G' && (next2 == 'E' || next2 == 'I' || next2 == 'Y')) {
+<a class="jxr_linenumber" name="L4389" href="#L4389">4389</a> result.append('J');
+<a class="jxr_linenumber" name="L4390" href="#L4390">4390</a> i++;
+<a class="jxr_linenumber" name="L4391" href="#L4391">4391</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4392" href="#L4392">4392</a> result.append('T');
+<a class="jxr_linenumber" name="L4393" href="#L4393">4393</a> }
+<a class="jxr_linenumber" name="L4394" href="#L4394">4394</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4395" href="#L4395">4395</a> <strong class="jxr_keyword">case</strong> 'F':
+<a class="jxr_linenumber" name="L4396" href="#L4396">4396</a> <strong class="jxr_keyword">case</strong> 'J':
+<a class="jxr_linenumber" name="L4397" href="#L4397">4397</a> <strong class="jxr_keyword">case</strong> 'L':
+<a class="jxr_linenumber" name="L4398" href="#L4398">4398</a> <strong class="jxr_keyword">case</strong> 'M':
+<a class="jxr_linenumber" name="L4399" href="#L4399">4399</a> <strong class="jxr_keyword">case</strong> 'N':
+<a class="jxr_linenumber" name="L4400" href="#L4400">4400</a> <strong class="jxr_keyword">case</strong> 'R':
+<a class="jxr_linenumber" name="L4401" href="#L4401">4401</a> result.append(c);
+<a class="jxr_linenumber" name="L4402" href="#L4402">4402</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4403" href="#L4403">4403</a> <strong class="jxr_keyword">case</strong> 'G':
+<a class="jxr_linenumber" name="L4404" href="#L4404">4404</a> <strong class="jxr_keyword">if</strong> (next == 'H' && (next2 == 'A' || next2 == 'E' || next2 == 'I' || next2 == 'O' || next2 == 'U')) {
+<a class="jxr_linenumber" name="L4405" href="#L4405">4405</a> <em class="jxr_comment">// Silent GH</em>
+<a class="jxr_linenumber" name="L4406" href="#L4406">4406</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'N' && (next2 == 'E' || next2 == 'D')) {
+<a class="jxr_linenumber" name="L4407" href="#L4407">4407</a> <em class="jxr_comment">// Silent GN</em>
+<a class="jxr_linenumber" name="L4408" href="#L4408">4408</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> ((next == 'E' || next == 'I' || next == 'Y') && prev != 'G') {
+<a class="jxr_linenumber" name="L4409" href="#L4409">4409</a> result.append('J');
+<a class="jxr_linenumber" name="L4410" href="#L4410">4410</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4411" href="#L4411">4411</a> result.append('K');
+<a class="jxr_linenumber" name="L4412" href="#L4412">4412</a> }
+<a class="jxr_linenumber" name="L4413" href="#L4413">4413</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4414" href="#L4414">4414</a> <strong class="jxr_keyword">case</strong> 'H':
+<a class="jxr_linenumber" name="L4415" href="#L4415">4415</a> <strong class="jxr_keyword">if</strong> (! isVowel(prev) || ! isVowel(next))
+<a class="jxr_linenumber" name="L4416" href="#L4416">4416</a> result.append('H');
+<a class="jxr_linenumber" name="L4417" href="#L4417">4417</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4418" href="#L4418">4418</a> <strong class="jxr_keyword">case</strong> 'K':
+<a class="jxr_linenumber" name="L4419" href="#L4419">4419</a> <strong class="jxr_keyword">if</strong> (prev != 'C')
+<a class="jxr_linenumber" name="L4420" href="#L4420">4420</a> result.append('K');
+<a class="jxr_linenumber" name="L4421" href="#L4421">4421</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4422" href="#L4422">4422</a> <strong class="jxr_keyword">case</strong> 'P':
+<a class="jxr_linenumber" name="L4423" href="#L4423">4423</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
+<a class="jxr_linenumber" name="L4424" href="#L4424">4424</a> result.append('F');
+<a class="jxr_linenumber" name="L4425" href="#L4425">4425</a> i++;
+<a class="jxr_linenumber" name="L4426" href="#L4426">4426</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4427" href="#L4427">4427</a> result.append('P');
+<a class="jxr_linenumber" name="L4428" href="#L4428">4428</a> }
+<a class="jxr_linenumber" name="L4429" href="#L4429">4429</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4430" href="#L4430">4430</a> <strong class="jxr_keyword">case</strong> 'Q':
+<a class="jxr_linenumber" name="L4431" href="#L4431">4431</a> result.append('K');
+<a class="jxr_linenumber" name="L4432" href="#L4432">4432</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4433" href="#L4433">4433</a> <strong class="jxr_keyword">case</strong> 'S':
+<a class="jxr_linenumber" name="L4434" href="#L4434">4434</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
+<a class="jxr_linenumber" name="L4435" href="#L4435">4435</a> result.append('X');
+<a class="jxr_linenumber" name="L4436" href="#L4436">4436</a> i++;
+<a class="jxr_linenumber" name="L4437" href="#L4437">4437</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' && (next2 == 'O' || next2 == 'A')) {
+<a class="jxr_linenumber" name="L4438" href="#L4438">4438</a> result.append('X');
+<a class="jxr_linenumber" name="L4439" href="#L4439">4439</a> i++;
+<a class="jxr_linenumber" name="L4440" href="#L4440">4440</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4441" href="#L4441">4441</a> result.append('S');
+<a class="jxr_linenumber" name="L4442" href="#L4442">4442</a> }
+<a class="jxr_linenumber" name="L4443" href="#L4443">4443</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4444" href="#L4444">4444</a> <strong class="jxr_keyword">case</strong> 'T':
+<a class="jxr_linenumber" name="L4445" href="#L4445">4445</a> <strong class="jxr_keyword">if</strong> (next == 'H') {
+<a class="jxr_linenumber" name="L4446" href="#L4446">4446</a> result.append('0'); <em class="jxr_comment">// TH sound</em>
+<a class="jxr_linenumber" name="L4447" href="#L4447">4447</a> i++;
+<a class="jxr_linenumber" name="L4448" href="#L4448">4448</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (next == 'I' && (next2 == 'O' || next2 == 'A')) {
+<a class="jxr_linenumber" name="L4449" href="#L4449">4449</a> result.append('X');
+<a class="jxr_linenumber" name="L4450" href="#L4450">4450</a> i++;
+<a class="jxr_linenumber" name="L4451" href="#L4451">4451</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4452" href="#L4452">4452</a> result.append('T');
+<a class="jxr_linenumber" name="L4453" href="#L4453">4453</a> }
+<a class="jxr_linenumber" name="L4454" href="#L4454">4454</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4455" href="#L4455">4455</a> <strong class="jxr_keyword">case</strong> 'V':
+<a class="jxr_linenumber" name="L4456" href="#L4456">4456</a> result.append('F');
+<a class="jxr_linenumber" name="L4457" href="#L4457">4457</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4458" href="#L4458">4458</a> <strong class="jxr_keyword">case</strong> 'W', 'Y':
+<a class="jxr_linenumber" name="L4459" href="#L4459">4459</a> <strong class="jxr_keyword">if</strong> (isVowel(next))
+<a class="jxr_linenumber" name="L4460" href="#L4460">4460</a> result.append(c);
<a class="jxr_linenumber" name="L4461" href="#L4461">4461</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4462" href="#L4462">4462</a> <strong class="jxr_keyword">case</strong> 'Z':
-<a class="jxr_linenumber" name="L4463" href="#L4463">4463</a> result.append('S');
-<a class="jxr_linenumber" name="L4464" href="#L4464">4464</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4465" href="#L4465">4465</a> <strong class="jxr_keyword">default</strong>:
-<a class="jxr_linenumber" name="L4466" href="#L4466">4466</a> <strong class="jxr_keyword">break</strong>;
-<a class="jxr_linenumber" name="L4467" href="#L4467">4467</a> }
-<a class="jxr_linenumber" name="L4468" href="#L4468">4468</a> i++;
-<a class="jxr_linenumber" name="L4469" href="#L4469">4469</a> }
-<a class="jxr_linenumber" name="L4470" href="#L4470">4470</a>
-<a class="jxr_linenumber" name="L4471" href="#L4471">4471</a> <strong class="jxr_keyword">return</strong> result.length() > 0 ? result.toString() : upper.substring(0, Math.min(1, upper.length()));
-<a class="jxr_linenumber" name="L4472" href="#L4472">4472</a> }
-<a class="jxr_linenumber" name="L4473" href="#L4473">4473</a>
-<a class="jxr_linenumber" name="L4474" href="#L4474">4474</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4475" href="#L4475">4475</a> <em class="jxr_javadoccomment"> * Returns the middle characters of a string.</em>
-<a class="jxr_linenumber" name="L4476" href="#L4476">4476</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4477" href="#L4477">4477</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4478" href="#L4478">4478</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4479" href="#L4479">4479</a> <em class="jxr_javadoccomment"> * mid(<jk>null</jk>, 1, 3); <jc>// null</jc></em>
-<a class="jxr_linenumber" name="L4480" href="#L4480">4480</a> <em class="jxr_javadoccomment"> * mid(<js>""</js>, 1, 3); <jc>// ""</jc></em>
-<a class="jxr_linenumber" name="L4481" href="#L4481">4481</a> <em class="jxr_javadoccomment"> * mid(<js>"hello"</js>, 1, 3); <jc>// "ell"</jc></em>
-<a class="jxr_linenumber" name="L4482" href="#L4482">4482</a> <em class="jxr_javadoccomment"> * mid(<js>"hello"</js>, 1, 10); <jc>// "ello"</jc></em>
-<a class="jxr_linenumber" name="L4483" href="#L4483">4483</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4484" href="#L4484">4484</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4485" href="#L4485">4485</a> <em class="jxr_javadoccomment"> * @param str The string to get characters from.</em>
-<a class="jxr_linenumber" name="L4486" href="#L4486">4486</a> <em class="jxr_javadoccomment"> * @param pos The starting position (0-based).</em>
-<a class="jxr_linenumber" name="L4487" href="#L4487">4487</a> <em class="jxr_javadoccomment"> * @param len The number of characters to get.</em>
-<a class="jxr_linenumber" name="L4488" href="#L4488">4488</a> <em class="jxr_javadoccomment"> * @return The middle characters, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4489" href="#L4489">4489</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4490" href="#L4490">4490</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String mid(String str, <strong class="jxr_keyword">int</strong> pos, <strong class="jxr_keyword">int</strong> len) {
-<a class="jxr_linenumber" name="L4491" href="#L4491">4491</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4492" href="#L4492">4492</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4493" href="#L4493">4493</a> <strong class="jxr_keyword">if</strong> (pos < 0 || len < 0)
-<a class="jxr_linenumber" name="L4494" href="#L4494">4494</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4495" href="#L4495">4495</a> <strong class="jxr_keyword">if</strong> (pos >= str.length())
-<a class="jxr_linenumber" name="L4496" href="#L4496">4496</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L4497" href="#L4497">4497</a> <strong class="jxr_keyword">int</strong> end = Math.min(pos + len, str.length());
-<a class="jxr_linenumber" name="L4498" href="#L4498">4498</a> <strong class="jxr_keyword">return</strong> str.substring(pos, end);
-<a class="jxr_linenumber" name="L4499" href="#L4499">4499</a> }
-<a class="jxr_linenumber" name="L4500" href="#L4500">4500</a>
-<a class="jxr_linenumber" name="L4501" href="#L4501">4501</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4502" href="#L4502">4502</a> <em class="jxr_javadoccomment"> * Finds the most frequent character in a string.</em>
-<a class="jxr_linenumber" name="L4503" href="#L4503">4503</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4504" href="#L4504">4504</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4505" href="#L4505">4505</a> <em class="jxr_javadoccomment"> * Returns the character that appears most often. If multiple characters have the same</em>
-<a class="jxr_linenumber" name="L4506" href="#L4506">4506</a> <em class="jxr_javadoccomment"> * frequency, returns the first one encountered.</em>
-<a class="jxr_linenumber" name="L4507" href="#L4507">4507</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4508" href="#L4508">4508</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4509" href="#L4509">4509</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4510" href="#L4510">4510</a> <em class="jxr_javadoccomment"> * mostFrequentChar(<js>"hello"</js>); <jc>// 'l'</jc></em>
-<a class="jxr_linenumber" name="L4511" href="#L4511">4511</a> <em class="jxr_javadoccomment"> * mostFrequentChar(<js>"aabbcc"</js>); <jc>// 'a' (first encountered)</jc></em>
-<a class="jxr_linenumber" name="L4512" href="#L4512">4512</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4462" href="#L4462">4462</a> <strong class="jxr_keyword">case</strong> 'X':
+<a class="jxr_linenumber" name="L4463" href="#L4463">4463</a> <strong class="jxr_keyword">if</strong> (i == 0)
+<a class="jxr_linenumber" name="L4464" href="#L4464">4464</a> result.append('S');
+<a class="jxr_linenumber" name="L4465" href="#L4465">4465</a> <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L4466" href="#L4466">4466</a> result.append(<span class="jxr_string">"KS"</span>);
+<a class="jxr_linenumber" name="L4467" href="#L4467">4467</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4468" href="#L4468">4468</a> <strong class="jxr_keyword">case</strong> 'Z':
+<a class="jxr_linenumber" name="L4469" href="#L4469">4469</a> result.append('S');
+<a class="jxr_linenumber" name="L4470" href="#L4470">4470</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4471" href="#L4471">4471</a> <strong class="jxr_keyword">default</strong>:
+<a class="jxr_linenumber" name="L4472" href="#L4472">4472</a> <strong class="jxr_keyword">break</strong>;
+<a class="jxr_linenumber" name="L4473" href="#L4473">4473</a> }
+<a class="jxr_linenumber" name="L4474" href="#L4474">4474</a> i++;
+<a class="jxr_linenumber" name="L4475" href="#L4475">4475</a> }
+<a class="jxr_linenumber" name="L4476" href="#L4476">4476</a>
+<a class="jxr_linenumber" name="L4477" href="#L4477">4477</a> <strong class="jxr_keyword">return</strong> result.length() > 0 ? result.toString() : upper.substring(0, Math.min(1, upper.length()));
+<a class="jxr_linenumber" name="L4478" href="#L4478">4478</a> }
+<a class="jxr_linenumber" name="L4479" href="#L4479">4479</a>
+<a class="jxr_linenumber" name="L4480" href="#L4480">4480</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4481" href="#L4481">4481</a> <em class="jxr_javadoccomment"> * Returns the middle characters of a string.</em>
+<a class="jxr_linenumber" name="L4482" href="#L4482">4482</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4483" href="#L4483">4483</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4484" href="#L4484">4484</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4485" href="#L4485">4485</a> <em class="jxr_javadoccomment"> * mid(<jk>null</jk>, 1, 3); <jc>// null</jc></em>
+<a class="jxr_linenumber" name="L4486" href="#L4486">4486</a> <em class="jxr_javadoccomment"> * mid(<js>""</js>, 1, 3); <jc>// ""</jc></em>
+<a class="jxr_linenumber" name="L4487" href="#L4487">4487</a> <em class="jxr_javadoccomment"> * mid(<js>"hello"</js>, 1, 3); <jc>// "ell"</jc></em>
+<a class="jxr_linenumber" name="L4488" href="#L4488">4488</a> <em class="jxr_javadoccomment"> * mid(<js>"hello"</js>, 1, 10); <jc>// "ello"</jc></em>
+<a class="jxr_linenumber" name="L4489" href="#L4489">4489</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4490" href="#L4490">4490</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4491" href="#L4491">4491</a> <em class="jxr_javadoccomment"> * @param str The string to get characters from.</em>
+<a class="jxr_linenumber" name="L4492" href="#L4492">4492</a> <em class="jxr_javadoccomment"> * @param pos The starting position (0-based).</em>
+<a class="jxr_linenumber" name="L4493" href="#L4493">4493</a> <em class="jxr_javadoccomment"> * @param len The number of characters to get.</em>
+<a class="jxr_linenumber" name="L4494" href="#L4494">4494</a> <em class="jxr_javadoccomment"> * @return The middle characters, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4495" href="#L4495">4495</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4496" href="#L4496">4496</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String mid(String str, <strong class="jxr_keyword">int</strong> pos, <strong class="jxr_keyword">int</strong> len) {
+<a class="jxr_linenumber" name="L4497" href="#L4497">4497</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4498" href="#L4498">4498</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4499" href="#L4499">4499</a> <strong class="jxr_keyword">if</strong> (pos < 0 || len < 0)
+<a class="jxr_linenumber" name="L4500" href="#L4500">4500</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4501" href="#L4501">4501</a> <strong class="jxr_keyword">if</strong> (pos >= str.length())
+<a class="jxr_linenumber" name="L4502" href="#L4502">4502</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">""</span>;
+<a class="jxr_linenumber" name="L4503" href="#L4503">4503</a> <strong class="jxr_keyword">int</strong> end = Math.min(pos + len, str.length());
+<a class="jxr_linenumber" name="L4504" href="#L4504">4504</a> <strong class="jxr_keyword">return</strong> str.substring(pos, end);
+<a class="jxr_linenumber" name="L4505" href="#L4505">4505</a> }
+<a class="jxr_linenumber" name="L4506" href="#L4506">4506</a>
+<a class="jxr_linenumber" name="L4507" href="#L4507">4507</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4508" href="#L4508">4508</a> <em class="jxr_javadoccomment"> * Finds the most frequent character in a string.</em>
+<a class="jxr_linenumber" name="L4509" href="#L4509">4509</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4510" href="#L4510">4510</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4511" href="#L4511">4511</a> <em class="jxr_javadoccomment"> * Returns the character that appears most often. If multiple characters have the same</em>
+<a class="jxr_linenumber" name="L4512" href="#L4512">4512</a> <em class="jxr_javadoccomment"> * frequency, returns the first one encountered.</em>
<a class="jxr_linenumber" name="L4513" href="#L4513">4513</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4514" href="#L4514">4514</a> <em class="jxr_javadoccomment"> * @param str The string to analyze. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4515" href="#L4515">4515</a> <em class="jxr_javadoccomment"> * @return The most frequent character, or <c>'\0'</c> if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L4516" href="#L4516">4516</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4517" href="#L4517">4517</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> mostFrequentChar(String str) {
-<a class="jxr_linenumber" name="L4518" href="#L4518">4518</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L4519" href="#L4519">4519</a> <strong class="jxr_keyword">return</strong> '\0';
-<a class="jxr_linenumber" name="L4520" href="#L4520">4520</a>
-<a class="jxr_linenumber" name="L4521" href="#L4521">4521</a> <strong class="jxr_keyword">var</strong> charCounts = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[Character.MAX_VALUE + 1];
-<a class="jxr_linenumber" name="L4522" href="#L4522">4522</a> <strong class="jxr_keyword">var</strong> maxCount = 0;
-<a class="jxr_linenumber" name="L4523" href="#L4523">4523</a> <strong class="jxr_keyword">var</strong> maxChar = '\0';
-<a class="jxr_linenumber" name="L4524" href="#L4524">4524</a>
-<a class="jxr_linenumber" name="L4525" href="#L4525">4525</a> <em class="jxr_comment">// Count occurrences of each character</em>
-<a class="jxr_linenumber" name="L4526" href="#L4526">4526</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
-<a class="jxr_linenumber" name="L4527" href="#L4527">4527</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
-<a class="jxr_linenumber" name="L4528" href="#L4528">4528</a> charCounts[c]++;
-<a class="jxr_linenumber" name="L4529" href="#L4529">4529</a> <strong class="jxr_keyword">if</strong> (charCounts[c] > maxCount) {
-<a class="jxr_linenumber" name="L4530" href="#L4530">4530</a> maxCount = charCounts[c];
-<a class="jxr_linenumber" name="L4531" href="#L4531">4531</a> maxChar = c;
-<a class="jxr_linenumber" name="L4532" href="#L4532">4532</a> }
-<a class="jxr_linenumber" name="L4533" href="#L4533">4533</a> }
-<a class="jxr_linenumber" name="L4534" href="#L4534">4534</a>
-<a class="jxr_linenumber" name="L4535" href="#L4535">4535</a> <strong class="jxr_keyword">return</strong> maxChar;
-<a class="jxr_linenumber" name="L4536" href="#L4536">4536</a> }
-<a class="jxr_linenumber" name="L4537" href="#L4537">4537</a>
-<a class="jxr_linenumber" name="L4538" href="#L4538">4538</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4539" href="#L4539">4539</a> <em class="jxr_javadoccomment"> * Performs natural string comparison that handles numbers correctly.</em>
-<a class="jxr_linenumber" name="L4540" href="#L4540">4540</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4541" href="#L4541">4541</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4542" href="#L4542">4542</a> <em class="jxr_javadoccomment"> * Compares strings in a way that numbers are compared numerically rather than lexicographically.</em>
-<a class="jxr_linenumber" name="L4543" href="#L4543">4543</a> <em class="jxr_javadoccomment"> * For example, "file2.txt" comes before "file10.txt" in natural order.</em>
-<a class="jxr_linenumber" name="L4544" href="#L4544">4544</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4545" href="#L4545">4545</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4546" href="#L4546">4546</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4547" href="#L4547">4547</a> <em class="jxr_javadoccomment"> * naturalCompare(<js>"file2.txt"</js>, <js>"file10.txt"</js>); <jc>// negative (2 &lt; 10)</jc></em>
-<a class="jxr_linenumber" name="L4548" href="#L4548">4548</a> <em class="jxr_javadoccomment"> * naturalCompare(<js>"file10.txt"</js>, <js>"file2.txt"</js>); <jc>// positive (10 &gt; 2)</jc></em>
-<a class="jxr_linenumber" name="L4549" href="#L4549">4549</a> <em class="jxr_javadoccomment"> * naturalCompare(<js>"file1.txt"</js>, <js>"file1.txt"</js>); <jc>// 0 (equal)</jc></em>
-<a class="jxr_linenumber" name="L4550" href="#L4550">4550</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4551" href="#L4551">4551</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4552" href="#L4552">4552</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
-<a class="jxr_linenumber" name="L4553" href="#L4553">4553</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
-<a class="jxr_linenumber" name="L4554" href="#L4554">4554</a> <em class="jxr_javadoccomment"> * @return A negative integer, zero, or a positive integer as the first string is less than, equal to, or greater than the second.</em>
-<a class="jxr_linenumber" name="L4555" href="#L4555">4555</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4556" href="#L4556">4556</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> naturalCompare(String str1, String str2) {
-<a class="jxr_linenumber" name="L4557" href="#L4557">4557</a> <strong class="jxr_keyword">if</strong> (str1 == str2)
-<a class="jxr_linenumber" name="L4558" href="#L4558">4558</a> <strong class="jxr_keyword">return</strong> 0;
-<a class="jxr_linenumber" name="L4559" href="#L4559">4559</a> <strong class="jxr_keyword">if</strong> (str1 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4560" href="#L4560">4560</a> <strong class="jxr_keyword">return</strong> -1;
-<a class="jxr_linenumber" name="L4561" href="#L4561">4561</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4562" href="#L4562">4562</a> <strong class="jxr_keyword">return</strong> 1;
-<a class="jxr_linenumber" name="L4563" href="#L4563">4563</a>
-<a class="jxr_linenumber" name="L4564" href="#L4564">4564</a> <strong class="jxr_keyword">var</strong> len1 = str1.length();
-<a class="jxr_linenumber" name="L4565" href="#L4565">4565</a> <strong class="jxr_keyword">var</strong> len2 = str2.length();
-<a class="jxr_linenumber" name="L4566" href="#L4566">4566</a> <strong class="jxr_keyword">var</strong> i1 = 0;
-<a class="jxr_linenumber" name="L4567" href="#L4567">4567</a> <strong class="jxr_keyword">var</strong> i2 = 0;
-<a class="jxr_linenumber" name="L4568" href="#L4568">4568</a>
-<a class="jxr_linenumber" name="L4569" href="#L4569">4569</a> <strong class="jxr_keyword">while</strong> (i1 < len1 && i2 < len2) {
-<a class="jxr_linenumber" name="L4570" href="#L4570">4570</a> <strong class="jxr_keyword">var</strong> c1 = str1.charAt(i1);
-<a class="jxr_linenumber" name="L4571" href="#L4571">4571</a> <strong class="jxr_keyword">var</strong> c2 = str2.charAt(i2);
-<a class="jxr_linenumber" name="L4572" href="#L4572">4572</a>
-<a class="jxr_linenumber" name="L4573" href="#L4573">4573</a> <em class="jxr_comment">// If both are digits, compare numerically</em>
-<a class="jxr_linenumber" name="L4574" href="#L4574">4574</a> <strong class="jxr_keyword">if</strong> (Character.isDigit(c1) && Character.isDigit(c2)) {
-<a class="jxr_linenumber" name="L4575" href="#L4575">4575</a> <em class="jxr_comment">// Skip leading zeros</em>
-<a class="jxr_linenumber" name="L4576" href="#L4576">4576</a> <strong class="jxr_keyword">while</strong> (i1 < len1 && str1.charAt(i1) == '0')
-<a class="jxr_linenumber" name="L4577" href="#L4577">4577</a> i1++;
-<a class="jxr_linenumber" name="L4578" href="#L4578">4578</a> <strong class="jxr_keyword">while</strong> (i2 < len2 && str2.charAt(i2) == '0')
-<a class="jxr_linenumber" name="L4579" href="#L4579">4579</a> i2++;
-<a class="jxr_linenumber" name="L4580" href="#L4580">4580</a>
-<a class="jxr_linenumber" name="L4581" href="#L4581">4581</a> <em class="jxr_comment">// Find end of number sequences</em>
-<a class="jxr_linenumber" name="L4582" href="#L4582">4582</a> <strong class="jxr_keyword">var</strong> end1 = i1;
-<a class="jxr_linenumber" name="L4583" href="#L4583">4583</a> <strong class="jxr_keyword">var</strong> end2 = i2;
-<a class="jxr_linenumber" name="L4584" href="#L4584">4584</a> <strong class="jxr_keyword">while</strong> (end1 < len1 && Character.isDigit(str1.charAt(end1)))
-<a class="jxr_linenumber" name="L4585" href="#L4585">4585</a> end1++;
-<a class="jxr_linenumber" name="L4586" href="#L4586">4586</a> <strong class="jxr_keyword">while</strong> (end2 < len2 && Character.isDigit(str2.charAt(end2)))
-<a class="jxr_linenumber" name="L4587" href="#L4587">4587</a> end2++;
-<a class="jxr_linenumber" name="L4588" href="#L4588">4588</a>
-<a class="jxr_linenumber" name="L4589" href="#L4589">4589</a> <em class="jxr_comment">// Compare lengths first (longer number is larger)</em>
-<a class="jxr_linenumber" name="L4590" href="#L4590">4590</a> <strong class="jxr_keyword">var</strong> lenNum1 = end1 - i1;
-<a class="jxr_linenumber" name="L4591" href="#L4591">4591</a> <strong class="jxr_keyword">var</strong> lenNum2 = end2 - i2;
-<a class="jxr_linenumber" name="L4592" href="#L4592">4592</a> <strong class="jxr_keyword">if</strong> (lenNum1 != lenNum2)
-<a class="jxr_linenumber" name="L4593" href="#L4593">4593</a> <strong class="jxr_keyword">return</strong> lenNum1 - lenNum2;
+<a class="jxr_linenumber" name="L4514" href="#L4514">4514</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4515" href="#L4515">4515</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4516" href="#L4516">4516</a> <em class="jxr_javadoccomment"> * mostFrequentChar(<js>"hello"</js>); <jc>// 'l'</jc></em>
+<a class="jxr_linenumber" name="L4517" href="#L4517">4517</a> <em class="jxr_javadoccomment"> * mostFrequentChar(<js>"aabbcc"</js>); <jc>// 'a' (first encountered)</jc></em>
+<a class="jxr_linenumber" name="L4518" href="#L4518">4518</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4519" href="#L4519">4519</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4520" href="#L4520">4520</a> <em class="jxr_javadoccomment"> * @param str The string to analyze. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4521" href="#L4521">4521</a> <em class="jxr_javadoccomment"> * @return The most frequent character, or <c>'\0'</c> if the string is <jk>null</jk> or empty.</em>
+<a class="jxr_linenumber" name="L4522" href="#L4522">4522</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4523" href="#L4523">4523</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">char</strong> mostFrequentChar(String str) {
+<a class="jxr_linenumber" name="L4524" href="#L4524">4524</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
+<a class="jxr_linenumber" name="L4525" href="#L4525">4525</a> <strong class="jxr_keyword">return</strong> '\0';
+<a class="jxr_linenumber" name="L4526" href="#L4526">4526</a>
+<a class="jxr_linenumber" name="L4527" href="#L4527">4527</a> <strong class="jxr_keyword">var</strong> charCounts = <strong class="jxr_keyword">new</strong> <strong class="jxr_keyword">int</strong>[Character.MAX_VALUE + 1];
+<a class="jxr_linenumber" name="L4528" href="#L4528">4528</a> <strong class="jxr_keyword">var</strong> maxCount = 0;
+<a class="jxr_linenumber" name="L4529" href="#L4529">4529</a> <strong class="jxr_keyword">var</strong> maxChar = '\0';
+<a class="jxr_linenumber" name="L4530" href="#L4530">4530</a>
+<a class="jxr_linenumber" name="L4531" href="#L4531">4531</a> <em class="jxr_comment">// Count occurrences of each character</em>
+<a class="jxr_linenumber" name="L4532" href="#L4532">4532</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> i = 0; i < str.length(); i++) {
+<a class="jxr_linenumber" name="L4533" href="#L4533">4533</a> <strong class="jxr_keyword">var</strong> c = str.charAt(i);
+<a class="jxr_linenumber" name="L4534" href="#L4534">4534</a> charCounts[c]++;
+<a class="jxr_linenumber" name="L4535" href="#L4535">4535</a> <strong class="jxr_keyword">if</strong> (charCounts[c] > maxCount) {
+<a class="jxr_linenumber" name="L4536" href="#L4536">4536</a> maxCount = charCounts[c];
+<a class="jxr_linenumber" name="L4537" href="#L4537">4537</a> maxChar = c;
+<a class="jxr_linenumber" name="L4538" href="#L4538">4538</a> }
+<a class="jxr_linenumber" name="L4539" href="#L4539">4539</a> }
+<a class="jxr_linenumber" name="L4540" href="#L4540">4540</a>
+<a class="jxr_linenumber" name="L4541" href="#L4541">4541</a> <strong class="jxr_keyword">return</strong> maxChar;
+<a class="jxr_linenumber" name="L4542" href="#L4542">4542</a> }
+<a class="jxr_linenumber" name="L4543" href="#L4543">4543</a>
+<a class="jxr_linenumber" name="L4544" href="#L4544">4544</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4545" href="#L4545">4545</a> <em class="jxr_javadoccomment"> * Performs natural string comparison that handles numbers correctly.</em>
+<a class="jxr_linenumber" name="L4546" href="#L4546">4546</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4547" href="#L4547">4547</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4548" href="#L4548">4548</a> <em class="jxr_javadoccomment"> * Compares strings in a way that numbers are compared numerically rather than lexicographically.</em>
+<a class="jxr_linenumber" name="L4549" href="#L4549">4549</a> <em class="jxr_javadoccomment"> * For example, "file2.txt" comes before "file10.txt" in natural order.</em>
+<a class="jxr_linenumber" name="L4550" href="#L4550">4550</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4551" href="#L4551">4551</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4552" href="#L4552">4552</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4553" href="#L4553">4553</a> <em class="jxr_javadoccomment"> * naturalCompare(<js>"file2.txt"</js>, <js>"file10.txt"</js>); <jc>// negative (2 &lt; 10)</jc></em>
+<a class="jxr_linenumber" name="L4554" href="#L4554">4554</a> <em class="jxr_javadoccomment"> * naturalCompare(<js>"file10.txt"</js>, <js>"file2.txt"</js>); <jc>// positive (10 &gt; 2)</jc></em>
+<a class="jxr_linenumber" name="L4555" href="#L4555">4555</a> <em class="jxr_javadoccomment"> * naturalCompare(<js>"file1.txt"</js>, <js>"file1.txt"</js>); <jc>// 0 (equal)</jc></em>
+<a class="jxr_linenumber" name="L4556" href="#L4556">4556</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4557" href="#L4557">4557</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4558" href="#L4558">4558</a> <em class="jxr_javadoccomment"> * @param str1 The first string.</em>
+<a class="jxr_linenumber" name="L4559" href="#L4559">4559</a> <em class="jxr_javadoccomment"> * @param str2 The second string.</em>
+<a class="jxr_linenumber" name="L4560" href="#L4560">4560</a> <em class="jxr_javadoccomment"> * @return A negative integer, zero, or a positive integer as the first string is less than, equal to, or greater than the second.</em>
+<a class="jxr_linenumber" name="L4561" href="#L4561">4561</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4562" href="#L4562">4562</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> naturalCompare(String str1, String str2) {
+<a class="jxr_linenumber" name="L4563" href="#L4563">4563</a> <strong class="jxr_keyword">if</strong> (str1 == str2)
+<a class="jxr_linenumber" name="L4564" href="#L4564">4564</a> <strong class="jxr_keyword">return</strong> 0;
+<a class="jxr_linenumber" name="L4565" href="#L4565">4565</a> <strong class="jxr_keyword">if</strong> (str1 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4566" href="#L4566">4566</a> <strong class="jxr_keyword">return</strong> -1;
+<a class="jxr_linenumber" name="L4567" href="#L4567">4567</a> <strong class="jxr_keyword">if</strong> (str2 == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4568" href="#L4568">4568</a> <strong class="jxr_keyword">return</strong> 1;
+<a class="jxr_linenumber" name="L4569" href="#L4569">4569</a>
+<a class="jxr_linenumber" name="L4570" href="#L4570">4570</a> <strong class="jxr_keyword">var</strong> len1 = str1.length();
+<a class="jxr_linenumber" name="L4571" href="#L4571">4571</a> <strong class="jxr_keyword">var</strong> len2 = str2.length();
+<a class="jxr_linenumber" name="L4572" href="#L4572">4572</a> <strong class="jxr_keyword">var</strong> i1 = 0;
+<a class="jxr_linenumber" name="L4573" href="#L4573">4573</a> <strong class="jxr_keyword">var</strong> i2 = 0;
+<a class="jxr_linenumber" name="L4574" href="#L4574">4574</a>
+<a class="jxr_linenumber" name="L4575" href="#L4575">4575</a> <strong class="jxr_keyword">while</strong> (i1 < len1 && i2 < len2) {
+<a class="jxr_linenumber" name="L4576" href="#L4576">4576</a> <strong class="jxr_keyword">var</strong> c1 = str1.charAt(i1);
+<a class="jxr_linenumber" name="L4577" href="#L4577">4577</a> <strong class="jxr_keyword">var</strong> c2 = str2.charAt(i2);
+<a class="jxr_linenumber" name="L4578" href="#L4578">4578</a>
+<a class="jxr_linenumber" name="L4579" href="#L4579">4579</a> <em class="jxr_comment">// If both are digits, compare numerically</em>
+<a class="jxr_linenumber" name="L4580" href="#L4580">4580</a> <strong class="jxr_keyword">if</strong> (Character.isDigit(c1) && Character.isDigit(c2)) {
+<a class="jxr_linenumber" name="L4581" href="#L4581">4581</a> <em class="jxr_comment">// Skip leading zeros</em>
+<a class="jxr_linenumber" name="L4582" href="#L4582">4582</a> <strong class="jxr_keyword">while</strong> (i1 < len1 && str1.charAt(i1) == '0')
+<a class="jxr_linenumber" name="L4583" href="#L4583">4583</a> i1++;
+<a class="jxr_linenumber" name="L4584" href="#L4584">4584</a> <strong class="jxr_keyword">while</strong> (i2 < len2 && str2.charAt(i2) == '0')
+<a class="jxr_linenumber" name="L4585" href="#L4585">4585</a> i2++;
+<a class="jxr_linenumber" name="L4586" href="#L4586">4586</a>
+<a class="jxr_linenumber" name="L4587" href="#L4587">4587</a> <em class="jxr_comment">// Find end of number sequences</em>
+<a class="jxr_linenumber" name="L4588" href="#L4588">4588</a> <strong class="jxr_keyword">var</strong> end1 = i1;
+<a class="jxr_linenumber" name="L4589" href="#L4589">4589</a> <strong class="jxr_keyword">var</strong> end2 = i2;
+<a class="jxr_linenumber" name="L4590" href="#L4590">4590</a> <strong class="jxr_keyword">while</strong> (end1 < len1 && Character.isDigit(str1.charAt(end1)))
+<a class="jxr_linenumber" name="L4591" href="#L4591">4591</a> end1++;
+<a class="jxr_linenumber" name="L4592" href="#L4592">4592</a> <strong class="jxr_keyword">while</strong> (end2 < len2 && Character.isDigit(str2.charAt(end2)))
+<a class="jxr_linenumber" name="L4593" href="#L4593">4593</a> end2++;
<a class="jxr_linenumber" name="L4594" href="#L4594">4594</a>
-<a class="jxr_linenumber" name="L4595" href="#L4595">4595</a> <em class="jxr_comment">// Same length, compare digit by digit</em>
-<a class="jxr_linenumber" name="L4596" href="#L4596">4596</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 0; j < lenNum1; j++) {
-<a class="jxr_linenumber" name="L4597" href="#L4597">4597</a> <strong class="jxr_keyword">var</strong> d1 = str1.charAt(i1 + j);
-<a class="jxr_linenumber" name="L4598" href="#L4598">4598</a> <strong class="jxr_keyword">var</strong> d2 = str2.charAt(i2 + j);
-<a class="jxr_linenumber" name="L4599" href="#L4599">4599</a> <strong class="jxr_keyword">if</strong> (d1 != d2)
-<a class="jxr_linenumber" name="L4600" href="#L4600">4600</a> <strong class="jxr_keyword">return</strong> d1 - d2;
-<a class="jxr_linenumber" name="L4601" href="#L4601">4601</a> }
-<a class="jxr_linenumber" name="L4602" href="#L4602">4602</a>
-<a class="jxr_linenumber" name="L4603" href="#L4603">4603</a> i1 = end1;
-<a class="jxr_linenumber" name="L4604" href="#L4604">4604</a> i2 = end2;
-<a class="jxr_linenumber" name="L4605" href="#L4605">4605</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L4606" href="#L4606">4606</a> <em class="jxr_comment">// Compare characters (case-insensitive)</em>
-<a class="jxr_linenumber" name="L4607" href="#L4607">4607</a> <strong class="jxr_keyword">var</strong> cmp = Character.toLowerCase(c1) - Character.toLowerCase(c2);
-<a class="jxr_linenumber" name="L4608" href="#L4608">4608</a> <strong class="jxr_keyword">if</strong> (cmp != 0)
-<a class="jxr_linenumber" name="L4609" href="#L4609">4609</a> <strong class="jxr_keyword">return</strong> cmp;
-<a class="jxr_linenumber" name="L4610" href="#L4610">4610</a> i1++;
-<a class="jxr_linenumber" name="L4611" href="#L4611">4611</a> i2++;
-<a class="jxr_linenumber" name="L4612" href="#L4612">4612</a> }
-<a class="jxr_linenumber" name="L4613" href="#L4613">4613</a> }
-<a class="jxr_linenumber" name="L4614" href="#L4614">4614</a>
-<a class="jxr_linenumber" name="L4615" href="#L4615">4615</a> <strong class="jxr_keyword">return</strong> len1 - len2;
-<a class="jxr_linenumber" name="L4616" href="#L4616">4616</a> }
-<a class="jxr_linenumber" name="L4617" href="#L4617">4617</a>
-<a class="jxr_linenumber" name="L4618" href="#L4618">4618</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4619" href="#L4619">4619</a> <em class="jxr_javadoccomment"> * Normalizes Unicode characters in a string.</em>
-<a class="jxr_linenumber" name="L4620" href="#L4620">4620</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4621" href="#L4621">4621</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4622" href="#L4622">4622</a> <em class="jxr_javadoccomment"> * Uses Unicode normalization form NFD (Canonical Decomposition).</em>
-<a class="jxr_linenumber" name="L4623" href="#L4623">4623</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4624" href="#L4624">4624</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4625" href="#L4625">4625</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4626" href="#L4626">4626</a> <em class="jxr_javadoccomment"> * normalizeUnicode(<js>"café"</js>);</em>
-<a class="jxr_linenumber" name="L4627" href="#L4627">4627</a> <em class="jxr_javadoccomment"> * <jc>// Normalized form</jc></em>
-<a class="jxr_linenumber" name="L4628" href="#L4628">4628</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4595" href="#L4595">4595</a> <em class="jxr_comment">// Compare lengths first (longer number is larger)</em>
+<a class="jxr_linenumber" name="L4596" href="#L4596">4596</a> <strong class="jxr_keyword">var</strong> lenNum1 = end1 - i1;
+<a class="jxr_linenumber" name="L4597" href="#L4597">4597</a> <strong class="jxr_keyword">var</strong> lenNum2 = end2 - i2;
+<a class="jxr_linenumber" name="L4598" href="#L4598">4598</a> <strong class="jxr_keyword">if</strong> (lenNum1 != lenNum2)
+<a class="jxr_linenumber" name="L4599" href="#L4599">4599</a> <strong class="jxr_keyword">return</strong> lenNum1 - lenNum2;
+<a class="jxr_linenumber" name="L4600" href="#L4600">4600</a>
+<a class="jxr_linenumber" name="L4601" href="#L4601">4601</a> <em class="jxr_comment">// Same length, compare digit by digit</em>
+<a class="jxr_linenumber" name="L4602" href="#L4602">4602</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> j = 0; j < lenNum1; j++) {
+<a class="jxr_linenumber" name="L4603" href="#L4603">4603</a> <strong class="jxr_keyword">var</strong> d1 = str1.charAt(i1 + j);
+<a class="jxr_linenumber" name="L4604" href="#L4604">4604</a> <strong class="jxr_keyword">var</strong> d2 = str2.charAt(i2 + j);
+<a class="jxr_linenumber" name="L4605" href="#L4605">4605</a> <strong class="jxr_keyword">if</strong> (d1 != d2)
+<a class="jxr_linenumber" name="L4606" href="#L4606">4606</a> <strong class="jxr_keyword">return</strong> d1 - d2;
+<a class="jxr_linenumber" name="L4607" href="#L4607">4607</a> }
+<a class="jxr_linenumber" name="L4608" href="#L4608">4608</a>
+<a class="jxr_linenumber" name="L4609" href="#L4609">4609</a> i1 = end1;
+<a class="jxr_linenumber" name="L4610" href="#L4610">4610</a> i2 = end2;
+<a class="jxr_linenumber" name="L4611" href="#L4611">4611</a> } <strong class="jxr_keyword">else</strong> {
+<a class="jxr_linenumber" name="L4612" href="#L4612">4612</a> <em class="jxr_comment">// Compare characters (case-insensitive)</em>
+<a class="jxr_linenumber" name="L4613" href="#L4613">4613</a> <strong class="jxr_keyword">var</strong> cmp = Character.toLowerCase(c1) - Character.toLowerCase(c2);
+<a class="jxr_linenumber" name="L4614" href="#L4614">4614</a> <strong class="jxr_keyword">if</strong> (cmp != 0)
+<a class="jxr_linenumber" name="L4615" href="#L4615">4615</a> <strong class="jxr_keyword">return</strong> cmp;
+<a class="jxr_linenumber" name="L4616" href="#L4616">4616</a> i1++;
+<a class="jxr_linenumber" name="L4617" href="#L4617">4617</a> i2++;
+<a class="jxr_linenumber" name="L4618" href="#L4618">4618</a> }
+<a class="jxr_linenumber" name="L4619" href="#L4619">4619</a> }
+<a class="jxr_linenumber" name="L4620" href="#L4620">4620</a>
+<a class="jxr_linenumber" name="L4621" href="#L4621">4621</a> <strong class="jxr_keyword">return</strong> len1 - len2;
+<a class="jxr_linenumber" name="L4622" href="#L4622">4622</a> }
+<a class="jxr_linenumber" name="L4623" href="#L4623">4623</a>
+<a class="jxr_linenumber" name="L4624" href="#L4624">4624</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4625" href="#L4625">4625</a> <em class="jxr_javadoccomment"> * Normalizes Unicode characters in a string.</em>
+<a class="jxr_linenumber" name="L4626" href="#L4626">4626</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4627" href="#L4627">4627</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4628" href="#L4628">4628</a> <em class="jxr_javadoccomment"> * Uses Unicode normalization form NFD (Canonical Decomposition).</em>
<a class="jxr_linenumber" name="L4629" href="#L4629">4629</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4630" href="#L4630">4630</a> <em class="jxr_javadoccomment"> * @param str The string to normalize. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4631" href="#L4631">4631</a> <em class="jxr_javadoccomment"> * @return The normalized string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4632" href="#L4632">4632</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4633" href="#L4633">4633</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String normalizeUnicode(String str) {
-<a class="jxr_linenumber" name="L4634" href="#L4634">4634</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4635" href="#L4635">4635</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4636" href="#L4636">4636</a> <strong class="jxr_keyword">return</strong> Normalizer.normalize(str, Normalizer.Form.NFD);
-<a class="jxr_linenumber" name="L4637" href="#L4637">4637</a> }
-<a class="jxr_linenumber" name="L4638" href="#L4638">4638</a>
-<a class="jxr_linenumber" name="L4639" href="#L4639">4639</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4640" href="#L4640">4640</a> <em class="jxr_javadoccomment"> * Normalizes all whitespace in a string to single spaces.</em>
-<a class="jxr_linenumber" name="L4641" href="#L4641">4641</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4642" href="#L4642">4642</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4643" href="#L4643">4643</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4644" href="#L4644">4644</a> <em class="jxr_javadoccomment"> * normalizeWhitespace(<js>"hello \t\n world"</js>); <jc>// "hello world"</jc></em>
-<a class="jxr_linenumber" name="L4645" href="#L4645">4645</a> <em class="jxr_javadoccomment"> * normalizeWhitespace(<js>" hello world "</js>); <jc>// "hello world"</jc></em>
-<a class="jxr_linenumber" name="L4646" href="#L4646">4646</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4630" href="#L4630">4630</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4631" href="#L4631">4631</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4632" href="#L4632">4632</a> <em class="jxr_javadoccomment"> * normalizeUnicode(<js>"café"</js>);</em>
+<a class="jxr_linenumber" name="L4633" href="#L4633">4633</a> <em class="jxr_javadoccomment"> * <jc>// Normalized form</jc></em>
+<a class="jxr_linenumber" name="L4634" href="#L4634">4634</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4635" href="#L4635">4635</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4636" href="#L4636">4636</a> <em class="jxr_javadoccomment"> * @param str The string to normalize. Can be <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4637" href="#L4637">4637</a> <em class="jxr_javadoccomment"> * @return The normalized string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4638" href="#L4638">4638</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4639" href="#L4639">4639</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String normalizeUnicode(String str) {
+<a class="jxr_linenumber" name="L4640" href="#L4640">4640</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4641" href="#L4641">4641</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4642" href="#L4642">4642</a> <strong class="jxr_keyword">return</strong> Normalizer.normalize(str, Normalizer.Form.NFD);
+<a class="jxr_linenumber" name="L4643" href="#L4643">4643</a> }
+<a class="jxr_linenumber" name="L4644" href="#L4644">4644</a>
+<a class="jxr_linenumber" name="L4645" href="#L4645">4645</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4646" href="#L4646">4646</a> <em class="jxr_javadoccomment"> * Normalizes all whitespace in a string to single spaces.</em>
<a class="jxr_linenumber" name="L4647" href="#L4647">4647</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4648" href="#L4648">4648</a> <em class="jxr_javadoccomment"> * @param str The string to normalize.</em>
-<a class="jxr_linenumber" name="L4649" href="#L4649">4649</a> <em class="jxr_javadoccomment"> * @return The normalized string, or <jk>null</jk> if input is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4650" href="#L4650">4650</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4651" href="#L4651">4651</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String normalizeWhitespace(String str) {
-<a class="jxr_linenumber" name="L4652" href="#L4652">4652</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4653" href="#L4653">4653</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4654" href="#L4654">4654</a> <strong class="jxr_keyword">return</strong> str.replaceAll(<span class="jxr_string">"\\s+"</span>, <span class="jxr_string">" "</span>).trim();
-<a class="jxr_linenumber" name="L4655" href="#L4655">4655</a> }
-<a class="jxr_linenumber" name="L4656" href="#L4656">4656</a>
-<a class="jxr_linenumber" name="L4657" href="#L4657">4657</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4658" href="#L4658">4658</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain the specified character.</em>
-<a class="jxr_linenumber" name="L4659" href="#L4659">4659</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4660" href="#L4660">4660</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4661" href="#L4661">4661</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #contains(String, char)}.</em>
-<a class="jxr_linenumber" name="L4662" href="#L4662">4662</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the string is <jk>null</jk> or does not contain the character.</em>
-<a class="jxr_linenumber" name="L4663" href="#L4663">4663</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4664" href="#L4664">4664</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4665" href="#L4665">4665</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4666" href="#L4666">4666</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>'x'</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4667" href="#L4667">4667</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>'o'</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L4668" href="#L4668">4668</a> <em class="jxr_javadoccomment"> * notContains(<jk>null</jk>, <js>'a'</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4669" href="#L4669">4669</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4670" href="#L4670">4670</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4671" href="#L4671">4671</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4672" href="#L4672">4672</a> <em class="jxr_javadoccomment"> * @param c The character to check for.</em>
-<a class="jxr_linenumber" name="L4673" href="#L4673">4673</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain the specified character.</em>
-<a class="jxr_linenumber" name="L4674" href="#L4674">4674</a> <em class="jxr_javadoccomment"> * @see #contains(String, char)</em>
-<a class="jxr_linenumber" name="L4675" href="#L4675">4675</a> <em class="jxr_javadoccomment"> * @see #notContainsAny(String, char...)</em>
-<a class="jxr_linenumber" name="L4676" href="#L4676">4676</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4677" href="#L4677">4677</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContains(String s, <strong class="jxr_keyword">char</strong> c) {
-<a class="jxr_linenumber" name="L4678" href="#L4678">4678</a> <strong class="jxr_keyword">return</strong> ! contains(s, c);
-<a class="jxr_linenumber" name="L4679" href="#L4679">4679</a> }
-<a class="jxr_linenumber" name="L4680" href="#L4680">4680</a>
-<a class="jxr_linenumber" name="L4681" href="#L4681">4681</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4682" href="#L4682">4682</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain the specified substring.</em>
-<a class="jxr_linenumber" name="L4683" href="#L4683">4683</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4684" href="#L4684">4684</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4685" href="#L4685">4685</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #contains(String, CharSequence)}.</em>
-<a class="jxr_linenumber" name="L4686" href="#L4686">4686</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the string is <jk>null</jk> or does not contain the substring.</em>
-<a class="jxr_linenumber" name="L4687" href="#L4687">4687</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4688" href="#L4688">4688</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4689" href="#L4689">4689</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4690" href="#L4690">4690</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>"Foo"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4691" href="#L4691">4691</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>"World"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L4692" href="#L4692">4692</a> <em class="jxr_javadoccomment"> * notContains(<jk>null</jk>, <js>"Hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4693" href="#L4693">4693</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4694" href="#L4694">4694</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4695" href="#L4695">4695</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4696" href="#L4696">4696</a> <em class="jxr_javadoccomment"> * @param substring The substring to check for.</em>
-<a class="jxr_linenumber" name="L4697" href="#L4697">4697</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain the specified substring.</em>
-<a class="jxr_linenumber" name="L4698" href="#L4698">4698</a> <em class="jxr_javadoccomment"> * @see #contains(String, CharSequence)</em>
-<a class="jxr_linenumber" name="L4699" href="#L4699">4699</a> <em class="jxr_javadoccomment"> * @see #notContainsAny(String, CharSequence...)</em>
-<a class="jxr_linenumber" name="L4700" href="#L4700">4700</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4701" href="#L4701">4701</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContains(String s, CharSequence substring) {
-<a class="jxr_linenumber" name="L4702" href="#L4702">4702</a> <strong class="jxr_keyword">return</strong> ! contains(s, substring);
-<a class="jxr_linenumber" name="L4703" href="#L4703">4703</a> }
-<a class="jxr_linenumber" name="L4704" href="#L4704">4704</a>
-<a class="jxr_linenumber" name="L4705" href="#L4705">4705</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4706" href="#L4706">4706</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain the specified substring.</em>
-<a class="jxr_linenumber" name="L4707" href="#L4707">4707</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4708" href="#L4708">4708</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4709" href="#L4709">4709</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #contains(String, String)}.</em>
-<a class="jxr_linenumber" name="L4710" href="#L4710">4710</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the string is <jk>null</jk> or does not contain the substring.</em>
-<a class="jxr_linenumber" name="L4711" href="#L4711">4711</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4712" href="#L4712">4712</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4713" href="#L4713">4713</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4714" href="#L4714">4714</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>"Foo"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4715" href="#L4715">4715</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>"World"</js>); <jc>// false</jc></em>
-<a class="jxr_linenumber" name="L4716" href="#L4716">4716</a> <em class="jxr_javadoccomment"> * notContains(<jk>null</jk>, <js>"Hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4717" href="#L4717">4717</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4718" href="#L4718">4718</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4719" href="#L4719">4719</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4720" href="#L4720">4720</a> <em class="jxr_javadoccomment"> * @param substring The substring to check for.</em>
-<a class="jxr_linenumber" name="L4721" href="#L4721">4721</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain the specified substring.</em>
-<a class="jxr_linenumber" name="L4722" href="#L4722">4722</a> <em class="jxr_javadoccomment"> * @see #contains(String, String)</em>
-<a class="jxr_linenumber" name="L4723" href="#L4723">4723</a> <em class="jxr_javadoccomment"> * @see #notContainsAny(String, String...)</em>
-<a class="jxr_linenumber" name="L4724" href="#L4724">4724</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4725" href="#L4725">4725</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContains(String s, String substring) {
-<a class="jxr_linenumber" name="L4726" href="#L4726">4726</a> <strong class="jxr_keyword">return</strong> ! contains(s, substring);
-<a class="jxr_linenumber" name="L4727" href="#L4727">4727</a> }
-<a class="jxr_linenumber" name="L4728" href="#L4728">4728</a>
-<a class="jxr_linenumber" name="L4729" href="#L4729">4729</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4730" href="#L4730">4730</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain all of the specified characters.</em>
-<a class="jxr_linenumber" name="L4731" href="#L4731">4731</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4732" href="#L4732">4732</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4733" href="#L4733">4733</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #containsAll(String, char...)}.</em>
-<a class="jxr_linenumber" name="L4734" href="#L4734">4734</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if:</em>
-<a class="jxr_linenumber" name="L4735" href="#L4735">4735</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4736" href="#L4736">4736</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L4737" href="#L4737">4737</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L4738" href="#L4738">4738</a> <em class="jxr_javadoccomment"> * <li>Any of the specified characters are not found in the string</li></em>
-<a class="jxr_linenumber" name="L4739" href="#L4739">4739</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4740" href="#L4740">4740</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4741" href="#L4741">4741</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4742" href="#L4742">4742</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4743" href="#L4743">4743</a> <em class="jxr_javadoccomment"> * notContainsAll(<js>"Hello World"</js>, <js>'H'</js>, <js>'x'</js>); <jc>// true (missing 'x')</jc></em>
-<a class="jxr_linenumber" name="L4744" href="#L4744">4744</a> <em class="jxr_javadoccomment"> * notContainsAll(<js>"Hello World"</js>, <js>'H'</js>, <js>'e'</js>, <js>'l'</js>); <jc>// false (contains all)</jc></em>
-<a class="jxr_linenumber" name="L4745" href="#L4745">4745</a> <em class="jxr_javadoccomment"> * notContainsAll(<jk>null</jk>, <js>'a'</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4746" href="#L4746">4746</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4747" href="#L4747">4747</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4748" href="#L4748">4748</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4749" href="#L4749">4749</a> <em class="jxr_javadoccomment"> * @param values The characters to check for.</em>
-<a class="jxr_linenumber" name="L4750" href="#L4750">4750</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain all of the specified characters.</em>
-<a class="jxr_linenumber" name="L4751" href="#L4751">4751</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, char...)</em>
-<a class="jxr_linenumber" name="L4752" href="#L4752">4752</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4753" href="#L4753">4753</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContainsAll(String s, <strong class="jxr_keyword">char</strong>...values) {
-<a class="jxr_linenumber" name="L4754" href="#L4754">4754</a> <strong class="jxr_keyword">return</strong> ! containsAll(s, values);
-<a class="jxr_linenumber" name="L4755" href="#L4755">4755</a> }
-<a class="jxr_linenumber" name="L4756" href="#L4756">4756</a>
-<a class="jxr_linenumber" name="L4757" href="#L4757">4757</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4758" href="#L4758">4758</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain all of the specified substrings.</em>
-<a class="jxr_linenumber" name="L4759" href="#L4759">4759</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4760" href="#L4760">4760</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4761" href="#L4761">4761</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #containsAll(String, CharSequence...)}.</em>
-<a class="jxr_linenumber" name="L4762" href="#L4762">4762</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if:</em>
-<a class="jxr_linenumber" name="L4763" href="#L4763">4763</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4764" href="#L4764">4764</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L4765" href="#L4765">4765</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L4766" href="#L4766">4766</a> <em class="jxr_javadoccomment"> * <li>Any of the specified substrings are not found in the string</li></em>
-<a class="jxr_linenumber" name="L4767" href="#L4767">4767</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4768" href="#L4768">4768</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4769" href="#L4769">4769</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4770" href="#L4770">4770</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4771" href="#L4771">4771</a> <em class="jxr_javadoccomment"> * notContainsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// true (missing "Foo")</jc></em>
-<a class="jxr_linenumber" name="L4772" href="#L4772">4772</a> <em class="jxr_javadoccomment"> * notContainsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"World"</js>); <jc>// false (contains all)</jc></em>
-<a class="jxr_linenumber" name="L4773" href="#L4773">4773</a> <em class="jxr_javadoccomment"> * notContainsAll(<jk>null</jk>, <js>"Hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4774" href="#L4774">4774</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4775" href="#L4775">4775</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4776" href="#L4776">4776</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4777" href="#L4777">4777</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
-<a class="jxr_linenumber" name="L4778" href="#L4778">4778</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain all of the specified substrings.</em>
-<a class="jxr_linenumber" name="L4779" href="#L4779">4779</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, CharSequence...)</em>
-<a class="jxr_linenumber" name="L4780" href="#L4780">4780</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4781" href="#L4781">4781</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContainsAll(String s, CharSequence...values) {
-<a class="jxr_linenumber" name="L4782" href="#L4782">4782</a> <strong class="jxr_keyword">return</strong> ! containsAll(s, values);
-<a class="jxr_linenumber" name="L4783" href="#L4783">4783</a> }
-<a class="jxr_linenumber" name="L4784" href="#L4784">4784</a>
-<a class="jxr_linenumber" name="L4785" href="#L4785">4785</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4786" href="#L4786">4786</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain all of the specified substrings.</em>
-<a class="jxr_linenumber" name="L4787" href="#L4787">4787</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4788" href="#L4788">4788</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4789" href="#L4789">4789</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #containsAll(String, String...)}.</em>
-<a class="jxr_linenumber" name="L4790" href="#L4790">4790</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if:</em>
-<a class="jxr_linenumber" name="L4791" href="#L4791">4791</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4792" href="#L4792">4792</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L4793" href="#L4793">4793</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L4794" href="#L4794">4794</a> <em class="jxr_javadoccomment"> * <li>Any of the specified substrings are not found in the string</li></em>
-<a class="jxr_linenumber" name="L4795" href="#L4795">4795</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4796" href="#L4796">4796</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4797" href="#L4797">4797</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4798" href="#L4798">4798</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4799" href="#L4799">4799</a> <em class="jxr_javadoccomment"> * notContainsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// true (missing "Foo")</jc></em>
-<a class="jxr_linenumber" name="L4800" href="#L4800">4800</a> <em class="jxr_javadoccomment"> * notContainsAll(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"World"</js>); <jc>// false (contains all)</jc></em>
-<a class="jxr_linenumber" name="L4801" href="#L4801">4801</a> <em class="jxr_javadoccomment"> * notContainsAll(<jk>null</jk>, <js>"Hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4802" href="#L4802">4802</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4803" href="#L4803">4803</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4804" href="#L4804">4804</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4805" href="#L4805">4805</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
-<a class="jxr_linenumber" name="L4806" href="#L4806">4806</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain all of the specified substrings.</em>
-<a class="jxr_linenumber" name="L4807" href="#L4807">4807</a> <em class="jxr_javadoccomment"> * @see #containsAll(String, String...)</em>
-<a class="jxr_linenumber" name="L4808" href="#L4808">4808</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4809" href="#L4809">4809</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContainsAll(String s, String...values) {
-<a class="jxr_linenumber" name="L4810" href="#L4810">4810</a> <strong class="jxr_keyword">return</strong> ! containsAll(s, values);
-<a class="jxr_linenumber" name="L4811" href="#L4811">4811</a> }
-<a class="jxr_linenumber" name="L4812" href="#L4812">4812</a>
-<a class="jxr_linenumber" name="L4813" href="#L4813">4813</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4814" href="#L4814">4814</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain any of the specified characters.</em>
-<a class="jxr_linenumber" name="L4815" href="#L4815">4815</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4816" href="#L4816">4816</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4817" href="#L4817">4817</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #containsAny(String, char...)}.</em>
-<a class="jxr_linenumber" name="L4818" href="#L4818">4818</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if:</em>
-<a class="jxr_linenumber" name="L4819" href="#L4819">4819</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4820" href="#L4820">4820</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L4821" href="#L4821">4821</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L4822" href="#L4822">4822</a> <em class="jxr_javadoccomment"> * <li>None of the specified characters are found in the string</li></em>
-<a class="jxr_linenumber" name="L4823" href="#L4823">4823</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4824" href="#L4824">4824</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4825" href="#L4825">4825</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4826" href="#L4826">4826</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4827" href="#L4827">4827</a> <em class="jxr_javadoccomment"> * notContainsAny(<js>"Hello World"</js>, <js>'x'</js>, <js>'y'</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4828" href="#L4828">4828</a> <em class="jxr_javadoccomment"> * notContainsAny(<js>"Hello World"</js>, <js>'o'</js>, <js>'x'</js>); <jc>// false (contains 'o')</jc></em>
-<a class="jxr_linenumber" name="L4829" href="#L4829">4829</a> <em class="jxr_javadoccomment"> * notContainsAny(<jk>null</jk>, <js>'a'</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4830" href="#L4830">4830</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4831" href="#L4831">4831</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4832" href="#L4832">4832</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4833" href="#L4833">4833</a> <em class="jxr_javadoccomment"> * @param values The characters to check for.</em>
-<a class="jxr_linenumber" name="L4834" href="#L4834">4834</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain any of the specified characters.</em>
-<a class="jxr_linenumber" name="L4835" href="#L4835">4835</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, char...)</em>
-<a class="jxr_linenumber" name="L4836" href="#L4836">4836</a> <em class="jxr_javadoccomment"> * @see #notContainsAll(String, char...)</em>
-<a class="jxr_linenumber" name="L4837" href="#L4837">4837</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4838" href="#L4838">4838</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContainsAny(String s, <strong class="jxr_keyword">char</strong>...values) {
-<a class="jxr_linenumber" name="L4839" href="#L4839">4839</a> <strong class="jxr_keyword">return</strong> ! containsAny(s, values);
-<a class="jxr_linenumber" name="L4840" href="#L4840">4840</a> }
-<a class="jxr_linenumber" name="L4841" href="#L4841">4841</a>
-<a class="jxr_linenumber" name="L4842" href="#L4842">4842</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4843" href="#L4843">4843</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain any of the specified substrings.</em>
-<a class="jxr_linenumber" name="L4844" href="#L4844">4844</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4845" href="#L4845">4845</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4846" href="#L4846">4846</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #containsAny(String, CharSequence...)}.</em>
-<a class="jxr_linenumber" name="L4847" href="#L4847">4847</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if:</em>
-<a class="jxr_linenumber" name="L4848" href="#L4848">4848</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4849" href="#L4849">4849</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L4850" href="#L4850">4850</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L4851" href="#L4851">4851</a> <em class="jxr_javadoccomment"> * <li>None of the specified substrings are found in the string</li></em>
-<a class="jxr_linenumber" name="L4852" href="#L4852">4852</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4853" href="#L4853">4853</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4854" href="#L4854">4854</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4855" href="#L4855">4855</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4856" href="#L4856">4856</a> <em class="jxr_javadoccomment"> * notContainsAny(<js>"Hello World"</js>, <js>"Foo"</js>, <js>"Bar"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4857" href="#L4857">4857</a> <em class="jxr_javadoccomment"> * notContainsAny(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// false (contains "Hello")</jc></em>
-<a class="jxr_linenumber" name="L4858" href="#L4858">4858</a> <em class="jxr_javadoccomment"> * notContainsAny(<jk>null</jk>, <js>"Hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4859" href="#L4859">4859</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4860" href="#L4860">4860</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4861" href="#L4861">4861</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4862" href="#L4862">4862</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
-<a class="jxr_linenumber" name="L4863" href="#L4863">4863</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain any of the specified substrings.</em>
-<a class="jxr_linenumber" name="L4864" href="#L4864">4864</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, CharSequence...)</em>
-<a class="jxr_linenumber" name="L4865" href="#L4865">4865</a> <em class="jxr_javadoccomment"> * @see #notContainsAll(String, CharSequence...)</em>
-<a class="jxr_linenumber" name="L4866" href="#L4866">4866</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4867" href="#L4867">4867</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContainsAny(String s, CharSequence...values) {
-<a class="jxr_linenumber" name="L4868" href="#L4868">4868</a> <strong class="jxr_keyword">return</strong> ! containsAny(s, values);
-<a class="jxr_linenumber" name="L4869" href="#L4869">4869</a> }
-<a class="jxr_linenumber" name="L4870" href="#L4870">4870</a>
-<a class="jxr_linenumber" name="L4871" href="#L4871">4871</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4872" href="#L4872">4872</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain any of the specified substrings.</em>
-<a class="jxr_linenumber" name="L4873" href="#L4873">4873</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4874" href="#L4874">4874</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4875" href="#L4875">4875</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #containsAny(String, String...)}.</em>
-<a class="jxr_linenumber" name="L4876" href="#L4876">4876</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if:</em>
-<a class="jxr_linenumber" name="L4877" href="#L4877">4877</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4878" href="#L4878">4878</a> <em class="jxr_javadoccomment"> * <li>The string is <jk>null</jk></li></em>
-<a class="jxr_linenumber" name="L4879" href="#L4879">4879</a> <em class="jxr_javadoccomment"> * <li>The values array is <jk>null</jk> or empty</li></em>
-<a class="jxr_linenumber" name="L4880" href="#L4880">4880</a> <em class="jxr_javadoccomment"> * <li>None of the specified substrings are found in the string</li></em>
-<a class="jxr_linenumber" name="L4881" href="#L4881">4881</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4882" href="#L4882">4882</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4883" href="#L4883">4883</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4884" href="#L4884">4884</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4885" href="#L4885">4885</a> <em class="jxr_javadoccomment"> * notContainsAny(<js>"Hello World"</js>, <js>"Foo"</js>, <js>"Bar"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4886" href="#L4886">4886</a> <em class="jxr_javadoccomment"> * notContainsAny(<js>"Hello World"</js>, <js>"Hello"</js>, <js>"Foo"</js>); <jc>// false (contains "Hello")</jc></em>
-<a class="jxr_linenumber" name="L4887" href="#L4887">4887</a> <em class="jxr_javadoccomment"> * notContainsAny(<jk>null</jk>, <js>"Hello"</js>); <jc>// true</jc></em>
-<a class="jxr_linenumber" name="L4888" href="#L4888">4888</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4889" href="#L4889">4889</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4890" href="#L4890">4890</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
-<a class="jxr_linenumber" name="L4891" href="#L4891">4891</a> <em class="jxr_javadoccomment"> * @param values The substrings to check for.</em>
-<a class="jxr_linenumber" name="L4892" href="#L4892">4892</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain any of the specified substrings.</em>
-<a class="jxr_linenumber" name="L4893" href="#L4893">4893</a> <em class="jxr_javadoccomment"> * @see #containsAny(String, String...)</em>
-<a class="jxr_linenumber" name="L4894" href="#L4894">4894</a> <em class="jxr_javadoccomment"> * @see #notContainsAll(String, String...)</em>
-<a class="jxr_linenumber" name="L4895" href="#L4895">4895</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4896" href="#L4896">4896</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContainsAny(String s, String...values) {
-<a class="jxr_linenumber" name="L4897" href="#L4897">4897</a> <strong class="jxr_keyword">return</strong> ! containsAny(s, values);
-<a class="jxr_linenumber" name="L4898" href="#L4898">4898</a> }
-<a class="jxr_linenumber" name="L4899" href="#L4899">4899</a>
-<a class="jxr_linenumber" name="L4900" href="#L4900">4900</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4901" href="#L4901">4901</a> <em class="jxr_javadoccomment"> * Returns the specified string, or <jk>null</jk> if that string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L4902" href="#L4902">4902</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4903" href="#L4903">4903</a> <em class="jxr_javadoccomment"> * @param value The string value to check.</em>
-<a class="jxr_linenumber" name="L4904" href="#L4904">4904</a> <em class="jxr_javadoccomment"> * @return The string value, or <jk>null</jk> if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L4905" href="#L4905">4905</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4906" href="#L4906">4906</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String nullIfEmpty(String value) {
-<a class="jxr_linenumber" name="L4907" href="#L4907">4907</a> <strong class="jxr_keyword">return</strong> isEmpty(value) ? <strong class="jxr_keyword">null</strong> : value;
-<a class="jxr_linenumber" name="L4908" href="#L4908">4908</a> }
-<a class="jxr_linenumber" name="L4909" href="#L4909">4909</a>
-<a class="jxr_linenumber" name="L4910" href="#L4910">4910</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4911" href="#L4911">4911</a> <em class="jxr_javadoccomment"> * Returns an obfuscated version of the specified string.</em>
-<a class="jxr_linenumber" name="L4912" href="#L4912">4912</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4913" href="#L4913">4913</a> <em class="jxr_javadoccomment"> * @param s The string to obfuscate.</em>
-<a class="jxr_linenumber" name="L4914" href="#L4914">4914</a> <em class="jxr_javadoccomment"> * @return The obfuscated string with most characters replaced by asterisks.</em>
-<a class="jxr_linenumber" name="L4915" href="#L4915">4915</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4916" href="#L4916">4916</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String obfuscate(String s) {
-<a class="jxr_linenumber" name="L4917" href="#L4917">4917</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong> || s.length() < 2)
-<a class="jxr_linenumber" name="L4918" href="#L4918">4918</a> <strong class="jxr_keyword">return</strong> <span class="jxr_string">"*"</span>;
-<a class="jxr_linenumber" name="L4919" href="#L4919">4919</a> <strong class="jxr_keyword">return</strong> s.substring(0, 1) + s.substring(1).replaceAll(<span class="jxr_string">"."</span>, <span class="jxr_string">"*"</span>); <em class="jxr_comment">// NOSONAR</em>
-<a class="jxr_linenumber" name="L4920" href="#L4920">4920</a> }
-<a class="jxr_linenumber" name="L4921" href="#L4921">4921</a>
-<a class="jxr_linenumber" name="L4922" href="#L4922">4922</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L4923" href="#L4923">4923</a> <em class="jxr_comment">// String validation methods</em>
-<a class="jxr_linenumber" name="L4924" href="#L4924">4924</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L4925" href="#L4925">4925</a>
-<a class="jxr_linenumber" name="L4926" href="#L4926">4926</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4927" href="#L4927">4927</a> <em class="jxr_javadoccomment"> * Provides optimization suggestions for a string based on its characteristics.</em>
-<a class="jxr_linenumber" name="L4928" href="#L4928">4928</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4929" href="#L4929">4929</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L4930" href="#L4930">4930</a> <em class="jxr_javadoccomment"> * Returns <jk>null</jk> if the input string is <jk>null</jk> or if no optimizations are suggested.</em>
-<a class="jxr_linenumber" name="L4931" href="#L4931">4931</a> <em class="jxr_javadoccomment"> * Returns a string containing optimization suggestions separated by newlines.</em>
-<a class="jxr_linenumber" name="L4932" href="#L4932">4932</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4933" href="#L4933">4933</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Optimization Suggestions:</h5></em>
-<a class="jxr_linenumber" name="L4934" href="#L4934">4934</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L4935" href="#L4935">4935</a> <em class="jxr_javadoccomment"> * <li><b>Large strings:</b> Suggests using StringBuilder for concatenation</li></em>
-<a class="jxr_linenumber" name="L4936" href="#L4936">4936</a> <em class="jxr_javadoccomment"> * <li><b>Frequently used strings:</b> Suggests interning</li></em>
-<a class="jxr_linenumber" name="L4937" href="#L4937">4937</a> <em class="jxr_javadoccomment"> * <li><b>Character manipulation:</b> Suggests using char[] for intensive operations</li></em>
-<a class="jxr_linenumber" name="L4938" href="#L4938">4938</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L4939" href="#L4939">4939</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4940" href="#L4940">4940</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Examples:</h5></em>
-<a class="jxr_linenumber" name="L4941" href="#L4941">4941</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4942" href="#L4942">4942</a> <em class="jxr_javadoccomment"> * optimizeString(<jk>null</jk>); <jc>// Returns: null</jc></em>
-<a class="jxr_linenumber" name="L4943" href="#L4943">4943</a> <em class="jxr_javadoccomment"> * optimizeString(<js>"short"</js>); <jc>// Returns: null (no suggestions)</jc></em>
-<a class="jxr_linenumber" name="L4944" href="#L4944">4944</a> <em class="jxr_javadoccomment"> * optimizeString(<js>"very long string..."</js>); <jc>// Returns: suggestions for large strings</jc></em>
-<a class="jxr_linenumber" name="L4945" href="#L4945">4945</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4946" href="#L4946">4946</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4947" href="#L4947">4947</a> <em class="jxr_javadoccomment"> * @param str The string to analyze. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4948" href="#L4948">4948</a> <em class="jxr_javadoccomment"> * @return A string with optimization suggestions, or <jk>null</jk> if no suggestions or input was <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L4949" href="#L4949">4949</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4950" href="#L4950">4950</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String optimizeString(String str) {
-<a class="jxr_linenumber" name="L4951" href="#L4951">4951</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L4952" href="#L4952">4952</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L4953" href="#L4953">4953</a>
-<a class="jxr_linenumber" name="L4954" href="#L4954">4954</a> <strong class="jxr_keyword">var</strong> suggestions = <strong class="jxr_keyword">new</strong> ArrayList<String>();
-<a class="jxr_linenumber" name="L4955" href="#L4955">4955</a> <strong class="jxr_keyword">var</strong> length = str.length();
-<a class="jxr_linenumber" name="L4956" href="#L4956">4956</a>
-<a class="jxr_linenumber" name="L4957" href="#L4957">4957</a> <em class="jxr_comment">// Suggest StringBuilder for large strings or frequent concatenation scenarios</em>
-<a class="jxr_linenumber" name="L4958" href="#L4958">4958</a> <strong class="jxr_keyword">if</strong> (length > 1000) {
-<a class="jxr_linenumber" name="L4959" href="#L4959">4959</a> suggestions.add(<span class="jxr_string">"Consider using StringBuilder for concatenation operations"</span>);
-<a class="jxr_linenumber" name="L4960" href="#L4960">4960</a> }
-<a class="jxr_linenumber" name="L4961" href="#L4961">4961</a>
-<a class="jxr_linenumber" name="L4962" href="#L4962">4962</a> <em class="jxr_comment">// Suggest interning for medium-length strings that might be repeated</em>
-<a class="jxr_linenumber" name="L4963" href="#L4963">4963</a> <strong class="jxr_keyword">if</strong> (length > 10 && length < 100 && ! isInterned(str)) {
-<a class="jxr_linenumber" name="L4964" href="#L4964">4964</a> suggestions.add(<span class="jxr_string">"Consider interning if this string is used frequently"</span>);
-<a class="jxr_linenumber" name="L4965" href="#L4965">4965</a> }
-<a class="jxr_linenumber" name="L4966" href="#L4966">4966</a>
-<a class="jxr_linenumber" name="L4967" href="#L4967">4967</a> <em class="jxr_comment">// Suggest char[] for intensive character manipulation</em>
-<a class="jxr_linenumber" name="L4968" href="#L4968">4968</a> <strong class="jxr_keyword">if</strong> (length > 100) {
-<a class="jxr_linenumber" name="L4969" href="#L4969">4969</a> suggestions.add(<span class="jxr_string">"For intensive character manipulation, consider using char[]"</span>);
-<a class="jxr_linenumber" name="L4970" href="#L4970">4970</a> }
-<a class="jxr_linenumber" name="L4971" href="#L4971">4971</a>
-<a class="jxr_linenumber" name="L4972" href="#L4972">4972</a> <em class="jxr_comment">// Suggest compression for very large strings</em>
-<a class="jxr_linenumber" name="L4973" href="#L4973">4973</a> <strong class="jxr_keyword">if</strong> (length > 10000) {
-<a class="jxr_linenumber" name="L4974" href="#L4974">4974</a> suggestions.add(<span class="jxr_string">"For very large strings, consider compression if storage is a concern"</span>);
-<a class="jxr_linenumber" name="L4975" href="#L4975">4975</a> }
-<a class="jxr_linenumber" name="L4976" href="#L4976">4976</a>
-<a class="jxr_linenumber" name="L4977" href="#L4977">4977</a> <strong class="jxr_keyword">return</strong> suggestions.isEmpty() ? <strong class="jxr_keyword">null</strong> : String.join(NEWLINE, suggestions);
-<a class="jxr_linenumber" name="L4978" href="#L4978">4978</a> }
-<a class="jxr_linenumber" name="L4979" href="#L4979">4979</a>
-<a class="jxr_linenumber" name="L4980" href="#L4980">4980</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L4981" href="#L4981">4981</a> <em class="jxr_javadoccomment"> * Converts a number to its ordinal form (1st, 2nd, 3rd, 4th, etc.).</em>
-<a class="jxr_linenumber" name="L4982" href="#L4982">4982</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4983" href="#L4983">4983</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L4984" href="#L4984">4984</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L4985" href="#L4985">4985</a> <em class="jxr_javadoccomment"> * ordinal(<js>1</js>); <jc>// "1st"</jc></em>
-<a class="jxr_linenumber" name="L4986" href="#L4986">4986</a> <em class="jxr_javadoccomment"> * ordinal(<js>2</js>); <jc>// "2nd"</jc></em>
-<a class="jxr_linenumber" name="L4987" href="#L4987">4987</a> <em class="jxr_javadoccomment"> * ordinal(<js>3</js>); <jc>// "3rd"</jc></em>
-<a class="jxr_linenumber" name="L4988" href="#L4988">4988</a> <em class="jxr_javadoccomment"> * ordinal(<js>4</js>); <jc>// "4th"</jc></em>
-<a class="jxr_linenumber" name="L4989" href="#L4989">4989</a> <em class="jxr_javadoccomment"> * ordinal(<js>11</js>); <jc>// "11th"</jc></em>
-<a class="jxr_linenumber" name="L4990" href="#L4990">4990</a> <em class="jxr_javadoccomment"> * ordinal(<js>21</js>); <jc>// "21st"</jc></em>
-<a class="jxr_linenumber" name="L4991" href="#L4991">4991</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L4992" href="#L4992">4992</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L4993" href="#L4993">4993</a> <em class="jxr_javadoccomment"> * @param number The number to convert.</em>
-<a class="jxr_linenumber" name="L4994" href="#L4994">4994</a> <em class="jxr_javadoccomment"> * @return The ordinal string representation of the number.</em>
-<a class="jxr_linenumber" name="L4995" href="#L4995">4995</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L4996" href="#L4996">4996</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String ordinal(<strong class="jxr_keyword">int</strong> number) {
-<a class="jxr_linenumber" name="L4997" href="#L4997">4997</a> <strong class="jxr_keyword">var</strong> abs = Math.abs(number);
-<a class="jxr_linenumber" name="L4998" href="#L4998">4998</a> <strong class="jxr_keyword">var</strong> suffix = <span class="jxr_string">"th"</span>;
-<a class="jxr_linenumber" name="L4999" href="#L4999">4999</a>
-<a class="jxr_linenumber" name="L5000" href="#L5000">5000</a> <em class="jxr_comment">// Special cases for 11, 12, 13 (all use "th")</em>
-<a class="jxr_linenumber" name="L5001" href="#L5001">5001</a> <strong class="jxr_keyword">if</strong> (abs % 100 != 11 && abs % 100 != 12 && abs % 100 != 13) {
-<a class="jxr_linenumber" name="L5002" href="#L5002">5002</a> <strong class="jxr_keyword">var</strong> lastDigit = abs % 10;
-<a class="jxr_linenumber" name="L5003" href="#L5003">5003</a> <strong class="jxr_keyword">if</strong> (lastDigit == 1)
-<a class="jxr_linenumber" name="L5004" href="#L5004">5004</a> suffix = <span class="jxr_string">"st"</span>;
-<a class="jxr_linenumber" name="L5005" href="#L5005">5005</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (lastDigit == 2)
-<a class="jxr_linenumber" name="L5006" href="#L5006">5006</a> suffix = <span class="jxr_string">"nd"</span>;
-<a class="jxr_linenumber" name="L5007" href="#L5007">5007</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (lastDigit == 3)
-<a class="jxr_linenumber" name="L5008" href="#L5008">5008</a> suffix = <span class="jxr_string">"rd"</span>;
-<a class="jxr_linenumber" name="L5009" href="#L5009">5009</a> }
-<a class="jxr_linenumber" name="L5010" href="#L5010">5010</a>
-<a class="jxr_linenumber" name="L5011" href="#L5011">5011</a> <strong class="jxr_keyword">return</strong> number + suffix;
-<a class="jxr_linenumber" name="L5012" href="#L5012">5012</a> }
-<a class="jxr_linenumber" name="L5013" href="#L5013">5013</a>
-<a class="jxr_linenumber" name="L5014" href="#L5014">5014</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5015" href="#L5015">5015</a> <em class="jxr_javadoccomment"> * Center pads a string with a specified character.</em>
-<a class="jxr_linenumber" name="L5016" href="#L5016">5016</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5017" href="#L5017">5017</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5018" href="#L5018">5018</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5019" href="#L5019">5019</a> <em class="jxr_javadoccomment"> * padCenter(<jk>null</jk>, 5, <js>' '</js>); <jc>// " "</jc></em>
-<a class="jxr_linenumber" name="L5020" href="#L5020">5020</a> <em class="jxr_javadoccomment"> * padCenter(<js>""</js>, 5, <js>' '</js>); <jc>// " "</jc></em>
-<a class="jxr_linenumber" name="L5021" href="#L5021">5021</a> <em class="jxr_javadoccomment"> * padCenter(<js>"hi"</js>, 6, <js>' '</js>); <jc>// " hi "</jc></em>
-<a class="jxr_linenumber" name="L5022" href="#L5022">5022</a> <em class="jxr_javadoccomment"> * padCenter(<js>"hi"</js>, 7, <js>' '</js>); <jc>// " hi "</jc></em>
-<a class="jxr_linenumber" name="L5023" href="#L5023">5023</a> <em class="jxr_javadoccomment"> * padCenter(<js>"hello"</js>, 3, <js>' '</js>); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L5024" href="#L5024">5024</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5025" href="#L5025">5025</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5026" href="#L5026">5026</a> <em class="jxr_javadoccomment"> * @param str The string to pad.</em>
-<a class="jxr_linenumber" name="L5027" href="#L5027">5027</a> <em class="jxr_javadoccomment"> * @param size The desired total string length.</em>
-<a class="jxr_linenumber" name="L5028" href="#L5028">5028</a> <em class="jxr_javadoccomment"> * @param padChar The character to pad with.</em>
-<a class="jxr_linenumber" name="L5029" href="#L5029">5029</a> <em class="jxr_javadoccomment"> * @return The center-padded string.</em>
-<a class="jxr_linenumber" name="L5030" href="#L5030">5030</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5031" href="#L5031">5031</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String padCenter(String str, <strong class="jxr_keyword">int</strong> size, <strong class="jxr_keyword">char</strong> padChar) {
-<a class="jxr_linenumber" name="L5032" href="#L5032">5032</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5033" href="#L5033">5033</a> str = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L5034" href="#L5034">5034</a> <strong class="jxr_keyword">int</strong> pads = size - str.length();
-<a class="jxr_linenumber" name="L5035" href="#L5035">5035</a> <strong class="jxr_keyword">if</strong> (pads <= 0)
-<a class="jxr_linenumber" name="L5036" href="#L5036">5036</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L5037" href="#L5037">5037</a> <strong class="jxr_keyword">int</strong> rightPads = pads / 2;
-<a class="jxr_linenumber" name="L5038" href="#L5038">5038</a> <strong class="jxr_keyword">int</strong> leftPads = pads - rightPads;
-<a class="jxr_linenumber" name="L5039" href="#L5039">5039</a> <strong class="jxr_keyword">return</strong> String.valueOf(padChar).repeat(leftPads) + str + String.valueOf(padChar).repeat(rightPads);
-<a class="jxr_linenumber" name="L5040" href="#L5040">5040</a> }
-<a class="jxr_linenumber" name="L5041" href="#L5041">5041</a>
-<a class="jxr_linenumber" name="L5042" href="#L5042">5042</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5043" href="#L5043">5043</a> <em class="jxr_javadoccomment"> * Left pads a string with a specified character.</em>
-<a class="jxr_linenumber" name="L5044" href="#L5044">5044</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5045" href="#L5045">5045</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5046" href="#L5046">5046</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5047" href="#L5047">5047</a> <em class="jxr_javadoccomment"> * padLeft(<jk>null</jk>, 5, <js>' '</js>); <jc>// " "</jc></em>
-<a class="jxr_linenumber" name="L5048" href="#L5048">5048</a> <em class="jxr_javadoccomment"> * padLeft(<js>""</js>, 5, <js>' '</js>); <jc>// " "</jc></em>
-<a class="jxr_linenumber" name="L5049" href="#L5049">5049</a> <em class="jxr_javadoccomment"> * padLeft(<js>"hello"</js>, 8, <js>' '</js>); <jc>// " hello"</jc></em>
-<a class="jxr_linenumber" name="L5050" href="#L5050">5050</a> <em class="jxr_javadoccomment"> * padLeft(<js>"hello"</js>, 3, <js>' '</js>); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L5051" href="#L5051">5051</a> <em class="jxr_javadoccomment"> * padLeft(<js>"123"</js>, 5, <js>'0'</js>); <jc>// "00123"</jc></em>
-<a class="jxr_linenumber" name="L5052" href="#L5052">5052</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5053" href="#L5053">5053</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5054" href="#L5054">5054</a> <em class="jxr_javadoccomment"> * @param str The string to pad.</em>
-<a class="jxr_linenumber" name="L5055" href="#L5055">5055</a> <em class="jxr_javadoccomment"> * @param size The desired total string length.</em>
-<a class="jxr_linenumber" name="L5056" href="#L5056">5056</a> <em class="jxr_javadoccomment"> * @param padChar The character to pad with.</em>
-<a class="jxr_linenumber" name="L5057" href="#L5057">5057</a> <em class="jxr_javadoccomment"> * @return The left-padded string.</em>
-<a class="jxr_linenumber" name="L5058" href="#L5058">5058</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5059" href="#L5059">5059</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String padLeft(String str, <strong class="jxr_keyword">int</strong> size, <strong class="jxr_keyword">char</strong> padChar) {
-<a class="jxr_linenumber" name="L5060" href="#L5060">5060</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5061" href="#L5061">5061</a> str = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L5062" href="#L5062">5062</a> <strong class="jxr_keyword">int</strong> pads = size - str.length();
-<a class="jxr_linenumber" name="L5063" href="#L5063">5063</a> <strong class="jxr_keyword">if</strong> (pads <= 0)
-<a class="jxr_linenumber" name="L5064" href="#L5064">5064</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L5065" href="#L5065">5065</a> <strong class="jxr_keyword">return</strong> String.valueOf(padChar).repeat(pads) + str;
-<a class="jxr_linenumber" name="L5066" href="#L5066">5066</a> }
-<a class="jxr_linenumber" name="L5067" href="#L5067">5067</a>
-<a class="jxr_linenumber" name="L5068" href="#L5068">5068</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5069" href="#L5069">5069</a> <em class="jxr_javadoccomment"> * Right pads a string with a specified character.</em>
-<a class="jxr_linenumber" name="L5070" href="#L5070">5070</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5071" href="#L5071">5071</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5072" href="#L5072">5072</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5073" href="#L5073">5073</a> <em class="jxr_javadoccomment"> * padRight(<jk>null</jk>, 5, <js>' '</js>); <jc>// " "</jc></em>
-<a class="jxr_linenumber" name="L5074" href="#L5074">5074</a> <em class="jxr_javadoccomment"> * padRight(<js>""</js>, 5, <js>' '</js>); <jc>// " "</jc></em>
-<a class="jxr_linenumber" name="L5075" href="#L5075">5075</a> <em class="jxr_javadoccomment"> * padRight(<js>"hello"</js>, 8, <js>' '</js>); <jc>// "hello "</jc></em>
-<a class="jxr_linenumber" name="L5076" href="#L5076">5076</a> <em class="jxr_javadoccomment"> * padRight(<js>"hello"</js>, 3, <js>' '</js>); <jc>// "hello"</jc></em>
-<a class="jxr_linenumber" name="L5077" href="#L5077">5077</a> <em class="jxr_javadoccomment"> * padRight(<js>"123"</js>, 5, <js>'0'</js>); <jc>// "12300"</jc></em>
-<a class="jxr_linenumber" name="L5078" href="#L5078">5078</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5079" href="#L5079">5079</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5080" href="#L5080">5080</a> <em class="jxr_javadoccomment"> * @param str The string to pad.</em>
-<a class="jxr_linenumber" name="L5081" href="#L5081">5081</a> <em class="jxr_javadoccomment"> * @param size The desired total string length.</em>
-<a class="jxr_linenumber" name="L5082" href="#L5082">5082</a> <em class="jxr_javadoccomment"> * @param padChar The character to pad with.</em>
-<a class="jxr_linenumber" name="L5083" href="#L5083">5083</a> <em class="jxr_javadoccomment"> * @return The right-padded string.</em>
-<a class="jxr_linenumber" name="L5084" href="#L5084">5084</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5085" href="#L5085">5085</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String padRight(String str, <strong class="jxr_keyword">int</strong> size, <strong class="jxr_keyword">char</strong> padChar) {
-<a class="jxr_linenumber" name="L5086" href="#L5086">5086</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5087" href="#L5087">5087</a> str = <span class="jxr_string">""</span>;
-<a class="jxr_linenumber" name="L5088" href="#L5088">5088</a> <strong class="jxr_keyword">int</strong> pads = size - str.length();
-<a class="jxr_linenumber" name="L5089" href="#L5089">5089</a> <strong class="jxr_keyword">if</strong> (pads <= 0)
-<a class="jxr_linenumber" name="L5090" href="#L5090">5090</a> <strong class="jxr_keyword">return</strong> str;
-<a class="jxr_linenumber" name="L5091" href="#L5091">5091</a> <strong class="jxr_keyword">return</strong> str + String.valueOf(padChar).repeat(pads);
-<a class="jxr_linenumber" name="L5092" href="#L5092">5092</a> }
-<a class="jxr_linenumber" name="L5093" href="#L5093">5093</a>
-<a class="jxr_linenumber" name="L5094" href="#L5094">5094</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5095" href="#L5095">5095</a> <em class="jxr_javadoccomment"> * Converts a <c>String</c> to a <c>Character</c></em>
-<a class="jxr_linenumber" name="L5096" href="#L5096">5096</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5097" href="#L5097">5097</a> <em class="jxr_javadoccomment"> * @param o The string to convert.</em>
-<a class="jxr_linenumber" name="L5098" href="#L5098">5098</a> <em class="jxr_javadoccomment"> * @return The first character of the string if the string is of length 1, or <jk>null</jk> if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5099" href="#L5099">5099</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException If the string length is not 1.</em>
-<a class="jxr_linenumber" name="L5100" href="#L5100">5100</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5101" href="#L5101">5101</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Character parseCharacter(Object o) {
-<a class="jxr_linenumber" name="L5102" href="#L5102">5102</a> <strong class="jxr_keyword">if</strong> (o == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5103" href="#L5103">5103</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5104" href="#L5104">5104</a> <strong class="jxr_keyword">var</strong> s = o.toString();
-<a class="jxr_linenumber" name="L5105" href="#L5105">5105</a> <strong class="jxr_keyword">if</strong> (s.isEmpty())
-<a class="jxr_linenumber" name="L5106" href="#L5106">5106</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5107" href="#L5107">5107</a> <strong class="jxr_keyword">if</strong> (s.length() == 1)
-<a class="jxr_linenumber" name="L5108" href="#L5108">5108</a> <strong class="jxr_keyword">return</strong> s.charAt(0);
-<a class="jxr_linenumber" name="L5109" href="#L5109">5109</a> <strong class="jxr_keyword">throw</strong> illegalArg(<span class="jxr_string">"Invalid character: ''{0}''"</span>, s);
-<a class="jxr_linenumber" name="L5110" href="#L5110">5110</a> }
-<a class="jxr_linenumber" name="L5111" href="#L5111">5111</a>
-<a class="jxr_linenumber" name="L5112" href="#L5112">5112</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5113" href="#L5113">5113</a> <em class="jxr_javadoccomment"> * Same as {@link Float#parseFloat(String)} but removes any underscore characters first.</em>
-<a class="jxr_linenumber" name="L5114" href="#L5114">5114</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5115" href="#L5115">5115</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000.5"</js>).</em>
-<a class="jxr_linenumber" name="L5116" href="#L5116">5116</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5117" href="#L5117">5117</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
-<a class="jxr_linenumber" name="L5118" href="#L5118">5118</a> <em class="jxr_javadoccomment"> * @return The parsed float value.</em>
-<a class="jxr_linenumber" name="L5119" href="#L5119">5119</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
-<a class="jxr_linenumber" name="L5120" href="#L5120">5120</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5121" href="#L5121">5121</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5122" href="#L5122">5122</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">float</strong> parseFloat(String value) {
-<a class="jxr_linenumber" name="L5123" href="#L5123">5123</a> <strong class="jxr_keyword">return</strong> Float.parseFloat(StringUtils.removeUnderscores(value));
-<a class="jxr_linenumber" name="L5124" href="#L5124">5124</a> }
-<a class="jxr_linenumber" name="L5125" href="#L5125">5125</a>
-<a class="jxr_linenumber" name="L5126" href="#L5126">5126</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5127" href="#L5127">5127</a> <em class="jxr_javadoccomment"> * Same as {@link Integer#parseInt(String)} but removes any underscore characters first.</em>
-<a class="jxr_linenumber" name="L5128" href="#L5128">5128</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5129" href="#L5129">5129</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000_000"</js>).</em>
-<a class="jxr_linenumber" name="L5130" href="#L5130">5130</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5131" href="#L5131">5131</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
-<a class="jxr_linenumber" name="L5132" href="#L5132">5132</a> <em class="jxr_javadoccomment"> * @return The parsed integer value.</em>
-<a class="jxr_linenumber" name="L5133" href="#L5133">5133</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
-<a class="jxr_linenumber" name="L5134" href="#L5134">5134</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5135" href="#L5135">5135</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5136" href="#L5136">5136</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> parseInt(String value) {
-<a class="jxr_linenumber" name="L5137" href="#L5137">5137</a> <strong class="jxr_keyword">return</strong> Integer.parseInt(StringUtils.removeUnderscores(value));
-<a class="jxr_linenumber" name="L5138" href="#L5138">5138</a> }
-<a class="jxr_linenumber" name="L5139" href="#L5139">5139</a>
-<a class="jxr_linenumber" name="L5140" href="#L5140">5140</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5141" href="#L5141">5141</a> <em class="jxr_javadoccomment"> * Converts a string containing a possible multiplier suffix to an integer.</em>
-<a class="jxr_linenumber" name="L5142" href="#L5142">5142</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5143" href="#L5143">5143</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5144" href="#L5144">5144</a> <em class="jxr_javadoccomment"> * The string can contain any of the following multiplier suffixes:</em>
-<a class="jxr_linenumber" name="L5145" href="#L5145">5145</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L5146" href="#L5146">5146</a> <em class="jxr_javadoccomment"> * <li><js>"K"</js> - x 1024</em>
-<a class="jxr_linenumber" name="L5147" href="#L5147">5147</a> <em class="jxr_javadoccomment"> * <li><js>"M"</js> - x 1024*1024</em>
-<a class="jxr_linenumber" name="L5148" href="#L5148">5148</a> <em class="jxr_javadoccomment"> * <li><js>"G"</js> - x 1024*1024*1024</em>
-<a class="jxr_linenumber" name="L5149" href="#L5149">5149</a> <em class="jxr_javadoccomment"> * <li><js>"k"</js> - x 1000</em>
-<a class="jxr_linenumber" name="L5150" href="#L5150">5150</a> <em class="jxr_javadoccomment"> * <li><js>"m"</js> - x 1000*1000</em>
-<a class="jxr_linenumber" name="L5151" href="#L5151">5151</a> <em class="jxr_javadoccomment"> * <li><js>"g"</js> - x 1000*1000*1000</em>
-<a class="jxr_linenumber" name="L5152" href="#L5152">5152</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L5153" href="#L5153">5153</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5154" href="#L5154">5154</a> <em class="jxr_javadoccomment"> * @param s The string to parse.</em>
-<a class="jxr_linenumber" name="L5155" href="#L5155">5155</a> <em class="jxr_javadoccomment"> * @return The parsed value.</em>
-<a class="jxr_linenumber" name="L5156" href="#L5156">5156</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5157" href="#L5157">5157</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">int</strong> parseIntWithSuffix(String s) {
-<a class="jxr_linenumber" name="L5158" href="#L5158">5158</a> assertArgNotNull(<span class="jxr_string">"s"</span>, s);
-<a class="jxr_linenumber" name="L5159" href="#L5159">5159</a> <strong class="jxr_keyword">var</strong> m = multiplierInt(s);
-<a class="jxr_linenumber" name="L5160" href="#L5160">5160</a> <strong class="jxr_keyword">if</strong> (m == 1)
-<a class="jxr_linenumber" name="L5161" href="#L5161">5161</a> <strong class="jxr_keyword">return</strong> Integer.decode(s);
-<a class="jxr_linenumber" name="L5162" href="#L5162">5162</a> <strong class="jxr_keyword">return</strong> Integer.decode(s.substring(0, s.length() - 1).trim()) * m; <em class="jxr_comment">// NOSONAR - NPE not possible here.</em>
-<a class="jxr_linenumber" name="L5163" href="#L5163">5163</a> }
-<a class="jxr_linenumber" name="L5164" href="#L5164">5164</a>
-<a class="jxr_linenumber" name="L5165" href="#L5165">5165</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L5166" href="#L5166">5166</a> <em class="jxr_comment">// String manipulation methods</em>
-<a class="jxr_linenumber" name="L5167" href="#L5167">5167</a> <em class="jxr_comment">//-----------------------------------------------------------------------------------------------------------------</em>
-<a class="jxr_linenumber" name="L5168" href="#L5168">5168</a>
-<a class="jxr_linenumber" name="L5169" href="#L5169">5169</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5170" href="#L5170">5170</a> <em class="jxr_javadoccomment"> * Parses an ISO8601 string into a calendar.</em>
-<a class="jxr_linenumber" name="L5171" href="#L5171">5171</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5172" href="#L5172">5172</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5173" href="#L5173">5173</a> <em class="jxr_javadoccomment"> * TODO-90: Investigate whether this helper can be removed in favor of java.time parsing (see TODO.md).</em>
-<a class="jxr_linenumber" name="L5174" href="#L5174">5174</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5175" href="#L5175">5175</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5176" href="#L5176">5176</a> <em class="jxr_javadoccomment"> * Supports any of the following formats:</em>
-<a class="jxr_linenumber" name="L5177" href="#L5177">5177</a> <em class="jxr_javadoccomment"> * <br><c>yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-ddThh, yyyy-MM-ddThh:mm, yyyy-MM-ddThh:mm:ss, yyyy-MM-ddThh:mm:ss.SSS</c></em>
-<a class="jxr_linenumber" name="L5178" href="#L5178">5178</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5179" href="#L5179">5179</a> <em class="jxr_javadoccomment"> * @param date The date string.</em>
-<a class="jxr_linenumber" name="L5180" href="#L5180">5180</a> <em class="jxr_javadoccomment"> * @return The parsed calendar.</em>
-<a class="jxr_linenumber" name="L5181" href="#L5181">5181</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException Value was not a valid date.</em>
-<a class="jxr_linenumber" name="L5182" href="#L5182">5182</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5183" href="#L5183">5183</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Calendar parseIsoCalendar(String date) <strong class="jxr_keyword">throws</strong> IllegalArgumentException {
-<a class="jxr_linenumber" name="L5184" href="#L5184">5184</a> <strong class="jxr_keyword">if</strong> (isEmpty(date))
-<a class="jxr_linenumber" name="L5185" href="#L5185">5185</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5186" href="#L5186">5186</a> date = date.trim().replace(' ', 'T'); <em class="jxr_comment">// Convert to 'standard' ISO8601</em>
-<a class="jxr_linenumber" name="L5187" href="#L5187">5187</a> <strong class="jxr_keyword">if</strong> (date.indexOf(',') != -1) <em class="jxr_comment">// Trim milliseconds</em>
-<a class="jxr_linenumber" name="L5188" href="#L5188">5188</a> date = date.substring(0, date.indexOf(','));
-<a class="jxr_linenumber" name="L5189" href="#L5189">5189</a> <strong class="jxr_keyword">if</strong> (date.matches(<span class="jxr_string">"\\d{4}"</span>))
-<a class="jxr_linenumber" name="L5190" href="#L5190">5190</a> date += <span class="jxr_string">"-01-01T00:00:00"</span>;
-<a class="jxr_linenumber" name="L5191" href="#L5191">5191</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (date.matches(<span class="jxr_string">"\\d{4}\\-\\d{2}"</span>))
-<a class="jxr_linenumber" name="L5192" href="#L5192">5192</a> date += <span class="jxr_string">"-01T00:00:00"</span>;
-<a class="jxr_linenumber" name="L5193" href="#L5193">5193</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (date.matches(<span class="jxr_string">"\\d{4}\\-\\d{2}\\-\\d{2}"</span>))
-<a class="jxr_linenumber" name="L5194" href="#L5194">5194</a> date += <span class="jxr_string">"T00:00:00"</span>;
-<a class="jxr_linenumber" name="L5195" href="#L5195">5195</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (date.matches(<span class="jxr_string">"\\d{4}\\-\\d{2}\\-\\d{2}T\\d{2}"</span>))
-<a class="jxr_linenumber" name="L5196" href="#L5196">5196</a> date += <span class="jxr_string">":00:00"</span>;
-<a class="jxr_linenumber" name="L5197" href="#L5197">5197</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (date.matches(<span class="jxr_string">"\\d{4}\\-\\d{2}\\-\\d{2}T\\d{2}\\:\\d{2}"</span>))
-<a class="jxr_linenumber" name="L5198" href="#L5198">5198</a> date += <span class="jxr_string">":00"</span>;
-<a class="jxr_linenumber" name="L5199" href="#L5199">5199</a> <strong class="jxr_keyword">return</strong> DateUtils.fromIso8601Calendar(date);
-<a class="jxr_linenumber" name="L5200" href="#L5200">5200</a> }
-<a class="jxr_linenumber" name="L5201" href="#L5201">5201</a>
-<a class="jxr_linenumber" name="L5202" href="#L5202">5202</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5203" href="#L5203">5203</a> <em class="jxr_javadoccomment"> * Parses an ISO8601 string into a date.</em>
-<a class="jxr_linenumber" name="L5204" href="#L5204">5204</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5205" href="#L5205">5205</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5206" href="#L5206">5206</a> <em class="jxr_javadoccomment"> * Supports any of the following formats:</em>
-<a class="jxr_linenumber" name="L5207" href="#L5207">5207</a> <em class="jxr_javadoccomment"> * <br><c>yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-ddThh, yyyy-MM-ddThh:mm, yyyy-MM-ddThh:mm:ss, yyyy-MM-ddThh:mm:ss.SSS</c></em>
-<a class="jxr_linenumber" name="L5208" href="#L5208">5208</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5209" href="#L5209">5209</a> <em class="jxr_javadoccomment"> * @param date The date string.</em>
-<a class="jxr_linenumber" name="L5210" href="#L5210">5210</a> <em class="jxr_javadoccomment"> * @return The parsed date.</em>
-<a class="jxr_linenumber" name="L5211" href="#L5211">5211</a> <em class="jxr_javadoccomment"> * @throws IllegalArgumentException Value was not a valid date.</em>
-<a class="jxr_linenumber" name="L5212" href="#L5212">5212</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5213" href="#L5213">5213</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Date parseIsoDate(String date) <strong class="jxr_keyword">throws</strong> IllegalArgumentException {
-<a class="jxr_linenumber" name="L5214" href="#L5214">5214</a> <strong class="jxr_keyword">if</strong> (isEmpty(date))
-<a class="jxr_linenumber" name="L5215" href="#L5215">5215</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5216" href="#L5216">5216</a> <strong class="jxr_keyword">return</strong> parseIsoCalendar(date).getTime(); <em class="jxr_comment">// NOSONAR - NPE not possible.</em>
-<a class="jxr_linenumber" name="L5217" href="#L5217">5217</a> }
-<a class="jxr_linenumber" name="L5218" href="#L5218">5218</a>
-<a class="jxr_linenumber" name="L5219" href="#L5219">5219</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5220" href="#L5220">5220</a> <em class="jxr_javadoccomment"> * Same as {@link Long#parseLong(String)} but removes any underscore characters first.</em>
-<a class="jxr_linenumber" name="L5221" href="#L5221">5221</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5222" href="#L5222">5222</a> <em class="jxr_javadoccomment"> * <p>Allows for better readability of numeric literals (e.g., <js>"1_000_000"</js>).</em>
-<a class="jxr_linenumber" name="L5223" href="#L5223">5223</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5224" href="#L5224">5224</a> <em class="jxr_javadoccomment"> * @param value The string to parse.</em>
-<a class="jxr_linenumber" name="L5225" href="#L5225">5225</a> <em class="jxr_javadoccomment"> * @return The parsed long value.</em>
-<a class="jxr_linenumber" name="L5226" href="#L5226">5226</a> <em class="jxr_javadoccomment"> * @throws NumberFormatException If the string cannot be parsed.</em>
-<a class="jxr_linenumber" name="L5227" href="#L5227">5227</a> <em class="jxr_javadoccomment"> * @throws NullPointerException If the string is <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5228" href="#L5228">5228</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5229" href="#L5229">5229</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> parseLong(String value) {
-<a class="jxr_linenumber" name="L5230" href="#L5230">5230</a> <strong class="jxr_keyword">return</strong> Long.parseLong(StringUtils.removeUnderscores(value));
-<a class="jxr_linenumber" name="L5231" href="#L5231">5231</a> }
-<a class="jxr_linenumber" name="L5232" href="#L5232">5232</a>
-<a class="jxr_linenumber" name="L5233" href="#L5233">5233</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5234" href="#L5234">5234</a> <em class="jxr_javadoccomment"> * Converts a string containing a possible multiplier suffix to a long.</em>
-<a class="jxr_linenumber" name="L5235" href="#L5235">5235</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5236" href="#L5236">5236</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5237" href="#L5237">5237</a> <em class="jxr_javadoccomment"> * The string can contain any of the following multiplier suffixes:</em>
-<a class="jxr_linenumber" name="L5238" href="#L5238">5238</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L5239" href="#L5239">5239</a> <em class="jxr_javadoccomment"> * <li><js>"K"</js> - x 1024</em>
-<a class="jxr_linenumber" name="L5240" href="#L5240">5240</a> <em class="jxr_javadoccomment"> * <li><js>"M"</js> - x 1024*1024</em>
-<a class="jxr_linenumber" name="L5241" href="#L5241">5241</a> <em class="jxr_javadoccomment"> * <li><js>"G"</js> - x 1024*1024*1024</em>
-<a class="jxr_linenumber" name="L5242" href="#L5242">5242</a> <em class="jxr_javadoccomment"> * <li><js>"T"</js> - x 1024*1024*1024*1024</em>
-<a class="jxr_linenumber" name="L5243" href="#L5243">5243</a> <em class="jxr_javadoccomment"> * <li><js>"P"</js> - x 1024*1024*1024*1024*1024</em>
-<a class="jxr_linenumber" name="L5244" href="#L5244">5244</a> <em class="jxr_javadoccomment"> * <li><js>"k"</js> - x 1000</em>
-<a class="jxr_linenumber" name="L5245" href="#L5245">5245</a> <em class="jxr_javadoccomment"> * <li><js>"m"</js> - x 1000*1000</em>
-<a class="jxr_linenumber" name="L5246" href="#L5246">5246</a> <em class="jxr_javadoccomment"> * <li><js>"g"</js> - x 1000*1000*1000</em>
-<a class="jxr_linenumber" name="L5247" href="#L5247">5247</a> <em class="jxr_javadoccomment"> * <li><js>"t"</js> - x 1000*1000*1000*1000</em>
-<a class="jxr_linenumber" name="L5248" href="#L5248">5248</a> <em class="jxr_javadoccomment"> * <li><js>"p"</js> - x 1000*1000*1000*1000*1000</em>
-<a class="jxr_linenumber" name="L5249" href="#L5249">5249</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L5250" href="#L5250">5250</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5251" href="#L5251">5251</a> <em class="jxr_javadoccomment"> * @param s The string to parse.</em>
-<a class="jxr_linenumber" name="L5252" href="#L5252">5252</a> <em class="jxr_javadoccomment"> * @return The parsed value.</em>
-<a class="jxr_linenumber" name="L5253" href="#L5253">5253</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5254" href="#L5254">5254</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">long</strong> parseLongWithSuffix(String s) {
-<a class="jxr_linenumber" name="L5255" href="#L5255">5255</a> assertArgNotNull(<span class="jxr_string">"s"</span>, s);
-<a class="jxr_linenumber" name="L5256" href="#L5256">5256</a> <strong class="jxr_keyword">var</strong> m = multiplierLong(s);
-<a class="jxr_linenumber" name="L5257" href="#L5257">5257</a> <strong class="jxr_keyword">if</strong> (m == 1) {
-<a class="jxr_linenumber" name="L5258" href="#L5258">5258</a> <em class="jxr_comment">// If multiplier is 1, try to decode the whole string</em>
-<a class="jxr_linenumber" name="L5259" href="#L5259">5259</a> <em class="jxr_comment">// This will throw NumberFormatException if it contains a suffix character</em>
-<a class="jxr_linenumber" name="L5260" href="#L5260">5260</a> <strong class="jxr_keyword">return</strong> Long.decode(s);
-<a class="jxr_linenumber" name="L5261" href="#L5261">5261</a> }
-<a class="jxr_linenumber" name="L5262" href="#L5262">5262</a> <strong class="jxr_keyword">var</strong> baseStr = s.substring(0, s.length() - 1).trim();
-<a class="jxr_linenumber" name="L5263" href="#L5263">5263</a> <strong class="jxr_keyword">var</strong> base = Long.decode(baseStr); <em class="jxr_comment">// NOSONAR - NPE not possible here.</em>
-<a class="jxr_linenumber" name="L5264" href="#L5264">5264</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L5265" href="#L5265">5265</a> <strong class="jxr_keyword">return</strong> Math.multiplyExact(base, m);
-<a class="jxr_linenumber" name="L5266" href="#L5266">5266</a> } <strong class="jxr_keyword">catch</strong> (@SuppressWarnings(<span class="jxr_string">"unused"</span>) ArithmeticException e) {
-<a class="jxr_linenumber" name="L5267" href="#L5267">5267</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(<span class="jxr_string">"Value "</span> + s + <span class="jxr_string">" exceeds Long.MAX_VALUE"</span>);
-<a class="jxr_linenumber" name="L5268" href="#L5268">5268</a> }
-<a class="jxr_linenumber" name="L5269" href="#L5269">5269</a> }
-<a class="jxr_linenumber" name="L5270" href="#L5270">5270</a>
-<a class="jxr_linenumber" name="L5271" href="#L5271">5271</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5272" href="#L5272">5272</a> <em class="jxr_javadoccomment"> * Parses a string containing key-value pairs into a map.</em>
-<a class="jxr_linenumber" name="L5273" href="#L5273">5273</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5274" href="#L5274">5274</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5275" href="#L5275">5275</a> <em class="jxr_javadoccomment"> * Splits the string by the entry delimiter, then splits each entry by the key-value delimiter.</em>
-<a class="jxr_linenumber" name="L5276" href="#L5276">5276</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5277" href="#L5277">5277</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
-<a class="jxr_linenumber" name="L5278" href="#L5278">5278</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
-<a class="jxr_linenumber" name="L5279" href="#L5279">5279</a> <em class="jxr_javadoccomment"> * parseMap(<js>"key1=value1,key2=value2"</js>, <js>'='</js>, <js>','</js>, <jk>false</jk>);</em>
-<a class="jxr_linenumber" name="L5280" href="#L5280">5280</a> <em class="jxr_javadoccomment"> * <jc>// {"key1":"value1","key2":"value2"}</jc></em>
-<a class="jxr_linenumber" name="L5281" href="#L5281">5281</a> <em class="jxr_javadoccomment"> * parseMap(<js>" key1 = value1 ; key2 = value2 "</js>, <js>'='</js>, <js>';'</js>, <jk>true</jk>);</em>
-<a class="jxr_linenumber" name="L5282" href="#L5282">5282</a> <em class="jxr_javadoccomment"> * <jc>// {"key1":"value1","key2":"value2"}</jc></em>
-<a class="jxr_linenumber" name="L5283" href="#L5283">5283</a> <em class="jxr_javadoccomment"> * </p></em>
-<a class="jxr_linenumber" name="L5284" href="#L5284">5284</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5285" href="#L5285">5285</a> <em class="jxr_javadoccomment"> * @param str The string to parse. Can be <jk>null</jk>.</em>
-<a class="jxr_linenumber" name="L5286" href="#L5286">5286</a> <em class="jxr_javadoccomment"> * @param keyValueDelimiter The character that separates keys from values.</em>
-<a class="jxr_linenumber" name="L5287" href="#L5287">5287</a> <em class="jxr_javadoccomment"> * @param entryDelimiter The character that separates entries.</em>
-<a class="jxr_linenumber" name="L5288" href="#L5288">5288</a> <em class="jxr_javadoccomment"> * @param trimKeys If <jk>true</jk>, trims whitespace from keys and values.</em>
-<a class="jxr_linenumber" name="L5289" href="#L5289">5289</a> <em class="jxr_javadoccomment"> * @return A map containing the parsed key-value pairs, or an empty map if the string is <jk>null</jk> or empty.</em>
-<a class="jxr_linenumber" name="L5290" href="#L5290">5290</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5291" href="#L5291">5291</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Map<String,String> parseMap(String str, <strong class="jxr_keyword">char</strong> keyValueDelimiter, <strong class="jxr_keyword">char</strong> entryDelimiter, <strong class="jxr_keyword">boolean</strong> trimKeys) {
-<a class="jxr_linenumber" name="L5292" href="#L5292">5292</a> <strong class="jxr_keyword">var</strong> result = <strong class="jxr_keyword">new</strong> LinkedHashMap<String,String>();
-<a class="jxr_linenumber" name="L5293" href="#L5293">5293</a> <strong class="jxr_keyword">if</strong> (isEmpty(str))
-<a class="jxr_linenumber" name="L5294" href="#L5294">5294</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5295" href="#L5295">5295</a>
-<a class="jxr_linenumber" name="L5296" href="#L5296">5296</a> <strong class="jxr_keyword">var</strong> entries = split(str, entryDelimiter);
-<a class="jxr_linenumber" name="L5297" href="#L5297">5297</a> <strong class="jxr_keyword">for</strong> (<strong class="jxr_keyword">var</strong> entry : entries) {
-<a class="jxr_linenumber" name="L5298" href="#L5298">5298</a> <strong class="jxr_keyword">if</strong> (isEmpty(entry))
-<a class="jxr_linenumber" name="L5299" href="#L5299">5299</a> <strong class="jxr_keyword">continue</strong>;
-<a class="jxr_linenumber" name="L5300" href="#L5300">5300</a> <strong class="jxr_keyword">var</strong> delimiterIndex = entry.indexOf(keyValueDelimiter);
-<a class="jxr_linenumber" name="L5301" href="#L5301">5301</a> <strong class="jxr_keyword">if</strong> (delimiterIndex == -1) {
-<a class="jxr_linenumber" name="L5302" href="#L5302">5302</a> <em class="jxr_comment">// No delimiter found, treat entire entry as key with empty value</em>
-<a class="jxr_linenumber" name="L5303" href="#L5303">5303</a> <strong class="jxr_keyword">var</strong> key = trimKeys ? entry.trim() : entry;
-<a class="jxr_linenumber" name="L5304" href="#L5304">5304</a> result.put(key, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L5305" href="#L5305">5305</a> } <strong class="jxr_keyword">else</strong> {
-<a class="jxr_linenumber" name="L5306" href="#L5306">5306</a> <strong class="jxr_keyword">var</strong> key = entry.substring(0, delimiterIndex);
-<a class="jxr_linenumber" name="L5307" href="#L5307">5307</a> <strong class="jxr_keyword">var</strong> value = entry.substring(delimiterIndex + 1);
-<a class="jxr_linenumber" name="L5308" href="#L5308">5308</a> <strong class="jxr_keyword">if</strong> (trimKeys) {
-<a class="jxr_linenumber" name="L5309" href="#L5309">5309</a> key = key.trim();
-<a class="jxr_linenumber" name="L5310" href="#L5310">5310</a> value = value.trim();
-<a class="jxr_linenumber" name="L5311" href="#L5311">5311</a> }
-<a class="jxr_linenumber" name="L5312" href="#L5312">5312</a> result.put(key, value);
-<a class="jxr_linenumber" name="L5313" href="#L5313">5313</a> }
-<a class="jxr_linenumber" name="L5314" href="#L5314">5314</a> }
-<a class="jxr_linenumber" name="L5315" href="#L5315">5315</a> <strong class="jxr_keyword">return</strong> result;
-<a class="jxr_linenumber" name="L5316" href="#L5316">5316</a> }
-<a class="jxr_linenumber" name="L5317" href="#L5317">5317</a>
-<a class="jxr_linenumber" name="L5318" href="#L5318">5318</a> <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L5319" href="#L5319">5319</a> <em class="jxr_javadoccomment"> * Parses a number from the specified string.</em>
-<a class="jxr_linenumber" name="L5320" href="#L5320">5320</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5321" href="#L5321">5321</a> <em class="jxr_javadoccomment"> * <p></em>
-<a class="jxr_linenumber" name="L5322" href="#L5322">5322</a> <em class="jxr_javadoccomment"> * Supports Java 7+ numeric literals with underscores (e.g., <js>"1_000_000"</js>).</em>
-<a class="jxr_linenumber" name="L5323" href="#L5323">5323</a> <em class="jxr_javadoccomment"> * The underscores are automatically removed before parsing.</em>
-<a class="jxr_linenumber" name="L5324" href="#L5324">5324</a> <em class="jxr_javadoccomment"> *</em>
-<a class="jxr_linenumber" name="L5325" href="#L5325">5325</a> <em class="jxr_javadoccomment"> * @param s The string to parse the number from.</em>
-<a class="jxr_linenumber" name="L5326" href="#L5326">5326</a> <em class="jxr_javadoccomment"> * @param type</em>
-<a class="jxr_linenumber" name="L5327" href="#L5327">5327</a> <em class="jxr_javadoccomment"> * The number type to created.</em>
-<a class="jxr_linenumber" name="L5328" href="#L5328">5328</a> <em class="jxr_javadoccomment"> * Can be any of the following:</em>
-<a class="jxr_linenumber" name="L5329" href="#L5329">5329</a> <em class="jxr_javadoccomment"> * <ul></em>
-<a class="jxr_linenumber" name="L5330" href="#L5330">5330</a> <em class="jxr_javadoccomment"> * <li> Integer (or <c>int</c> primitive)</em>
-<a class="jxr_linenumber" name="L5331" href="#L5331">5331</a> <em class="jxr_javadoccomment"> * <li> Long (or <c>long</c> primitive)</em>
-<a class="jxr_linenumber" name="L5332" href="#L5332">5332</a> <em class="jxr_javadoccomment"> * <li> Short (or <c>short</c> primitive)</em>
-<a class="jxr_linenumber" name="L5333" href="#L5333">5333</a> <em class="jxr_javadoccomment"> * <li> Byte (or <c>byte</c> primitive)</em>
-<a class="jxr_linenumber" name="L5334" href="#L5334">5334</a> <em class="jxr_javadoccomment"> * <li> Float (or <c>float</c> primitive)</em>
-<a class="jxr_linenumber" name="L5335" href="#L5335">5335</a> <em class="jxr_javadoccomment"> * <li> Double (or <c>double</c> primitive)</em>
-<a class="jxr_linenumber" name="L5336" href="#L5336">5336</a> <em class="jxr_javadoccomment"> * <li> BigInteger</em>
-<a class="jxr_linenumber" name="L5337" href="#L5337">5337</a> <em class="jxr_javadoccomment"> * <li> BigDecimal</em>
-<a class="jxr_linenumber" name="L5338" href="#L5338">5338</a> <em class="jxr_javadoccomment"> * <li> AtomicInteger</em>
-<a class="jxr_linenumber" name="L5339" href="#L5339">5339</a> <em class="jxr_javadoccomment"> * <li> AtomicLong</em>
-<a class="jxr_linenumber" name="L5340" href="#L5340">5340</a> <em class="jxr_javadoccomment"> * </ul></em>
-<a class="jxr_linenumber" name="L5341" href="#L5341">5341</a> <em class="jxr_javadoccomment"> * If <jk>null</jk> or <c>Number</c>, uses the best guess.</em>
-<a class="jxr_linenumber" name="L5342" href="#L5342">5342</a> <em class="jxr_javadoccomment"> * @return The parsed number, or <jk>null</jk> if the string was null.</em>
-<a class="jxr_linenumber" name="L5343" href="#L5343">5343</a> <em class="jxr_javadoccomment"> */</em>
-<a class="jxr_linenumber" name="L5344" href="#L5344">5344</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> Number parseNumber(String s, Class<? <strong class="jxr_keyword">extends</strong> Number> type) {
-<a class="jxr_linenumber" name="L5345" href="#L5345">5345</a> <strong class="jxr_keyword">if</strong> (s == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5346" href="#L5346">5346</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L5347" href="#L5347">5347</a> <strong class="jxr_keyword">if</strong> (s.isEmpty())
-<a class="jxr_linenumber" name="L5348" href="#L5348">5348</a> s = <span class="jxr_string">"0"</span>;
-<a class="jxr_linenumber" name="L5349" href="#L5349">5349</a> <strong class="jxr_keyword">if</strong> (type == <strong class="jxr_keyword">null</strong>)
-<a class="jxr_linenumber" name="L5350" href="#L5350">5350</a> type = Number.<strong class="jxr_keyword">class</strong>;
-<a class="jxr_linenumber" name="L5351" href="#L5351">5351</a>
-<a class="jxr_linenumber" name="L5352" href="#L5352">5352</a> <em class="jxr_comment">// Remove underscores (Java 7+ numeric literal support) before parsing</em>
-<a class="jxr_linenumber" name="L5353" href="#L5353">5353</a> <em class="jxr_comment">// Note: We do this before type detection to ensure clean parsing</em>
-<a class="jxr_linenumber" name="L5354" href="#L5354">5354</a> s = s.replace(<span class="jxr_string">"_"</span>, <span class="jxr_string">""</span>);
-<a class="jxr_linenumber" name="L5355" href="#L5355">5355</a>
-<a class="jxr_linenumber" name="L5356" href="#L5356">5356</a> <em class="jxr_comment">// Determine the data type if it wasn't specified.</em>
-<a class="jxr_linenumber" name="L5357" href="#L5357">5357</a> <strong class="jxr_keyword">var</strong> isAutoDetect = (type == Number.<strong class="jxr_keyword">class</strong>);
-<a class="jxr_linenumber" name="L5358" href="#L5358">5358</a> <strong class="jxr_keyword">var</strong> isDecimal = false;
-<a class="jxr_linenumber" name="L5359" href="#L5359">5359</a> <strong class="jxr_keyword">if</strong> (isAutoDetect) {
-<a class="jxr_linenumber" name="L5360" href="#L5360">5360</a> <em class="jxr_comment">// If we're auto-detecting, then we use either an Integer, Long, or Double depending on how</em>
-<a class="jxr_linenumber" name="L5361" href="#L5361">5361</a> <em class="jxr_comment">// long the string is.</em>
-<a class="jxr_linenumber" name="L5362" href="#L5362">5362</a> <em class="jxr_comment">// An integer range is -2,147,483,648 to 2,147,483,647</em>
-<a class="jxr_linenumber" name="L5363" href="#L5363">5363</a> <em class="jxr_comment">// An long range is -9,223,372,036,854,775,808 to +9,223,372,036,854,775,807</em>
-<a class="jxr_linenumber" name="L5364" href="#L5364">5364</a> isDecimal = isDecimal(s);
-<a class="jxr_linenumber" name="L5365" href="#L5365">5365</a> <strong class="jxr_keyword">if</strong> (isDecimal) {
-<a class="jxr_linenumber" name="L5366" href="#L5366">5366</a> <strong class="jxr_keyword">if</strong> (s.length() > 20)
-<a class="jxr_linenumber" name="L5367" href="#L5367">5367</a> type = Double.<strong class="jxr_keyword">class</strong>;
-<a class="jxr_linenumber" name="L5368" href="#L5368">5368</a> <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (s.length() >= 10)
-<a class="jxr_linenumber" name="L5369" href="#L5369">5369</a> type = Long.<strong class="jxr_keyword">class</strong>;
-<a class="jxr_linenumber" name="L5370" href="#L5370">5370</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L5371" href="#L5371">5371</a> type = Integer.<strong class="jxr_keyword">class</strong>;
-<a class="jxr_linenumber" name="L5372" href="#L5372">5372</a> } <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> (isFloat(s))
-<a class="jxr_linenumber" name="L5373" href="#L5373">5373</a> type = Double.<strong class="jxr_keyword">class</strong>;
-<a class="jxr_linenumber" name="L5374" href="#L5374">5374</a> <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L5375" href="#L5375">5375</a> <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> NumberFormatException(s);
-<a class="jxr_linenumber" name="L5376" href="#L5376">5376</a> }
-<a class="jxr_linenumber" name="L5377" href="#L5377">5377</a>
-<a class="jxr_linenumber" name="L5378" href="#L5378">5378</a> <strong class="jxr_keyword">if</strong> (type == Double.<strong class="jxr_keyword">class</strong> || type == Double.TYPE) {
-<a class="jxr_linenumber" name="L5379" href="#L5379">5379</a> <strong class="jxr_keyword">var</strong> d = Double.valueOf(s);
-<a class="jxr_linenumber" name="L5380" href="#L5380">5380</a> <strong class="jxr_keyword">var</strong> f = Float.valueOf(s);
-<a class="jxr_linenumber" name="L5381" href="#L5381">5381</a> <strong class="jxr_keyword">if</strong> (isAutoDetect && (! isDecimal) && d.toString().equals(f.toString()))
-<a class="jxr_linenumber" name="L5382" href="#L5382">5382</a> <strong class="jxr_keyword">return</strong> f;
-<a class="jxr_linenumber" name="L5383" href="#L5383">5383</a> <strong class="jxr_keyword">return</strong> d;
-<a class="jxr_linenumber" name="L5384" href="#L5384">5384</a> }
-<a class="jxr_linenumber" name="L5385" href="#L5385">5385</a> <strong class="jxr_keyword">if</strong> (type == Float.<strong class="jxr_keyword">class</strong> || type == Float.TYPE)
-<a class="jxr_linenumber" name="L5386" href="#L5386">5386</a> <strong class="jxr_keyword">return</strong> Float.valueOf(s);
-<a class="jxr_linenumber" name="L5387" href="#L5387">5387</a> <strong class="jxr_keyword">if</strong> (type == BigDecimal.<strong class="jxr_keyword">class</strong>)
-<a class="jxr_linenumber" name="L5388" href="#L5388">5388</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> BigDecimal(s);
-<a class="jxr_linenumber" name="L5389" href="#L5389">5389</a> <strong class="jxr_keyword">if</strong> (type == Long.<strong class="jxr_keyword">class</strong> || type == Long.TYPE || type == AtomicLong.<strong class="jxr_keyword">class</strong>) {
-<a class="jxr_linenumber" name="L5390" href="#L5390">5390</a> <strong class="jxr_keyword">try</strong> {
-<a class="jxr_linenumber" name="L5391" href="#L5391">5391</a> <strong class="jxr_keyword">var</strong> l = parseLongWithSuffix(s);
-<a class="jxr_linenumber" name="L5392" href="#L5392">5392</a> <strong class="jxr_keyword">if</strong> (type == AtomicLong.<strong class="jxr_keyword">class</strong>)
-<a class="jxr_linenumber" name="L5393" href="#L5393">5393</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">new</strong> AtomicLong(l);
-<a class="jxr_linenumber" name="L5394" href="#L5394">5394</a> <strong class="jxr_keyword">if</strong> (isAutoDetect && l >= Integer.MIN_VALUE && l <= Integer.MAX_VALUE) {
-<a class="jxr_linenumber" name="L5395" href="#L5395">5395</a> <em class="jxr_comment">// This occurs if the string is 10 characters long but is still a valid integer value.</em>
-<a class="jxr_linenumber" name="L5396" href="#L5396">5396</a> <strong class="jxr_keyword">return</strong> (<strong class="jxr_keyword">int</strong>)l;
-<a class="jxr_linenumber" name="L5397" href="#L5397">5397</a> }
-<a class="jxr_linenumber" name="L5398" href="#L5398">5398</a> <strong class="jxr_keyword">return</strong> l;
-<a class="jxr_linenumber" name="L5399" href="#L5399">5399</a> } <strong class="jxr_keyword">catch</strong> (NumberFormatException e) {
-<a class="jxr_linenumber" name="L5400" href="#L5400">5400</a> <strong class="jxr_keyword">if</strong> (isAutoDetect) {
-<a class="jxr_linenumber" name="L5401" href="#L5401">5401</a> <em class="jxr_comment">// This occurs if the string is 20 characters long but still falls outside the range of a valid long.</em>
-<a class="jxr_linenumber" name="L5402" href="#L5402">5402</a> <strong class="jxr_keyword">return</strong> Double.valueOf(s);
+<a class="jxr_linenumber" name="L4648" href="#L4648">4648</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4649" href="#L4649">4649</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4650" href="#L4650">4650</a> <em class="jxr_javadoccomment"> * normalizeWhitespace(<js>"hello \t\n world"</js>); <jc>// "hello world"</jc></em>
+<a class="jxr_linenumber" name="L4651" href="#L4651">4651</a> <em class="jxr_javadoccomment"> * normalizeWhitespace(<js>" hello world "</js>); <jc>// "hello world"</jc></em>
+<a class="jxr_linenumber" name="L4652" href="#L4652">4652</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4653" href="#L4653">4653</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4654" href="#L4654">4654</a> <em class="jxr_javadoccomment"> * @param str The string to normalize.</em>
+<a class="jxr_linenumber" name="L4655" href="#L4655">4655</a> <em class="jxr_javadoccomment"> * @return The normalized string, or <jk>null</jk> if input is <jk>null</jk>.</em>
+<a class="jxr_linenumber" name="L4656" href="#L4656">4656</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4657" href="#L4657">4657</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> String normalizeWhitespace(String str) {
+<a class="jxr_linenumber" name="L4658" href="#L4658">4658</a> <strong class="jxr_keyword">if</strong> (str == <strong class="jxr_keyword">null</strong>)
+<a class="jxr_linenumber" name="L4659" href="#L4659">4659</a> <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L4660" href="#L4660">4660</a> <strong class="jxr_keyword">return</strong> str.replaceAll(<span class="jxr_string">"\\s+"</span>, <span class="jxr_string">" "</span>).trim();
+<a class="jxr_linenumber" name="L4661" href="#L4661">4661</a> }
+<a class="jxr_linenumber" name="L4662" href="#L4662">4662</a>
+<a class="jxr_linenumber" name="L4663" href="#L4663">4663</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4664" href="#L4664">4664</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain the specified character.</em>
+<a class="jxr_linenumber" name="L4665" href="#L4665">4665</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4666" href="#L4666">4666</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4667" href="#L4667">4667</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #contains(String, char)}.</em>
+<a class="jxr_linenumber" name="L4668" href="#L4668">4668</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the string is <jk>null</jk> or does not contain the character.</em>
+<a class="jxr_linenumber" name="L4669" href="#L4669">4669</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4670" href="#L4670">4670</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4671" href="#L4671">4671</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4672" href="#L4672">4672</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>'x'</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L4673" href="#L4673">4673</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>'o'</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L4674" href="#L4674">4674</a> <em class="jxr_javadoccomment"> * notContains(<jk>null</jk>, <js>'a'</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L4675" href="#L4675">4675</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4676" href="#L4676">4676</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4677" href="#L4677">4677</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L4678" href="#L4678">4678</a> <em class="jxr_javadoccomment"> * @param c The character to check for.</em>
+<a class="jxr_linenumber" name="L4679" href="#L4679">4679</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain the specified character.</em>
+<a class="jxr_linenumber" name="L4680" href="#L4680">4680</a> <em class="jxr_javadoccomment"> * @see #contains(String, char)</em>
+<a class="jxr_linenumber" name="L4681" href="#L4681">4681</a> <em class="jxr_javadoccomment"> * @see #notContainsAny(String, char...)</em>
+<a class="jxr_linenumber" name="L4682" href="#L4682">4682</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4683" href="#L4683">4683</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContains(String s, <strong class="jxr_keyword">char</strong> c) {
+<a class="jxr_linenumber" name="L4684" href="#L4684">4684</a> <strong class="jxr_keyword">return</strong> ! contains(s, c);
+<a class="jxr_linenumber" name="L4685" href="#L4685">4685</a> }
+<a class="jxr_linenumber" name="L4686" href="#L4686">4686</a>
+<a class="jxr_linenumber" name="L4687" href="#L4687">4687</a> <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L4688" href="#L4688">4688</a> <em class="jxr_javadoccomment"> * Checks if a string does not contain the specified substring.</em>
+<a class="jxr_linenumber" name="L4689" href="#L4689">4689</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4690" href="#L4690">4690</a> <em class="jxr_javadoccomment"> * <p></em>
+<a class="jxr_linenumber" name="L4691" href="#L4691">4691</a> <em class="jxr_javadoccomment"> * This is the inverse of {@link #contains(String, CharSequence)}.</em>
+<a class="jxr_linenumber" name="L4692" href="#L4692">4692</a> <em class="jxr_javadoccomment"> * Returns <jk>true</jk> if the string is <jk>null</jk> or does not contain the substring.</em>
+<a class="jxr_linenumber" name="L4693" href="#L4693">4693</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4694" href="#L4694">4694</a> <em class="jxr_javadoccomment"> * <h5 class='section'>Example:</h5></em>
+<a class="jxr_linenumber" name="L4695" href="#L4695">4695</a> <em class="jxr_javadoccomment"> * <p class='bjava'></em>
+<a class="jxr_linenumber" name="L4696" href="#L4696">4696</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>"Foo"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L4697" href="#L4697">4697</a> <em class="jxr_javadoccomment"> * notContains(<js>"Hello World"</js>, <js>"World"</js>); <jc>// false</jc></em>
+<a class="jxr_linenumber" name="L4698" href="#L4698">4698</a> <em class="jxr_javadoccomment"> * notContains(<jk>null</jk>, <js>"Hello"</js>); <jc>// true</jc></em>
+<a class="jxr_linenumber" name="L4699" href="#L4699">4699</a> <em class="jxr_javadoccomment"> * </p></em>
+<a class="jxr_linenumber" name="L4700" href="#L4700">4700</a> <em class="jxr_javadoccomment"> *</em>
+<a class="jxr_linenumber" name="L4701" href="#L4701">4701</a> <em class="jxr_javadoccomment"> * @param s The string to check.</em>
+<a class="jxr_linenumber" name="L4702" href="#L4702">4702</a> <em class="jxr_javadoccomment"> * @param substring The substring to check for.</em>
+<a class="jxr_linenumber" name="L4703" href="#L4703">4703</a> <em class="jxr_javadoccomment"> * @return <jk>true</jk> if the string does not contain the specified substring.</em>
+<a class="jxr_linenumber" name="L4704" href="#L4704">4704</a> <em class="jxr_javadoccomment"> * @see #contains(String, CharSequence)</em>
+<a class="jxr_linenumber" name="L4705" href="#L4705">4705</a> <em class="jxr_javadoccomment"> * @see #notContainsAny(String, CharSequence...)</em>
+<a class="jxr_linenumber" name="L4706" href="#L4706">4706</a> <em class="jxr_javadoccomment"> */</em>
+<a class="jxr_linenumber" name="L4707" href="#L4707">4707</a> <strong class="jxr_keyword">public</strong> <strong class="jxr_keyword">static</strong> <strong class="jxr_keyword">boolean</strong> notContains(String s, CharSequence substring) {
+<a class="jxr_linenumber" name="L4708" href="#L4708">4708</a> <strong class="jxr_keyword">return</strong> ! contains(s, substring);
+<a class="jxr_linenumber" name="L4709" href="#L4709">4709</a> }
... 6900 lines suppressed ...