cvs: phpdoc-fa /language constants.xml

psalehpoor Tue Jun 24 17:27:02 2008 UTC Added files: /phpdoc-fa/language constants.xml Log: translation to persian

http://cvs.php.net/viewvc.cgi/phpdoc-fa/language/constants.xml?view=markup&rev=1.1 Index: phpdoc-fa/language/constants.xml +++ phpdoc-fa/language/constants.xml <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.52 Maintainer: pedram Status: ready --> <!-- $Revision: 1.1 $ --> <chapter xml:id="language.constants" xmlns="http://docbook.org/ns/docbook"> <title>ثابت‌ها</title> <simpara> یک ثابت یک توصیف‌کننده (نام) برای یک مقدار است. همانطور که از نام آن مشخص است مقدار آن در طول اجرای اسکریپت تغییر نمی‌یابد (به جز <link linkend="language.constants.predefined"> ثابت‌های جادویی</link> که در واقع ثابت نیستند). یک ثابت بصورت پیشفرض حساس به حروف بزرگ و کوچک است. بطور معمول توصیف کننده‌های ثابت با حروف بزرگ نوشته می‌شود. </simpara> <para> نام یک ثابت همان قوانین برچسب‌ها را در PHP دنبال می‌نماید. یک نام صحیح ثابت با یک حرف یا _ شروع شده و در ادامه حروف اعداد یا _ می‌تواند به هر تعداد قرار گیرد. اگر بخواهیم آن را بصورت یک عبارت منظم نمایش دهیم: <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> </para> &tip.userlandnaming; <para> <example> <title>نام‌های ثابت صحیح و غیرصحیح</title> <programlisting role="php"> <![CDATA[ <?php // Valid constant names define("FOO", "something"); define("FOO2", "something else"); define("FOO_BAR", "something more"); // Invalid constant names define("2FOO", "something"); // This is valid, but should be avoided: // PHP may one day provide a magical constant // that will break your script define("__FOO__", "something"); ?> ]]> </programlisting> </example> </para> <note> <simpara> برای اهداف ما در اینجا یک حرف a-z A-Z است و کاراکترهای ASCII از 127 تا 255 (0x7f-0xff).هستند </simpara> </note> <simpara> مانند &link.superglobals; حوزه یک ثابت جهانی است. شما می‌توانید به ثابت‌ها در هر جای اسکریپت شما بدون توجه به حوزه قابل دسترسی است. برای اطلاعات بیشتر درباره حوزه به بخش راهنما <link linkend="language.variables.scope">حوزه متغیر</link> مراجعه کنید. </simpara> <sect1 xml:id="language.constants.syntax"> <title>دستور</title> <simpara> شما می‌توانید یک ثابت را با استفاده از تابع <function>define</function>تعریف نمایید. وقتی یک ثابت تعریف شد نمی‌توان آن را تغییر داد و یا از تعریف خارج کرد. </simpara> <simpara> تنها داده خطی (<type>boolean</type> <type>integer</type> <type>float</type> و <type>string</type>) می‌تواند در ثابت‌ها وارد شوند. ثابت‌های <type>resource</type> را تعریف ننمایید. </simpara> <simpara> شما می‌توانید مقدار یک ثابت را با مشخص نمودن نام آن دسترسی داشته باشیم. برخلاف متغیرها شما باید <emphasis>نباید</emphasis> <literal>$</literal> به یک ثابت اضافه نمایید. شما می‌توانید از تابع <function>constant</function> برای خواندن مقدار ثابت اگر بخواهید نام ثابت را بصورت پویا دسترسی داشته باشیم. <function>get_defined_constants</function> برای دریافت یک فهرست از ثابت‌ها استفاده نمایید. </simpara> <note> <simpara> ثابت‌ها و متغیرها (جهانی) در فضای نام متفاوت هستند. این مورد برای نمونه &true; و <varname>$TRUE</varname> ذره‌ای متفاوت هستند. </simpara> </note> <simpara> اگر از ثابت تعیین نشده استفاده کنید PHP نام ثابت را خود تعیین می‌نماید مانند این که به آن بگوییم یک <type>string</type> (CONSTANT برخلاف "CONSTANT"). یک خطای سطح <link linkend="ref.errorfunc">E_NOTICE</link> در این موقعیت ایجاد خواهد گردید. همچنین ورودی راهنما در مورد اشتباه بودن <link linkend="language.types.array.foo-bar">$foo[bar]</link> ببینید (مگر شما ابتدا <function>define</function> <literal>bar</literal> را یک ثابت اعلام نمایید). اگر بخواهید بررسی نمایید آیا ثابت تعیین شده است از تابع <function>defined</function> استفاده کنید. </simpara> <para> تفاوت‌هایی میان ثابت‌ها و متغیها وجود دارد: <itemizedlist> <listitem> <simpara> ثابت‌ها علامت (<literal>$</literal>) را پیش از خود ندارند. </simpara> </listitem> <listitem> <simpara> ثابت‌ها تنها از طریق تابع <function>define</function> و نه با انتصاب معمولی تعریف می‌شوند. </simpara> </listitem> <listitem> <simpara> ثابت‌ها ممکن است تعریف شده باشند و از هر نقطه بدون توجه به قوانین حوزه دسترسی به آنها دسترسی خواهد داشت. </simpara> </listitem> <listitem> <simpara> ثابت‌ها دوباره تعریف نمی‌شوند و یا نمی‌توان آنها را از تعریف خارج کرد اگر تعریف شوند. و </simpara> </listitem> <listitem> <simpara> ثابت‌ها ممکن است به مقدار خطی ارزیابی گردند. </simpara> </listitem> </itemizedlist> </para> <para> <example> <title>تعریف ثابت</title> <programlisting role="php"> <![CDATA[ <?php define("CONSTANT", "Hello world."); echo CONSTANT; // outputs "Hello world." echo Constant; // outputs "Constant" and issues a notice. ?> ]]> </programlisting> </example> </para> <simpara> See also <link linkend="language.oop5.constants">Class Constants</link>. </simpara> </sect1> <sect1 xml:id="language.constants.predefined"> <title>ثابت‌های جادویی</title> <simpara> PHP تعداد زیادی <link linkend="reserved.constants">ثابت‌های از پیش تعریف شده</link> تعریف نموده است تا به هر اسکریپت در حال اجرا اضافه نماید. بیشتر این ثابت‌ها به هرحال توسط ضمیمه‌های مختلف تعریف شده‌اند و تنها در آن ضمیمه‌ها حاضر خواهند بود که یا بصورت دینامیک یا کامپایل شده در برنامه شما حضور دارد. </simpara> <para> هفت ثابت جادویی وجود دارند که براساس تغییرات محل استفاده آنها تعیین می‌گردد. برای نمونه مقدار <constant>__LINE__</constant> بر خط استفاده شده در اسکریپت شما بستگی دارد. این ثابت‌های ویژه غیرحساس به حروف بزرگ و کوچک است و بصورت زیر است: </para> <para> <table> <title>چند ثابت جادویی در PHP</title> <tgroup cols="2"> <thead> <row> <entry>نام</entry> <entry>توضیح</entry> </row> </thead> <tbody> <row> <entry><constant>__LINE__</constant></entry> <entry> شماره خط فعلی. </entry> </row> <row> <entry><constant>__FILE__</constant></entry> <entry> مسیر کامل و نام فایل. اگر در داخل include استفاده شود نام فایل اضافه شده بازگردانده می‌شود. از رمان PHP 4.0.2 <constant>__FILE__</constant> همیشه مسیر مطلق با symlink رفع شده است در نسخه‌های قدیمی‌تر مسیر نسبی در آن موجود بوده است. </entry> </row> <row> <entry><constant>__DIR__</constant></entry> <entry> دایرکتوری فایل. اگر در داخل include استفاده شود دایرکتوری فایل اضافه شده را باز می‌گرداند. این ثابت معادل <literal>dirname(__FILE__)</literal> است. نام دایرکتوری / در پایان خود ندارد تا زمانی که دایرکتوری ریشه باشد. (اضافه شده در PHP 5.3.0) </entry> </row> <row> <entry><constant>__FUNCTION__</constant></entry> <entry> نام تابع. (اضافه شده در PHP 4.3.0) از زمان PHP 5 این ثابت نام تابع را بصورت تعریف شده بازگردانده می‌شود (حساس به حروف بزرگ و کوچک). در PHP 4 مقدار آن حروف کوچک است. </entry> </row> <row> <entry><constant>__CLASS__</constant></entry> <entry> نام کلاس. (اضافه شده در PHP 4.3.0) از زمان PHP 5 این ثابت نام کلاس را بصورت تعریف شده باز می‌گرداند (حساس به حروف بزرگ و کوچک) در PHP 4 مقدار آن همیشه با حروف کوچک است. </entry> </row> <row> <entry><constant>__METHOD__</constant></entry> <entry> نام متد کلاس. (اضافه شده در PHP 5.0.0) نام متد همانند زمان تعریف آن بازگردانده می‌شود (حساس به حروف بزرگ و کوچک). </entry> </row> <row> <entry><constant>__NAMESPACE__</constant></entry> <entry> نام فضای نام فعلی (حساس به حروف بزرگ و کوچگ). این ثابت در زمان کامپایل تعیین می‌گردد (اضافه شده در PHP 5.3.0). </entry> </row> </tbody> </tgroup> </table> </para> <para> همچنین <function>get_class</function> <function>get_object_vars</function> <function>file_exists</function>&listendand; <function>function_exists</function> را ببینید </para> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->