svn: /phpdoc/de/trunk/reference/info/functions/ version-compare.xml

From: Date: Sat, 19 Feb 2011 17:25:56 +0000
Subject: svn: /phpdoc/de/trunk/reference/info/functions/ version-compare.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-3836@lists.php.net to get a copy of this message
raphaelm Sat, 19 Feb 2011 17:25:56 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=308486 Log: version_compare translated Changed paths: A phpdoc/de/trunk/reference/info/functions/version-compare.xml Added: phpdoc/de/trunk/reference/info/functions/version-compare.xml =================================================================== --- phpdoc/de/trunk/reference/info/functions/version-compare.xml (rev 0) +++ phpdoc/de/trunk/reference/info/functions/version-compare.xml 2011-02-19 17:25:56 UTC (rev 308486) @@ -0,0 +1,190 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: n/a $ --> +<!-- EN-Revision: 297028 Maintainer: raphaelm Status: ready --> +<refentry xml:id="function.version-compare" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>version_compare</refname> + <refpurpose>Vergleicht zwei Versionsnummern im PHP-Stil</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>version_compare</methodname> + <methodparam><type>string</type><parameter>version1</parameter></methodparam> + <methodparam><type>string</type><parameter>version2</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>operator</parameter></methodparam> + </methodsynopsis> + <para> + <function>version_compare</function> vergleicht zwei den PHP-Versionen + angeglichenen Versionsnummern. Dies ist beispielsweise nützlich, wenn + Code nur unter bestimmten Versionen von PHP funktionieren soll. + </para> + <para> + Zuerst ersetzt die Funktion <literal>_</literal>, <literal>-</literal> + und <literal>+</literal> durch einen Punkt <literal>.</literal> in den + Versionsangaben und setzt vor und nach jeder Kette aus nicht-numerischen + Zeichen Punkte ein, sodass beispielsweise '4.3.2RC1' zu '4.3.2.RC.1' + wird. Dann wird diese Zeichenkette an den Punkten aufgespalten wie + wenn man explode('.', $ver) benutzen würde. Anschließend werden von + links nach rechts die Teile verglichen. Wenn ein Teil spezielle Zeichen + enthält, werden diese nach der folgenden Reihenfolge behandelt: + <literal>jede Zeichenkette, die nicht in dieser Liste vorkommt</literal> &lt; + <literal>dev</literal> &lt; <literal>alpha</literal> = + <literal>a</literal> &lt; <literal>beta</literal> = + <literal>b</literal> &lt; <literal>RC</literal> = + <literal>rc</literal> &lt; <literal>#</literal> &lt; + <literal>pl</literal> = <literal>p</literal>. Auf diese Weise können + nicht nur Versionen verschiedener Tiefe wie '4.1' und '4.1.2' sondern + auch alle anderen Versionen verglichen werden, die sich auf bestimmte + Entwicklungsstadien von PHP beziehen. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>version1</parameter></term> + <listitem> + <para> + Erste Versionsnummer. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>version2</parameter></term> + <listitem> + <para> + Zweite Versionsnummer + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>operator</parameter></term> + <listitem> + <para> + Wenn der freiwillige Parameter <parameter>operator</parameter> + angegeben ist, wird auf ein bestimmtes Verhältnis geprüft. + Mögliche Operatoren sind: <literal>&lt;</literal>, + <literal>lt</literal>, <literal>&lt;=</literal>, + <literal>le</literal>, <literal>&gt;</literal>, + <literal>gt</literal>, <literal>&gt;=</literal>, + <literal>ge</literal>, <literal>==</literal>, + <literal>=</literal>, <literal>eq</literal>, + <literal>!=</literal>, <literal>&lt;&gt;</literal>, + <literal>ne</literal>. + </para> + <para> + Dieser Parameter berücksicht Groß- und Kleinschreibung, die Werte + sollten alle kleingeschrieben werden, + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Standardmäßig gibt <function>version_compare</function> <literal>-1</literal> + zurück, wenn die erste Version kleiner ist als die zweite, + <literal>0</literal>, wenn die Versionen gleich sind und + <literal>1</literal>, wenn die zweite Version kleiner ist. + </para> + <para> + Wenn der optionale Parameter <parameter>operator</parameter> übergeben + wurde, gibt die Funktion &true; oder &false; zurück, je nach dem, ob + das mit dem Operator definierte Verhältnis der Wahrheit entspricht + oder nicht. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + The examples below use the <constant>PHP_VERSION</constant> constant, + because it contains the value of the PHP version that is executing + the code. + Das untenstehende Beispiel benutzt die Konstante <constant>PHP_VERSION</constant>, + die die Version des aktuell ausführenden PHP-Interpreters enthält. + </para> + <para> + <example> + <title><function>version_compare</function>-Beispiele</title> + <programlisting role="php"> +<![CDATA[ +<?php +if (version_compare(PHP_VERSION, '6.0.0') >= 0) { + echo 'Ich bin mindestens PHP 6.0.0, und zwar: ' . PHP_VERSION . "\n"; +} + +if (version_compare(PHP_VERSION, '5.3.0') >= 0) { + echo 'Ich bin mindestens PHP 5.3.0, nämlich: ' . PHP_VERSION . "\n"; +} + +if (version_compare(PHP_VERSION, '5.0.0', '>=')) { + echo 'Ich bin PHP 5. Meine Versionsnummer lautet: ' . PHP_VERSION . "\n"; +} + +if (version_compare(PHP_VERSION, '5.0.0', '<')) { + echo 'Ich bin PHP 4. Meine Versionsnummer lautet: ' . PHP_VERSION . "\n"; +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Die Konstante <constant>PHP_VERSION</constant> enthält die aktuelle + PHP-Version + </para> + </note> + <note> + <para> + Vorveröffentlichte Versionen wie 5.3.0-dev werden als kleiner erkannt + als ihre finalen Veröffentlichungen wie 5.3.0. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>phpversion</function></member> + <member><function>php_uname</function></member> + <member><function>function_exists</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> + +<!-- 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:"~/.phpdoc/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 +-->

« previous php.doc.de (#3836) next »