cvs: phpdoc-hu /reference/simplexml/functions simplexml-load-file.xml
[email protected] ("Lajos Cseppent?")
| Newsgroups | php.doc.hu |
|---|---|
| Message-ID | <cvschappy1170066896@cvsserver> |
chappy Mon Jan 29 10:34:56 2007 UTC
Modified files:
/phpdoc-hu/reference/simplexml/functions simplexml-load-file.xml
Log:
sync
http://cvs.php.net/viewvc.cgi/phpdoc-hu/reference/simplexml/functions/simplexml-load-file.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc-hu/reference/simplexml/functions/simplexml-load-file.xml
diff -u phpdoc-hu/reference/simplexml/functions/simplexml-load-file.xml:1.4 phpdoc-hu/reference/simplexml/functions/simplexml-load-file.xml:1.5
--- phpdoc-hu/reference/simplexml/functions/simplexml-load-file.xml:1.4 Sun Oct 22 11:21:58 2006
+++ phpdoc-hu/reference/simplexml/functions/simplexml-load-file.xml Mon Jan 29 10:34:56 2007
@@ -1,69 +1,122 @@
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.14 Maintainer: chappy Status: ready -->
- <refentry id='function.simplexml-load-file'>
- <refnamediv>
- <refname>simplexml_load_file</refname>
- <refpurpose>
- XML fájlt dolgoz fel, és tölt be objektumba
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Leírás</title>
- <methodsynopsis>
- <type>object</type><methodname>simplexml_load_file</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>ns</parameter></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>is_prefix</parameter></methodparam>
- </methodsynopsis>
- <para>
- Ez a függvény a <parameter>filename</parameter> paraméterben találhatókéri
- helyes XML karakterláncot konvertálja objektum típusú (<type>object</type>)
- <type>SimpleXMLElement</type> osztállyá, és ezzel tér vissza. Ha hiba lép
- fel, a visszatérési érték &false;.
- </para>
- <para>
- Használhatód az opcinális <parameter>class_name</parameter> paramétert,
- így a <function>simplexml_load_string</function> függvény a megadott
- típusú osztállyal tér vissza. Ennek az osztálynak a <type>SimpleXMLElement</type>
- osztálynak kellene az utódja lennie.
- </para>
- <para>
- PHP 5.1.0 és Libxml 2.6.0 óta te használhatod az <parameter>options</parameter>
- patamétert, hogy megadd a <link
- linkend="libxml.constants">kiegészítõ Libxml paramétereket</link>.
- </para>
- <note>
- <para>
- Libxml 2 nem védi le az URI karaktereit, tehát ha pl.: a <literal>b&c</literal>-t akarot átadni
- URI paraméterként, a <literal>simplexml_load_file(rawurlencode('http://example.com/?a=' . urlencode('b&c')))</literal>-t
- kell meghívnod. PHP 5.1.0 óta nem kell megcsinálnod ezt, mert a PHP megcsinálja neked.
- </para>
- </note>
- <para>
- <example>
- <title>XML dokumentum értelmezése</title>
- <programlisting role="php">
+<refentry id='function.simplexml-load-file'>
+ <refnamediv>
+ <refname>simplexml_load_file</refname>
+ <refpurpose>
+ XML fájlt dolgoz fel, és tölt be objektumba
+ </refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>object</type><methodname>simplexml_load_file</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>ns</parameter></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>is_prefix</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ A megadott és helyesen formázott XML dokumentom tartalmát objektumként adja vissza.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ XML fájl elérési útvonala
+ </para>
+ <note>
+ <para>
+ Libxml 2 nem védi le az URI karaktereit, tehát ha pl.:
+ a <literal>b&c</literal>-t akarot átadni
+ URI paraméterként, a
+ <literal>simplexml_load_file(rawurlencode('http://example.com/?a=' . urlencode('b&c')))</literal>-t
+ kell meghívnod.
+ PHP 5.1.0 óta nem kell megcsinálni ezt, mert a PHP automatikusan megcsinálja.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>class_name</parameter></term>
+ <listitem>
+ <para>
+ Ezt a paramétert használva a
+ <function>simplexml_load_file</function> egy megadott osztályú
+ objektumot ad vissza. Ennek az osztálynak a
+ <type>SimpleXMLElement</type> osztálynak kell az utóda lennie.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>options</parameter></term>
+ <listitem>
+ <para>
+ A PHP 5.1.0 és Libxml 2.6.0 óta használható a
+ <parameter>options</parameter> paraméter <link
+ linkend="libxml.constants">egyéb Libxml paraméterek</link> megadásához.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>ns</parameter></term>
+ <listitem>
+ <para>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>is_prefix</parameter></term>
+ <listitem>
+ <para>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Egy <type>SimpleXMLElement</type> osztályú <type>object</type> típussal tér vissza,
+ aminek az adattagjai tartalmazzák az XML dokumentumban tárolt adatokat.
+ Hiba esetén &false;-szal tér vissza.
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>XML dokumentum értelmezése</title>
+ <programlisting role="php">
<![CDATA[
<?php
-// A test.xml fájl tartalmazza az XML dokumentumot root elemmel
-// és legalább egy másik elemmel /[root]/title.
+// A test.xml fájl tartalmazza az XML adatokat gyökér elemmel
+// és legalább van egy eleme (/[root]/title).
if (file_exists('test.xml')) {
$xml = simplexml_load_file('test.xml');
var_dump($xml);
} else {
- exit('Nem létezik: test.xml.');
+ exit('Failed to open test.xml.');
}
?>
]]>
- </programlisting>
- <para>
- Siker esetén a kód kimenete:
- </para>
- <screen>
+ </programlisting>
+ <para>
+ A fenti kód kimenete:
+ </para>
+ <screen>
<![CDATA[
SimpleXMLElement Object
(
@@ -71,18 +124,25 @@
...
)
]]>
- </screen>
- <simpara>
- Itt használhatod a <literal>$xml->title</literal>-t a
- <literal>/[root]/title</literal> eléréséhez.
- </simpara>
- </example>
- </para>
- <para>
- Lásd még: <function>simplexml_load_string</function>
- </para>
- </refsect1>
- </refentry>
+ </screen>
+ <simpara>
+ A <literal>title</literal> kinyeréséhez elég csak <literal>$xml->title</literal>-t
+ használni.
+ </simpara>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><xref linkend="function.simplexml-load-string" /></member>
+ <member><xref linkend="function.simplexml-element-construct" /></member>
+ </simplelist>
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables: