cvs: phpdoc-hu /language constants.xml

From: Date: Tue, 03 Aug 2004 09:31:22 +0000
Subject: cvs: phpdoc-hu /language constants.xml
Groups: php.doc.hu 
Request: Send a blank email to doc-hu+get-745@lists.php.net to get a copy of this message
bagilevi Tue Aug 3 05:31:22 2004 EDT Modified files: /phpdoc-hu/language constants.xml Log: sync http://cvs.php.net/diff.php/phpdoc-hu/language/constants.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc-hu/language/constants.xml diff -u phpdoc-hu/language/constants.xml:1.14 phpdoc-hu/language/constants.xml:1.15 --- phpdoc-hu/language/constants.xml:1.14 Sun Aug 25 08:52:04 2002 +++ phpdoc-hu/language/constants.xml Tue Aug 3 05:31:22 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.25 Maintainer: goba Status: ready --> +<!-- EN-Revision: 1.38 Maintainer: goba Status: ready --> <!-- CREDITS: kgergely,gerzson --> <chapter id="language.constants"> @@ -8,9 +8,10 @@ <simpara> Az állandó egy skalár érték azonosítója (neve). Mint ahogy az elnevezése is mutatja, a program futása során nem változik/hat - meg az értéke. Ez alól csak a 'mágikus' <constant>__FILE__</constant> és - <constant>__LINE__</constant> állandók tûnhetnek kivételeknek, ám ezek - valójában nem állandók. Az állandók alapesetben érzékenyek a kis- és nagybetûs + meg az értéke. Kivételt képeznek a + <link linkend="language.constants.predefined">mágikus + konstansok</link>, amelyek tulajdonképpen nem is konstansok. + Az állandók alapesetben érzékenyek a kis- és nagybetûs irásmódra. Megállapodás szerint általában csupa nagybetûs neveket használunk az állandók neveiként. </simpara> @@ -23,6 +24,33 @@ <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> </para> + <para> + <example> + <title>Helyes és helytelen konstans nevek</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Helyes konstans nevek +define("IZE", "valami"); +define("IZE2", "valami más"); +define("IZEÜBIGYO", "valami egészen más"); + +// Helytelen konstans nevek +define("2IZE", "valami"); + +// Ez helyes, de jobb nem használni, mivel +// elõfordulhat, hogy egyszer a PHP-nek lesz +// ilyen nevû mágikus konstansa, ami +// mûködésképtelenné teszi a szkriptedet +define("__IZE__", "valami"); + +?> +]]> + </programlisting> + </example> + </para> + <note> <simpara> Ebben az esetben egy betû lehet az angol abc egy betûje @@ -32,8 +60,11 @@ </note> <simpara> - Az állandók bárhonnan elérhetõek -- az aktuális érvényességi körtõl (scope) - függetlenül bárhol használhatók. + Hasonlóan a <link linkend="language.variables.superglobals">szuperglobális + változókhoz</link>, az állandók bárhonnan elérhetõek. + Az aktuális hatáskörtõl (scope) függetlenül bárhol használhatók. + A <link linkend="language.variables.scope">változók hatásköre</link> címû + részben tobbet megtudhatsz a hatáskörökrõl. </simpara> <sect1 id="language.constants.syntax"> @@ -52,8 +83,10 @@ A konstans értékére a nevének megadásával lehet hivatkozni. A változókkal ellentétben <emphasis>nem</emphasis> szabad <literal>$</literal> jelet tenned a konstand neve elé. - Használható még a <function>constant</function> függvényt is, - ha például a konstans nevét egy változó adja. + Egy konstans értékének lekérésére használhatod még a + <function>constant</function> függvényt is, + abban az esetben, ha a konstans nevét dinamikusan szeretnéd + megkapni. A <function>get_defined_constants</function> függvénnyel lehet a definiált konstansok listáját megkapni. </simpara> @@ -66,11 +99,16 @@ </note> <simpara> Ha egy definiálatlan konstanst próbálsz meg használni, a PHP - a konstans nevét veszi karaktersorozatként értékül. - Ilyen esetekben egy - <link linkend="features.error-handling">notice</link> szintû hiba - keletkezik. A <function>defined</function> - függvény segítségével vizsgálható a konstans létezése. + a konstans nevét veszi karaktersorozatként értékül + (KONSTANS és "KONSTANS"). Ilyen esetekben egy + <link linkend="ref.errorfunc">E_NOTICE</link> szintû hiba + keletkezik. Lásd még a kézikönyvnek azt a részét, ahol azt + tárgyalja, miért nem jó az + <link linkend="language.types.array.foo-bar">$ize[bigyo]</link> + használata, abban az esetben, ha elõtte nem definiáltad a + <literal>bigyo</literal>-t konstansként. Ha szeretnéd megtudni, + hogy egy konstans definiálva van, használd a + <function>defined</function> függvényt. </simpara> <para> A következõk a fontosabb különbségek a változókhoz képest: @@ -117,21 +155,68 @@ </sect1> <sect1 id="language.constants.predefined"> - <title>Elõre definiált állandók</title> + <title>Mágikus konstansok</title> <simpara> - <acronym>PHP</acronym> számos elõredefiniált állandót biztosít a szkriptek - futtatása során. Ezek többnyire a különbözõ kiterjesztések által + A PHP számos <link linkend="reserved.constants">elõredefiniált + állandót</link> biztosít a szkripteknek. + Ezek többnyire a különbözõ kiterjesztések által meghatározott állandók, és csak akkor léteznek, ha az adott kiterjesztés is elérhetõ/használható akár dinamikusan betöltve vagy elõre befordítva. </simpara> - <simpara> - Az elõre definiált állandók listája <link - linkend="reserved.constants">itt</link> olvasható. - </simpara> + <para> + 5 mágikus konstans létezik, amelyek változnak aszerint, hogy + hol használják. Például a <constant>__LINE__</constant> + értéke attól függ, hogy a szkript melyik sorában használják. + Ezek a speciális állandók nem érzékenyek a kis- és nagybetûkre. + </para> + <para> + <table> + <title>Néhány "mágikus" konstans</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Név</entry> + <entry>Leírás</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>__LINE__</constant></entry> + <entry> + A fájl aktuális sorának száma. + </entry> + </row> + <row> + <entry><constant>__FILE__</constant></entry> + <entry> + Az állomány teljes elérési útvonala és neve. + </entry> + </row> + <row> + <entry><constant>__FUNCTION__</constant></entry> + <entry> + A függvény neve. (A PHP 4.3.0-ban került a nyelvbe.) + </entry> + </row> + <row> + <entry><constant>__CLASS__</constant></entry> + <entry> + Az osztály neve. (A PHP 4.3.0-ban került a nyelvbe.) + </entry> + </row> + <row> + <entry><constant>__METHOD__</constant></entry> + <entry> + Az osztály metódusának neve. (PHP 5.0.0-ban került a nyelvbe.) + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> </sect1> - </chapter> <!-- Keep this comment at the end of the file

« previous php.doc.hu (#745) next »