luk Thu Nov 22 16:54:55 2001 EDT Modified files: /phpdoc/cs/functions filesystem.xml Log: The most part of filesystem is translated. Ufff...
Index: phpdoc/cs/functions/filesystem.xml diff -u phpdoc/cs/functions/filesystem.xml:1.8 phpdoc/cs/functions/filesystem.xml:1.9 --- phpdoc/cs/functions/filesystem.xml:1.8 Wed Nov 21 19:02:09 2001 +++ phpdoc/cs/functions/filesystem.xml Thu Nov 22 16:54:54 2001 @@ -1883,7 +1883,7 @@ <refentry id="function.mkdir"> <refnamediv> <refname>mkdir</refname> - <refpurpose>Makes directory</refpurpose> + <refpurpose>Vytvoří adresář</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1895,11 +1895,11 @@ </funcprototype> </funcsynopsis> <para> - Attempts to create the directory specified by pathname. + Pokusí se vytvořit adresář specifikovaný svým názvem. </para> - <para> - Pozn.: you probably want to specify the mode as an - octal number, which means it should have a leading zero. + <para> + Pozn.: Pravděpodobně chcete specifikovat mód jako oktalové číslo, + potom by však mělo začínat nulou. <informalexample> <programlisting role="php"> mkdir ("/path/to/my/dir", 0700); @@ -1907,7 +1907,7 @@ </informalexample> </para> <para> - Returns &true; on success and &false; on failure. + Vrací &true; při úspěchu a &false; při chybě. </para> <para> Viz také <function>rmdir</function>. @@ -1918,7 +1918,7 @@ <refentry id="function.move-uploaded-file"> <refnamediv> <refname>move_uploaded_file</refname> - <refpurpose>Moves an uploaded file to a new location.</refpurpose> + <refpurpose>Přesune uploadovaný soubor na nové místo</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1931,43 +1931,41 @@ </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 fuknce je dostupná pouze ve verzích PHP 3 od 3.0.16 a + ve verzích PHP 4 od 4.0.2. </para> <para> - This function checks to ensure that the file designated by - <parameter>filename</parameter> is a valid upload file (meaning - that it was uploaded via PHP's HTTP POST upload mechanism). If - the file is valid, it will be moved to the filename given by + Tato si ověřuje, zda soubor identifikovaný názvem + <parameter>filename</parameter> je platným uploadovaným souborem + (prostřednictvím HTTP POST mechanismu poskytovaného PHP). + Pokud je soubor platný, je přesunut/přejmenován na <parameter>destination</parameter>. </para> <para> - If <parameter>filename</parameter> is not a valid upload file, - then no action will occur, and - <function>move_uploaded_file</function> will return - &false;. + Pokud <parameter>filename</parameter> není platný uploadovaný soubor, + funkce <function>move_uploaded_file</function> nic neprovede a + vrátí &false;. </para> <para> - If <parameter>filename</parameter> is a valid upload file, but - cannot be moved for some reason, no action will occur, and - <function>move_uploaded_file</function> will return - &false;. Additionally, a warning will be issued. + Pokud <parameter>filename</parameter> je platný uploadovaný soubor, + ale z nějakého důvodu nemůže být přesunut, funkce + <function>move_uploaded_file</function> nic neprovede a vrátí + &false;. Navíc je vygenerováno varování (warning). </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>is_uploaded_file</function>, and the section - <link linkend="features.file-upload">Handling file uploads</link> - for a simple usage example. + Viz také <function>is_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> @@ -1975,7 +1973,7 @@ <refentry id="function.pclose"> <refnamediv> <refname>pclose</refname> - <refpurpose>Closes process file pointer</refpurpose> + <refpurpose>Zavře procesový soubor (rouru)</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -1986,16 +1984,15 @@ </funcprototype> </funcsynopsis> <para> - Closes a file pointer to a pipe opened by + Zavře rouru otevřenou pomocí funkce <function>popen</function>. </para> <para> - The file pointer must be valid, and must have been returned by a - successful call to <function>popen</function>. + Deskriptor souboru musí být platný a musí ukazovat na rouru úspěšně + otevřenou pomocí <function>popen</function>. </para> <para> - Returns the termination status of the process that was - run. + Vrací návratový kód procesu, který na rouře běžel. </para> <para> Viz také <function>popen</function>. @@ -2006,7 +2003,7 @@ <refentry id="function.popen"> <refnamediv> <refname>popen</refname> - <refpurpose>Opens process file pointer</refpurpose> + <refpurpose>Otevře procesový soubor (rouru)</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2018,19 +2015,21 @@ </funcprototype> </funcsynopsis> <para> - Opens a pipe to a process executed by forking the command given - by command. + Otevře rouru do procesu spuštěného rozštěpením stávajícího procesu + následným a spuštěním programu specifikovaného parametrem + <parameter>command</parameter>. </para> <para> - Returns a file pointer identical to that returned by - <function>fopen</function>, except that it is unidirectional (may - only be used for reading or writing) and must be closed with - <function>pclose</function>. This pointer may be used with - <function>fgets</function>, <function>fgetss</function>, and - <function>fputs</function>. + Vrací deskriptor souboru identický s tím, který vrací funkce + <function>fopen</function>, je však vždy pouze jednosměrný + (může být otevřen pro čtení nebo zápis, nikoli současně) + a na závěr musí být zavřen pomocí + <function>pclose</function>. Tento deskriptor může být použit + funkcemi <function>fgets</function>, <function>fgetss</function>, + a <function>fputs</function>. </para> <para> - If an error occurs, returns &false;. + Nastane-li chyba, vrací &false;. </para> <para> <informalexample> @@ -2048,7 +2047,7 @@ <refentry id="function.readfile"> <refnamediv> <refname>readfile</refname> - <refpurpose>Outputs a file</refpurpose> + <refpurpose>Vypíše soubor</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2064,43 +2063,43 @@ </funcprototype> </funcsynopsis> <para> - Reads a file and writes it to standard output. + Přečte soubor a vypíše ho na standardní výstup. </para> <para> - Returns the number of bytes read from the file. If an error - occurs, &false; is returned and unless the function was called as - @readfile, an error message is printed. + Vrací počet bytů přečtených ze souboru. Pokud nastane chyba, + vrátí &false; a pokud nebyla použita notace @readfile, + vypíše se chybové hlášení. </para> - <para> - If <parameter>filename</parameter> begins with "http://" - (not case sensitive), an HTTP 1.0 connection is opened to the - specified server and the text of the response is written to - standard output. + <para> + Když <parameter>filename</parameter> začíná "http://" + (velkými nebo malými písmeny), otevře se spojení na příslušný + server protokolem HTTP 1.0 a získaný dokument se vypíše na + standardní výstup. </para> <para> - 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. </para> <para> - If <parameter>filename</parameter> begins with "ftp://" - (not case sensitive), an ftp connection to the specified server is - opened and the requested file is written to standard output. If the server - does not support passive mode ftp, this will fail. + Když <parameter>filename</parameter> začíná "ftp://" (velká + či malá písmena), je otevřena FTP relace na příslušný server + a dokument se vypíše na standardní výstup. Pokud server + nepodporuje pasivní režim FTP komunikace, selže to. </para> <para> - If <parameter>filename</parameter> begins with neither - of these strings, the file will be opened from the filesystem and - its contents written to standard output. + Když <parameter>filename</parameter> začíná čímkoli jiným, + bude otevřen obyčejný soubor (z filesystému) a jeho obsah + vypsán na standardní výstup. </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ý třetí parametr a nastavit ho na + "1", pokud chcete hledat soubor také v + <link linkend="ini.include-path">include_path</link>. </para> <para> Viz také <function>fpassthru</function>, <function>file</function>, <function>fopen</function>, - <function>include</function>, <function>require</function>, and + <function>include</function>, <function>require</function>, a <function>virtual</function>. </para> </refsect1> @@ -2109,7 +2108,7 @@ <refentry id="function.readlink"> <refnamediv> <refname>readlink</refname> - <refpurpose>Returns the target of a symbolic link</refpurpose> + <refpurpose>Vrací cíl symbolického odkazu</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2120,13 +2119,13 @@ </funcprototype> </funcsynopsis> <para> - <function>readlink</function> does the same as the readlink C - function and returns the contents of the symbolic link path or 0 - in case of error. + <function>readlink</function> provádí totéž jako funkce + readlink v C a vrací název souboru, na který symbolický + odkaz (link) ukazuje. Při chybě vrací 0. </para> <para> Viz také <function>symlink</function>, - <function>readlink</function> and + <function>readlink</function> a <function>linkinfo</function>. </para> <note> @@ -2140,7 +2139,7 @@ <refentry id="function.rename"> <refnamediv> <refname>rename</refname> - <refpurpose>Renames a file</refpurpose> + <refpurpose>Přejmenuje soubor</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2152,11 +2151,11 @@ </funcprototype> </funcsynopsis> <para> - Attempts to rename <parameter>oldname</parameter> to + Pokusí se přejmenovat soubor <parameter>oldname</parameter> na <parameter>newname</parameter>. </para> <para> - Returns &true; on success and &false; on failure. + Vrací &true; při úspěchu a &false; při chybě. </para> </refsect1> </refentry> @@ -2164,7 +2163,7 @@ <refentry id="function.rewind"> <refnamediv> <refname>rewind</refname> - <refpurpose>Rewind the position of a file pointer</refpurpose> + <refpurpose>Vrátí ukazatel v souboru na začátek</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2175,13 +2174,20 @@ </funcprototype> </funcsynopsis> <para> - Sets the file position indicator for fp to the beginning of the - file stream.</para> <para> If an error occurs, returns 0.</para> - <para> The file pointer must be valid, and must point to a file - successfully opened by <function>fopen</function>. + Nastaví pozici ukazatele v souboru specifikované deskriptorem + <parameter>fp</parameter> na začátek tohoto souboru. + </para> + + <para> + Nastane-li chyba, vrací 0. + </para> + + <para> + Deskriptor souboru musí být platný a musí ukazovat na soubor úspěšně + otevřený pomocí <function>fopen</function>. </para> <para> - Viz také <function>fseek</function> and + Viz také <function>fseek</function> a <function>ftell</function>. </para> </refsect1> @@ -2191,7 +2197,7 @@ <refentry id="function.rmdir"> <refnamediv> <refname>rmdir</refname> - <refpurpose>Removes directory</refpurpose> + <refpurpose>Odstraní adresář</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2202,12 +2208,11 @@ </funcprototype> </funcsynopsis> <para> - Attempts to remove the directory named by pathname. The directory - must be empty, and the relevant permissions must permit. - this. + Pokusí se odstranit adresář specifikovaný svým názvem. Adresář + musí být být prázdný a mít nastavena odpovídající oprávnění. </para> <para> - If an error occurs, returns 0. + Nastane-li chyba, vrací 0. </para> <para> Viz také <function>mkdir</function>. @@ -2218,7 +2223,7 @@ <refentry id="function.stat"> <refnamediv> <refname>stat</refname> - <refpurpose>Gives information about a file</refpurpose> + <refpurpose>Zjišťuje informace o souboru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2229,10 +2234,11 @@ </funcprototype> </funcsynopsis> <para> - Gathers the statistics of the file named by filename.</para> + Sbírá statistiky o souboru indentifikovaném názvem + <parameter>filename</parameter>. + </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> @@ -2248,11 +2254,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émechs podporou typu st_blksize -- jinde + (např. na Windows) vrátí -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 informací - viz + <function>clearstatcache</function>. </para> </refsect1> </refentry> @@ -2261,7 +2267,7 @@ <refnamediv> <refname>lstat</refname> <refpurpose> - Gives information about a file or symbolic link + Zjišťuje informace o souboru nebo symbolickém odkazu </refpurpose> </refnamediv> <refsect1> @@ -2273,16 +2279,16 @@ </funcprototype> </funcsynopsis> <para> - Gathers the statistics of the file or symbolic link named by - filename. This function is identical to the - <function>stat</function> function except that if the - <parameter>filename</parameter> parameter is a symbolic link, the - status of the symbolic link is returned, not the status of the - file pointed to by the symbolic link. + Sbírá statistiky o souboru nebo symbolickém odkazu (linku) + identifikovaném pomocí názvu <parameter>filename</parameter>. + Tato funkce je identická s funkcí + <function>stat</function>, s výjimkou situace, kdy parametrem + <parameter>filename</parameter> je symbolický odkaz -- tehdy + jsou vráceny informace o odkazu, nikoli o souboru, na který + ukazuje. </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> @@ -2298,11 +2304,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émechs podporou typu st_blksize -- jinde + (např. na Windows) vrátí -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 informací - viz + <function>clearstatcache</function>. </para> </refsect1> </refentry> @@ -2310,7 +2316,7 @@ <refentry id="function.realpath"> <refnamediv> <refname>realpath</refname> - <refpurpose>Returns canonicalized absolute pathname</refpurpose> + <refpurpose>Vrátí absolutní cestu v kanonickém tvaru</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2321,15 +2327,15 @@ </funcprototype> </funcsynopsis> <para> - <function>realpath</function> expands all symbolic links and - resolves references to '/./', '/../' and extra '/' characters in - the input <parameter>path</parameter> and return the canonicalized - absolute pathname. The resulting path will have no symbolic link, - '/./' or '/../' components. + <function>realpath</function> zpracuje všechny symbolické odkazy + a vyhodnotí odkazy na '/./', '/../' a samostatné znaky '/' + v parametru <parameter>path</parameter> a vrací absolutní + cestu v kanonickém tvaru. Tato výsledná cesta neobsahuje + symbolické odkazy a komponenty typu '/./' or '/../'. </para> <para> <example> - <title><function>realpath</function> example</title> + <title><function>realpath</function> příklad</title> <programlisting role="php"> $real_path = realpath ("../../index.php"); </programlisting> @@ -2341,7 +2347,7 @@ <refentry id="function.symlink"> <refnamediv> <refname>symlink</refname> - <refpurpose>Creates a symbolic link</refpurpose> + <refpurpose>Vytvoří symbolický odkaz</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2353,13 +2359,13 @@ </funcprototype> </funcsynopsis> <para> - <function>symlink</function> creates a symbolic link - from the existing <parameter>target</parameter> with - the specified name <parameter>link</parameter>. + <function>symlink</function> vytvoří symbolický odkaz (link) + k existujícímu souboru <parameter>target</parameter> a nazve + ho <parameter>link</parameter>. </para> <para> - Viz také <function>link</function> to create hard links, - and <function>readlink</function> along with + Viz také <function>link</function> -- vytváření hard linků, + a <function>readlink</function> společně s <function>linkinfo</function>. </para> <note> @@ -2373,7 +2379,7 @@ <refentry id="function.tempnam"> <refnamediv> <refname>tempnam</refname> - <refpurpose>Creates unique file name</refpurpose> + <refpurpose>Vytvoří soubor s unikátním názvem</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2385,24 +2391,24 @@ </funcprototype> </funcsynopsis> <para> - Creates a unique temporary filename in the specified directory. - If the directory does not exist, <function>tempnam</function> may - generate a filename in the system's temporary directory. - </para> - <para> - The behaviour of the <function>tempnam</function> function is - system dependent. On Windows the TMP environment variable will - override the <parameter>dir</parameter> parameter, on Linux the - TMPDIR environment variable has precedence, while SVR4 will always - use your <parameter>dir</parameter> parameter if the directory it - points to exists. Consult your system documentation on the - tempnam(3) function if in doubt. + Ve specifikovaném adresáři vytvoří dočasný soubor s unikátním + názvem. Pokud adresář neexistuje, <function>tempnam</function> + může vytvořit soubor v systémovém adresáři pro dočasné soubory. + </para> + <para> + Chování funkce <function>tempnam</function> je závislé na + platformě. Na Windows má parametr <parameter>dir</parameter> + přednost před systémovou proměnnou TMP, na Linuxu má předost + proměnná TMPDIR a SVR4 vždy použije parametr + <parameter>dir</parameter>, pokud tento adresář existuje. + Podívejte se do dokumentace k vašemu systému na funkci + tempnam(3). </para> <para> - Returns the new temporary filename, or the &null; string on - failure. + Vrací název nového dočasného souboru, při chybě pak řetězec + &null;. <example> - <title><function>tempnam</function> example</title> + <title><function>tempnam</function> příklad</title> <programlisting role="php"> $tmpfname = tempnam ("/tmp", "FOO"); </programlisting> @@ -2410,7 +2416,8 @@ </para> <note> <simpara> - This function's behavior changed in 4.0.3. The temporary file is also + Chování této funkce bylo změněno ve verzi 4.0.3. + The temporary file is also created to avoid a race condition where the file might appear in the filesystem between the time the string was generated and before the the script gets around to creating the file. @@ -2425,7 +2432,7 @@ <refentry id="function.tmpfile"> <refnamediv> <refname>tmpfile</refname> - <refpurpose>Vytvořit tmp soubor</refpurpose> + <refpurpose>Vytvoří dočasný soubor</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2436,10 +2443,11 @@ </funcprototype> </funcsynopsis> <para> - Vytvoří temp soubor, s unikátním názvem, v módu zápisu, a vrací deskriptor - tohoto souboru podobně jako <function>fopen</function>. - Tento soubor se při zavření (pomocí <function>fclose</function>) nebo při - ukončení skriptu automaticky smaže. + Vytvoří dočasný soubor s unikátním názvem, v módu zápisu, + a vrací deskriptor tohoto souboru podobně jako + <function>fopen</function>. Soubor se při zavření (pomocí + <function>fclose</function>) nebo při ukončení skriptu + automaticky smaže. </para> <para> Detaily viz systémová dokumentace k funkci @@ -2498,7 +2506,7 @@ <refentry id="function.umask"> <refnamediv> <refname>umask</refname> - <refpurpose>Změnit současnou umask</refpurpose> + <refpurpose>Změní současné nastavení umask</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -2509,17 +2517,17 @@ </funcprototype> </funcsynopsis> <para> - <function>umask</function> sets PHP's umask to mask & 0777 and - returns the old umask. When PHP is being used as a server module, - the umask is restored when each request is finished. + <function>umask</function> nastaví umask PHP na & 0777 a + vrátí staré nastavení umask. Pokud PHP běží jako modul serveru, + je staré nastavení obnoveno po ukončení každého HTTP požadavku. </para> <para> - <function>umask</function> without arguments simply returns the - current umask. + <function>umask</function> bez parametrů vrací současné + nastavení umask. </para> <note> <simpara> - Tato funkce nemusí na Windows fungovat. + Tato funkce nemusí na Windows fungovat </simpara> </note> </refsect1> @@ -2549,7 +2557,7 @@ </para> <note> <simpara> - Tato funkce nemusí na Windows fungovat. + Tato funkce nemusí na Windows fungovat </simpara> </note> </refsect1>