psalehpoor		Tue Jun 24 17:27:40 2008 UTC

  Added files:                 
    /phpdoc-fa/language	exceptions.xml 
  Log:
  translation to persian
  

http://cvs.php.net/viewvc.cgi/phpdoc-fa/language/exceptions.xml?view=markup&rev=1.1
Index: phpdoc-fa/language/exceptions.xml
+++ phpdoc-fa/language/exceptions.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1.6 Maintainer: pedram Status: ready -->
<!-- $Revision: 1.1 $ -->
 <chapter xml:id="language.exceptions" xmlns="http://docbook.org/ns/docbook">
  <title>Exceptions</title>

  <para>
   PHP 5 یک مدل استثنا مشابه زبان‌های برنامه‌نویسی دیگر دارد.
   یک استثنا Ù…ÛŒ‌تواند <literal>throw</literal> شود Ùˆ توسط 
   ("<literal>catch</literal>") در PHP گر�ته شود. کد میان علامت بلوک
   <literal>try</literal> استثناهای محتمل را کنترل Ù…ÛŒ‌نماید. هر <literal>try</literal> باید حداقل یک
   بلوک <literal>catch</literal> مرتبط داشته باشد. بلوک‌های
   <literal>catch</literal> چندگانه برای گرÙ�تن کلاس استثناهای مختلÙ� بکار Ù…ÛŒ‌رود.
   اجرای معمولی (بدون استثنای ایجاد شده در بلوک
   <literal>try</literal> یا زمان انطباق <literal>catch</literal> که catch متناسب وجود ندارد) 
   پس از آخرین بلوک catch ادامه خواهد یاÙ�ت.استثناها Ù…ÛŒ‌توانند <literal>throw</literal> پرتاب شوند(یا دوباره پرتاب شوند)
   در یک بلوک <literal>catch</literal> گر�ته خواهد شد.
  </para>
  <para>
   وقتی یک استثنا پرتاب Ù…ÛŒ‌شود کد بلاÙ�اصله پس از جمله 
   اجرا نخواهد گردید و PHP تلاش خواهد نمود تا اولین انطباق
   <literal>catch</literal> را بیابد. اگر یک
   استثنا گر�ته نشود خطای مرگبار PHP ایجاد خواهد شدکه پیام
   "<literal>Uncaught Exception ...</literal>" را نمایش Ù…ÛŒ‌دهد مگر این Ú©Ù‡ پردازشگر توسط 
	  <function>set_exception_handler</function> تعیین شده باشد.
  </para>
   <example>
    <title>پرتاب استثنا</title>
    <programlisting role="php">
<![CDATA[
<?php
function inverse($x) {
    if (!$x) {
        throw new Exception('Division by zero.');
    }
    else return 1/$x;
}

try {
    echo inverse(5) . "\n";
    echo inverse(0) . "\n";
} catch (Exception $e) {
    echo 'Caught exception: ',  $e->getMessage(), "\n";
}

// Continue execution
echo 'Hello World';
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
0.2
Caught exception: Division by zero.
Hello World
]]>
    </screen>
   </example>
   <example>
    <title>استثنا تودرتو</title>
    <programlisting role="php">
<![CDATA[
<?php

class MyException extends Exception { }

class Test {
    public function testing() {
        try {
            try {
                throw new MyException('foo!');
            } catch (MyException $e) {
                /* rethrow it */
                throw $e;
            }
        } catch (Exception $e) {
            var_dump($e->getMessage());
        }
    }
}

$foo = new Test;
$foo->testing();

?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
string(4) "foo!"
]]>
    </screen>
   </example>
   
  <sect1 xml:id="language.exceptions.extending">
   <title>گسترش استثناها</title>
   <para>
    یک کلاس استثنای تعریÙ� شده توسط کاربر Ù…ÛŒ‌تواند با استÙ�اده از گسترش 
	یک کلاس استثنای داخلی انجام شود. اعضا Ùˆ متدهای پایین نشان Ù…ÛŒ‌دهد Ú©Ù‡ Ú†Ù‡‌چیزهایی در کلاس Ù�رزند از کلاس پایه مشتق شده است.
   </para>
   <example>
    <title>The Built in Exception class</title>
    <programlisting role="php">
