git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@56012 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jeroen van Wolffelaar 2001-08-26 22:41:56 +00:00
parent 8bd63a961a
commit 1249e50102

View file

@ -1,5 +1,5 @@
<?xml encoding="iso-8859-1"?>
<!-- $Revision: 1.107 $ -->
<!-- $Revision: 1.108 $ -->
<reference id="ref.strings">
<title>String functions</title>
<titleabbrev>Strings</titleabbrev>
@ -279,32 +279,32 @@ $new_string = chunk_split(base64_encode($data));
<itemizedlist>
<listitem>
<simpara>
k - koi8-r
k - koi8-r
</simpara>
</listitem>
<listitem>
<simpara>
w - windows-1251
w - windows-1251
</simpara>
</listitem>
<listitem>
<simpara>
i - iso8859-5
i - iso8859-5
</simpara>
</listitem>
<listitem>
<simpara>
a - x-cp866
a - x-cp866
</simpara>
</listitem>
<listitem>
<simpara>
d - x-cp866
d - x-cp866
</simpara>
</listitem>
<listitem>
<simpara>
m - x-mac-cyrillic
m - x-mac-cyrillic
</simpara>
</listitem>
</itemizedlist>
@ -341,30 +341,30 @@ $new_string = chunk_split(base64_encode($data));
<itemizedlist>
<listitem>
<simpara>
0 - an array with the byte-value as key and the frequency of
every byte as value.
0 - an array with the byte-value as key and the frequency of
every byte as value.
</simpara>
</listitem>
<listitem>
<simpara>
1 - same as 0 but only byte-values with a frequency greater
than zero are listed.
1 - same as 0 but only byte-values with a frequency greater
than zero are listed.
</simpara>
</listitem>
<listitem>
<simpara>
2 - same as 0 but only byte-values with a frequency equal to
zero are listed.
2 - same as 0 but only byte-values with a frequency equal to
zero are listed.
</simpara>
</listitem>
<listitem>
<simpara>
3 - a string containing all used byte-values is returned.
3 - a string containing all used byte-values is returned.
</simpara>
</listitem>
<listitem>
<simpara>
4 - a string containing all not used byte-values is returned.
4 - a string containing all not used byte-values is returned.
</simpara>
</listitem>
</itemizedlist>
@ -447,7 +447,7 @@ $new_string = chunk_split(base64_encode($data));
salt is generated once. If you are calling this function
recursively, this may impact both appearance and, to a certain
extent, security.
</simpara>
</simpara>
<simpara>
The standard DES encryption <function>crypt</function> contains
the salt as the first two characters of the output.
@ -560,7 +560,7 @@ echo $some_var ? 'true': 'false'; // changing the statement around
I have &lt;?=$foo?> foo.
</programlisting>
</informalexample>
</para>
</para>
<simpara>
See also:
<function>print</function>,
@ -582,7 +582,7 @@ I have &lt;?=$foo?> foo.
<funcdef>array <function>explode</function></funcdef>
<paramdef>string <parameter>separator</parameter></paramdef>
<paramdef>string <parameter>string</parameter></paramdef>
<paramdef>int
<paramdef>int
<parameter><optional>limit</optional></parameter>
</paramdef>
</funcprototype>
@ -1017,7 +1017,7 @@ $colon_separated = implode(":", $array);
<refnamediv>
<refname>levenshtein</refname>
<refpurpose>
Calculate Levenshtein distance between two strings
Calculate Levenshtein distance between two strings
</refpurpose>
</refnamediv>
<refsect1>
@ -1059,7 +1059,7 @@ $colon_separated = implode(":", $array);
length of <parameter>str1</parameter> and
<parameter>str2</parameter> (rather good when compared to
<function>similar_text</function>, which is O(max(n,m)**3),
but still expensive).
but still expensive).
</para>
<para>
In its simplest form the function will take only the two
@ -1085,37 +1085,37 @@ $colon_separated = implode(":", $array);
<itemizedlist>
<listitem>
<simpara>
operation to apply: 'I', 'R' or 'D'
operation to apply: 'I', 'R' or 'D'
</simpara>
</listitem>
<listitem>
<simpara>
actual character in string 1
actual character in string 1
</simpara>
</listitem>
<listitem>
<simpara>
actual character in string 2
actual character in string 2
</simpara>
</listitem>
<listitem>
<simpara>
position in string 1
position in string 1
</simpara>
</listitem>
<listitem>
<simpara>
position in string 2
position in string 2
</simpara>
</listitem>
<listitem>
<simpara>
remaining characters in string 1
remaining characters in string 1
</simpara>
</listitem>
<listitem>
<simpara>
remaining characters in string 2
remaining characters in string 2
</simpara>
</listitem>
</itemizedlist>
@ -1179,76 +1179,76 @@ $colon_separated = implode(":", $array);
<entry>Thousands separator</entry>
</row>
<row>
<entry>grouping</entry>
<entry>Array containing numeric groupings</entry>
<entry>grouping</entry>
<entry>Array containing numeric groupings</entry>
</row>
<row>
<entry>int_curr_symbol</entry>
<entry>International currency symbol (i.e. USD)</entry>
<entry>int_curr_symbol</entry>
<entry>International currency symbol (i.e. USD)</entry>
</row>
<row>
<entry>currency_symbol</entry>
<entry>Local currency symbol (i.e. $)</entry>
<entry>currency_symbol</entry>
<entry>Local currency symbol (i.e. $)</entry>
</row>
<row>
<entry>mon_decimal_point</entry>
<entry>Monetary decimal point character</entry>
<entry>mon_decimal_point</entry>
<entry>Monetary decimal point character</entry>
</row>
<row>
<entry>mon_thousands_sep</entry>
<entry>Monetary thousands separator</entry>
<entry>mon_thousands_sep</entry>
<entry>Monetary thousands separator</entry>
</row>
<row>
<entry>mon_grouping</entry>
<entry>Array containing monetary groupings</entry>
<entry>mon_grouping</entry>
<entry>Array containing monetary groupings</entry>
</row>
<row>
<entry>positive_sign</entry>
<entry>Sign for positive values</entry>
<entry>positive_sign</entry>
<entry>Sign for positive values</entry>
</row>
<row>
<entry>negative_sign</entry>
<entry>Sign for negative values</entry>
<entry>negative_sign</entry>
<entry>Sign for negative values</entry>
</row>
<row>
<entry>int_frac_digits</entry>
<entry>International fractional digits</entry>
<entry>int_frac_digits</entry>
<entry>International fractional digits</entry>
</row>
<row>
<entry>frac_digits</entry>
<entry>Local fractional digits</entry>
<entry>frac_digits</entry>
<entry>Local fractional digits</entry>
</row>
<row>
<entry>p_cs_precedes</entry>
<entry>
&true; if currency_symbol precedes a positive value, &false;
if it succeeds one
</entry>
<entry>p_cs_precedes</entry>
<entry>
&true; if currency_symbol precedes a positive value, &false;
if it succeeds one
</entry>
</row>
<row>
<entry>p_sep_by_space</entry>
<entry>
&true; if a space separates currency_symbol from a positive
value, &false; otherwise
</entry>
<entry>p_sep_by_space</entry>
<entry>
&true; if a space separates currency_symbol from a positive
value, &false; otherwise
</entry>
</row>
<row>
<entry>n_cs_precedes</entry>
<entry>
&true; if currency_symbol precedes a negative value, &false;
if it succeeds one
</entry>
<entry>n_cs_precedes</entry>
<entry>
&true; if currency_symbol precedes a negative value, &false;
if it succeeds one
</entry>
</row>
<row>
<entry>n_sep_by_space</entry>
<entry>
&true; if a space separates currency_symbol from a negative
value, &false; otherwise
</entry>
<entry>n_sep_by_space</entry>
<entry>
&true; if a space separates currency_symbol from a negative
value, &false; otherwise
</entry>
</row>
<row valign="top">
<entry>p_sign_posn</entry>
<entry>
<entry>p_sign_posn</entry>
<entry>
<!-- something wrong with the indentation -->
@ -2216,7 +2216,7 @@ printf($format,$num,$location);
<example>
<title>Argument swapping</title>
<programlisting role="php">
$format = "The %2\$s contains %1\$d monkeys.
$format = "The %2\$s contains %1\$d monkeys.
That's a nice %2\$s full of %1\$d monkeys.";
printf($format, $num, $location);
</programlisting>
@ -2864,7 +2864,7 @@ print str_pad($input, 10, "_", STR_PAD_BOTH); // produces "__Alien___"
position 0" and "character not found". Here's how to detect
the difference:
<informalexample>
<programlisting role="php">
<programlisting role="php">
// in PHP 4.0b3 and newer:
$pos = strpos($mystring, "b");
if ($pos === false) { // note: three equal signs
@ -2876,7 +2876,7 @@ $pos = strpos($mystring, "b");
if (is_string($pos) &amp;&amp; !$pos) {
// not found...
}
</programlisting>
</programlisting>
</informalexample>
</para>
</note>
@ -3037,7 +3037,7 @@ echo str_repeat("-=", 10);
position 0" and "character not found". Here's how to detect
the difference:
<informalexample>
<programlisting role="php">
<programlisting role="php">
// in PHP 4.0b3 and newer:
$pos = strrpos($mystring, "b");
if ($pos === false) { // note: three equal signs
@ -3049,7 +3049,7 @@ $pos = strrpos($mystring, "b");
if (is_string($pos) &amp;&amp; !$pos) {
// not found...
}
</programlisting>
</programlisting>
</informalexample>
</para>
</note>
@ -3232,7 +3232,7 @@ while ($tok) {
<title><function>strtolower</function> example</title>
<programlisting role="php">
$str = "Mary Had A Little Lamb and She LOVED It So";
$str = strtolower($str);
$str = strtolower($str);
print $str; # Prints mary had a little lamb and she loved it so
</programlisting>
</example>
@ -3269,7 +3269,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>
@ -3458,7 +3458,7 @@ $rest = substr("abcdef", 1, 3); // returns "bcd"
<para>
If <parameter>start</parameter> is negative, the returned string
will start at the <parameter>start</parameter>'th character
from the end of <parameter>string</parameter>.</para>
from the end of <parameter>string</parameter>.</para>
<para>
Examples:
<informalexample>
@ -3530,7 +3530,7 @@ print substr_count("This is a test", "is"); // prints out 2
</para>
</refsect1>
</refentry>
<refentry id="function.substr-replace">
<refnamediv>
<refname>substr_replace</refname>
@ -3559,12 +3559,12 @@ print substr_count("This is a test", "is"); // prints out 2
<para>
If <parameter>start</parameter> is positive, the replacing will
begin at the <parameter>start</parameter>'th offset into
<parameter>string</parameter>.
<parameter>string</parameter>.
</para>
<para>
If <parameter>start</parameter> is negative, the replacing will
begin at the <parameter>start</parameter>'th character from the
end of <parameter>string</parameter>.
end of <parameter>string</parameter>.
</para>
<para>
If <parameter>length</parameter> is given and is positive, it
@ -3743,7 +3743,7 @@ $clean = trim($binary,"\0x00..\0x1F");
(&auml;) will not be converted.
<example>
<title><function>ucfirst</function> example</title>
<programlisting role="php">
<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
// and she loved it so.
@ -3839,9 +3839,9 @@ $text = ucwords($text); // $text is now: Mary Had A Little
</para>
<para>
If the <parameter>cut</parameter> is set to 1, the string is
always wrapped at the specified width. So if you have a word
that is larger than the given width, it is broken apart.
(See second example).
always wrapped at the specified width. So if you have a word
that is larger than the given width, it is broken apart.
(See second example).
<note>
<para>
The <parameter>cut</parameter> parameter was added in PHP 4.0.3.