cvs: phpdoc-cs /reference/bzip2 configure.xml reference.xml /reference/bzip2/functions bzopen.xml /reference/datetime reference.xml /reference/datetime/functions checkdate.xml date.xml getdate.xml gmdate.xml gmmktime.xml gmstrftime.xml localtime.xml microtime.xml mktime.xml strftime.xml
[email protected] ("Jakub Vrana") Mon, 08 Dec 2003 15:12:59 -0000
| Newsgroups | php.doc.cs |
|---|---|
| Message-ID | <cvsvrana1070896379@cvsserver> |
vrana Mon Dec 8 10:12:59 2003 EDT
Added files:
/phpdoc-cs/reference/bzip2 configure.xml
Modified files:
/phpdoc-cs/reference/bzip2 reference.xml
/phpdoc-cs/reference/bzip2/functions bzopen.xml
/phpdoc-cs/reference/datetime reference.xml
/phpdoc-cs/reference/datetime/functions checkdate.xml date.xml
getdate.xml gmdate.xml
gmmktime.xml gmstrftime.xml
localtime.xml microtime.xml
mktime.xml strftime.xml
Log:
Make up to date
vrana-20031208101259.txt
(text/plain, 41.8 KB)
Index: phpdoc-cs/reference/bzip2/reference.xml
diff -u phpdoc-cs/reference/bzip2/reference.xml:1.1 phpdoc-cs/reference/bzip2/reference.xml:1.2
--- phpdoc-cs/reference/bzip2/reference.xml:1.1 Fri Jun 21 17:42:31 2002
+++ phpdoc-cs/reference/bzip2/reference.xml Mon Dec 8 10:12:54 2003
@@ -19,18 +19,11 @@
<para>
Tento modul pou¾ívá funkce z knihovny <ulink
url="&url.bzip2;">bzip2</ulink> od Juliana Sewarda.
+ Tento modul vy¾aduje bzip2/libbzip2 verze >= 1.0.x.
</para>
</section>
- <section id="bzip2.installation">
- &reftitle.install;
- <para>
- Podpora bzip2 není v PHP implicitnì k dispozici. K aktivaci budete muset
- pøi kompilaci PHP pou¾ít konfiguraèní volbu
- <link linkend="install.configure.with-bz2">--with-bz2</link>. Tento modul
- vy¾aduje bzip2/libbzip2 verze >= 1.0.x.
- </para>
- </section>
+ &reference.bzip2.configure;
<section id="bzip2.configuration">
&reftitle.runtime;
Index: phpdoc-cs/reference/bzip2/functions/bzopen.xml
diff -u phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.1 phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.2
--- phpdoc-cs/reference/bzip2/functions/bzopen.xml:1.1 Sat Aug 3 18:55:51 2002
+++ phpdoc-cs/reference/bzip2/functions/bzopen.xml Mon Dec 8 10:12:56 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: luk Status: ready -->
<refentry id="function.bzopen">
<refnamediv>
@@ -30,7 +30,10 @@
<![CDATA[
<?php
$bz = bzopen("/tmp/foo.bz2", "r");
-$decompressed_file = bzread($bz, filesize("/tmp/foo.bz2"));
+$decompressed_file = '';
+while (!feof($bz)) {
+ $decompressed_file .= bzread($bz, 4096);
+}
bzclose($bz);
print( "Obsah souboru /tmp/foo.bz2 je: " );
Index: phpdoc-cs/reference/datetime/reference.xml
diff -u phpdoc-cs/reference/datetime/reference.xml:1.1 phpdoc-cs/reference/datetime/reference.xml:1.2
--- phpdoc-cs/reference/datetime/reference.xml:1.1 Sat Aug 3 18:55:51 2002
+++ phpdoc-cs/reference/datetime/reference.xml Mon Dec 8 10:12:57 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.3 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: luk Status: ready -->
<reference id="ref.datetime">
<title>Funkce pro datum a èas</title>
@@ -8,14 +8,14 @@
<section id="datetime.intro">
&reftitle.intro;
<para>
- Tyto funkce mù¾ete pou¾ít k práci s datem a èasem. Umo¾òují získat datum
- a èas ze serveru, na kterém PHP bì¾í. Lze je pou¾ít k formátování zápisu
+ Tyto funkce vám umo¾òují získat datum a èas ze serveru,
+ na kterém bì¾í PHP skripty. Lze je pou¾ít k formátování zápisu
èasu a data mnoha rùznými zpùsoby.
</para>
<note>
<simpara>
Uvìdomte si prosím, ¾e tyto funkce závisí na národním nastavení va¹eho
- serveru. Zvlá¹tní pozornost vìnujte letnímu èasu a pøestupným rokùm!
+ serveru. Zvlá¹tní pozornost vìnujte letnímu èasu a pøestupným rokùm!
</simpara>
</note>
Index: phpdoc-cs/reference/datetime/functions/checkdate.xml
diff -u phpdoc-cs/reference/datetime/functions/checkdate.xml:1.1 phpdoc-cs/reference/datetime/functions/checkdate.xml:1.2
--- phpdoc-cs/reference/datetime/functions/checkdate.xml:1.1 Sat Aug 3 18:55:51 2002
+++ phpdoc-cs/reference/datetime/functions/checkdate.xml Mon Dec 8 10:12:58 2003
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: luk Status: ready -->
<refentry id="function.checkdate">
<refnamediv>
<refname>checkdate</refname>
- <refpurpose>Zkontroluje gregoriánské datum/èas</refpurpose>
+ <refpurpose>Zkontroluje gregoriánské datum</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
Index: phpdoc-cs/reference/datetime/functions/date.xml
diff -u phpdoc-cs/reference/datetime/functions/date.xml:1.1 phpdoc-cs/reference/datetime/functions/date.xml:1.2
--- phpdoc-cs/reference/datetime/functions/date.xml:1.1 Sat Aug 3 18:55:51 2002
+++ phpdoc-cs/reference/datetime/functions/date.xml Mon Dec 8 10:12:58 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.4 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.9 Maintainer: luk Status: ready -->
<refentry id="function.date">
<refnamediv>
@@ -17,7 +17,8 @@
<para>
Vrací øetìzec formátovaný podle daného formátovacího øetìzce s pou¾itím
daného celoèíselného èasového razítka <parameter>timestamp</parameter>
- nebo aktuálního místního èasu (není-li èasové razítko zadáno).
+ nebo aktuálního místního èasu (není-li èasové razítko zadáno). Jinými slovy, parametr <parameter>timestamp</parameter>
+ je nepovinný a jeho výchozí hodnota je výsledek funkce <function>time</function>.
<note>
<para>
Platný rozsah pro èasové razítko je typicky od pátku 13.12.1901
@@ -29,183 +30,206 @@
K vygenerování èasového razítka z øetìzce reprezentujícího datum
lze pou¾ít funkci <function>strtotime</function>. Navíc nìkteré
databáze mají funkce, které konvertují jejich datové formáty na
- èasová razítka (napø. funce UNIX_TIMESTAMP v MySQL).
+ èasová razítka (napø. funce <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink> v MySQL).
</para>
</note>
</para>
<para>
- Ve formátovacím øetìzci lze pou¾ívat tyto znaky:
- <itemizedlist>
- <listitem>
- <simpara>
- a - "am" nebo "pm"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- A - "AM" nebo "PM"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- B - internetový èas Swatch ("zavináèe")
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- d - den v mìsíci, 2 èíslice s úvodními nulami, "01" a¾ "31"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- D - den v týdnu, textovì, 3 písmena, napø. "Fri"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- F - mìsíc, textovì, dlouhý název, napø. "January"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- g - hodina, 12-hodinový formát bez úvodních nul, "1" a¾ "12"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- G - hodina, 24-hodinový formát bez úvodních nul, "0" a¾ "23"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- h - hodina, 12-hodinový formát, "01" a¾ "12"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- H - hodina, 24-hodinový formát, "00" a¾ "23"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- i - minuty, "00" a¾ "59"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- I (velké i) - "1" pro letní èas, jinak "0"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- j - den v mìsíci bez úvodních nul, napø. "1" a¾ "31"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- l (malé 'L') - den v týdnu, textovì, dlouhý název, napø. "Friday"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- L - pravdivostní hodnota urèující, zda je pøestupný rok, "0" nebo "1"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- m - mìsíc, "01" a¾ "12"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- M - mìsíc, textovì, 3 písmena, napø. "Jan"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- n - mìsíc bez úvodních nul, "1" a¾ "12"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- O - odchylka od greenwichského èasu v hodinách, napø. "+0200"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- r - datum formátované podle RFC 822, napø.
- "Thu, 21 Dec 2000 16:01:07 +0200" (pøidáno v PHP 4.0.4)
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- s - sekundy, "00" a¾ "59"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- S - anglická pøípona øadové èíslovky pro den v mìsíci, 2 znaky,
- "st", "nd", "rd" nebo "th"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- t - poèet dní v daném mìsíci, "28" a¾ "31"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- T - èasová zóna nastavená na serveru, napø. "EST" nebo "MDT"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- U - sekundy od Unix Epoch (1.1.1970 00:00:00 GMT)
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- w - den v týdnu, èíselnì, "0" (nedìle) a¾ "6" (sobota)
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- W - poèet týdnù v roce podle ISO-8601, týden zaèíná v pondìlí
- (pøidáno v PHP 4.1.0)
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Y - rok, 4 èíslice, napø. "1999"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- y - rok, 2 èíslice, napø. "99"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- z - den v roce, "0" a¾ "365"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Z - èasový posun v sekundách ("-43200" a¾ "43200"). Posun má pro èasové
- zóny na západ od UTC zápornou hodnotu, na východ kladnou.
- </simpara>
- </listitem>
- </itemizedlist>
+ <table>
+ <title>Ve formátovacím øetìzci lze pou¾ívat tyto
+ znaky:</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>znak parametru <parameter>format</parameter></entry>
+ <entry>Popis</entry>
+ <entry>Ukázka vracených hodnot</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>a</literal></entry>
+ <entry>Pøíznak dopoledne/odpoledne malými písmeny</entry>
+ <entry><literal>am</literal> nebo <literal>pm</literal></entry>
+ </row>
+ <row>
+ <entry><literal>A</literal></entry>
+ <entry>Pøíznak dopoledne/odpoledne velkými písmeny</entry>
+ <entry><literal>AM</literal> nebo <literal>PM</literal></entry>
+ </row>
+ <row>
+ <entry><literal>B</literal></entry>
+ <entry>Internetový èas Swatch</entry>
+ <entry><literal>000</literal> a¾ <literal>999</literal></entry>
+ </row>
+ <row>
+ <entry><literal>d</literal></entry>
+ <entry>Den mìsíce, dvì èíslice s úvodními nulami</entry>
+ <entry><literal>01</literal> a¾ <literal>31</literal></entry>
+ </row>
+ <row>
+ <entry><literal>D</literal></entry>
+ <entry>Textová reprezentace dne, tøi znaky</entry>
+ <entry><literal>Mon</literal> a¾ <literal>Sun</literal></entry>
+ </row>
+ <row>
+ <entry><literal>F</literal></entry>
+ <entry>Plná textová reprezentace mìsíce typu January nebo March</entry>
+ <entry><literal>January</literal> a¾ <literal>December</literal></entry>
+ </row>
+ <row>
+ <entry><literal>g</literal></entry>
+ <entry>12-hodinový formát hodiny bez úvodních nul</entry>
+ <entry><literal>1</literal> a¾ <literal>12</literal></entry>
+ </row>
+ <row>
+ <entry><literal>G</literal></entry>
+ <entry>24-hodinový formát hodiny bez úvodních nul</entry>
+ <entry><literal>0</literal> a¾ <literal>23</literal></entry>
+ </row>
+ <row>
+ <entry><literal>h</literal></entry>
+ <entry>12-hodinový formát hodiny s úvodními nulami</entry>
+ <entry><literal>01</literal> a¾ <literal>12</literal></entry>
+ </row>
+ <row>
+ <entry><literal>H</literal></entry>
+ <entry>24-hodinový formát hodiny s úvodními nulami</entry>
+ <entry><literal>00</literal> a¾ <literal>23</literal></entry>
+ </row>
+ <row>
+ <entry><literal>i</literal></entry>
+ <entry>Minuty s úvodními nulami</entry>
+ <entry><literal>00</literal> a¾ <literal>59</literal></entry>
+ </row>
+ <row>
+ <entry><literal>I</literal> (velké i)</entry>
+ <entry>Zji¹tìní, zda je letní èas</entry>
+ <entry><literal>1</literal> pokud je letní èas, <literal>0</literal> jinak.</entry>
+ </row>
+ <row>
+ <entry><literal>j</literal></entry>
+ <entry>Den mìsíce bez úvodních nul</entry>
+ <entry><literal>1</literal> a¾ <literal>31</literal></entry>
+ </row>
+ <row>
+ <entry><literal>l</literal> (malé 'L')</entry>
+ <entry>Plná textová reprezentace dne v týdnu</entry>
+ <entry><literal>Sunday</literal> a¾ <literal>Saturday</literal></entry>
+ </row>
+ <row>
+ <entry><literal>L</literal></entry>
+ <entry>Zji¹tìní, zda je rok pøestupný</entry>
+ <entry><literal>1</literal> pokud je pøestupný rok, <literal>0</literal> jinak.</entry>
+ </row>
+ <row>
+ <entry><literal>m</literal></entry>
+ <entry>Èíselná reprezentace mìsíce s úvodními nulami</entry>
+ <entry><literal>01</literal> a¾ <literal>12</literal></entry>
+ </row>
+ <row>
+ <entry><literal>M</literal></entry>
+ <entry>Krátká textová reprezentace mìsíce, tøi znaky</entry>
+ <entry><literal>Jan</literal> a¾ <literal>Dec</literal></entry>
+ </row>
+ <row>
+ <entry><literal>n</literal></entry>
+ <entry>Èíselná reprezentace mìsíce bez úvodních nul</entry>
+ <entry><literal>1</literal> a¾ <literal>12</literal></entry>
+ </row>
+ <row>
+ <entry><literal>O</literal></entry>
+ <entry>Odchylka od Greenwichského èasu (GMT) v hodinách</entry>
+ <entry>Pøíklad: <literal>+0200</literal></entry>
+ </row>
+ <row>
+ <entry><literal>r</literal></entry>
+ <entry>Datum formátované podle RFC 822</entry>
+ <entry>Pøíklad: <literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry>
+ </row>
+ <row>
+ <entry><literal>s</literal></entry>
+ <entry>Sekundy s úvodními nulami</entry>
+ <entry><literal>00</literal> a¾ <literal>59</literal></entry>
+ </row>
+ <row>
+ <entry><literal>S</literal></entry>
+ <entry>Anglická poøadová pøípona dne v mìsíci, 2 znaky</entry>
+ <entry>
+ <literal>st</literal>, <literal>nd</literal>, <literal>rd</literal> nebo
+ <literal>th</literal>. Dobøe funguje s <literal>j</literal>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>t</literal></entry>
+ <entry>Poèet dní v daném mìsíci</entry>
+ <entry><literal>28</literal> a¾ <literal>31</literal></entry>
+ </row>
+ <row>
+ <entry><literal>T</literal></entry>
+ <entry>Nastavení èasového pásma na tomto poèítaèi</entry>
+ <entry>Pøíklady: <literal>EST</literal>, <literal>MDT</literal> ...</entry>
+ </row>
+ <row>
+ <entry><literal>U</literal></entry>
+ <entry>Sekundy od poèátku éry Unix (1. ledna 1970 00:00:00 GMT)</entry>
+ <entry>Viz také <function>time</function></entry>
+ </row>
+ <row>
+ <entry><literal>w</literal></entry>
+ <entry>Èíselná reprezentace dne v týdnu</entry>
+ <entry><literal>0</literal> (pro nedìli) a¾ <literal>6</literal> (pro sobotu)</entry>
+ </row>
+ <row>
+ <entry><literal>W</literal></entry>
+ <entry>Èíslo týdne podle ISO-8601, týdny zaèínají v pondìlí (doplnìno v PHP 4.1.0)</entry>
+ <entry>Pøíklad: <literal>42</literal> (42. týden v roce)</entry>
+ </row>
+ <row>
+ <entry><literal>Y</literal></entry>
+ <entry>Plná èíselná reprezentace roku, 4 èíslice</entry>
+ <entry>Pøíklady: <literal>1999</literal> nebo <literal>2003</literal></entry>
+ </row>
+ <row>
+ <entry><literal>y</literal></entry>
+ <entry>Dvouciferná reprezentace roku</entry>
+ <entry>Pøíklady: <literal>99</literal> nebo <literal>03</literal></entry>
+ </row>
+ <row>
+ <entry><literal>z</literal></entry>
+ <entry>Den v roce</entry>
+ <entry><literal>0</literal> a¾ <literal>366</literal></entry>
+ </row>
+ <row>
+ <entry><literal>Z</literal></entry>
+ <entry>Posun èasového pásma v sekundách. Posun èasových pásem západnì od UTC je v¾dy
+ záporný, východnì od UTC je v¾dy kladný.</entry>
+ <entry><literal>-43200</literal> a¾ <literal>43200</literal></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
Nerozpoznané znaky ve formátovacím øetìzci se vytiskou tak, jak jsou.
- Pøi pou¾ití <function>gmdate</function> má formát "Z" v¾dy hodnotu 0.
+ Pøi pou¾ití <function>gmdate</function> má formát <literal>Z</literal>
+ v¾dy hodnotu <literal>0</literal>.
</para>
<para>
<example>
- <title>Pøíklad - <function>date</function></title>
+ <title>Pøíklady - <function>date</function></title>
<programlisting role="php">
<![CDATA[
+<?php
+// Vytiskne nìco jako: Wednesday
+echo date("l");
+
+// Vytiskne nìco jako: Wednesday 15th of January 2003 05:51:38 AM
echo date ("l dS of F Y h:i:s A");
+
+// Vytiskne: July 1, 2000 is on a Saturday
echo "July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000));
+?>
]]>
</programlisting>
</example>
@@ -219,7 +243,10 @@
<title>Ochrana znakù ve funkci <function>date</function></title>
<programlisting role="php">
<![CDATA[
-echo date("l \\t\h\e jS"); // vytiskne nìco jako 'Saturday the 8th'
+<?php
+// vytiskne nìco jako 'Saturday the 8th'
+echo date("l \\t\h\e jS");
+?>
]]>
</programlisting>
</example>
@@ -232,9 +259,11 @@
</title>
<programlisting role="php">
<![CDATA[
+<?php
$tomorrow = mktime (0,0,0,date("m") ,date("d")+1,date("Y"));
$lastmonth = mktime (0,0,0,date("m")-1,date("d"), date("Y"));
$nextyear = mktime (0,0,0,date("m"), date("d"), date("Y")+1);
+?>
]]>
</programlisting>
</example>
@@ -258,7 +287,8 @@
</title>
<programlisting role="php">
<![CDATA[
-/* Dnes je 10. bøezna 2001, 5:16:18 odpoledne */
+<?php
+// Pøedpokládejme, ¾e dnes je 10. bøezna 2001, 17:16:18
$today = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm
$today = date("m.d.y"); // 03.10.01
$today = date("j, n, Y"); // 10, 3, 2001
@@ -268,6 +298,7 @@
$today = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001
$today = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:17 m is month
$today = date("H:i:s"); // 17:16:17
+?>
]]>
</programlisting>
</example>
Index: phpdoc-cs/reference/datetime/functions/getdate.xml
diff -u phpdoc-cs/reference/datetime/functions/getdate.xml:1.1 phpdoc-cs/reference/datetime/functions/getdate.xml:1.2
--- phpdoc-cs/reference/datetime/functions/getdate.xml:1.1 Sat Aug 10 19:37:15 2002
+++ phpdoc-cs/reference/datetime/functions/getdate.xml Mon Dec 8 10:12:58 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: luk Status: ready -->
<refentry id="function.getdate">
<refnamediv>
@@ -16,73 +16,121 @@
Vrací asociativní pole obsahující informaci o datu (èase) v argumentu
<parameter>timestamp</parameter> nebo aktuální místní èas (pokud není
argument pøítomen), jako tyto elementy:
- <itemizedlist>
- <listitem>
- <simpara>
- "seconds" - sekundy
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "minutes" - minuty
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "hours" - hodiny
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "mday" - den v mìsíci
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "wday" - den v týdnu, èíselnì: od 0 (nedìle) do 6 (sobota)
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "mon" - mìsíc, èíselnì
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "year" - rok, èíselnì
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "yday" - den v roce, èíselnì; napø. "299"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "weekday" - den v týdnu, textovì, plný název; napø. "Friday"
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- "month" - mìsíc, textovì, plný název; napø. "January"
- </simpara>
- </listitem>
- </itemizedlist>
+ </para>
+ <para>
+ <table>
+ <title>Klíèe vráceného asociativního pole</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Klíè</entry>
+ <entry>Popis</entry>
+ <entry>Ukázka vracených hodnot</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>"seconds"</literal></entry>
+ <entry>Èíselná reprezentace sekund</entry>
+ <entry><literal>0</literal> a¾ <literal>59</literal></entry>
+ </row>
+ <row>
+ <entry><literal>"minutes"</literal></entry>
+ <entry>Èíselná reprezentace minut</entry>
+ <entry><literal>0</literal> a¾ <literal>59</literal></entry>
+ </row>
+ <row>
+ <entry><literal>"hours"</literal></entry>
+ <entry>Èíselná reprezentace hodin</entry>
+ <entry><literal>0</literal> a¾ <literal>23</literal></entry>
+ </row>
+ <row>
+ <entry><literal>"mday"</literal></entry>
+ <entry>Èíselná reprezentace dne v mìsíci</entry>
+ <entry><literal>1</literal> a¾ <literal>31</literal></entry>
+ </row>
+ <row>
+ <entry><literal>"wday"</literal></entry>
+ <entry>Èíselná reprezentace dne v týdnu</entry>
+ <entry><literal>0</literal> (pro nedìli) a¾ <literal>6</literal> (pro sobotu)</entry>
+ </row>
+ <row>
+ <entry><literal>"mon"</literal></entry>
+ <entry>Èíselná reprezentace mìsíce</entry>
+ <entry><literal>1</literal> a¾ <literal>12</literal></entry>
+ </row>
+ <row>
+ <entry><literal>"year"</literal></entry>
+ <entry>Plná èíselná reprezentace roku, 4 èíslice</entry>
+ <entry>Pøíklady: <literal>1999</literal> nebo <literal>2003</literal></entry>
+ </row>
+ <row>
+ <entry><literal>"yday"</literal></entry>
+ <entry>Èíselná reprezentace dne v roce</entry>
+ <entry><literal>0</literal> a¾ <literal>366</literal></entry>
+ </row>
+ <row>
+ <entry><literal>"weekday"</literal></entry>
+ <entry>Plná textová reprezentace dne v týdnu</entry>
+ <entry><literal>Sunday</literal> a¾ <literal>Saturday</literal></entry>
+ </row>
+ <row>
+ <entry><literal>"month"</literal></entry>
+ <entry>Plná textová reprezentace mìsíce</entry>
+ <entry><literal>January</literal> a¾ <literal>December</literal></entry>
+ </row>
+ <row>
+ <entry><literal>0</literal></entry>
+ <entry>Sekundy éry Unixu, obdobnì jako hodnoty vracené funkcí
+ <function>time</function> a pou¾ívané funkcí <function>date</function>.</entry>
+ <entry>Závislé na systému, typicky <literal>-2147483648</literal> a¾
+ <literal>2147483647</literal>.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
<example>
<title>
Pøíklad - <function>getdate</function>
</title>
<programlisting role="php">
<![CDATA[
-$today = getdate();
-$month = $today['month'];
-$mday = $today['mday'];
-$year = $today['year'];
-echo "$month $mday, $year";
+<?php
+$today = getdate();
+print_r($today);
+?>
]]>
</programlisting>
+ <para>
+ Výstup bude vypadat zhruba takto:
+ </para>
+ <screen>
+<![CDATA[
+Array
+(
+ [seconds] => 40
+ [minutes] => 58
+ [hours] => 21
+ [mday] => 17
+ [wday] => 2
+ [mon] => 6
+ [year] => 2003
+ [yday] => 167
+ [weekday] => Tuesday
+ [month] => June
+ [0] => 1055901520
+)
+]]>
+ </screen>
</example>
</para>
+ <para>
+ Viz také <function>date</function>,
+ <function>time</function> a
+ <function>setlocale</function>.
+ </para>
</refsect1>
</refentry>
Index: phpdoc-cs/reference/datetime/functions/gmdate.xml
diff -u phpdoc-cs/reference/datetime/functions/gmdate.xml:1.1 phpdoc-cs/reference/datetime/functions/gmdate.xml:1.2
--- phpdoc-cs/reference/datetime/functions/gmdate.xml:1.1 Tue Sep 3 16:20:51 2002
+++ phpdoc-cs/reference/datetime/functions/gmdate.xml Mon Dec 8 10:12:58 2003
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.7 Maintainer: luk Status: ready -->
<refentry id="function.gmdate">
<refnamediv>
<refname>gmdate</refname>
- <refpurpose>Formátuje datum/èas GMT/CUT</refpurpose>
+ <refpurpose>Formátuje datum/èas GMT/UTC</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -21,12 +21,34 @@
<title>Pøíklad - <function>gmdate</function></title>
<programlisting role="php">
<![CDATA[
+<?php
echo date ("M d Y H:i:s", mktime (0,0,0,1,1,1998));
echo gmdate ("M d Y H:i:s", mktime (0,0,0,1,1,1998));
+?>
]]>
</programlisting>
</example>
</para>
+ <note>
+ <para>
+ V operaèním systému Microsoft Windows jsou systémové
+ knihovny implementující tuto funkci po¹kozené, tak¾e
+ funkce <function>gmdate</function> nepodporuje negativní hodnoty
+ parametru <parameter>timestamp</parameter>.
+ Blí¾e viz bug-reporty:
+ <ulink url="&url.php.bugs;22620">#22620</ulink>,
+ <ulink url="&url.php.bugs;22457">#22457</ulink>
+ a <ulink url="&url.php.bugs;14391">#14391</ulink>.
+ </para>
+ <para>
+ K tomuto problému nedochází v operaèních systémech Unix/Linux, kde
+ se systémové knihovny chovají podle oèekávání.
+ </para>
+ <para>
+ PHP nemá moc opravit po¹kozené systémové knihovny. Kontaktujte
+ prodejce svého OS, aby tento a podobné problémy opravil.
+ </para>
+ </note>
<para>
Viz také <function>date</function>, <function>mktime</function>,
<function>gmmktime</function> a <function>strftime</function>.
Index: phpdoc-cs/reference/datetime/functions/gmmktime.xml
diff -u phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.1 phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.2
--- phpdoc-cs/reference/datetime/functions/gmmktime.xml:1.1 Tue Sep 3 16:20:51 2002
+++ phpdoc-cs/reference/datetime/functions/gmmktime.xml Mon Dec 8 10:12:58 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: luk Status: ready -->
<refentry id="function.gmmktime">
<refnamediv>
<refname>gmmktime</refname>
@@ -9,18 +9,23 @@
<title>Popis</title>
<methodsynopsis>
<type>int</type><methodname>gmmktime</methodname>
- <methodparam><type>int</type><parameter>hour</parameter></methodparam>
- <methodparam><type>int</type><parameter>minute</parameter></methodparam>
- <methodparam><type>int</type><parameter>second</parameter></methodparam>
- <methodparam><type>int</type><parameter>month</parameter></methodparam>
- <methodparam><type>int</type><parameter>day</parameter></methodparam>
- <methodparam><type>int</type><parameter>year</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>hour</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>minute</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>month</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam>
</methodsynopsis>
<para>
Identické k <function>mktime</function>, kromì toho, ¾e parametry
reprezentují datum/èas v GMT.
</para>
+ <para>
+ Podobnì jako u funkce <function>mktime</function> mohou být parametry vynechány v poøadí
+ zprava doleva. Neuvedené parametry budou nastaveny
+ na odpovídající hodnotu souèasného GMT.
+ </para>
</refsect1>
</refentry>
Index: phpdoc-cs/reference/datetime/functions/gmstrftime.xml
diff -u phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.1 phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.2
--- phpdoc-cs/reference/datetime/functions/gmstrftime.xml:1.1 Tue Sep 3 16:20:51 2002
+++ phpdoc-cs/reference/datetime/functions/gmstrftime.xml Mon Dec 8 10:12:58 2003
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.3 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: luk Status: ready -->
<refentry id="function.gmstrftime">
<refnamediv>
<refname>gmstrftime</refname>
<refpurpose>
- Formátuje datum/èas v GMT/CUT vzhledem k národnímu nastavení
+ Formátuje datum/èas v GMT/UTC vzhledem k národnímu nastavení
</refpurpose>
</refnamediv>
<refsect1>
@@ -23,9 +23,11 @@
<title><function>gmstrftime</function> example</title>
<programlisting role="php">
<![CDATA[
+<?php
setlocale (LC_TIME, 'en_US');
echo strftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n";
echo gmstrftime ("%b %d %Y %H:%M:%S", mktime (20,0,0,12,31,98))."\n";
+?>
]]>
</programlisting>
</example>
Index: phpdoc-cs/reference/datetime/functions/localtime.xml
diff -u phpdoc-cs/reference/datetime/functions/localtime.xml:1.1 phpdoc-cs/reference/datetime/functions/localtime.xml:1.2
--- phpdoc-cs/reference/datetime/functions/localtime.xml:1.1 Tue Sep 3 16:20:51 2002
+++ phpdoc-cs/reference/datetime/functions/localtime.xml Mon Dec 8 10:12:58 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: luk Status: ready -->
<refentry id="function.localtime">
<refnamediv>
@@ -21,7 +21,8 @@
Funkce <function>localtime</function> vrací pole strukturálnì identické
k návratové hodnotì volání v C. První argument funkce
<function>localtime</function> je èasové razítko; není-li dáno, pou¾ije
- se aktuální èas. Druhý argument <function>localtime</function> je
+ se aktuální èas, který vrátí funkce <function>time</function>.
+ Druhý argument <function>localtime</function> je
<parameter>is_associative</parameter>, který (nastavením na nulu)
signalizuje, ¾e vracené pole je obyèejné, èíselnì indexované pole.
Je-li argument nastaven na 1, potom <function>localtime</function>
Index: phpdoc-cs/reference/datetime/functions/microtime.xml
diff -u phpdoc-cs/reference/datetime/functions/microtime.xml:1.1 phpdoc-cs/reference/datetime/functions/microtime.xml:1.2
--- phpdoc-cs/reference/datetime/functions/microtime.xml:1.1 Tue Sep 3 16:20:51 2002
+++ phpdoc-cs/reference/datetime/functions/microtime.xml Mon Dec 8 10:12:58 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: luk Status: ready -->
<refentry id="function.microtime">
<refnamediv>
@@ -25,6 +25,7 @@
<title>Pøíklad - <function>microtime</function></title>
<programlisting role="php">
<![CDATA[
+<?php
function getmicrotime(){
list($usec, $sec) = explode(" ",microtime());
return ((float)$usec + (float)$sec);
@@ -40,6 +41,7 @@
$time = $time_end - $time_start;
echo "Nic se nedìlalo $time sekund";
+?>
]]>
</programlisting>
</example>
Index: phpdoc-cs/reference/datetime/functions/mktime.xml
diff -u phpdoc-cs/reference/datetime/functions/mktime.xml:1.1 phpdoc-cs/reference/datetime/functions/mktime.xml:1.2
--- phpdoc-cs/reference/datetime/functions/mktime.xml:1.1 Tue Sep 3 16:20:51 2002
+++ phpdoc-cs/reference/datetime/functions/mktime.xml Mon Dec 8 10:12:58 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: luk Status: ready -->
<refentry id="function.mktime">
<refnamediv>
@@ -10,12 +10,12 @@
<title>Popis</title>
<methodsynopsis>
<type>int</type><methodname>mktime</methodname>
- <methodparam><type>int</type><parameter>hour</parameter></methodparam>
- <methodparam><type>int</type><parameter>minute</parameter></methodparam>
- <methodparam><type>int</type><parameter>second</parameter></methodparam>
- <methodparam><type>int</type><parameter>month</parameter></methodparam>
- <methodparam><type>int</type><parameter>day</parameter></methodparam>
- <methodparam><type>int</type><parameter>year</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>hour</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>minute</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>month</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam>
</methodsynopsis>
<para>
@@ -54,10 +54,12 @@
<title>Pøíklad - <function>mktime</function></title>
<programlisting role="php">
<![CDATA[
+<?php
echo date ("M-d-Y", mktime (0,0,0,12,32,1997));
echo date ("M-d-Y", mktime (0,0,0,13,1,1997));
echo date ("M-d-Y", mktime (0,0,0,1,1,1998));
echo date ("M-d-Y", mktime (0,0,0,1,1,98));
+?>
]]>
</programlisting>
</example>
@@ -65,7 +67,17 @@
èíslicemi, s hodnotami 0-69 mapovanými na 2000-2069 a 70-99 na
1970-1999 (na systémech, kde time_t je 32bitové celé èíslo se znaménkem,
jak je dnes obvyklé, budou platné hodnoty pro <parameter>year</parameter>
- nìkde mezi 1902 a 2037).
+ nìkde mezi 1901 a 2038).
+ </para>
+ <para>
+ <note>
+ <title>Windows</title>
+ <simpara>
+ Záporné èasové znaèky nejsou podporovány v ¾ádné známé
+ verzi Windows. Platné rozmezí rokù je proto pouze 1970
+ a¾ 2038.
+ </simpara>
+ </note>
</para>
<para>
Poslední den daného mìsíce mù¾e být vyjádøen jako den "0" mìsíce pøí¹tího,
@@ -75,11 +87,13 @@
<title>Poslední den mìsíce</title>
<programlisting role="php">
<![CDATA[
+<?php
$lastday = mktime (0,0,0,3,0,2000);
echo strftime ("Last day in Feb 2000 is: %d", $lastday);
$lastday = mktime (0,0,0,4,-31,2000);
echo strftime ("Last day in Feb 2000 is: %d", $lastday);
+?>
]]>
</programlisting>
</example>
Index: phpdoc-cs/reference/datetime/functions/strftime.xml
diff -u phpdoc-cs/reference/datetime/functions/strftime.xml:1.1 phpdoc-cs/reference/datetime/functions/strftime.xml:1.2
--- phpdoc-cs/reference/datetime/functions/strftime.xml:1.1 Thu Sep 26 16:22:18 2002
+++ phpdoc-cs/reference/datetime/functions/strftime.xml Mon Dec 8 10:12:58 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.2 Maintainer: luk Status: ready -->
+<!-- EN-Revision: 1.10 Maintainer: luk Status: ready -->
<refentry id="function.strftime">
<refnamediv>
@@ -228,30 +228,100 @@
<para>
V¹echny konverzní specifikátory nemusí být podporovány va¹í C knihovnou,
potom nebudou podporovány ani funkcí <function>strftime</function>
- v PHP. To znamená, ¾e %T a %D nebudou fungovat na Windows.
+ v PHP. Kromì toho také ne v¹echny platformy
+ podporují práci s negativními èasovými znaèkami, tak¾e rozsah mo¾ných datumù
+ mù¾e být omezen zaèátkem éry Unixu. To znamená, ¾e
+ napø. %e, %T, %R a %D (a pøípadnì i dal¹í) a datumy pøedcházející
+ <literal>1.1.1970</literal> nebudou fungovat pod Windows, nìkterými distribucemi
+ Linuxu a nìkolika dal¹ími operaèními systémy. Pro Windows lze
+ kompletní pøehled podporovaných konverzních specifikátorù najít na
+ <ulink url="&url.strftime.win32;">webových stránkách <acronym>MSDN</acronym></ulink>.
+
</para>
</note>
<example>
- <title>Pøíklad - <function>strftime</function></title>
+ <title><function>strftime</function> - místní pøíklady</title>
<programlisting role="php">
<![CDATA[
-setlocale (LC_TIME, "C");
-print (strftime ("%A je ve fin¹tinì "));
-setlocale (LC_TIME, "fi_FI");
-print (strftime ("%A, ve francouz¹tinì "));
-setlocale (LC_TIME, "fr_FR");
-print (strftime ("%A a v nìmèinì "));
-setlocale (LC_TIME, "de_DE");
-print (strftime ("%A.\n"));
+<?php
+setlocale(LC_TIME, "C");
+echo strftime("%A");
+setlocale(LC_TIME, "fi_FI");
+echo strftime(" je ve fin¹tinì %A,");
+setlocale(LC_TIME, "fr_FR");
+echo strftime(" ve francouz¹tinì %A a");
+setlocale(LC_TIME, "de_DE");
+echo strftime(" v nìmèinì %A.\n");
+?>
]]>
</programlisting>
</example>
Tento pøíklad bude fungovat jen tehdy, máte-li daná národní specifika
nainstalována v systému.
+ <note>
+ <simpara>
+ %G a %V, které jsou zalo¾eny na normì ISO 8601:1988, mohou
+ vrátit neoèekávané (a pøesto správné) výsledky, pokud nemáte v èíslovacím systému
+ zcela jasno. Viz %V vý¹e a pøíklad ní¾e.
+ </simpara>
+ </note>
+ <example>
+ <title>Pøíklad èísel týdnù podle ISO 8601:1988</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* December 2002 / January 2003
+ISOWk M Tu W Thu F Sa Su
+----- ----------------------------
+51 16 17 18 19 20 21 22
+52 23 24 25 26 27 28 29
+1 30 31 1 2 3 4 5
+2 6 7 8 9 10 11 12
+3 13 14 15 16 17 18 19 */
+
+// Vypí¹e: 28.12.2002 - %V,%G,%Y = 52,2002,2002
+echo "28.12.2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/28/2002")) . "\n";
+
+// Vypí¹e: 30.12.2002 - %V,%G,%Y = 1,2003,2002
+echo "30.12.2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/30/2002")) . "\n";
+
+// Vypí¹e: 3.1.2003 - %V,%G,%Y = 1,2003,2003
+echo "3.1.2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n";
+
+// Vypí¹e: 10.1.2003 - %V,%G,%Y = 2,2003,2003
+echo "10.1.2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n";
+
+
+
+/* December 2004 / January 2005
+ISOWk M Tu W Thu F Sa Su
+----- ----------------------------
+51 13 14 15 16 17 18 19
+52 20 21 22 23 24 25 26
+53 27 28 29 30 31 1 2
+1 3 4 5 6 7 8 9
+2 10 11 12 13 14 15 16 */
+
+// Vypí¹e: 23.12.2004 - %V,%G,%Y = 52,2004,2004
+echo "23.12.2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n";
+
+// Vypí¹e: 31.12.2004 - %V,%G,%Y = 53,2004,2004
+echo "31.12.2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n";
+
+// Vypí¹e: 2.1.2005 - %V,%G,%Y = 53,2004,2005
+echo "2.1.2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n";
+
+// Vypí¹e: 3.1.2005 - %V,%G,%Y = 1,2005,2005
+echo "3.1.2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n";
+
+?>
+]]>
+ </programlisting>
+ </example>
</para>
<para>
- Viz také <function>setlocale</function> a
- <function>mktime</function>, a <ulink url="&spec.strftime;">
+ Viz také <function>setlocale</function>,
+ <function>mktime</function> a <ulink url="&spec.strftime;">
specifikaci Open Group
<function>strftime</function></ulink>.
</para>
Index: phpdoc-cs/reference/bzip2/configure.xml
+++ phpdoc-cs/reference/bzip2/configure.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: luk Status: ready -->
<section id="bzip2.installation">
&reftitle.install;
<para>
Podpora bzip2 není v PHP implicitnì k dispozici. K aktivaci budete muset
pøi kompilaci PHP pou¾ít konfiguraèní volbu
<option role="configure">--with-bz2[=DIR]</option>.
</para>
</section>
<!-- 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:"../../../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
-->