[PHP-DOC] cvs: phpdoc /cs/functions satellite.xml

[Roman Neuhauser]

cynic           Thu Jan 25 19:58:41 2001 EDT

  Added files:                 
    /phpdoc/cs/functions        satellite.xml 
  Log:
  
  
  translated (win-1250)
  

Index: phpdoc/cs/functions/satellite.xml
+++ phpdoc/cs/functions/satellite.xml
<!--

        $Id: satellite.xml,v 1.1 2001/01/26 03:58:41 cynic Exp $

        Author: David Eriksson <[EMAIL PROTECTED]>

-->

 <reference id="ref.satellite">
  <title>Satellite CORBA klient extenze</title>
  <titleabbrev>Satellite</titleabbrev>

  <partintro>
   <para>
    Satellite extenze se pou��v� pro p��stup ke CORBA objekt�m. Vy�aduje
    idl_directory= polo�ku v php.ini ukazuj�c� na cestu kde jsou v�echny
    pou��van� IDL soubory.
   </para>
  </partintro>

  <refentry id="class.orbitobject">
   <refnamediv>
    <refname>OrbitObject</refname>
    <refpurpose>Zp��stupnit CORBA objekty</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>new <function>OrbitObject</function></funcdef>
      <paramdef>string <parameter>ior</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato t��da poskytuje p��stup ke CORBA objektu. Argument
     <parameter>ior</parameter> by m�l b�t �et�zec obsahuj�c� IOR
     (Interoperable Object Reference) kter� identifikuje vzd�len� objekt.
    </para>
    <para>
     <example>
      <title>Uk�zkov� IDL soubor</title>
      <programlisting>
interface MyInterface {
    void SetInfo (string info);
    string GetInfo();

    attribute int value;
}
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>PHP k�d pro p��stup k MyInterface</title>
      <programlisting role="php">
&lt;?php
$obj = new OrbitObject ($ior);

$obj->SetInfo ("A 2GooD object");

echo $obj->GetInfo();

$obj->value = 42;

echo $obj->value;
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="class.orbitenum">
   <refnamediv>
    <refname>OrbitEnum</refname>
    <refpurpose>Pou��t CORBA enumerace</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>new <function>OrbitEnum</function></funcdef>
      <paramdef>string <parameter>id</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato t��da p�edstavuje enumeraci ur�enou argumentem
     <parameter>id</parameter> parameter. <parameter>id</parameter> m��e b�t bu�
     n�zev t�to enumerace (nap�. "MyEnum"), nebo pln� repository id (nap�.
     "IDL:MyEnum:1.0").
    </para>
    <para>
     <example>
      <title>Uk�zkov� IDL soubor</title>
      <programlisting>
enum MyEnum {
    a,b,c,d,e
};
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>PHP k�d pro p��stup k MyEnum</title>
      <programlisting role="php">
&lt;?php
$enum = new OrbitEnum ("MyEnum");

echo $enum->a;  /* write 0 */
echo $enum->c;  /* write 2 */
echo $enum->e;  /* write 4 */
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="class.orbitstruct">
   <refnamediv>
    <refname>OrbitStruct</refname>
    <refpurpose>Pou��t CORBA struktury</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>new <function>OrbitStruct</function></funcdef>
      <paramdef>string <parameter>id</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato t��da p�edstavuje strukturu ur�enou argumentem
     <parameter>id</parameter>. <parameter>id</parameter> m��e b�t bu� n�zev
     t�to struktury (nap�. "MyStruct"), nebo pln� repository id
     (nap�. "IDL:MyStruct:1.0").
    </para>
    <para>
     <example>
      <title>Uk�zkov� IDL soubor</title>
      <programlisting>
struct MyStruct {
    short shortvalue;
    string stringvalue;
};

interface SomeInterface {
  void SetValues (MyStruct values);
  MyStruct GetValues();
}
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>PHP k�d pro p��stup k MyStruct</title>
      <programlisting role="php">
&lt;?php
$obj = new OrbitObject ($ior);

$initial_values = new OrbitStruct ("IDL:MyStruct:1.0");
$initial_values->shortvalue = 42;
$initial_values->stringvalue = "HGTTG";

$obj->SetValues ($initial_values);

$values = $obj->GetValues();

echo $values->shortvalue;
echo $values->stringvalue;
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.satellite_caught_exception">
   <refnamediv>
    <refname>satellite_caught_exception</refname>
    <refpurpose>
     Zjistit, jestli byla v p�edchoz� funkci zachycena v�jimka
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>bool
       <function>satellite_caught_exception</function>
      </funcdef>
      <paramdef></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Tato funkce vrac� <literal>true</literal>, pokud byla zachycena v�jimka.
    </para>
    <para>
     <example>
      <title>Uk�zkov� IDL soubor</title>
      <programlisting>
/* ++?????++ Out of Cheese Error. Redo From Start. */
exception OutOfCheeseError {
    int parameter;
}

interface AnotherInterface {
    void AskWhy() raises (OutOfCheeseError);
}
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>PHP k�d pro zpracov�n� CORBA v�jimek</title>
      <programlisting role="php">
&lt;?php
$obj = new OrbitObject ($ior);

$obj->AskWhy();

if (satellite_caught_exception()) {
    if ("IDL:OutOfCheeseError:1.0" == satellite_exception_id()) {
        $exception = satellite_exception_value();
        echo $exception->parameter;
    }
}
?>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.satellite_exception_id">
   <refnamediv>
    <refname>satellite_exception_id</refname>
    <refpurpose>Zjistit repository id posledn� v�jimky</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>string <function>satellite_exception_id</function></funcdef>
      <paramdef></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Vrac� �et�zec obsahuj�c� repository id (napr. "IDL:MyException:1.0".).
     Uk�zkov� pou�it� viz <function>satellite_caught_exception</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.satellite_exception_value">
   <refnamediv>
    <refname>satellite_exception_value</refname>
    <refpurpose>Z�skat strukturu posledn� v�jimky</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>OrbitStruct
       <function>satellite_exception_value</function>
      </funcdef>
      <paramdef></paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Vr�t� strukturu v�jimky. Uk�zkov� pou�it� viz
     <function>satellite_caught_exception</function>.
    </para>
   </refsect1>
  </refentry>
 </reference>

<!-- 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:
-->