luk Wed Nov 21 09:37:20 2001 EDT
Modified files:
/phpdoc/cs/functions com.xml dir.xml exec.xml filesystem.xml
Log:
Index: phpdoc/cs/functions/com.xml
diff -u phpdoc/cs/functions/com.xml:1.5 phpdoc/cs/functions/com.xml:1.6
--- phpdoc/cs/functions/com.xml:1.5 Sat Nov 10 16:49:20 2001
+++ phpdoc/cs/functions/com.xml Wed Nov 21 09:37:20 2001
@@ -5,8 +5,8 @@
<partintro>
<simpara>
- Tyto funkce jsou dostupné pouze ve Windows verzi PHP. Tyto funkce byly
- přidány v PHP 4.
+ Tyto funkce jsou dostupné pouze ve Windows verzi PHP. Byly přidány
+ v PHP 4.
</simpara>
</partintro>
@@ -14,7 +14,7 @@
<refnamediv>
<refname>com_load</refname>
<refpurpose>
- Creates a new reference to a COM component
+ Vytvoří nový odkaz na COM komponentu
</refpurpose>
</refnamediv>
<refsect1>
@@ -53,7 +53,7 @@
<paramdef>string <parameter>function_name</parameter></paramdef>
<paramdef>mixed
<parameter>
- <optional>function parameters, ...</optional>
+ <optional>parametry funkce, ...</optional>
</parameter>
</paramdef>
</funcprototype>
Index: phpdoc/cs/functions/dir.xml
diff -u phpdoc/cs/functions/dir.xml:1.6 phpdoc/cs/functions/dir.xml:1.7
--- phpdoc/cs/functions/dir.xml:1.6 Sat Nov 10 16:49:20 2001
+++ phpdoc/cs/functions/dir.xml Wed Nov 21 09:37:20 2001
@@ -153,8 +153,9 @@
</example>
</para>
<para>
- Všimněte si, že <function>readdir</function> vráží také . a
- .. položky. Pokud je nechcete, můžete je snadno vynechat:
+ Všimněte si, že <function>readdir</function> vrací také . a
+ .. položky (odkaz na sebe sama a na nadřazený adresář. Pokud je nechcete,
+ můžete je snadno vynechat:
<example>
<title>
Vypiš všechny soubory v adresáři a vynech . a ..
@@ -178,7 +179,7 @@
<refentry id="function.rewinddir">
<refnamediv>
<refname>rewinddir</refname>
- <refpurpose>rewind directory handle</refpurpose>
+ <refpurpose>návrat na začátek adresáře</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -189,9 +190,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Resets the directory stream indicated by
- <parameter>dir_handle</parameter> to the beginning of the
- directory.
+ Vrací adresářový proud odkazovaný deskriptorem
+ <parameter>dir_handle</parameter> na začátek adresáře.
</para>
</refsect1>
Index: phpdoc/cs/functions/exec.xml
diff -u phpdoc/cs/functions/exec.xml:1.5 phpdoc/cs/functions/exec.xml:1.6
--- phpdoc/cs/functions/exec.xml:1.5 Sat Nov 10 16:49:20 2001
+++ phpdoc/cs/functions/exec.xml Wed Nov 21 09:37:20 2001
@@ -6,7 +6,7 @@
<refentry id="function.escapeshellarg">
<refnamediv>
<refname>escapeshellarg</refname>
- <refpurpose>escape a string to be used as a shell argument</refpurpose>
+ <refpurpose>ouvozovkování řetězce pro použití jako argument shellu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
Index: phpdoc/cs/functions/filesystem.xml
diff -u phpdoc/cs/functions/filesystem.xml:1.6 phpdoc/cs/functions/filesystem.xml:1.7
--- phpdoc/cs/functions/filesystem.xml:1.6 Sat Nov 10 16:49:20 2001
+++ phpdoc/cs/functions/filesystem.xml Wed Nov 21 09:37:20 2001
@@ -6,7 +6,7 @@
<refentry id="function.basename">
<refnamediv>
<refname>basename</refname>
- <refpurpose>Vrátit část cesty obsahující název souboru</refpurpose>
+ <refpurpose>Vrátí část cesty obsahující název souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -20,7 +20,7 @@
Přijímá řetězec obsahující cestu na soubor, vrací název souboru.
</para>
<para>
- Na Windows, se jako oddělovač cesty dá použít jak lomítko
+ Na Windows se jako oddělovač cesty dá použít jak lomítko
(<literal>/</literal>), tak zpětné lomítko (<literal>\</literal>).
V ostatních prostředích je to normální lomítko (<literal>/</literal>).
</para>
@@ -42,7 +42,7 @@
<refentry id="function.chgrp">
<refnamediv>
<refname>chgrp</refname>
- <refpurpose>Změnit skupinou souboru</refpurpose>
+ <refpurpose>Změnit skupinu souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -121,7 +121,7 @@
<refentry id="function.chown">
<refnamediv>
<refname>chown</refname>
- <refpurpose>Změnit majitele souboru</refpurpose>
+ <refpurpose>Změní vlastníka souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -165,8 +165,8 @@
</funcsynopsis>
<para>
Volání systémových funkcí <systemitem>stat</systemitem> či
- <systemitem>lstat</systemitem> má docela velkou režii. Tudíž se výsledek
- posledního volání všech status funkcí (viz seznam níže) ukládá pro použití
+ <systemitem>lstat</systemitem> má poměrně velkou režii. Tudíž se výsledek
+ posledního volání všech stavových funkcí (viz seznam níže) ukládá pro použití
při dalším takovém volání používajícím stejný název souboru. Pokud chcete
vynutit novou kontrolu stavu, např. pokud je soubor kontrolován mnohokrát
a může se změnit nebo zmizet, použijte tuto funkci k uvolnění výsledků
@@ -202,7 +202,7 @@
<refentry id="function.copy">
<refnamediv>
<refname>copy</refname>
- <refpurpose>Zkopírovat soubor</refpurpose>
+ <refpurpose>Zkopíruje soubor</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -295,7 +295,7 @@
<refentry id="function.diskfreespace">
<refnamediv>
<refname>diskfreespace</refname>
- <refpurpose>Vrátit diskový prostor dostupný v adresáři</refpurpose>
+ <refpurpose>Vrátí diskový prostor dostupný v adresáři</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -324,7 +324,7 @@
<refentry id="function.fclose">
<refnamediv>
<refname>fclose</refname>
- <refpurpose>Zavřít otevřený deskriptor souboru</refpurpose>
+ <refpurpose>Zavře otevřený deskriptor souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -352,7 +352,7 @@
<refentry id="function.feof">
<refnamediv>
<refname>feof</refname>
- <refpurpose>Tests for end-of-file on a file pointer</refpurpose>
+ <refpurpose>Test na konec souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -363,13 +363,13 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns &true; if the file pointer is at EOF or an error occurs;
- otherwise returns &false;.
+ Vrací &true;, pokud je konec souboru (EOF) nebo nastala chyba,
+ jinak &false;.
</para>
<para>
- The file pointer must be valid, and must point to a file
- successfully opened by <function>fopen</function>,
- <function>popen</function>, or <function>fsockopen</function>.
+ Deskriptor souboru musí být platný a musí ukazovat na soubor úspěšně
+ otevřený pomocí <function>fopen</function>,
+ <function>popen</function>, nebo <function>fsockopen</function>.
</para>
</refsect1>
</refentry>
@@ -377,7 +377,7 @@
<refentry id="function.fflush">
<refnamediv>
<refname>fflush</refname>
- <refpurpose>Flushes the output to a file</refpurpose>
+ <refpurpose>Zapíše obsah výstupního bufferu</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -388,15 +388,14 @@
</funcprototype>
</funcsynopsis>
<para>
- This function forces a write of all buffered output to the
- to the resource pointed to by the file handle
- <parameter>fp</parameter>. Returns &true; if succesful, &false;
- otherwise.
+ Funkce vynutí okamžitý zápis veškerých dat uložených ve výstupním bufferu
+ do souboru odkazovaného pomocí deskriptoru
+ <parameter>fp</parameter>. Vrací &true; při úspěchu, jinak &false;.
</para>
<para>
- The file pointer must be valid, and must point to a file
- successfully opened by <function>fopen</function>,
- <function>popen</function>, or <function>fsockopen</function>.
+ Deskriptor souboru musí být platný a musí ukazovat na soubor úspěšně
+ otevřený pomocí <function>fopen</function>,
+ <function>popen</function>, nebo <function>fsockopen</function>.
</para>
</refsect1>
</refentry>
@@ -404,7 +403,7 @@
<refentry id="function.fgetc">
<refnamediv>
<refname>fgetc</refname>
- <refpurpose>Gets character from file pointer</refpurpose>
+ <refpurpose>Načte 1 znak ze souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -415,17 +414,18 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns a string containing a single character read from the
- file pointed to by fp. Returns &false; on EOF.
+ Vrátí řetězec obsahující jediný znak přečtený ze souboru odkazovaného
+ pomocí deskriptoru <parameter>fp</parameter>.
+ Je-li konec souboru (EOF), vrací &false;.
</para>
<para>
- The file pointer must be valid, and must point to a file
- successfully opened by <function>fopen</function>,
- <function>popen</function>, or <function>fsockopen</function>.
+ Deskriptor souboru musí být platný a musí ukazovat na soubor úspěšně
+ otevřený pomocí <function>fopen</function>,
+ <function>popen</function>, nebo <function>fsockopen</function>.
</para>
<para>
Viz také <function>fread</function>, <function>fopen</function>,
- <function>popen</function>, <function>fsockopen</function>, and
+ <function>popen</function>, <function>fsockopen</function>, a
<function>fgets</function>.
</para>
</refsect1>
@@ -435,7 +435,7 @@
<refnamediv>
<refname>fgetcsv</refname>
<refpurpose>
- Gets line from file pointer and parse for CSV fields
+ Načte řádek ze souboru a parsuje ho na CSV hodnoty
</refpurpose>
</refnamediv>
<refsect1>
@@ -453,34 +453,33 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Similar to <function>fgets</function> except that
- <function>fgetcsv</function> parses the line it reads for fields
- in <acronym>CSV</acronym> format and returns an array containing
- the fields read. The field delimiter is a comma, unless you
- specify another delimiter with the optional third parameter.
+ Podobné jako <function>fgets</function> s výjimkou toho. že
+ <function>fgetcsv</function> parsuje přečtený řádek podle
+ <acronym>CSV</acronym> formátu a vrací pole obsahující
+ získané hodnoty. Oddělovačem je čárka, pokud nespecifikujete
+ jiný oddělovač jako nepovinný třetí parametr.
</simpara>
<simpara>
- <parameter>Fp</parameter> must be a valid file pointer to a file
- successfully opened by <function>fopen</function>,
- <function>popen</function>, or <function>fsockopen</function>
+ <parameter>Fp</parameter> musí být platný deskriptor souboru
+ úspěšně otevřeného pomocí <function>fopen</function>,
+ <function>popen</function>, nebo <function>fsockopen</function>
</simpara>
<simpara>
- Length must be greater than the longest line to be found in the
- CSV file (allowing for trailing line-end characters).
+ Délka <parameter>length</parameter> musí být větší než nejdelší
+ řádek, vyskytující se v souboru (nepočítaje v to znak konce řádku).
</simpara>
<simpara>
- <function>fgetcsv</function> returns &false; on error, including
- end of file.
+ <function>fgetcsv</function> vrací &false; při chybě včetně konce
+ souboru (EOF).
</simpara>
<simpara>
- N.B. A blank line in a CSV file will be returned as an array
- comprising a single &null; field, and will not be treated as an
- error.
+ N.B. Prázdný řádek v CSV souboru bude vrácen jako pole s jediným
+ &null; polem, aniž by to bylo vyhodnoceno jako chyba.
</simpara>
<example>
<title>
- <function>fgetcsv</function> example - Read and print entire
- contents of a CSV file
+ <function>fgetcsv</function> příklad - Čtení a tisk celého
+ CVS souboru
</title>
<programlisting role="php">
$row = 1;
@@ -502,7 +501,7 @@
<refentry id="function.fgets">
<refnamediv>
<refname>fgets</refname>
- <refpurpose>Gets line from file pointer</refpurpose>
+ <refpurpose>Přečte řádek ze souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -514,31 +513,30 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns a string of up to length - 1 bytes read from the file
- pointed to by fp. Reading ends when length - 1 bytes have been
- read, on a newline (which is included in the return value), or on
- EOF (whichever comes first).
+ Vrací řádek o délce max. <parameter>length</parameter> - 1 byte
+ přečtený ze souboru. Čtení končí, pokud bylo přečteno
+ <parameter>length</parameter> - 1 bytů, nastal konec řádku
+ nebo konec souboru (podle toho, co přijde první).
</para>
<para>
- If an error occurs, returns &false;.
+ Při výskytu chyby vrací &false;.
</para>
<para>
- Common Pitfalls:
+ Nejčastější úskalí:
</para>
<simpara>
- People used to the 'C' semantics of fgets should note the
- difference in how EOF is returned.
+ Lidé, kteří používali 'C' sémantiku funkce fgets, by si měli
+ uvědomit rozdíl v tom, jak je vrácen konec souboru.
</simpara>
<simpara>
- The file pointer must be valid, and must point to a file
- successfully opened by <function>fopen</function>,
- <function>popen</function>, or
- <function>fsockopen</function>.
+ Deskriptor souboru musí být platný a musí ukazovat na soubor úspěšně
+ otevřený pomocí <function>fopen</function>,
+ <function>popen</function>, nebo <function>fsockopen</function>.
</simpara>
<para>
- A simple example follows:
+ Jednoduchý příklad:
<example>
- <title>Reading a file line by line</title>
+ <title>Čtení souboru řádek po řádku</title>
<programlisting role="php">
$fd = fopen ("/tmp/inputfile.txt", "r");
while (!feof ($fd)) {
@@ -552,7 +550,7 @@
<para>
Viz také <function>fread</function>, <function>fopen</function>,
<function>popen</function>, <function>fgetc</function>,
- <function>fsockopen</function>, and
+ <function>fsockopen</function>, a
<function>socket_set_timeout</function>.
</para>
</refsect1>
@@ -562,7 +560,7 @@
<refnamediv>
<refname>fgetss</refname>
<refpurpose>
- Gets line from file pointer and strip HTML tags
+ Přečte řádek ze souboru a odstraní HTML značky
</refpurpose>
</refnamediv>
<refsect1>
@@ -580,23 +578,22 @@
</funcprototype>
</funcsynopsis>
<para>
- Identical to <function>fgets</function>, except that fgetss
- attempts to strip any HTML and PHP tags from the text it
- reads.
+ Identické s <function>fgets</function>, ale jsou zde
+ z přečteného textu odstraňovány HTML a PHP značky.
</para>
<para>
- You can use the optional third parameter to specify tags which
- should not be stripped.
+ Jako nepovinný třetí parametr můžete specifikovat značky, které
+ nebudou odstraňovány.
<note>
<para>
- <parameter>allowable_tags</parameter> was added in PHP 3.0.13,
+ <parameter>allowable_tags</parameter> - přidáno v PHP 3.0.13,
PHP4B3.
</para>
</note>
</para>
<para>
Viz také <function>fgets</function>, <function>fopen</function>,
- <function>fsockopen</function>, <function>popen</function>, and
+ <function>fsockopen</function>, <function>popen</function>, a
<function>strip_tags</function>.
</para>
</refsect1>
@@ -605,7 +602,7 @@
<refentry id="function.file">
<refnamediv>
<refname>file</refname>
- <refpurpose>Reads entire file into an array</refpurpose>
+ <refpurpose>Načte celý soubor do pole</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -619,27 +616,26 @@
</funcprototype>
</funcsynopsis>
<para>
- Identical to <function>readfile</function>, except that
- <function>file</function> returns the file in an array. Each
- element of the array corresponds to a line in the file, with the
- newline still attached.
+ Identické s <function>readfile</function>, soubor je však
+ vrácen v podobě pole. Každý element pole odpovídá jednomu
+ řádku v souboru včetně znaku konce řádku.
</para>
<para>
- You can use the optional second parameter and set it to "1", if
- you want to search for the file in the <link
- linkend="ini.include-path">include_path</link>, too.
+ Můžete použít nepovinný druhý parametr a nastavit ho na "1",
+ pokud chcete hledat soubor také v
+ <link linkend="ini.include-path">include_path</link>.
</para>
<para>
<informalexample>
<programlisting role="php">
<?php
-// get a web page into an array and print it out
+// načti WWW stránku do pole a vytiskni ji
$fcontents = file ('http://www.php.net');
while (list ($line_num, $line) = each ($fcontents)) {
echo "<b>Line $line_num:</b> " . htmlspecialchars ($line) .
"<br>\n";
}
-// get a web page into a string
+// načti WWW stránku do řetězce
$fcontents = join ('', file ('http://www.php.net'));
?>
</programlisting>
@@ -647,7 +643,7 @@
</para>
<para>
Viz také <function>readfile</function>,
- <function>fopen</function>, <function>fsockopen</function>, and
+ <function>fopen</function>, <function>fsockopen</function>, a
<function>popen</function>.
</para>
</refsect1>
@@ -657,7 +653,7 @@
<refentry id="function.file-exists">
<refnamediv>
<refname>file_exists</refname>
- <refpurpose>Checks whether a file exists</refpurpose>
+ <refpurpose>Zjistí, zda soubor existuje</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -668,17 +664,16 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Returns &true; if the file specified by
- <parameter>filename</parameter> exists; &false; otherwise.
+ Vrací &true;, pokud soubor specifikovaný pomocí
+ <parameter>filename</parameter> existuje, jinak &false;.
</simpara>
<simpara>
- <function>file_exists</function> will not work on remote files;
- the file to be examined must be accessible via the server's
- filesystem.
+ <function>file_exists</function> nefunguje na vzdálených souborech;
+ soubor k ověření musí být přístupný prostřednictvím filesystému serveru.
</simpara>
<simpara>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</simpara>
</refsect1>
</refentry>
@@ -687,7 +682,7 @@
<refentry id="function.fileatime">
<refnamediv>
<refname>fileatime</refname>
- <refpurpose>Gets last access time of file</refpurpose>
+ <refpurpose>Vrací čas posledního přístupu k souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -698,22 +693,21 @@
</funcprototype>
</funcsynopsis>
<simpara>
- Returns the time the file was last accessed, or &false; in case of
- an error. The time is returned as a Unix timestamp.
+ Vrací čas posledního přístupu k souboru, při chybě &false;.
+ Čas je vrácen jako Unix timestamp.
</simpara>
<simpara>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</simpara>
<simpara>
- Note: The atime of a file is supposed to change whenever
- the data blocks of a file are being read. This can be
- costly performancewise when an appliation regularly
- accesses a very large number of files or directories. Some
- Unix filesystems can be mounted with atime updates disabled
- to increase the performance of such applications; USENET
- news spools are a common example. On such filesystems
- this function will be useless.
+ Pozn.: Atime (čas posl. přístupu) souboru se obvykle
+ mění při čtení datových bloků ze souboru. To se může značně
+ negativně projevit na výkonu systému, pokud aplikace přistupuje
+ k velkému počtu souborů nebo adresářů. Některé Unixové
+ filesystémy mohou mít atime deaktivován za účelem zvýšení
+ výkonu pro takové aplikace; takovým případem jsou USENET news
+ spools. Tehdy je tato funkce bezpředmětná.
</simpara>
</refsect1>
</refentry>
@@ -721,7 +715,7 @@
<refentry id="function.filectime">
<refnamediv>
<refname>filectime</refname>
- <refpurpose>Gets inode change time of file</refpurpose>
+ <refpurpose>Vrací čas změny inodu souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -732,25 +726,28 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns the time the file was last changed, or &false; in case of
- an error. The time is returned as a Unix timestamp.
+ Vrací čas poslední změny inodu souboru, při chybě &false;. Čas je
+ vracen
+ jako Unix timestamp.
</para>
<para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</para>
- <para>Note: In most Unix filesystem, a file is considered
- changed, when it's Inode data is changed, that is, when
- the permissions, the owner, the group or other metadata
- from the Inode is written to. Viz také
- <function>filemtime</function> (this is what you want to use
- when you want to create "Last Modified" footers on web pages) and
+ <para>
+ Pozn.: Na většině unixových filesystémů platí,
+ že soubor je považován za změněný, pokud jsou změněna
+ data v Inodu, tj. přístupová práva, vlastník, skupina
+ nebo jiná metadata jsou zapsána do Inodu.
+ <function>filemtime</function> (toto je to, co chcete použít,
+ když chcete vytvořit údaj "Poslední změna" na WWW stránce) a
<function>fileatime</function>.
</para>
- <para>Note: In some Unix texts the ctime of a file is being
- referred to as the creation time of the file. This is wrong.
- There is no creation time for Unix files in most Unix
- filesystems.
+ <para>
+ Pozn.: Na některých Unixech je ctime považován za čas
+ vytvoření souboru. To je chyba. Na většině unixových
+ filesystémů neexistuje žádný čas vytvoření unixových
+ souborů.
</para>
</refsect1>
</refentry>
@@ -758,7 +755,7 @@
<refentry id="function.filegroup">
<refnamediv>
<refname>filegroup</refname>
- <refpurpose>Gets file group</refpurpose>
+ <refpurpose>Vrací skupinu pro soubor</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -769,13 +766,13 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns the group ID of the owner of the file, or &false; in case
- of an error. The group ID is returned in numerical format, use
- <function>posix_getgrgid</function> to resolve it to a group name.
+ Vrací ID skupiny vlastníka souboru, při chybě &false;.
+ Skupinové ID je v číselném tvaru, použijte
+ <function>posix_getgrgid</function> pro získání názvu skupiny.
</para>
<para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</para>
<note>
<simpara>
@@ -788,7 +785,7 @@
<refentry id="function.fileinode">
<refnamediv>
<refname>fileinode</refname>
- <refpurpose>Gets file inode</refpurpose>
+ <refpurpose>Vrací inode souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -799,11 +796,11 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns the inode number of the file, or &false; in case of an
- error.</para>
+ Vrací inode číslo souboru, při chybě &false;.
+ </para>
<para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</para>
<note>
<simpara>
@@ -816,7 +813,7 @@
<refentry id="function.filemtime">
<refnamediv>
<refname>filemtime</refname>
- <refpurpose>Gets file modification time</refpurpose>
+ <refpurpose>Vrací čas změny souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -827,18 +824,19 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns the time the file was last modified, or &false; in case of
- an error. The time is returned as a Unix timestamp.
+ Vrací čas poslední změny souboru, při chybě &false;.
+ Čas je vracen jako Unix timestamp.
</para>
<para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</para>
- <para>Note: This function returns the time when the data
- blocks of a file were being written to, that is, the time
- when the content of the file was changed. Use
- <function>date</function> on the result of this function
- to get a printable modification date for use in page footers.
+ <para>
+ Tato funkce vrací čas, kdy byly zapsány datové bloky,
+ tj. čas poslední změny obsahu souboru. Použijte funkci
+ <function>date</function> na výsledek této funkce k
+ získání formátovaného tvaru data pro použití na WWW
+ stránkách.
</para>
</refsect1>
</refentry>
@@ -846,7 +844,7 @@
<refentry id="function.fileowner">
<refnamediv>
<refname>fileowner</refname>
- <refpurpose>Gets file owner</refpurpose>
+ <refpurpose>Vrací vlastníka souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -857,13 +855,13 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns the user ID of the owner of the file, or &false; in case of
- an error. The user ID is returned in numerical format, use
- <function>posix_getpwuid</function> to resolve it to a username.
+ Vrací ID uživatele (UID), vlastnícího soubor; při chybě &false;.
+ Hodnota je v číselném tvaru, použijte funkci
+ <function>posix_getpwuid</function> k získání uživatelského jména.
</para>
<para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</para>
<note>
<simpara>
@@ -876,7 +874,7 @@
<refentry id="function.fileperms">
<refnamediv>
<refname>fileperms</refname>
- <refpurpose>Gets file permissions</refpurpose>
+ <refpurpose>Vrací přístupová práva k souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -887,11 +885,11 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns the permissions on the file, or &false; in case of an error.
+ Vrací přístupová práva (permissions) k souboru, při chybě &false;.
</para>
<para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</para>
</refsect1>
</refentry>
@@ -899,7 +897,7 @@
<refentry id="function.filesize">
<refnamediv>
<refname>filesize</refname>
- <refpurpose>Gets file size</refpurpose>
+ <refpurpose>Vrací velikost souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -910,11 +908,11 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns the size of the file, or &false; in case of an error.
+ Vrací velikost souboru, při chybě &false;.
</para>
<para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</para>
</refsect1>
</refentry>
@@ -922,7 +920,7 @@
<refentry id="function.filetype">
<refnamediv>
<refname>filetype</refname>
- <refpurpose>Gets file type</refpurpose>
+ <refpurpose>Vrací typ souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -933,13 +931,15 @@
</funcprototype>
</funcsynopsis>
<para>
- Returns the type of the file. Possible values are fifo, char,
- dir, block, link, file, and unknown.</para> <para> Returns &false;
- if an error occurs.
+ Vrací typ souboru. Možné hodnoty jsou fifo, char, dir, block, link,
+ file a unknown.
+ </para>
+ <para>
+ Při chybě vrací &false;.
</para>
<para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
+ Výsledek této funkce je cachován. Více informací - viz
+ <function>clearstatcache</function>.
</para>
</refsect1>
</refentry>
@@ -947,7 +947,8 @@
<refentry id="function.flock">
<refnamediv>
<refname>flock</refname>
- <refpurpose>Portable advisory file locking</refpurpose>
+ <refpurpose>Jednotné "portable advisory" zamykání
+ souboru</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -964,66 +965,64 @@
</funcprototype>
</funcsynopsis>
<simpara>
- PHP supports a portable way of locking complete files in an
- advisory way (which means all accessing programs have to use the
- same way of locking or it will not work).
+ PHP podporuje "portable" způsob zamykání celých souborů na základě
+ jednotného "advisory" principu (tzn. všechny přistupující programy
+ musí používat tentýž systém zamykání, jinak to nebude fungovat).
</simpara>
<simpara>
- <function>flock</function> operates on <parameter>fp</parameter>
- which must be an open file
- pointer. <parameter>operation</parameter> is one of the following
- values:
+ <function>flock</function> funguje na deskriptoru
+ <parameter>fp</parameter>, který musí patřit otevřenému souboru.
+ <parameter>operation</parameter> je jedna z následujících hodnot:
</simpara>
<para>
<itemizedlist>
<listitem>
<simpara>
- To acquire a shared lock (reader), set
- <parameter>operation</parameter> to LOCK_SH (set to 1 prior to
+ K získání sdíleného (shared) zámku (čtení) nastavte
+ <parameter>operation</parameter> na LOCK_SH (resp. 1 u verzí do
PHP 4.0.1).
</simpara>
</listitem>
<listitem>
<simpara>
- To acquire an exclusive lock (writer), set
- <parameter>operation</parameter> to LOCK_EX (set to 2 prior to
+ K získání výhradního zámku (zápis) nastavte
+ <parameter>operation</parameter> na LOCK_EX (resp. 2 u verzí do
PHP 4.0.1).
</simpara>
</listitem>
<listitem>
<simpara>
- To release a lock (shared or exclusive), set
- <parameter>operation</parameter> to LOCK_UN (set to 3 prior to
+ K uvolnění zámku (sdíleného nebo výhradního) nastavte
+ <parameter>operation</parameter> na LOCK_UN (resp. 3 u verzí do
PHP 4.0.1).
</simpara>
</listitem>
<listitem>
<simpara>
- If you don't want <function>flock</function> to block while
- locking, add LOCK_NB (4 prior to PHP 4.0.1) to
- <parameter>operation</parameter>.
+ Pokud nechcete, aby funkce <function>flock</function> blokovala
+ během zamykání, přidejte k <parameter>operation</parameter>
+ hodnotu LOCK_NB (4 pro verze do PHP 4.0.1).
</simpara>
</listitem>
</itemizedlist>
</para>
<simpara>
- <function>flock</function> allows you to perform a simple
- reader/writer model which can be used on virtually every platform
- (including most Unices and even Windows). The optional 3rd
- argument is set to &true; if the lock would block (EWOULDBLOCK
- errno condition)
+ <function>flock</function> umožnuje jednoduchý model čtení/zápis
+ použitelný teoreticky na všech platformách (včetně většiny
+ Unixů a nejspíš i Windows). Nepovinný třetí argument se nastaví na
+ &true;, pokud by zámek měl blokovat (EWOULDBLOCK errno podmínka).
</simpara>
<simpara>
- <function>flock</function> returns &true; on success and &false; on
- error (e.g. when a lock could not be acquired).
+ <function>flock</function> vrací &true; při úspěchu, &false; při
+ chybě (např. když nelze vytvořit zámek).
</simpara>
<warning>
<para>
- On most operation systems <function>flock</function> is implemented
- at the process level. When using a multithreaded server API like
- ISAPI you cannot rely on <function>flock</function> to protect
- files against other PHP scripts running in parallel threads of the
- same server instance!
+ Na většině operačních systémů je funkce <function>flock</function>
+ implementována na úrovni procesů. Při použití multithreadového
+ serverového API (jako je ISAPI) nemůžete spoléhat na ochranu
+ souborů proti jiným PHP skriptům běžícím v paralelních vláknech
+ stejné instance serveru!
</para>
</warning>
</refsect1>
@@ -1032,7 +1031,7 @@
<refentry id="function.fopen">
<refnamediv>
<refname>fopen</refname>
- <refpurpose>Opens file or URL</refpurpose>
+ <refpurpose>Otevře soubor nebo URL</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
@@ -1049,92 +1048,91 @@
</funcprototype>
</funcsynopsis>
<simpara>
- If <parameter>filename</parameter> begins with "http://"; (not
- case sensitive), an HTTP 1.0 connection is opened to the
- specified server and a file pointer is returned to the beginning
- of the text of the response. A 'Host:' header is sent with the
- request in order to handle name-based virtual hosts.
+ Jestliže <parameter>filename</parameter> začíná "http://";
+ (velkými nebo malými písmeny), je otevřeno spojení na
+ příslušný server protokolem HTTP 1.0 a je vrácen deskriptor
+ ukazující na začátek těla dokumentu. Posílá se hlavička
+ 'Host:' pro přístup k virtuálním serverům založeným na
+ jméně.
</simpara>
<simpara>
- Does not handle HTTP redirects, so you must include trailing
- slashes on directories.
+ Nezpracovává HTTP přesměrování, je třeba vložit koncové
+ lomítko za název adresáře.
</simpara>
- <simpara>
- If <parameter>filename</parameter> begins with "ftp://"; (not case
- sensitive), an ftp connection to the specified server is opened
- and a pointer to the requested file is returned. If the server
- does not support passive mode ftp, this will fail. You can open
- files for either reading or writing via ftp (but not both
- simultaneously).
+ <simpara>
+ Když <parameter>filename</parameter> začíná "ftp://"; (velká
+ či malá písmena), je otevřena FTP relace na příslušný server
+ a vrácen deskriptor na požadovaný soubor. Pokud server
+ nepodporuje pasivní režim FTP komunikace, selže to. Můžete
+ přes FTP otvírat soubory pro čtení i zápis, ale ne pro obojí
+ najednou.
</simpara>
<simpara>
- If <parameter>filename</parameter> is one of "php://stdin",
- "php://stdout", or "php://stderr", the corresponding stdio
- stream will be opened. (This was introduced in PHP 3.0.13;
- in earlier versions, a filename such as "/dev/stdin" or
- "/dev/fd/0" must be used to access the stdio streams.)
+ Když <parameter>filename</parameter> je buď "php://stdin",
+ "php://stdout", nebo "php://stderr", bude otevřen standardní
+ vstup/výstup (stdio). (To platí od verze PHP 3.0.13;
+ v dřívějších verzích se musí použít názvy jako "/dev/stdin"
+ nebo "/dev/fd/0".)
</simpara>
<simpara>
- If <parameter>filename</parameter> begins with anything else, the
- file will be opened from the filesystem, and a file pointer to
- the file opened is returned.
+ Když <parameter>filename</parameter> začíná čímkoli jiným,
+ bude otevřen obyčejný soubor (z filesystému) a vrácen
+ jeho deskriptor.
</simpara>
<simpara>
- If the open fails, the function returns &false;.
+ Pokud otvírání selže, funkce vrátí &false;.
</simpara>
<para>
- <parameter>mode</parameter> may be any of the following:
+ <parameter>mode</parameter> může být kterýkoli z těchto:
<itemizedlist>
<listitem>
<simpara>
- 'r' - Open for reading only; place the file pointer at the
- beginning of the file.
+ 'r' - Otevřít pouze pro čtení; nastaví ukazatel na začátek
+ souboru.
</simpara>
</listitem>
<listitem>
<simpara>
- 'r+' - Open for reading and writing; place the file pointer at
- the beginning of the file.
+ 'r+' - Otevřít pro čtení a zápis; nastaví ukazatel na začátek
+ souboru.
</simpara>
</listitem>
<listitem>
<simpara>
- 'w' - Open for writing only; place the file pointer at the
- beginning of the file and truncate the file to zero length.
- If the file does not exist, attempt to create it.
+ 'w' - Otevřít pouze pro zápis; nastaví ukazatel na začátek
+ souboru a zkrátí soubor na nulovou délku. Pokud soubor
+ neexistuje, pokusí se ho vytvořit.
</simpara>
</listitem>
<listitem>
<simpara>
- 'w+' - Open for reading and writing; place the file pointer at
- the beginning of the file and truncate the file to zero
- length. If the file does not exist, attempt to create it.
+ 'w+' - Otevřít pro čtení a zápis; nastaví ukazatel na začátek
+ souboru a zkrátí soubor na nulovou délku. Pokud soubor
+ neexistuje, pokusí se ho vytvořit.
</simpara>
</listitem>
<listitem>
<simpara>
- 'a' - Open for writing only; place the file pointer at the end
- of the file. If the file does not exist, attempt to create
- it.
+ 'a' - Otevřít pouze pro zápis; nastaví ukazatel na konec
+ souboru, Pokud soubor neexistuje, pokusí se ho vytvořit.
</simpara>
</listitem>
<listitem>
<simpara>
- 'a+' - Open for reading and writing; place the file pointer at
- the end of the file. If the file does not exist, attempt to
- create it.
+ 'a+' -Otevřít pro čtení a zápis; nastaví ukazatel na konec
+ souboru. Pokud soubor neexistuje, pokusí se ho vytvořit.
</simpara>
</listitem>
</itemizedlist>
- The <parameter>mode</parameter> may contain the letter
- 'b'. This is useful only on systems which differentiate between
- binary and text files (i.e., it's useless on Unix). If not
- needed, this will be ignored.
+ <parameter>mode</parameter> může obsahovat písmeno 'b'.
+ To je užitečné pouze na systémech které rozlišují mezi
+ binárními a textovými soubory (nikoli např. na Unixu).
+ Pokud není zapotřebí, je ignorován.
</para>
<para>
- You can use the optional third parameter and set it to "1", if
- you want to search for the file in the <link
- linkend="ini.include-path">include_path</link>, too.
+ Můžete použít nepovinný třetí parametr a nastavit ho na
+ "1", pokud chcete hledat soubor také v
+ <link linkend="ini.include-path">include_path</link>.
</para>
<para>
<example>
