Location: PHPKode > scripts > LanguageSys > languagesys/doc/de/functions.htm
<html>
 <head>
  <link rel="stylesheet" href="inline.css" />
 </head>
 <body>
  <h1>Klassenfunktionen:</h1>
  <div id="body">
   <h1>Instanzierung</h1>
   <p>
    <span class="func">void LanguageSys( void )</span><br />
    Zur instanzierung kann ein einfaches neues objekt von LanguageSys ertsellt werden.<br />
    Du darfst nicht vergessen die Klasse einzubinden!<br />
    <code>
     include('LanguageSys.class.php');<br />
     $lang = new LanguageSys();<br />
     $lang->...
    </code>
   </p>
   <h2>LanguageSys::set_res_dir</h2>
   <p>
    <span class="func">bool set_res_dir( string dir )</span><br />
    Mit dieser funktion wird das Verzeichnis gesetzt, welches nach den Sprachdatein durchsucht werden soll.<br />
    Gibt bei erfolg TRUE zurück, im fehlerfall (Verzeichniss existiert nicht) wird FALSE zurückgegeben.<br />
    Vor dem ersten aufruf von set_res_dir() ist der pfad auf das verzeichniss ./lang relativ vom eigenen verzeichniss gesetzt.
    <code>
     include('LanguageSys.class.php');<br />
     $lang = new LanguageSys();<br />
     $lang->set_res_dir('./foo/bar/');<br />
     $lang->...
    </code>
   </p>
   <h2>LanguageSys::get_aviable_languages</h2>
   <p>
    <span class="func">array get_aviable_languages([lsys_return_type type])</span><br />
    Gibt anhand des angegebenen Return types einen Array zurück. Dieser kann numerisch sein und die language codes enthalten (LSYS_RTN_CODES), numerisch sein und Ausgeschriebene sprachbezeichnungen enthalten wie zum beispiel &quot;German (Germany)&quot; (LSYS_RTN_NAMES), eine andere mäglichkeit ist ein Assizioatives array bestehend aus dem sprachcode als bezeichner und der Beschreibung als inhalt (LSYS_RTN_MIXED).<br />
    Wenn kein type angegeben wird, so wied als standart LSYS_RTN_CODES genutzt.<br />
    Beispiel für LSYS_RTN_CODES:
    <code>
     $lang = new LanguageSys();<br />
     $languages = $lang->get_aviable_languages();<br />
     &nbsp;&nbsp;print_r($languages);<br />
     $lang->...
    </code>
    Könnte zum Beispiel folgendes ausgeben:
    <cite>
     Array (<br />
     &nbsp;&nbsp;[0] =&gt; de_DE<br />
     &nbsp;&nbsp;[1] =&gt; en_EN<br />
     &nbsp;&nbsp;[2] =&gt; en_US<br />
     )<br />
    </cite>
    Beispiel für LSYS_RTN_NAMES:
    <code>
     $lang = new LanguageSys();<br />
     $languages = $lang->get_aviable_languages(LSYS_RTN_NAMES);<br />
     &nbsp;&nbsp;print_r($languages);<br />
     $lang->...
    </code>
    Würde folgendes ergeben:
    <cite>
     Array (<br />
     &nbsp;&nbsp;[0] =&gt; German (Germany)<br />
     &nbsp;&nbsp;[1] =&gt; English<br />
     &nbsp;&nbsp;[2] =&gt; English (United States of America)<br />
     )<br />
    </cite>
    Beispiel für LSYS_RTN_MIXED:
    <code>
     $lang = new LanguageSys();<br />
     $languages = $lang->get_aviable_languages(LSYS_RTN_MIXED);<br />
     &nbsp;&nbsp;print_r($languages);<br />
     $lang->...
    </code>
    Würde folgendes ergeben:
    <cite>
     Array (<br />
     &nbsp;&nbsp;[de_DE] =&gt; German (Germany)<br />
     &nbsp;&nbsp;[en_EN] =&gt; English<br />
     &nbsp;&nbsp;[en_US] =&gt; English (United States of America)<br />
     )<br />
    </cite>
   </p>
   <h2>LanguageSys::load</h2>
   <p>
    <span class="func">bool load( string language_code )</span><br />
    Die funktion load() wird benutzt, um eine Sprachdatei zu laden,
    nach dem Laden ist die Sprachdatei verfügbar und die Variablen werden
    initialisiert.<br />
    Wenn vorher schon eine Sprachdatei geladen war und eine neue geladen wird
    so werden die Variablen nicht gelöscht, nur die die auch in der neu geladenen
    datei angegeben sind werden überschrieben.<br />
    Dies verhält sich so für den fall, das zum Beispiel eine zu alte Sprachdatei
    verwendet wurde, insofern dann vorher eine Standartsprache geladen wurde sind
    die nicht vorhandenen einträge in der Standartsprache.<br />
    Bei erfolg wird TRUE zurückgegeben, bei einem fehler wird FALSE zurückgegeben.
    Zur fehlerbehandlung siehe LanguageSys::last_error().
    <code>
     $lang = new LanguageSys();<br />
     //Laden der Sprachdatei für Englisch.<br />
     $lang->load('en_EN');<br />
     //Ausgeben des inhaltes &quot;foo&quot;.<br />
     print $lang->foo;<br />
    </code>
   </p>
   <h2>LanguageSys::compile</h2>
   <p>
    <span class="func">bool compile(string sourcefile, string destinationfile)</span><br />
    Die Compile-Funktion wird benutzt, um eine Datei vorzukompilieren.<br />
    Dabei muss für sourcefile und destinationfile ein vollständiger pfad angegeben werden, der resource dir wird nicht benutzt.<br />
    Durch das Kompilieren wird das Parsen erheblich schneller, nach möglichkeit sollten deswegen vorkompilierte datein verwendet werden.<br />
    Mehr dazu siehe &quot;Vorkompilieren&quot;.
    Beispiel:
    <code>
     $lang = new LanguageSys();<br />
     $lang->compile('./uncompiled/en_EN.ini', './compiled/en_EN.lng');<br />
     $lang->...
    </code>
   </p>
   <h2>LanguageSys::_parse</h2>
   <p>
    <span class="func">private mixed _parse( string &amp;code )</span><br />
    Die Methode _parse wird intern von LanguageSys verwendet um die Daten aus einer Vorkompilierten Sprachdatei zu gewinnen.<br />
    Sie ist nicht für den normalen gebrauch gedacht.
   </p>
   <h2>LanguageSys::_pparse</h2>
   <p>
    <span class="func">private mixed _pparse( array &amp;code )</span><br />
    Die Methode _pparse wird intern von LanguageSys verwendet um die Daten aus einer Sprachdatei zu gewinnen.<br />
    Sie ist nicht für den normalen gebrauch gedacht.
   </p>
   <h2>LanguageSys::_error</h2>
   <p>
    <span class="func">private void _error(lsys_error_type type, string message [, int line])</span><br />
    Die Methode _error wird intern von LanguageSys verwendet um einen Fehler in den Fehlerpuffer zu schreiben.<br />
    Sie ist nicht für den normalen gebrauch gedacht. Kann aber sinnvol in abgeleiteten klassen eingesetzt werden.<br />
   </p>
   <h2>LanguageSys::last_error</h2>
   <p>
    <span class="func">string last_error( void )</span><br />
    Gibt den zu letzt aufgetretenen fehler zurück.<br />
    Wenn noch kein fehler aufgetreten ist, so wird FALSE zurückgegeben.<br />
    last_error() wird normalerweise im zusammenhang mit load() und compile() benutzt.<br />
    Beispiel:
    <code>
     ...<br />
     if( !$lang->load('en_EN') )<br />
     {<br />
     &nbsp;&nbsp;die($lang->last_error());<br />
     }<br />
     ...<br />
    </code>
   </p>
   <h2>LanguageSys::get_fileinfo</h2>
   <p>
    <span class="func">string get_fileinfo(string info)</span><br />
    Gibt einen in der sektion [info] der Sprachdatein angegbenen werte zurück.<br />
    Wenn der wert nicht vorhanden ist wird NULL zurückgegeben.<br />
    <code>
     ...<br />
     if( !$lang->load('en_EN') )<br />
     {<br />
     &nbsp;&nbsp;die($lang->last_error());<br />
     }<br />
     //Übersetzungsinformationen ausgeben..<br />
     print $lang->get_fileinfo('translation_info');<br />
     ...<br />
    </code>
   </p>
   <h2>LanguageSys::get_author</h2>
   <p>
    <span class="func">string get_author( void )</span><br />
    Alias für LanguageSys::get_fileinfo('<i>author</i>')
   </p>
   <h2>LanguageSys::get_transinfo</h2>
   <p>
    <span class="func">string get_transinfo( void )</span><br />
    Alias für LanguageSys::get_fileinfo('<i>translation_info</i>')
   </p>
   <h2>LanguageSys::get_version</h2>
   <p>
    <span class="func">string get_version( void )</span><br />
    Alias für LanguageSys::get_fileinfo('<i>version</i>')
   </p>
   <h2>LanguageSys::get_application</h2>
   <p>
    <span class="func">string get_application( void )</span><br />
    Alias für LanguageSys::get_fileinfo('<i>application</i>')
   </p>
  </div>
 </body>
</html>
Return current item: LanguageSys