cvs: phpdoc /cs/functions filesystem.xml
| From: | Lukas Jelinek | Date: | Thu, 22 Nov 2001 00:02:11 +0000 |
| Subject: | cvs: phpdoc /cs/functions filesystem.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969339109@lists.php.net to get a copy of this message | ||
luk Wed Nov 21 19:02:11 2001 EDT
Modified files:
/phpdoc/cs/functions filesystem.xml
Log:
Index: phpdoc/cs/functions/filesystem.xml diff -u phpdoc/cs/functions/filesystem.xml:1.7 phpdoc/cs/functions/filesystem.xml:1.8 --- phpdoc/cs/functions/filesystem.xml:1.7 Wed Nov 21 09:37:20 2001 +++ phpdoc/cs/functions/filesystem.xml Wed Nov 21 19:02:09 2001 @@ -55,7 +55,7 @@ </funcsynopsis> <para> Pokusí se nastavit skupinu souboru <parameter>filename</parameter> na - <parameter>group</parameter>. Pouze superuser mù¾e libovolnì zmìnit + <parameter>group</parameter>. Pouze superu¾ivatel mù¾e libovolnì zmìnit skupinu souboru; ostatní u¾ivatelé mohou zmìnit skupinu souboru na jinou skupinu, jí¾ jsou èleny. </para> @@ -133,8 +133,8 @@ </funcprototype> </funcsynopsis> <para> - Pokusí se zmìnit majitele souboru na <parameter>user</parameter>. Pouze - superuser mù¾e zmìnit majitele souboru. + Pokusí se zmìnit vlastníka souboru na <parameter>user</parameter>. Pouze + superu¾ivatel mù¾e zmìnit majitele souboru. </para> <para> Pøi úspìchu vrací &true;, jinak &false;. @@ -1136,7 +1136,7 @@ </para> <para> <example> - <title><function>fopen</function> example</title> + <title><function>fopen</function> pøíklad</title> <programlisting role="php"> $fp = fopen ("/home/rasmus/file.txt", "r"); $fp = fopen ("/home/rasmus/file.gif", "wb"); @@ -1146,14 +1146,14 @@ </example> </para> <simpara> - If you are experiencing problems with reading and writing to - files and you're using the server module version of PHP, remember - to make sure that the files and directories you're using are - accessible to the server process. + Pokud jste zaznamenali problémy se ètením a zápisem do souborù + a pou¾íváte PHP jako modul do serveru, nezapomeòte zajistit, aby + soubory a adresáøe, které pou¾íváte, byly pøístupné pro serverový + proces. </simpara> <para> - On the Windows platform, be careful to escape any backslashes - used in the path to the file, or use forward slashes. + Na Windows je tøeba oescapovat v¹echna zpìtná lomítka ve specifikaci + cesty k souboru nebo pou¾ívat obyèejná (dopøedná) lomítka. <informalexample> <programlisting role="php"> $fp = fopen ("c:\\data\\info.txt", "r"); @@ -1163,7 +1163,7 @@ <simpara> Viz také <function>fclose</function>, <function>fsockopen</function>, - <function>socket_set_timeout</function>, and + <function>socket_set_timeout</function>, a <function>popen</function>. </simpara> </refsect1> @@ -1173,7 +1173,7 @@ <refnamediv> <refname>fpassthru</refname> <refpurpose> - Output all remaining data on a file pointer + Vypí¹e v¹echna zbývající data v souboru </refpurpose> </refnamediv> <refsect1> @@ -1185,28 +1185,28 @@ </funcprototype> </funcsynopsis> <simpara> - Reads to EOF on the given file pointer and writes the results to - standard output. + Ète a¾ do dosa¾ení konce souboru specifikovaného deskriptorem a + naètené pøepisuje na standardní výstup. </simpara> <simpara> - If an error occurs, <function>fpassthru</function> returns - &false;. + Pokud nastane chyba, funkce <function>fpassthru</function> + vrací &false;. </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>. - The file is closed when <function>fpassthru</function> is done - reading it (leaving <parameter>fp</parameter> useless). + 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>. + A¾ funkce <function>fpassthru</function> ukonèí ètení, zavøe soubor + (deskriptor <parameter>fp</parameter> tím ztrácí smysl). </simpara> <simpara> - If you just want to dump the contents of a file to stdout you may - want to use the <function>readfile</function>, which saves you - the <function>fopen</function> call. + Kdy¾ chcete vypsat obsah souboru na standardní výstup (stdout), + mù¾ete pou¾í funkci <function>readfile</function>, která vás + u¹etøí volání funkce <function>fopen</function>. </simpara> <simpara> Viz také <function>readfile</function>, - <function>fopen</function>, <function>popen</function>, and + <function>fopen</function>, <function>popen</function>, a <function>fsockopen</function> </simpara> </refsect1> @@ -1215,7 +1215,7 @@ <refentry id="function.fputs"> <refnamediv> <refname>fputs</refname> - <refpurpose>Writes to a file pointer</refpurpose> + <refpurpose>Zapí¹e do souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1232,10 +1232,10 @@ </funcprototype> </funcsynopsis> <para> - <function>fputs</function> is an alias to - <function>fwrite</function>, and is identical in every way. Note - that the <parameter>length</parameter> parameter is optional and - if not specified the entire string will be written. + Funkce <function>fputs</function> je alias k + <function>fwrite</function> a je s ní tedy naprosto identická. + Uvìdomte si, ¾e parametr <parameter>length</parameter> je nepovinný + a pokud není specifikován, zapí¹e se celý øetezec. </para> </refsect1> </refentry> @@ -1243,7 +1243,7 @@ <refentry id="function.fread"> <refnamediv> <refname>fread</refname> - <refpurpose>Binary-safe file read</refpurpose> + <refpurpose>Binárnì bezpeèné ètení ze souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1255,16 +1255,16 @@ </funcprototype> </funcsynopsis> <simpara> - <function>fread</function> reads up to - <parameter>length</parameter> bytes from the file pointer - referenced by <parameter>fp</parameter>. Reading stops when - <parameter>length</parameter> bytes have been read or EOF is - reached, whichever comes first. + <function>fread</function> pøeète nejvý¹e + <parameter>length</parameter> bytù ze souboru specifikovaného + deskriptorem <parameter>fp</parameter>. Ètení konèí, pokud je + pøeèteno <parameter>length</parameter> bytù nebo je dosa¾en konec + souboru (podle toho, co pøijde døív). </simpara> <para> <informalexample> <programlisting role="php"> -// get contents of a file into a string +// nacte obsah souboru do retezce $filename = "/usr/local/something.txt"; $fd = fopen ($filename, "r"); $contents = fread ($fd, filesize ($filename)); @@ -1276,7 +1276,7 @@ Viz také <function>fwrite</function>, <function>fopen</function>, <function>fsockopen</function>, <function>popen</function>, <function>fgets</function>, <function>fgetss</function>, - <function>fscanf</function>, <function>file</function>, and + <function>fscanf</function>, <function>file</function>, a <function>fpassthru</function>. </simpara> </refsect1> @@ -1285,7 +1285,7 @@ <refentry id="function.fscanf"> <refnamediv> <refname>fscanf</refname> - <refpurpose>Parses input from a file according to a format</refpurpose> + <refpurpose>Parsuje vstup ze souboru podle formátu</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1300,22 +1300,21 @@ </funcprototype> </funcsynopsis> <para> - The function <function>fscanf</function> is similar to - <function>sscanf</function>, but it takes its input from a file - associated with <parameter>handle</parameter> and interprets the - input according to the specified - <parameter>format</parameter>. If only two parameters were passed - to this function, the values parsed will be returned as an array. - Otherwise, if optional parameters are passed, the function will - return the number of assigned values. The optional parameters - must be passed by reference. + Funkce <function>fscanf</function> je podobná + <function>sscanf</function>, ale naèítá ze souboru specifikovaného + <parameter>handle</parameter> a interpretuje vstupní data podle + specifikovaného formátu <parameter>format</parameter>. Pokud má + funkce pouze dva parametry, parsované hodnoty bude vráceny jako pole. + Jinak, kdy¾ jsou pou¾ity nepovinné parametry, funkce vrací urèitý + poèet asignovaných hodnot. Nepovinné parametry musí být vlo¾eny + odkazem. <example> - <title><function>fscanf</function> Example</title> + <title><function>fscanf</function> Pøíklad</title> <programlisting role="php"> $fp = fopen ("users.txt","r"); while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; - //... do something with the values + //... udelej neco s hodnotami } fclose($fp); </programlisting> @@ -1333,7 +1332,7 @@ <para> Viz také <function>fread</function>, <function>fgets</function>, <function>fgetss</function>, <function>sscanf</function>, - <function>printf</function>, and <function>sprintf</function>. + <function>printf</function>, a <function>sprintf</function>. </para> </refsect1> </refentry> @@ -1341,7 +1340,7 @@ <refentry id="function.fseek"> <refnamediv> <refname>fseek</refname> - <refpurpose>Seeks on a file pointer</refpurpose> + <refpurpose>Posouvá ukazatel v souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1356,40 +1355,39 @@ </funcprototype> </funcsynopsis> <para> - Sets the file position indicator for the file referenced by - <parameter>fp</parameter>.The new position, measured in bytes - from the beginning of the file, is obtained by adding - <parameter>offset</parameter> to the position specified by - <parameter>whence</parameter>, whose values are defined as - follows: + Nastaví ukazatel pozice v souboru specifikované pomocí + deskriptoru <parameter>fp</parameter>. Nová pozice, mìøená + poètem bytù od zaèátku souboru, je získána pøiètením hodnoty + <parameter>offset</parameter> k pozici specifikované pomocí + <parameter>whence</parameter>, jeho¾ hodnota je definovanána: <simplelist> - <member>SEEK_SET - Set position equal to - <parameter>offset</parameter> bytes.</member> <member>SEEK_CUR - - Set position to current location plus - <parameter>offset</parameter>.</member> <member>SEEK_END - Set - position to end-of-file plus - <parameter>offset</parameter>.</member> + <member>SEEK_SET - Nastav na pozici rovnu + <parameter>offset</parameter> bytù.</member> <member>SEEK_CUR - + Nastav pozici na souèasnou plus poèet bytù v + <parameter>offset</parameter>.</member> <member>SEEK_END - Nastav + na konec souboru plus + <parameter>offset</parameter> bytù.</member> </simplelist> </para> - <para>If <parameter>whence is not specified, it is assumed to be - SEEK_SET.</parameter> + <para>Pokud není parametr <parameter>whence</parameter> specifikován, + pou¾ije se SEEK_SET. </para> <para> - Upon success, returns 0; otherwise, returns -1. Pozn.: seeking - past EOF is not considered an error. + Pøi úspìchu vrací 0, jinak -1. Pozn.: pøesun za konec souboru + není pova¾ován za chybu. </para> <para> - May not be used on file pointers returned by - <function>fopen</function> if they use the "http://" or "ftp://" - formats. + Nelze pou¾ít na deskriptor souboru vrácený funkcí + <function>fopen</function>, jestli¾e byl pou¾it formát "http://" nebo + "ftp://". </para> <note> <para> - The <parameter>whence</parameter> argument was added after PHP 4.0 RC1. + Argument <parameter>whence</parameter> byl pøidán po verzi PHP 4.0 RC1. </para> </note> <para> - Viz také <function>ftell</function> and + Viz také <function>ftell</function> a <function>rewind</function>. </para> </refsect1> @@ -1399,7 +1397,7 @@ <refnamediv> <refname>fstat</refname> <refpurpose> - Gets information about a file using an open file pointer + Vrací informace o otevøeném souboru </refpurpose> </refnamediv> <refsect1> @@ -1411,14 +1409,13 @@ </funcprototype> </funcsynopsis> <para> - Gathers the statistics of the file opened by the file - pointer fp. This function is similar to the - <function>stat</function> function except that it operates - on an open file pointer instead of a filename. + Sbírá statistiky otevøeného souboru specifikovaném + deskriptorem <parameter>fp</parameter>. Tato funkce je + podobná funkci <function>stat</function>, pracuje + v¹ak s deskriptorem, nikoli názvem souboru. </para> <para> - Returns an array with the statistics of the file with the - following elements: + Vrací pole se statistikami souboru s tìmito elementy: <orderedlist> <listitem><simpara>device</simpara></listitem> <listitem><simpara>inode</simpara></listitem> @@ -1433,11 +1430,11 @@ <listitem><simpara>blocksize for filesystem I/O *</simpara></listitem> <listitem><simpara>number of blocks allocated</simpara></listitem> </orderedlist> - * - only valid on systems supporting the st_blksize type--other - systems (i.e. Windows) return -1</para> + * - platné pouze na systémech s podporou typu st_blksize -- jinde + (napø. na Windows) vrací -1</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 detailù - viz + <function>clearstatcache</function>. </para> </refsect1> </refentry> @@ -1445,7 +1442,7 @@ <refentry id="function.ftell"> <refnamediv> <refname>ftell</refname> - <refpurpose>Tells file pointer read/write position</refpurpose> + <refpurpose>Vrací pozici v souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1456,20 +1453,20 @@ </funcprototype> </funcsynopsis> <para> - Returns the position of the file pointer referenced by fp; i.e., - its offset into the file stream. + Vrací pozici v souboru odkazovaném deskriptorem fp; typicky + offset ve streamu. </para> <para> - If an error occurs, returns &false;. + Pokud nastane chyba, vrací &false;. </para> <para> - The file pointer must be valid, and must point to a file - successfully opened by <function>fopen</function> or - <function>popen</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>fopen</function>, <function>popen</function>, - <function>fseek</function> and <function>rewind</function>. + <function>fseek</function> a <function>rewind</function>. </para> </refsect1> </refentry> @@ -1478,7 +1475,7 @@ <refnamediv> <refname>ftruncate</refname> <refpurpose> - Truncates a file to a given length. + Zkrátí soubor na danou délku </refpurpose> </refnamediv> <refsect1> @@ -1491,8 +1488,9 @@ </funcprototype> </funcsynopsis> <para> - Takes the filepointer, fp, and truncates the file to length, size. - This function returns &true; on success and &false; on failure. + Vezme soubor specifikovaný pomocí <parameter>fp</parameter> a + zkrátí ho na délku <parameter>size</parameter>. + Vrací &true; pøi úspìchu a &false; pøi chybì. </para> </refsect1> </refentry> @@ -1500,7 +1498,7 @@ <refentry id="function.fwrite"> <refnamediv> <refname>fwrite</refname> - <refpurpose>Binary-safe file write</refpurpose> + <refpurpose>Binárnì bezpeèný zápis do souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1517,24 +1515,23 @@ </funcprototype> </funcsynopsis> <simpara> - <function>fwrite</function> writes the contents of - <parameter>string</parameter> to the file stream pointed to by - <parameter>fp</parameter>. If the <parameter>length</parameter> - argument is given, writing will stop after - <parameter>length</parameter> bytes have been written or the end - of <parameter>string</parameter> is reached, whichever comes - first. + <function>fwrite</function> zapí¹e obsah øetìzce + <parameter>string</parameter> do souboru specifikovaného pomocí + <parameter>fp</parameter>. Pokud je zde argument + <parameter>length</parameter>, zápis skonèí po zapsání + <parameter>length</parameter> bytù nebo pøi dosa¾ení konce + øetìzce <parameter>string</parameter>, podle toho, co pøijde + døív. </simpara> <simpara> - Pozn.: if the <parameter>length</parameter> argument is given, - then the <link - linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link> - configuration option will be ignored and no slashes will be - stripped from <parameter>string</parameter>. + Pozn.: pokud je dán argument <parameter>length</parameter>, volba + <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link> + v konfiguraci bude ignorována a nebudou odstraòována ¾ádná + lomítka z øetìzce <parameter>string</parameter>. </simpara> <simpara> Viz také <function>fread</function>, <function>fopen</function>, - <function>fsockopen</function>, <function>popen</function>, and + <function>fsockopen</function>, <function>popen</function>, a <function>fputs</function>. </simpara> </refsect1> @@ -1544,7 +1541,7 @@ <refnamediv> <refname>set_file_buffer</refname> <refpurpose> - Sets file buffering on the given file pointer + Nastaví buffer pro soubor </refpurpose> </refnamediv> <refsect1> @@ -1557,24 +1554,25 @@ </funcprototype> </funcsynopsis> <simpara> - Output using <function>fwrite</function> is normally buffered at - 8K. This means that if there are two processess wanting to write - to the same output stream (a file), each is paused after 8K of - data to allow the other to write. <function>set_file_buffer</function> - sets the buffering for write operations on the given filepointer - <parameter>fp</parameter> to <parameter>buffer</parameter> bytes. - If <parameter>buffer</parameter> is 0 then write operations are - unbuffered. This ensures that all writes with - <function>fwrite</function> are completed before other processes - are allowed to write to that output stream. - </simpara> - <simpara> - The function returns 0 on success, or EOF if the request cannot - be honored. - </simpara> - <para> - The following example demonstrates how to use - <function>set_file_buffer</function> to create an unbuffered stream. + Výstup pomocí <function>fwrite</function> je implicitnì bufferován + do bufferu o velikosti 8 KB. To znamená, ¾e kdy¾ chtìjí dva procesy + zapisovat do tého¾ streamu (souboru), ka¾dý je v¾dy po 8 KB pøeru¹en, + aby ten druhý mohl zapisovat. Funkce + <function>set_file_buffer</function> + nastavuje buffering pro zápis pøes daný deskriptor + <parameter>fp</parameter> na <parameter>buffer</parameter> bytù. + Pokud je <parameter>buffer</parameter> roven 0, zápisy nejsou + bufferovány. To zaji¹»uje, ¾e v¹echny zápisy jsou dokonèeny + døív, ne¾ ostatní procesy mohou do souboru zapisovat. + </simpara> + <simpara> + Funkce vrací 0 pøi úspìchu nebo EOF (konec souboru) pokud + po¾adavek nemù¾e být uskuteènìn. + </simpara> + <para> + Následující pøíklad demonstruje, jak pou¾ívat funkci + <function>set_file_buffer</function> k vytvoøení nebufferovaného + streamu. <example> <title><function>set_file_buffer</function> example</title> <programlisting role="php"> @@ -1597,7 +1595,7 @@ <refentry id="function.is-dir"> <refnamediv> <refname>is_dir</refname> - <refpurpose>Tells whether the filename is a directory</refpurpose> + <refpurpose>Zjistí, zda je daný soubor adresáøem</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1608,14 +1606,14 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is a directory. + Vrací &true; kdy¾ soubor existuje a jedná se o adresáø. </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 detailù - viz + <function>clearstatcache</function>. </para> <para> - Viz také <function>is_file</function> and + Viz také <function>is_file</function> a <function>is_link</function>. </para> </refsect1> @@ -1624,7 +1622,7 @@ <refentry id="function.is-executable"> <refnamediv> <refname>is_executable</refname> - <refpurpose>Tells whether the filename is executable</refpurpose> + <refpurpose>Zjistí, zda je soubor spustitelný</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1635,14 +1633,14 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is executable. + Vrací &true;, kdy¾ soubor existuje a je spustitelný (proveditelný) </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 detailù - viz + <function>clearstatcache</function>. </para> <para> - Viz také <function>is_file</function> and + Viz také <function>is_file</function> a <function>is_link</function>. </para> </refsect1> @@ -1652,7 +1650,7 @@ <refnamediv> <refname>is_file</refname> <refpurpose> - Tells whether the filename is a regular file + Zjistí, zda se jedná o obyèejný (regular) soubor </refpurpose> </refnamediv> <refsect1> @@ -1664,14 +1662,14 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is a regular file. + Vrací &true;, kdy¾ soubor existuje a jedná se o obyèejný (regular) soubor </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 detailù - viz + <function>clearstatcache</function>. </para> <para> - Viz také <function>is_dir</function> and + Viz také <function>is_dir</function> a <function>is_link</function>. </para> </refsect1> @@ -1681,7 +1679,7 @@ <refnamediv> <refname>is_link</refname> <refpurpose> - Tells whether the filename is a symbolic link + Zjistí, zda se jedná o symbolický odkaz (link) </refpurpose> </refnamediv> <refsect1> @@ -1693,14 +1691,14 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is a symbolic link. + Vrací &true;, kdy¾ soubor existuje a jedná se o symbolický odkaz (link). </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 detailù - viz + <function>clearstatcache</function>. </para> <para> - Viz také <function>is_dir</function> and + Viz také <function>is_dir</function> a <function>is_file</function>. </para> <note> @@ -1715,7 +1713,7 @@ <refnamediv> <refname>is_readable</refname> <refpurpose> - Tells whether the filename is readable + Zjistí, zda lze ze souboru èíst </refpurpose> </refnamediv> <refsect1> @@ -1727,16 +1725,17 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is readable. + Vrací &true;, kdy¾ soubor existuje a lze z nìj èíst. </para> <para> - Keep in mind that PHP may be accessing the file as the user - id that the web server runs as (often 'nobody'). Safe mode - limitations are not taken into account. + Mìjte na pamìti, ¾e PHP mù¾e pøistupovat k souboru s právy, + kterými disponuje WWW server (obvykle 'nobody'). Omezení + bezpeèného re¾imu (safe mode limitations) + are not taken into account. </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 detailù - viz + <function>clearstatcache</function>. </para> <para> Viz také <function>is_writable</function>. @@ -1747,7 +1746,7 @@ <refentry id="function.is-writable"> <refnamediv> <refname>is_writable</refname> - <refpurpose>Tells whether the filename is writable</refpurpose> + <refpurpose>Zjistí, zda lze do souboru zapisovat</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1758,18 +1757,19 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is writable. The - filename argument may be a directory name allowing you to check - if a directory is writeable. + Vrací &true;, kdy¾ soubor existuje a lze do nìj zapisovat. + Název souboru (argument filename) mù¾e být název adresáøe, + potom se zji¹»uje, zda lze do adresáøe zapisovat. </para> <para> - Keep in mind that PHP may be accessing the file as the user id - that the web server runs as (often 'nobody'). Safe mode - limitations are not taken into account. + Mìjte na pamìti, ¾e PHP mù¾e pøistupovat k souboru s právy, + kterými disponuje WWW server (obvykle 'nobody'). Omezení + bezpeèného re¾imu (safe mode limitations) + are not taken into account. </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 detailù - viz + <function>clearstatcache</function>. </para> <para> Viz také <function>is_readable</function>. @@ -1780,7 +1780,7 @@ <refentry id="function.is-uploaded-file"> <refnamediv> <refname>is_uploaded_file</refname> - <refpurpose>Tells whether the file was uploaded via HTTP POST.</refpurpose> + <refpurpose>Zjistí, zda byl soubor uploadován pomocí HTTP POST</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1792,29 +1792,28 @@ </funcsynopsis> <para> - This function is available only in versions of PHP 3 after PHP - 3.0.16, and in versions of PHP 4 after 4.0.2. + Tato funkce je dostupná pouze na verzích PHP 3 od 3.0.16 + a na verzích PHP 4 od 4.0.2. </para> <para> - Returns &true; if the file named by <varname>filename</varname> was - uploaded via HTTP POST. This is useful to help ensure that a - malicious user hasn't tried to trick the script into working on - files upon which it should not be working--for instance, + Vrací &true;, pokud soubor nazvaný <varname>filename</varname> + byl uploadován pomocí HTTP POST. To je u¾iteèné k uji¹tìní se, + zda se neukáznìný u¾ivatel nepokusil upravit skript tak, aby + pracoval se soubory, se kterými by pracovat nemìl -- napøíklad <filename>/etc/passwd</filename>. </para> <para> - This sort of check is especially important if there is any chance - that anything done with uploaded files could reveal their - contents to the user, or even to other users on the same - system. + Tento druh testù je zvlá¹tì dùle¾itý, je-li mo¾nost, + ¾e akce na uploadovaných souborech mù¾e zpøístupnit jejich + obsah u¾ivateli nebo jiným u¾ivatekùm tohoto systému. </para> <para> - Viz také <function>move_uploaded_file</function>, and the section - <link linkend="features.file-upload">Handling file uploads</link> - for a simple usage example. + Viz také <function>move_uploaded_file</function>, a sekce + <link linkend="features.file-upload">Handling file uploads</link>, + kde je pøíklad jednoduchého pou¾ití. </para> </refsect1> </refentry> @@ -1822,7 +1821,7 @@ <refentry id="function.link"> <refnamediv> <refname>link</refname> - <refpurpose>Create a hard link</refpurpose> + <refpurpose>Vytvoøí hard link</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1834,10 +1833,10 @@ </funcprototype> </funcsynopsis> <para> - <function>link</function> creates a hard link.</para> + <function>link</function> vytvoøí hard link.</para> <para> - Viz také the <function>symlink</function> to create soft links, - and <function>readlink</function> along with + Viz také <function>symlink</function> pro vytváøení symbolických linkù + a <function>readlink</function> spolu s <function>linkinfo</function>. </para> <note> @@ -1851,7 +1850,7 @@ <refentry id="function.linkinfo"> <refnamediv> <refname>linkinfo</refname> - <refpurpose>Gets information about a link</refpurpose> + <refpurpose>Vrací informaci o odkazu (linku)</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1862,16 +1861,16 @@ </funcprototype> </funcsynopsis> <para> - <function>linkinfo</function> returns the st_dev field of the - UNIX C stat structure returned by the lstat system call. This - function is used to verify if a link (pointed to by - <parameter>path</parameter>) really exists (using the same method - as the S_ISLNK macro defined in stat.h). Returns 0 or &false; in - case of error. + <function>linkinfo</function> vrací polo¾ku st_dev field + struktury UNIX C stat získanou systémovým voláním lstat. + Tato funkce se pou¾ívá pro ovìøení, zda odkaz (specifikovaný + pomocí <parameter>path</parameter>) opravdu existuje (pou¾ívá se + tatá¾ metoda jako je makro S_ISLNK definovaní v stat.h). Vrací 0, + v pøípadì chyby&false;. </para> <para> Viz také <function>symlink</function>, <function>link</function>, - and <function>readlink</function>. + a <function>readlink</function>. </para> <note> <simpara>
Index: phpdoc/cs/functions/filesystem.xml diff -u phpdoc/cs/functions/filesystem.xml:1.7 phpdoc/cs/functions/filesystem.xml:1.8 --- phpdoc/cs/functions/filesystem.xml:1.7 Wed Nov 21 09:37:20 2001 +++ phpdoc/cs/functions/filesystem.xml Wed Nov 21 19:02:09 2001 @@ -55,7 +55,7 @@ </funcsynopsis> <para> Pokusí se nastavit skupinu souboru <parameter>filename</parameter> na - <parameter>group</parameter>. Pouze superuser mù¾e libovolnì zmìnit + <parameter>group</parameter>. Pouze superu¾ivatel mù¾e libovolnì zmìnit skupinu souboru; ostatní u¾ivatelé mohou zmìnit skupinu souboru na jinou skupinu, jí¾ jsou èleny. </para> @@ -133,8 +133,8 @@ </funcprototype> </funcsynopsis> <para> - Pokusí se zmìnit majitele souboru na <parameter>user</parameter>. Pouze - superuser mù¾e zmìnit majitele souboru. + Pokusí se zmìnit vlastníka souboru na <parameter>user</parameter>. Pouze + superu¾ivatel mù¾e zmìnit majitele souboru. </para> <para> Pøi úspìchu vrací &true;, jinak &false;. @@ -1136,7 +1136,7 @@ </para> <para> <example> - <title><function>fopen</function> example</title> + <title><function>fopen</function> pøíklad</title> <programlisting role="php"> $fp = fopen ("/home/rasmus/file.txt", "r"); $fp = fopen ("/home/rasmus/file.gif", "wb"); @@ -1146,14 +1146,14 @@ </example> </para> <simpara> - If you are experiencing problems with reading and writing to - files and you're using the server module version of PHP, remember - to make sure that the files and directories you're using are - accessible to the server process. + Pokud jste zaznamenali problémy se ètením a zápisem do souborù + a pou¾íváte PHP jako modul do serveru, nezapomeòte zajistit, aby + soubory a adresáøe, které pou¾íváte, byly pøístupné pro serverový + proces. </simpara> <para> - On the Windows platform, be careful to escape any backslashes - used in the path to the file, or use forward slashes. + Na Windows je tøeba oescapovat v¹echna zpìtná lomítka ve specifikaci + cesty k souboru nebo pou¾ívat obyèejná (dopøedná) lomítka. <informalexample> <programlisting role="php"> $fp = fopen ("c:\\data\\info.txt", "r"); @@ -1163,7 +1163,7 @@ <simpara> Viz také <function>fclose</function>, <function>fsockopen</function>, - <function>socket_set_timeout</function>, and + <function>socket_set_timeout</function>, a <function>popen</function>. </simpara> </refsect1> @@ -1173,7 +1173,7 @@ <refnamediv> <refname>fpassthru</refname> <refpurpose> - Output all remaining data on a file pointer + Vypí¹e v¹echna zbývající data v souboru </refpurpose> </refnamediv> <refsect1> @@ -1185,28 +1185,28 @@ </funcprototype> </funcsynopsis> <simpara> - Reads to EOF on the given file pointer and writes the results to - standard output. + Ète a¾ do dosa¾ení konce souboru specifikovaného deskriptorem a + naètené pøepisuje na standardní výstup. </simpara> <simpara> - If an error occurs, <function>fpassthru</function> returns - &false;. + Pokud nastane chyba, funkce <function>fpassthru</function> + vrací &false;. </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>. - The file is closed when <function>fpassthru</function> is done - reading it (leaving <parameter>fp</parameter> useless). + 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>. + A¾ funkce <function>fpassthru</function> ukonèí ètení, zavøe soubor + (deskriptor <parameter>fp</parameter> tím ztrácí smysl). </simpara> <simpara> - If you just want to dump the contents of a file to stdout you may - want to use the <function>readfile</function>, which saves you - the <function>fopen</function> call. + Kdy¾ chcete vypsat obsah souboru na standardní výstup (stdout), + mù¾ete pou¾í funkci <function>readfile</function>, která vás + u¹etøí volání funkce <function>fopen</function>. </simpara> <simpara> Viz také <function>readfile</function>, - <function>fopen</function>, <function>popen</function>, and + <function>fopen</function>, <function>popen</function>, a <function>fsockopen</function> </simpara> </refsect1> @@ -1215,7 +1215,7 @@ <refentry id="function.fputs"> <refnamediv> <refname>fputs</refname> - <refpurpose>Writes to a file pointer</refpurpose> + <refpurpose>Zapí¹e do souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1232,10 +1232,10 @@ </funcprototype> </funcsynopsis> <para> - <function>fputs</function> is an alias to - <function>fwrite</function>, and is identical in every way. Note - that the <parameter>length</parameter> parameter is optional and - if not specified the entire string will be written. + Funkce <function>fputs</function> je alias k + <function>fwrite</function> a je s ní tedy naprosto identická. + Uvìdomte si, ¾e parametr <parameter>length</parameter> je nepovinný + a pokud není specifikován, zapí¹e se celý øetezec. </para> </refsect1> </refentry> @@ -1243,7 +1243,7 @@ <refentry id="function.fread"> <refnamediv> <refname>fread</refname> - <refpurpose>Binary-safe file read</refpurpose> + <refpurpose>Binárnì bezpeèné ètení ze souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1255,16 +1255,16 @@ </funcprototype> </funcsynopsis> <simpara> - <function>fread</function> reads up to - <parameter>length</parameter> bytes from the file pointer - referenced by <parameter>fp</parameter>. Reading stops when - <parameter>length</parameter> bytes have been read or EOF is - reached, whichever comes first. + <function>fread</function> pøeète nejvý¹e + <parameter>length</parameter> bytù ze souboru specifikovaného + deskriptorem <parameter>fp</parameter>. Ètení konèí, pokud je + pøeèteno <parameter>length</parameter> bytù nebo je dosa¾en konec + souboru (podle toho, co pøijde døív). </simpara> <para> <informalexample> <programlisting role="php"> -// get contents of a file into a string +// nacte obsah souboru do retezce $filename = "/usr/local/something.txt"; $fd = fopen ($filename, "r"); $contents = fread ($fd, filesize ($filename)); @@ -1276,7 +1276,7 @@ Viz také <function>fwrite</function>, <function>fopen</function>, <function>fsockopen</function>, <function>popen</function>, <function>fgets</function>, <function>fgetss</function>, - <function>fscanf</function>, <function>file</function>, and + <function>fscanf</function>, <function>file</function>, a <function>fpassthru</function>. </simpara> </refsect1> @@ -1285,7 +1285,7 @@ <refentry id="function.fscanf"> <refnamediv> <refname>fscanf</refname> - <refpurpose>Parses input from a file according to a format</refpurpose> + <refpurpose>Parsuje vstup ze souboru podle formátu</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1300,22 +1300,21 @@ </funcprototype> </funcsynopsis> <para> - The function <function>fscanf</function> is similar to - <function>sscanf</function>, but it takes its input from a file - associated with <parameter>handle</parameter> and interprets the - input according to the specified - <parameter>format</parameter>. If only two parameters were passed - to this function, the values parsed will be returned as an array. - Otherwise, if optional parameters are passed, the function will - return the number of assigned values. The optional parameters - must be passed by reference. + Funkce <function>fscanf</function> je podobná + <function>sscanf</function>, ale naèítá ze souboru specifikovaného + <parameter>handle</parameter> a interpretuje vstupní data podle + specifikovaného formátu <parameter>format</parameter>. Pokud má + funkce pouze dva parametry, parsované hodnoty bude vráceny jako pole. + Jinak, kdy¾ jsou pou¾ity nepovinné parametry, funkce vrací urèitý + poèet asignovaných hodnot. Nepovinné parametry musí být vlo¾eny + odkazem. <example> - <title><function>fscanf</function> Example</title> + <title><function>fscanf</function> Pøíklad</title> <programlisting role="php"> $fp = fopen ("users.txt","r"); while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; - //... do something with the values + //... udelej neco s hodnotami } fclose($fp); </programlisting> @@ -1333,7 +1332,7 @@ <para> Viz také <function>fread</function>, <function>fgets</function>, <function>fgetss</function>, <function>sscanf</function>, - <function>printf</function>, and <function>sprintf</function>. + <function>printf</function>, a <function>sprintf</function>. </para> </refsect1> </refentry> @@ -1341,7 +1340,7 @@ <refentry id="function.fseek"> <refnamediv> <refname>fseek</refname> - <refpurpose>Seeks on a file pointer</refpurpose> + <refpurpose>Posouvá ukazatel v souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1356,40 +1355,39 @@ </funcprototype> </funcsynopsis> <para> - Sets the file position indicator for the file referenced by - <parameter>fp</parameter>.The new position, measured in bytes - from the beginning of the file, is obtained by adding - <parameter>offset</parameter> to the position specified by - <parameter>whence</parameter>, whose values are defined as - follows: + Nastaví ukazatel pozice v souboru specifikované pomocí + deskriptoru <parameter>fp</parameter>. Nová pozice, mìøená + poètem bytù od zaèátku souboru, je získána pøiètením hodnoty + <parameter>offset</parameter> k pozici specifikované pomocí + <parameter>whence</parameter>, jeho¾ hodnota je definovanána: <simplelist> - <member>SEEK_SET - Set position equal to - <parameter>offset</parameter> bytes.</member> <member>SEEK_CUR - - Set position to current location plus - <parameter>offset</parameter>.</member> <member>SEEK_END - Set - position to end-of-file plus - <parameter>offset</parameter>.</member> + <member>SEEK_SET - Nastav na pozici rovnu + <parameter>offset</parameter> bytù.</member> <member>SEEK_CUR - + Nastav pozici na souèasnou plus poèet bytù v + <parameter>offset</parameter>.</member> <member>SEEK_END - Nastav + na konec souboru plus + <parameter>offset</parameter> bytù.</member> </simplelist> </para> - <para>If <parameter>whence is not specified, it is assumed to be - SEEK_SET.</parameter> + <para>Pokud není parametr <parameter>whence</parameter> specifikován, + pou¾ije se SEEK_SET. </para> <para> - Upon success, returns 0; otherwise, returns -1. Pozn.: seeking - past EOF is not considered an error. + Pøi úspìchu vrací 0, jinak -1. Pozn.: pøesun za konec souboru + není pova¾ován za chybu. </para> <para> - May not be used on file pointers returned by - <function>fopen</function> if they use the "http://" or "ftp://" - formats. + Nelze pou¾ít na deskriptor souboru vrácený funkcí + <function>fopen</function>, jestli¾e byl pou¾it formát "http://" nebo + "ftp://". </para> <note> <para> - The <parameter>whence</parameter> argument was added after PHP 4.0 RC1. + Argument <parameter>whence</parameter> byl pøidán po verzi PHP 4.0 RC1. </para> </note> <para> - Viz také <function>ftell</function> and + Viz také <function>ftell</function> a <function>rewind</function>. </para> </refsect1> @@ -1399,7 +1397,7 @@ <refnamediv> <refname>fstat</refname> <refpurpose> - Gets information about a file using an open file pointer + Vrací informace o otevøeném souboru </refpurpose> </refnamediv> <refsect1> @@ -1411,14 +1409,13 @@ </funcprototype> </funcsynopsis> <para> - Gathers the statistics of the file opened by the file - pointer fp. This function is similar to the - <function>stat</function> function except that it operates - on an open file pointer instead of a filename. + Sbírá statistiky otevøeného souboru specifikovaném + deskriptorem <parameter>fp</parameter>. Tato funkce je + podobná funkci <function>stat</function>, pracuje + v¹ak s deskriptorem, nikoli názvem souboru. </para> <para> - Returns an array with the statistics of the file with the - following elements: + Vrací pole se statistikami souboru s tìmito elementy: <orderedlist> <listitem><simpara>device</simpara></listitem> <listitem><simpara>inode</simpara></listitem> @@ -1433,11 +1430,11 @@ <listitem><simpara>blocksize for filesystem I/O *</simpara></listitem> <listitem><simpara>number of blocks allocated</simpara></listitem> </orderedlist> - * - only valid on systems supporting the st_blksize type--other - systems (i.e. Windows) return -1</para> + * - platné pouze na systémech s podporou typu st_blksize -- jinde + (napø. na Windows) vrací -1</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 detailù - viz + <function>clearstatcache</function>. </para> </refsect1> </refentry> @@ -1445,7 +1442,7 @@ <refentry id="function.ftell"> <refnamediv> <refname>ftell</refname> - <refpurpose>Tells file pointer read/write position</refpurpose> + <refpurpose>Vrací pozici v souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1456,20 +1453,20 @@ </funcprototype> </funcsynopsis> <para> - Returns the position of the file pointer referenced by fp; i.e., - its offset into the file stream. + Vrací pozici v souboru odkazovaném deskriptorem fp; typicky + offset ve streamu. </para> <para> - If an error occurs, returns &false;. + Pokud nastane chyba, vrací &false;. </para> <para> - The file pointer must be valid, and must point to a file - successfully opened by <function>fopen</function> or - <function>popen</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>fopen</function>, <function>popen</function>, - <function>fseek</function> and <function>rewind</function>. + <function>fseek</function> a <function>rewind</function>. </para> </refsect1> </refentry> @@ -1478,7 +1475,7 @@ <refnamediv> <refname>ftruncate</refname> <refpurpose> - Truncates a file to a given length. + Zkrátí soubor na danou délku </refpurpose> </refnamediv> <refsect1> @@ -1491,8 +1488,9 @@ </funcprototype> </funcsynopsis> <para> - Takes the filepointer, fp, and truncates the file to length, size. - This function returns &true; on success and &false; on failure. + Vezme soubor specifikovaný pomocí <parameter>fp</parameter> a + zkrátí ho na délku <parameter>size</parameter>. + Vrací &true; pøi úspìchu a &false; pøi chybì. </para> </refsect1> </refentry> @@ -1500,7 +1498,7 @@ <refentry id="function.fwrite"> <refnamediv> <refname>fwrite</refname> - <refpurpose>Binary-safe file write</refpurpose> + <refpurpose>Binárnì bezpeèný zápis do souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1517,24 +1515,23 @@ </funcprototype> </funcsynopsis> <simpara> - <function>fwrite</function> writes the contents of - <parameter>string</parameter> to the file stream pointed to by - <parameter>fp</parameter>. If the <parameter>length</parameter> - argument is given, writing will stop after - <parameter>length</parameter> bytes have been written or the end - of <parameter>string</parameter> is reached, whichever comes - first. + <function>fwrite</function> zapí¹e obsah øetìzce + <parameter>string</parameter> do souboru specifikovaného pomocí + <parameter>fp</parameter>. Pokud je zde argument + <parameter>length</parameter>, zápis skonèí po zapsání + <parameter>length</parameter> bytù nebo pøi dosa¾ení konce + øetìzce <parameter>string</parameter>, podle toho, co pøijde + døív. </simpara> <simpara> - Pozn.: if the <parameter>length</parameter> argument is given, - then the <link - linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link> - configuration option will be ignored and no slashes will be - stripped from <parameter>string</parameter>. + Pozn.: pokud je dán argument <parameter>length</parameter>, volba + <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link> + v konfiguraci bude ignorována a nebudou odstraòována ¾ádná + lomítka z øetìzce <parameter>string</parameter>. </simpara> <simpara> Viz také <function>fread</function>, <function>fopen</function>, - <function>fsockopen</function>, <function>popen</function>, and + <function>fsockopen</function>, <function>popen</function>, a <function>fputs</function>. </simpara> </refsect1> @@ -1544,7 +1541,7 @@ <refnamediv> <refname>set_file_buffer</refname> <refpurpose> - Sets file buffering on the given file pointer + Nastaví buffer pro soubor </refpurpose> </refnamediv> <refsect1> @@ -1557,24 +1554,25 @@ </funcprototype> </funcsynopsis> <simpara> - Output using <function>fwrite</function> is normally buffered at - 8K. This means that if there are two processess wanting to write - to the same output stream (a file), each is paused after 8K of - data to allow the other to write. <function>set_file_buffer</function> - sets the buffering for write operations on the given filepointer - <parameter>fp</parameter> to <parameter>buffer</parameter> bytes. - If <parameter>buffer</parameter> is 0 then write operations are - unbuffered. This ensures that all writes with - <function>fwrite</function> are completed before other processes - are allowed to write to that output stream. - </simpara> - <simpara> - The function returns 0 on success, or EOF if the request cannot - be honored. - </simpara> - <para> - The following example demonstrates how to use - <function>set_file_buffer</function> to create an unbuffered stream. + Výstup pomocí <function>fwrite</function> je implicitnì bufferován + do bufferu o velikosti 8 KB. To znamená, ¾e kdy¾ chtìjí dva procesy + zapisovat do tého¾ streamu (souboru), ka¾dý je v¾dy po 8 KB pøeru¹en, + aby ten druhý mohl zapisovat. Funkce + <function>set_file_buffer</function> + nastavuje buffering pro zápis pøes daný deskriptor + <parameter>fp</parameter> na <parameter>buffer</parameter> bytù. + Pokud je <parameter>buffer</parameter> roven 0, zápisy nejsou + bufferovány. To zaji¹»uje, ¾e v¹echny zápisy jsou dokonèeny + døív, ne¾ ostatní procesy mohou do souboru zapisovat. + </simpara> + <simpara> + Funkce vrací 0 pøi úspìchu nebo EOF (konec souboru) pokud + po¾adavek nemù¾e být uskuteènìn. + </simpara> + <para> + Následující pøíklad demonstruje, jak pou¾ívat funkci + <function>set_file_buffer</function> k vytvoøení nebufferovaného + streamu. <example> <title><function>set_file_buffer</function> example</title> <programlisting role="php"> @@ -1597,7 +1595,7 @@ <refentry id="function.is-dir"> <refnamediv> <refname>is_dir</refname> - <refpurpose>Tells whether the filename is a directory</refpurpose> + <refpurpose>Zjistí, zda je daný soubor adresáøem</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1608,14 +1606,14 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is a directory. + Vrací &true; kdy¾ soubor existuje a jedná se o adresáø. </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 detailù - viz + <function>clearstatcache</function>. </para> <para> - Viz také <function>is_file</function> and + Viz také <function>is_file</function> a <function>is_link</function>. </para> </refsect1> @@ -1624,7 +1622,7 @@ <refentry id="function.is-executable"> <refnamediv> <refname>is_executable</refname> - <refpurpose>Tells whether the filename is executable</refpurpose> + <refpurpose>Zjistí, zda je soubor spustitelný</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1635,14 +1633,14 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is executable. + Vrací &true;, kdy¾ soubor existuje a je spustitelný (proveditelný) </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 detailù - viz + <function>clearstatcache</function>. </para> <para> - Viz také <function>is_file</function> and + Viz také <function>is_file</function> a <function>is_link</function>. </para> </refsect1> @@ -1652,7 +1650,7 @@ <refnamediv> <refname>is_file</refname> <refpurpose> - Tells whether the filename is a regular file + Zjistí, zda se jedná o obyèejný (regular) soubor </refpurpose> </refnamediv> <refsect1> @@ -1664,14 +1662,14 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is a regular file. + Vrací &true;, kdy¾ soubor existuje a jedná se o obyèejný (regular) soubor </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 detailù - viz + <function>clearstatcache</function>. </para> <para> - Viz také <function>is_dir</function> and + Viz také <function>is_dir</function> a <function>is_link</function>. </para> </refsect1> @@ -1681,7 +1679,7 @@ <refnamediv> <refname>is_link</refname> <refpurpose> - Tells whether the filename is a symbolic link + Zjistí, zda se jedná o symbolický odkaz (link) </refpurpose> </refnamediv> <refsect1> @@ -1693,14 +1691,14 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is a symbolic link. + Vrací &true;, kdy¾ soubor existuje a jedná se o symbolický odkaz (link). </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 detailù - viz + <function>clearstatcache</function>. </para> <para> - Viz také <function>is_dir</function> and + Viz také <function>is_dir</function> a <function>is_file</function>. </para> <note> @@ -1715,7 +1713,7 @@ <refnamediv> <refname>is_readable</refname> <refpurpose> - Tells whether the filename is readable + Zjistí, zda lze ze souboru èíst </refpurpose> </refnamediv> <refsect1> @@ -1727,16 +1725,17 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is readable. + Vrací &true;, kdy¾ soubor existuje a lze z nìj èíst. </para> <para> - Keep in mind that PHP may be accessing the file as the user - id that the web server runs as (often 'nobody'). Safe mode - limitations are not taken into account. + Mìjte na pamìti, ¾e PHP mù¾e pøistupovat k souboru s právy, + kterými disponuje WWW server (obvykle 'nobody'). Omezení + bezpeèného re¾imu (safe mode limitations) + are not taken into account. </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 detailù - viz + <function>clearstatcache</function>. </para> <para> Viz také <function>is_writable</function>. @@ -1747,7 +1746,7 @@ <refentry id="function.is-writable"> <refnamediv> <refname>is_writable</refname> - <refpurpose>Tells whether the filename is writable</refpurpose> + <refpurpose>Zjistí, zda lze do souboru zapisovat</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1758,18 +1757,19 @@ </funcprototype> </funcsynopsis> <para> - Returns &true; if the filename exists and is writable. The - filename argument may be a directory name allowing you to check - if a directory is writeable. + Vrací &true;, kdy¾ soubor existuje a lze do nìj zapisovat. + Název souboru (argument filename) mù¾e být název adresáøe, + potom se zji¹»uje, zda lze do adresáøe zapisovat. </para> <para> - Keep in mind that PHP may be accessing the file as the user id - that the web server runs as (often 'nobody'). Safe mode - limitations are not taken into account. + Mìjte na pamìti, ¾e PHP mù¾e pøistupovat k souboru s právy, + kterými disponuje WWW server (obvykle 'nobody'). Omezení + bezpeèného re¾imu (safe mode limitations) + are not taken into account. </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 detailù - viz + <function>clearstatcache</function>. </para> <para> Viz také <function>is_readable</function>. @@ -1780,7 +1780,7 @@ <refentry id="function.is-uploaded-file"> <refnamediv> <refname>is_uploaded_file</refname> - <refpurpose>Tells whether the file was uploaded via HTTP POST.</refpurpose> + <refpurpose>Zjistí, zda byl soubor uploadován pomocí HTTP POST</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1792,29 +1792,28 @@ </funcsynopsis> <para> - This function is available only in versions of PHP 3 after PHP - 3.0.16, and in versions of PHP 4 after 4.0.2. + Tato funkce je dostupná pouze na verzích PHP 3 od 3.0.16 + a na verzích PHP 4 od 4.0.2. </para> <para> - Returns &true; if the file named by <varname>filename</varname> was - uploaded via HTTP POST. This is useful to help ensure that a - malicious user hasn't tried to trick the script into working on - files upon which it should not be working--for instance, + Vrací &true;, pokud soubor nazvaný <varname>filename</varname> + byl uploadován pomocí HTTP POST. To je u¾iteèné k uji¹tìní se, + zda se neukáznìný u¾ivatel nepokusil upravit skript tak, aby + pracoval se soubory, se kterými by pracovat nemìl -- napøíklad <filename>/etc/passwd</filename>. </para> <para> - This sort of check is especially important if there is any chance - that anything done with uploaded files could reveal their - contents to the user, or even to other users on the same - system. + Tento druh testù je zvlá¹tì dùle¾itý, je-li mo¾nost, + ¾e akce na uploadovaných souborech mù¾e zpøístupnit jejich + obsah u¾ivateli nebo jiným u¾ivatekùm tohoto systému. </para> <para> - Viz také <function>move_uploaded_file</function>, and the section - <link linkend="features.file-upload">Handling file uploads</link> - for a simple usage example. + Viz také <function>move_uploaded_file</function>, a sekce + <link linkend="features.file-upload">Handling file uploads</link>, + kde je pøíklad jednoduchého pou¾ití. </para> </refsect1> </refentry> @@ -1822,7 +1821,7 @@ <refentry id="function.link"> <refnamediv> <refname>link</refname> - <refpurpose>Create a hard link</refpurpose> + <refpurpose>Vytvoøí hard link</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1834,10 +1833,10 @@ </funcprototype> </funcsynopsis> <para> - <function>link</function> creates a hard link.</para> + <function>link</function> vytvoøí hard link.</para> <para> - Viz také the <function>symlink</function> to create soft links, - and <function>readlink</function> along with + Viz také <function>symlink</function> pro vytváøení symbolických linkù + a <function>readlink</function> spolu s <function>linkinfo</function>. </para> <note> @@ -1851,7 +1850,7 @@ <refentry id="function.linkinfo"> <refnamediv> <refname>linkinfo</refname> - <refpurpose>Gets information about a link</refpurpose> + <refpurpose>Vrací informaci o odkazu (linku)</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1862,16 +1861,16 @@ </funcprototype> </funcsynopsis> <para> - <function>linkinfo</function> returns the st_dev field of the - UNIX C stat structure returned by the lstat system call. This - function is used to verify if a link (pointed to by - <parameter>path</parameter>) really exists (using the same method - as the S_ISLNK macro defined in stat.h). Returns 0 or &false; in - case of error. + <function>linkinfo</function> vrací polo¾ku st_dev field + struktury UNIX C stat získanou systémovým voláním lstat. + Tato funkce se pou¾ívá pro ovìøení, zda odkaz (specifikovaný + pomocí <parameter>path</parameter>) opravdu existuje (pou¾ívá se + tatá¾ metoda jako je makro S_ISLNK definovaní v stat.h). Vrací 0, + v pøípadì chyby&false;. </para> <para> Viz také <function>symlink</function>, <function>link</function>, - and <function>readlink</function>. + a <function>readlink</function>. </para> <note> <simpara>