<![CDATA[
<?php
class Exception
{
    protected $message = 'Unknown exception';   // exception message
    protected $code = 0;                        // user defined exception code
    protected $file;                            // source filename of exception
    protected $line;                            // source line of exception

    function __construct($message = null, $code = 0);

    final function getMessage();                // message of exception 
    final function getCode();                   // code of exception
    final function getFile();                   // source filename
    final function getLine();                   // source line
    final function getTrace();                  // an array of the backtrace()
    final function getTraceAsString();          // formated string of trace

    /* Overrideable */
    function __toString();                       // formated string for display
}
?>
]]>
    </programlisting>
   </example>
   <para>
    اگر یک کلاس کلاس استثناهای داخلی را گسترش داده و <link
    linkend="language.oop5.decon">سازنده</link> را دوباره تعریÙ� نماید توصیه Ù…ÛŒ‌گردد Ú©Ù‡ <link
    linkend="language.oop5.paamayim-nekudotayim">parent::__construct()</link> را �راخوانی نماید.
    برای تضمین صحت انتصاب در همه داده‌های موجود این کار باید انجام شود. متد <link
    linkend="language.oop5.magic">__toString()</link> برای بازنویسی خروجی دلخواه زمانی که یک شی 
	به عنوان رشته نمایش داده Ù…ÛŒ‌شود استÙ�اده خواهد شد.
   </para>
   <example>
    <title>گسترش کلاس استثنا</title>
    <programlisting role="php">
<![CDATA[
<?php
/**
 * Define a custom exception class
 */
class MyException extends Exception
{
    // Redefine the exception so message isn't optional
    public function __construct($message, $code = 0) {
        // some code
    
        // make sure everything is assigned properly
        parent::__construct($message, $code);
    }

    // custom string representation of object
    public function __toString() {
        return __CLASS__ . ": [{$this->code}]: {$this->message}\n";
    }

    public function customFunction() {
        echo "A Custom function for this type of exception\n";
    }
}


/**
 * Create a class to test the exception
 */
class TestException
{
    public $var;

    const THROW_NONE    = 0;
    const THROW_CUSTOM  = 1;
    const THROW_DEFAULT = 2;

    function __construct($avalue = self::THROW_NONE) {

        switch ($avalue) {
            case self::THROW_CUSTOM:
                // throw custom exception
                throw new MyException('1 is an invalid parameter', 5);
                break;

            case self::THROW_DEFAULT:
                // throw default one.
                throw new Exception('2 isnt allowed as a parameter', 6);
                break;

            default: 
                // No exception, object will be created.
                $this->var = $avalue;
                break;
        }
    }
}


// Example 1
try {
    $o = new TestException(TestException::THROW_CUSTOM);
} catch (MyException $e) {      // Will be caught
    echo "Caught my exception\n", $e;
    $e->customFunction();
} catch (Exception $e) {        // Skipped
    echo "Caught Default Exception\n", $e;
}

// Continue execution
var_dump($o);
echo "\n\n";


// Example 2
try {
    $o = new TestException(TestException::THROW_DEFAULT);
} catch (MyException $e) {      // Doesn't match this type
    echo "Caught my exception\n", $e;
    $e->customFunction();
} catch (Exception $e) {        // Will be caught
    echo "Caught Default Exception\n", $e;
}

// Continue execution
var_dump($o);
echo "\n\n";


// Example 3
try {
    $o = new TestException(TestException::THROW_CUSTOM);
} catch (Exception $e) {        // Will be caught
    echo "Default Exception caught\n", $e;
}

// Continue execution
var_dump($o);
echo "\n\n";


// Example 4
try {
    $o = new TestException();
} catch (Exception $e) {        // Skipped, no exception
    echo "Default Exception caught\n", $e;
}

// Continue execution
var_dump($o);
echo "\n\n";
?>
]]>
    </programlisting>
   </example>
  </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
-->