Fix examles (whitespace between funcname and parameters), and a few entities

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@53504 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jeroen van Wolffelaar 2001-08-05 22:49:38 +00:00
parent 43186f1e02
commit 7d2ccc9786

View file

@ -1,5 +1,5 @@
<?xml encoding="iso-8859-1"?>
<!-- $Revision: 1.101 $ -->
<!-- $Revision: 1.102 $ -->
<reference id="ref.strings">
<title>String functions</title>
<titleabbrev>Strings</titleabbrev>
@ -22,7 +22,7 @@
<refentry id="function.addcslashes">
<refnamediv>
<refname>AddCSlashes</refname>
<refname>addcslashes</refname>
<refpurpose>Quote string with slashes in a C style</refpurpose>
</refnamediv>
<refsect1>
@ -55,7 +55,7 @@
<example>
<title><function>addcslashes</function> example</title>
<programlisting role="php">
$escaped = addcslashes ($not_escaped, "\0..\37!@\177..\377");
$escaped = addcslashes($not_escaped, "\0..\37!@\177..\377");
</programlisting>
</example>
</para>
@ -101,7 +101,7 @@ echo addcslashes("zoo['.']", 'z..A');
<refentry id="function.addslashes">
<refnamediv>
<refname>AddSlashes</refname>
<refname>addslashes</refname>
<refpurpose>Quote string with slashes</refpurpose>
</refnamediv>
<refsect1>
@ -169,7 +169,7 @@ echo addcslashes("zoo['.']", 'z..A');
<example>
<title><function>chop</function> example</title>
<programlisting role="php">
$trimmed = chop ($line);
$trimmed = chop($line);
</programlisting>
</example>
</para>
@ -206,11 +206,11 @@ $trimmed = chop ($line);
<example>
<title><function>chr</function> example</title>
<programlisting role="php">
$str .= chr (27); /* add an escape character at the end of $str */
$str .= chr(27); /* add an escape character at the end of $str */
/* Often this is more useful */
$str = sprintf ("The string ends in escape: %c", 27);
$str = sprintf("The string ends in escape: %c", 27);
</programlisting>
</example>
This function complements <function>ord</function>. See also
@ -252,7 +252,7 @@ $str = sprintf ("The string ends in escape: %c", 27);
<programlisting role="php">
# format $data using RFC 2045 semantics
$new_string = chunk_split (base64_encode($data));
$new_string = chunk_split(base64_encode($data));
</programlisting>
</example>
This function is significantly faster than
@ -560,7 +560,7 @@ echo $foo,$bar; // foobarbarbaz
// However, the following examples will work:
($some_var) ? print('true'): print('false'); // print is a function
echo ($some_var) ? 'true': 'false'; // changing the statement around
echo $some_var ? 'true': 'false'; // changing the statement around
?>
</programlisting>
</example>
@ -623,7 +623,7 @@ I have &lt;?=$foo?> foo.
<title><function>explode</function> example</title>
<programlisting role="php">
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode (" ", $pizza);
$pieces = explode(" ", $pizza);
</programlisting>
</example>
</para>
@ -681,9 +681,9 @@ $pieces = explode (" ", $pizza);
<example>
<title>Translation Table Example</title>
<programlisting role="php">
$trans = get_html_translation_table (HTML_ENTITIES);
$trans = get_html_translation_table(HTML_ENTITIES);
$str = "Hallo &amp; &lt;Frau> &amp; Kr&auml;mer";
$encoded = strtr ($str, $trans);
$encoded = strtr($str, $trans);
</programlisting>
</example>
The <literal>$encoded</literal> variable will now contain: "Hallo
@ -696,8 +696,8 @@ $encoded = strtr ($str, $trans);
the direction of the translation.
<informalexample>
<programlisting role="php">
$trans = array_flip ($trans);
$original = strtr ($str, $trans);
$trans = array_flip($trans);
$original = strtr($str, $trans);
</programlisting>
</informalexample>
The content of <literal>$original</literal> would be: "Hallo &amp;
@ -970,7 +970,7 @@ $new = htmlspecialchars("&lt;a href='test'&gt;Test&lt;/a&gt;", ENT_QUOTES);
<example>
<title><function>implode</function> example</title>
<programlisting role="php">
$colon_separated = implode (":", $array);
$colon_separated = implode(":", $array);
</programlisting>
</example>
</para>
@ -1465,7 +1465,7 @@ echo "&lt;/PRE&gt;\n";
<example>
<title><function>ord</function> example</title>
<programlisting role="php">
if (ord ($str) == 10) {
if (ord($str) == 10) {
echo "The first character of \$str is a line feed.\n";
}
</programlisting>
@ -1636,7 +1636,7 @@ echo $second[1]; /* prints "another" */
<example>
<title><function>rtrim</function> example</title>
<programlisting role="php">
$trimmed = rtrim ($line);
$trimmed = rtrim($line);
</programlisting>
</example>
</para>
@ -1841,12 +1841,12 @@ echo "&lt;author id='$id'&gt;
<example>
<title>Soundex Examples</title>
<programlisting role="php">
soundex ("Euler") == soundex ("Ellery") == 'E460';
soundex ("Gauss") == soundex ("Ghosh") == 'G200';
soundex ("Hilbert") == soundex ("Heilbronn") == 'H416';
soundex ("Knuth") == soundex ("Kant") == 'K530';
soundex ("Lloyd") == soundex ("Ladd") == 'L300';
soundex ("Lukasiewicz") == soundex ("Lissajous") == 'L222';
soundex("Euler") == soundex("Ellery") == 'E460';
soundex("Gauss") == soundex("Ghosh") == 'G200';
soundex("Hilbert") == soundex("Heilbronn") == 'H416';
soundex("Knuth") == soundex("Kant") == 'K530';
soundex("Lloyd") == soundex("Ladd") == 'L300';
soundex("Lukasiewicz") == soundex("Lissajous") == 'L222';
</programlisting>
</example>
</para>
@ -2027,7 +2027,7 @@ printf($format,$num,$location);
<example>
<title><function>sprintf</function>: zero-padded integers</title>
<programlisting role="php">
$isodate = sprintf ("%04d-%02d-%02d", $year, $month, $day);
$isodate = sprintf("%04d-%02d-%02d", $year, $month, $day);
</programlisting>
</example>
<example>
@ -2037,7 +2037,7 @@ $money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money will output "123.1";
$formatted = sprintf ("%01.2f", $money);
$formatted = sprintf("%01.2f", $money);
// echo $formatted will output "123.10"
</programlisting>
</example>
@ -2110,7 +2110,7 @@ $formatted = sprintf ("%01.2f", $money);
<programlisting role="php">
$var1 = "Hello";
$var2 = "hello";
if (!strcasecmp ($var1, $var2)) {
if (!strcasecmp($var1, $var2)) {
echo '$var1 is equal to $var2 in a case-insensitive string comparison';
}
</programlisting>
@ -2421,7 +2421,7 @@ if (!strcasecmp ($var1, $var2)) {
below:
<informalexample>
<programlisting>
$arr1 = $arr2 = array ("img12.png","img10.png","img2.png","img1.png");
$arr1 = $arr2 = array("img12.png","img10.png","img2.png","img1.png");
echo "Standard string comparison\n";
usort($arr1,"strcmp");
print_r($arr1);
@ -2655,14 +2655,14 @@ print str_pad($input, 10, "_", STR_PAD_BOTH); // produces "__Alien___"
<informalexample>
<programlisting role="php">
// in PHP 4.0b3 and newer:
$pos = strpos ($mystring, "b");
$pos = strpos($mystring, "b");
if ($pos === false) { // note: three equal signs
// not found...
}
// in versions older than 4.0b3:
$pos = strpos ($mystring, "b");
if (is_string ($pos) &amp;&amp; !$pos) {
$pos = strpos($mystring, "b");
if (is_string($pos) &amp;&amp; !$pos) {
// not found...
}
</programlisting>
@ -2724,11 +2724,11 @@ if (is_string ($pos) &amp;&amp; !$pos) {
<title><function>strrchr</function> example</title>
<programlisting role="php">
// get last directory in $PATH
$dir = substr (strrchr ($PATH, ":"), 1);
$dir = substr(strrchr($PATH, ":"), 1);
// get everything after last newline
$text = "Line 1\nLine 2\nLine 3";
$last = substr (strrchr ($text, 10), 1 );
$last = substr(strrchr($text, 10), 1 );
</programlisting>
</example>
</para>
@ -2761,7 +2761,7 @@ $last = substr (strrchr ($text, 10), 1 );
<example>
<title><function>str_repeat</function> example</title>
<programlisting role="php">
echo str_repeat ("-=", 10);
echo str_repeat("-=", 10);
</programlisting>
</example>
<para>
@ -2828,14 +2828,14 @@ echo str_repeat ("-=", 10);
<informalexample>
<programlisting role="php">
// in PHP 4.0b3 and newer:
$pos = strrpos ($mystring, "b");
$pos = strrpos($mystring, "b");
if ($pos === false) { // note: three equal signs
// not found...
}
// in versions older than 4.0b3:
$pos = strrpos ($mystring, "b");
if (is_string ($pos) &amp;&amp; !$pos) {
$pos = strrpos($mystring, "b");
if (is_string($pos) &amp;&amp; !$pos) {
// not found...
}
</programlisting>
@ -2880,7 +2880,7 @@ if (is_string ($pos) &amp;&amp; !$pos) {
The line of code:
<informalexample>
<programlisting role="php">
$var = strspn ("42 is the answer, what is the question ...", "1234567890");
$var = strspn("42 is the answer, what is the question ...", "1234567890");
</programlisting>
</informalexample>
will assign 2 to <varname>$var</varname>, because the string "42" will
@ -2930,7 +2930,7 @@ $var = strspn ("42 is the answer, what is the question ...", "1234567890");
<title><function>strstr</function> example</title>
<programlisting role="php">
$email = 'sterling@designmultimedia.com';
$domain = strstr ($email, '@');
$domain = strstr($email, '@');
print $domain; // prints @designmultimedia.com
</programlisting>
</example>
@ -2966,10 +2966,10 @@ print $domain; // prints @designmultimedia.com
<title><function>strtok</function> example</title>
<programlisting role="php">
$string = "This is an example string";
$tok = strtok ($string," ");
$tok = strtok($string," ");
while ($tok) {
echo "Word=$tok&lt;br>";
$tok = strtok (" ");
$tok = strtok(" ");
}
</programlisting>
</example>
@ -3015,7 +3015,7 @@ while ($tok) {
<para>
Note that 'alphabetic' is determined by the current locale. This
means that in i.e. the default "C" locale, characters such as
umlaut-A (Ä) will not be converted.
umlaut-A (&Auml;) will not be converted.
</para>
<example>
<title><function>strtolower</function> example</title>
@ -3058,7 +3058,7 @@ print $str; # Prints mary had a little lamb and she loved it so
<title><function>strtoupper</function> example</title>
<programlisting role="php">
$str = "Mary Had A Little Lamb and She LOVED It So";
$str = strtoupper ($str);
$str = strtoupper($str);
print $str; # Prints MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
</programlisting>
</example>
@ -3118,7 +3118,7 @@ print $str; # Prints MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
<example>
<title><function>str_replace</function> example</title>
<programlisting role="php">
$bodytag = str_replace ("%body%", "black", "&lt;body text=%body%>");
$bodytag = str_replace("%body%", "black", "&lt;body text=%body%>");
</programlisting>
</example>
</para>
@ -3183,7 +3183,7 @@ $addr = strtr($addr, "
Examples:
<informalexample>
<programlisting role="php">
$trans = array ("hello" =&gt; "hi", "hi" =&gt; "hello");
$trans = array("hello" =&gt; "hi", "hi" =&gt; "hello");
echo strtr("hi all, I said hello", $trans) . "\n";
</programlisting>
</informalexample>
@ -3235,8 +3235,8 @@ echo strtr("hi all, I said hello", $trans) . "\n";
Examples:
<informalexample>
<programlisting role="php">
$rest = substr ("abcdef", 1); // returns "bcdef"
$rest = substr ("abcdef", 1, 3); // returns "bcd"
$rest = substr("abcdef", 1); // returns "bcdef"
$rest = substr("abcdef", 1, 3); // returns "bcd"
</programlisting>
</informalexample>
</para>
@ -3248,9 +3248,9 @@ $rest = substr ("abcdef", 1, 3); // returns "bcd"
Examples:
<informalexample>
<programlisting role="php">
$rest = substr ("abcdef", -1); // returns "f"
$rest = substr ("abcdef", -2); // returns "ef"
$rest = substr ("abcdef", -3, 1); // returns "d"
$rest = substr("abcdef", -1); // returns "f"
$rest = substr("abcdef", -2); // returns "ef"
$rest = substr("abcdef", -3, 1); // returns "d"
</programlisting>
</informalexample>
</para>
@ -3274,7 +3274,7 @@ $rest = substr ("abcdef", -3, 1); // returns "d"
Examples:
<informalexample>
<programlisting role="php">
$rest = substr ("abcdef", 1, -1); // returns "bcde"
$rest = substr("abcdef", 1, -1); // returns "bcde"
</programlisting>
</informalexample>
</para>
@ -3370,18 +3370,18 @@ $var = 'ABCDEFGH:/MNRPQR/';
echo "Original: $var&lt;hr&gt;\n";
/* These two examples replace all of $var with 'bob'. */
echo substr_replace ($var, 'bob', 0) . "&lt;br&gt;\n";
echo substr_replace ($var, 'bob', 0, strlen ($var)) . "&lt;br&gt;\n";
echo substr_replace($var, 'bob', 0) . "&lt;br&gt;\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "&lt;br&gt;\n";
/* Insert 'bob' right at the beginning of $var. */
echo substr_replace ($var, 'bob', 0, 0) . "&lt;br&gt;\n";
echo substr_replace($var, 'bob', 0, 0) . "&lt;br&gt;\n";
/* These next two replace 'MNRPQR' in $var with 'bob'. */
echo substr_replace ($var, 'bob', 10, -1) . "&lt;br&gt;\n";
echo substr_replace ($var, 'bob', -7, -1) . "&lt;br&gt;\n";
echo substr_replace($var, 'bob', 10, -1) . "&lt;br&gt;\n";
echo substr_replace($var, 'bob', -7, -1) . "&lt;br&gt;\n";
/* Delete 'MNRPQR' from $var. */
echo substr_replace ($var, '', 10, -1) . "&lt;br&gt;\n";
echo substr_replace($var, '', 10, -1) . "&lt;br&gt;\n";
?&gt;
</programlisting>
</example>
@ -3447,12 +3447,12 @@ echo substr_replace ($var, '', 10, -1) . "&lt;br&gt;\n";
<para>
Note that 'alphabetic' is determined by the current locale. For
instance, in the default "C" locale characters such as umlaut-a
(ä) will not be converted.
(&auml;) will not be converted.
<example>
<title><function>ucfirst</function> example</title>
<programlisting role="php">
$text = 'mary had a little lamb and she loved it so.';
$text = ucfirst ($text); // $text is now Mary had a little lamb
$text = ucfirst($text); // $text is now Mary had a little lamb
// and she loved it so.
</programlisting>
</example>
@ -3625,4 +3625,5 @@ sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim: ts=1 sw=1 et syntax=sgml
-->