sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-15 16:38:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Remove obsolete PHP 4 related info

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@344814 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Christoph Michael Becker 2018-04-23 15:10:18 +00:00
parent 8c23c19594
commit 7b83a76433
1 changed files with 2 additions and 81 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

83
reference/com/com.xml
View file

@ -132,7 +132,7 @@
Specifies the codepage that is used to convert strings to
unicode-strings and vice versa. The conversion is applied whenever a
PHP string is passed as a parameter or returned from a method of this
COM object. The code page is sticky in PHP 5, which means that it will
COM object. The code page is sticky, which means that it will
propagate to objects and variants returned from the object.
</simpara>
<simpara>
@ -161,7 +161,7 @@
property or method accesses are passed through to COM.
</para>
<para>
Starting with PHP 5, PHP will automatically detect methods that accept
PHP will automatically detect methods that accept
parameters by reference, and will automatically convert regular PHP
variables to a form that can be passed by reference. This means that you
can call the method very naturally; you needn't go to any extra effort in
@ -169,85 +169,6 @@
</para>
</section>
<section xml:id="class.com.falsemethods">
<title>Pseudo Methods</title>
<para>
In PHP versions prior to 5, a number of not very pleasant hacks meant that
the following method names were not passed through to COM and were handled
directly by PHP. PHP 5 eliminates these things; read the details below to
determine how to fix your scripts. These magic method names are case
insensitive.
</para>
<methodsynopsis xml:id="com.addref">
<type>void</type><methodname>COM::AddRef</methodname>
<void/>
</methodsynopsis>
<simpara>
Artificially adds a reference count to the COM object.
</simpara>
<warning>
<simpara>
You should never need to use this method. It exists as a logical complement
to the Release() method below.
</simpara>
</warning>
<methodsynopsis xml:id="com.release">
<type>void</type><methodname>COM::Release</methodname>
<void/>
</methodsynopsis>
<simpara>
Artificially removes a reference count from the COM object.
</simpara>
<warning>
<simpara>
You should never need to use this method. Its existence in PHP is a bug
designed to work around a bug that keeps COM objects running longer than
they should.
</simpara>
</warning>
</section>
<section xml:id="class.com.iteratormethods">
<title>Pseudo Methods for Iterating</title>
<para>
These pseudo methods are only available if
<function>com_isenum</function> returns &true;, in which case, they hide
any methods with the same names that might otherwise be provided by the
COM object. These methods have all been eliminated in PHP 5, and you
should use <xref linkend="com.examples.foreach"/> instead.
</para>
<methodsynopsis xml:id="com.all">
<type>variant</type><methodname>COM::All</methodname>
<void/>
</methodsynopsis>
<simpara>
Returns a variant representing a SafeArray that has 10 elements;
each element will be an empty/null variant. This function was supposed to
return an array containing all the elements from the iterator, but was
never completed. Do not use.
</simpara>
<methodsynopsis xml:id="com.next">
<type>variant</type><methodname>COM::Next</methodname>
<void/>
</methodsynopsis>
<simpara>
Returns a variant representing the next element available from
the iterator, or &false; when there are no more elements.
</simpara>
<methodsynopsis xml:id="com.prev">
<type>variant</type><methodname>COM::Prev</methodname>
<void/>
</methodsynopsis>
<simpara>Returns a variant representing the previous element available from
the iterator, or &false; when there are no more elements.
</simpara>
<methodsynopsis xml:id="com.reset">
<type>void</type><methodname>COM::Reset</methodname>
<void/>
</methodsynopsis>
<simpara>
Rewinds the iterator back to the start.
</simpara>
</section>
<section xml:id="class.com.examples">
<title>COM examples</title>
<para>