[PHP-DOC] cvs: phpdoc /cs/language basic-syntax.xml constants.xml

[Roman Neuhauser]

cynic           Wed Jan 24 05:22:06 2001 EDT

  Added files:                 
    /phpdoc/cs/language basic-syntax.xml constants.xml 
  Log:
  
  
  couple of others in functions dir. should be complete (though translated 
  from a not-so-up-to-date version) except for strings.xml
  

Index: phpdoc/cs/language/basic-syntax.xml
+++ phpdoc/cs/language/basic-syntax.xml
  <chapter id="language.basic-syntax">
   <title>Z�kladn� syntaxe</title>

   <sect1 id="language.basic-syntax.phpmode">
    <title>Opu�t�n� HTML</title>

    <para>
    Jsou �ty�i zp�soby jak opustit HTML a vstoupit to "PHP m�du":
    </para>

    <para>
     <example>
      <title>Zp�soby opu�t�n� HTML</title>
      <programlisting>
1.  &lt;? echo ("toto je nejjednodu��� SGML zpracovatelsk� instrukce\n"); ?&gt;

2.  &lt;?php echo("pokud chcete zpracov�vat XHTML nebo XML dokumenty, pou��vejte 
toto\n"); ?&gt;

3.  &lt;script language="php"&gt;
        echo ("n�kter� editory (nap��klad FrontPage) nemaj� zpracovatelsk� instrukce v 
l�sce");
    &lt;/script&gt;

4.  &lt;% echo ("p��padn� m��ete pou��vat ASP tagy"); %&gt;
    &lt;%= $variable; # toto je zkratka za "&lt;%echo .." %&gt;
      </programlisting>
     </example>
    </para>

    <para>
    Prvn� zp�sob je dostupn� pouze, pokud jsou povoleny kr�tk� tagy. To se d�
    ud�lat
    <!-- pomoc� funkce <function>short_tags</function>,-->
    povolen�m konfigura�n� direktivy
    <link linkend="ini.short-open-tag">short_open_tag</link> v konfigura�n�m
    souboru PHP, nebo kompilac� PHP s <command>configure</command> volbou
    --enable-short-tags.
    </para>

    <para>
    Obecn� preferovanou metodou je druh� zp�sob, proto�e umo��uje snadnou
    implementaci dal��ho generov�n� XHTML z PHP.
    </para>

    <para>
    �tvrt� zp�sob je dostupn�, pouze pokud byly povoleny ASP tagy pomoc�
    konfigura�n� direktivy <link linkend="ini.asp-tags">asp_tags</link>.

    <note>
     <para>Podpora ASP tag� byla p�id�na v 3.0.4.</para>
    </note></para>

    <para>
    P��padn� bezprost�edn� n�sleduj�c� sekvence konce ��dku je sou��st�
    uzav�raj�c�ho tagu.
    </para>
   </sect1>

   <sect1 id="language.basic-syntax.instruction-separation">
    <title>Odd�lov�n� instrukc�</title>

    <simpara>
    Instrukce se odd�luj� stejn� jako v C nebo Perlu - ukon�ujte ka�d� v�raz
    st�edn�kem.
    </simpara>

    <para>
    Uzav�raj�c� tag (?&gt;) tak� implikuje konec v�razu, tak�e n�sleduj�c�
    uk�zky jsou ekvivalentn�:

     <informalexample>
      <programlisting>
&lt;?php
    echo "Toto je test";
?>

&lt;?php echo "Toto je test" ?>
      </programlisting>
     </informalexample></para></sect1>

   <sect1 id="language.basic-syntax.comments">
    <title>Koment��e</title>

    <para>
    PHP podporuje koment��ov� notace jazyk� 'C', 'C++' a Unixov�ho shellu.
    Nap��klad:

    <informalexample><programlisting>
&lt;?php
    echo "Toto je test"; // Toto je jedno��dkov� koment�� typu C++
    /* Toto je v�ce��dkov� koment��
       a je�t� jeden koment�� */
    echo "Toto je dal�� test";
    echo "Posledn� Test"; # Toto je koment�� shellov�ho typu
?>
     </programlisting>
    </informalexample></para>

    <simpara>
    Jedno��dkov� typy koment��� ve skute�nosti komentuj� do konce ��dku nebo
    sou�asn�ho bloku PHP k�du, podle toho, co se vyskytuje d��v.
    </simpara>
    <informalexample><programlisting>
&lt;h1&gt;Toto je  &lt;?php # echo "mal�";?> p��klad.&lt;/h1&gt;
&lt;p&gt;Hlavi�ka na p�edchoz�m ��dku bude 'Toto je p��klad'.
</programlisting></informalexample>

    <simpara>
    M�li byste si d�t pozor na vno�ov�n� koment��� typu 'C++', ke kter�mu m��e
    doj�t p�i zakomentov�n� velk�ch blok�.
    </simpara>

    <informalexample><programlisting>
&lt;?php
 /*
    echo "Toto je test"; /* Tento koment�� zp�sob� probl�m */
 */
?>
    </programlisting></informalexample></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
 sgml-parent-document:nil
 sgml-default-dtd-file:"../manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 -->

Index: phpdoc/cs/language/constants.xml
+++ phpdoc/cs/language/constants.xml
 <chapter id="language.constants">
  <title>Konstanty</title>

  <simpara>
  PHP definuje n�kolik konstant, a poskytuje mechanismus pro definici dal��ch
  za b�hu. Konstanty se hodn� podobaj� prom�nn�m s v�jimkou dvou skute�nost�:
  konstanty se mus� definovat pomoc� <function>define</function> function, a
  nemohou pozd�ji nab�vat jin�ch hodnot.
  </simpara>

  <para>
  P�eddefinovan� konstanty (dostupn� v�dy) jsou:

   <variablelist>

    <varlistentry>
     <term>__FILE__</term>
     <listitem>
      <simpara>
      N�zev souboru skriptu, kter� je pr�v� �ten. Pokud je pou�ita v souboru,
      kter� byl include-ov�n nebo require-ov�n, obsahuje n�zev include-ovan�ho,
      ne rodi�ovsk�ho souboru.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>__LINE__</term>
     <listitem>
      <simpara>
      ��slo ��dku ve skriptu, kter� je pr�v� �ten. Pokud je pou�ita v
      include-ovan�m nebo require-ovan�m souboru, obsahuje pozici v r�mci
      tohoto souboru.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>PHP_VERSION</term>
     <listitem>
      <simpara>
      Textov� vyj�d�en� verze b��c�ho PHP parseru, nap�. '3.0.8-dev'.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>PHP_OS</term>
     <listitem>
      <simpara>
      N�zev opera�n�ho syst�mu, na kter�m PHP parser b��, nap�. 'Linux'.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>TRUE</term>
     <listitem>
      <simpara>
       Pravdiv� hodnota.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>FALSE</term>
     <listitem>
      <simpara>
       Nepravdiv� hodnota.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>E_ERROR</term>
     <listitem>
      <simpara>
      Ozna�uje neo�et�itelnou chybu jinou ne� parse error.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>E_WARNING</term>
     <listitem>
      <simpara>
      Ozna�uje stav, kdy PHP v�, �e je n�co �patn�, ale bude d�l pokra�ovat.
      Tyto stavy se daj� o�et�it v samotn�m skriptu. P��kladem by byl neplatn�
      regexp ve funkci <function>ereg</function>.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>E_PARSE</term>
     <listitem>
      <simpara>
      Parser se zad�v�l neplatnou syntax� skriptu. O�et�en� nen� mo�n�.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>E_NOTICE</term>
     <listitem>
      <simpara>
      Do�lo k n��emu co by mohlo b�t chybou. Prov�d�n� skriptu pokra�uje.
      Mezi p��klady pat�� textov� index pole neopat�en� uvozovkami nebo pr�ce
      s prom�nnou, kter� je�t� nebyla definov�na.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>E_ALL</term>
     <listitem>
      <simpara>
      V�echny E_* konstanty shrnut� do jedn�. P�i pou�it� s
       <function>error_reporting</function> zp�sob� hl�en� �pln� v�ech
       probl�mu zaregistrovan�ch PHP.
      </simpara>
     </listitem>
    </varlistentry>

   </variablelist>
  </para>

   <para>
   E_* konstanty se typicky pou��vaj� s funkc�
   <function>error_reporting</function> nastaven� hladiny hl�en� chyb. Viz
   v�echny tyto konstanty v
   <link linkend="features.error-handling">O�et�en� chyb</link>.
   </para>

   <para>
   Dal�� konstanty m��ete definovat pomoc� funkce
   <function>define</function> function.
   </para>

   <para>
   V�imn�te si, �e toto jsou konstanty, ne c��kovsk� makra; konstanty mohou
   reprezentovat pouze platn� skal�rn� data.
   Note that these are constants, not C-style macros; only valid
   scalar data may be represented by a constant.

    <example>
     <title>Definice konstant</title>
     <programlisting>
&lt;?php
define("CONSTANT", "Hello world.");
echo CONSTANT; // vytiskne "Hello world."
?&gt;
     </programlisting>
    </example>

    <example>
     <title>Pou�it� __FILE__ a __LINE__</title>
     <programlisting>
&lt;?php
function report_error($file, $line, $message) {
    echo "Do�lo k chyb� v souboru $file na ��dku $line: $message.";
}

report_error(__FILE__,__LINE__, "N�co je �patn�!");
?&gt;
     </programlisting>
    </example></para>

  </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
 sgml-parent-document:nil
 sgml-default-dtd-file:"../manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 -->