svn: /phpdoc/de/trunk/reference/info/functions/ version-compare.xml
[email protected] (Raphael Michel)
| Newsgroups | php.doc.de |
|---|---|
| Message-ID | <[email protected]> |
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> <
+ <literal>dev</literal> < <literal>alpha</literal> =
+ <literal>a</literal> < <literal>beta</literal> =
+ <literal>b</literal> < <literal>RC</literal> =
+ <literal>rc</literal> < <literal>#</literal> <
+ <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><</literal>,
+ <literal>lt</literal>, <literal><=</literal>,
+ <literal>le</literal>, <literal>></literal>,
+ <literal>gt</literal>, <literal>>=</literal>,
+ <literal>ge</literal>, <literal>==</literal>,
+ <literal>=</literal>, <literal>eq</literal>,
+ <literal>!=</literal>, <literal><></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
+-->