Description:
------------
Could the documentation on php.net under  'PHP Manual > Function Reference > Text Processing Strings > String Functions' mention how some of the functions (substr, strpos), handle html special chars? The example in the "Test script" shows the confusion I encountered before learning by coding and running the "Test script". Thank you


Test script:
---------------
$stringA = 'Lorem ipsum, <x> sit amet, consectetur </x> adipiscing';

$substrA1 = substr($stringA, 0, 24);

$substrA2 = substr(htmlspecialchars($stringA), 0, 24);

$stringB = 'Lorem ipsum, xxx sit amet, consectetur xxxx adipiscing';

$substrB1 = substr($stringB, 0, 24);

$substrB2 = substr(htmlspecialchars($stringB), 0, 24);


echo '<pre>';
echo '<br> ..............................|----|----1----|----2----|----3----|----4----|----5----|';
echo '<br> $stringA  as htmlspecialchars |' . htmlspecialchars($stringA) . '|';
echo '<br> $substrA1 as raw              |' . $substrA1 . '|';
echo '<br> $substrA1 as htmlspecialchars |' . htmlspecialchars($substrA1) . '|';
echo '<br> $substrA2 as raw              |' . $substrA2 . '|';
echo '<br> $substrA2 as htmlspecialchars |' . htmlspecialchars($substrA2) . '|';
echo '<br> $stringB  as htmlspecialchars |' . htmlspecialchars($stringB) . '|';
echo '<br> $substrB1 as raw              |' . $substrB1 . '|';
echo '<br> $substrB2 as htmlspecialchars |' . $substrB2 . '|';
echo '<br></pre>';


Actual result:
--------------

 ..............................|----|----1----|----2----|----3----|----4----|----5----|
 $stringA  as htmlspecialchars |Lorem ipsum, <x> sit amet, consectetur </x> adipiscing|
 $substrA1 as raw              |Lorem ipsum,  sit ame|
 $substrA1 as htmlspecialchars |Lorem ipsum, <x> sit ame|
 $substrA2 as raw              |Lorem ipsum, <x> s|
 $substrA2 as htmlspecialchars |Lorem ipsum, &lt;x&gt; s|
 $stringB  as htmlspecialchars |Lorem ipsum, xxx sit amet, consectetur xxxx adipiscing|
 $substrB1 as raw              |Lorem ipsum, xxx sit ame|
 $substrB2 as htmlspecialchars |Lorem ipsum, xxx sit ame|