cvs: phpdoc /cs/functions com.xml dir.xml exec.xml filesystem.xml

From: Date: Wed, 21 Nov 2001 14:37:20 +0000
Subject: cvs: phpdoc /cs/functions com.xml dir.xml exec.xml filesystem.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969339093@lists.php.net to get a copy of this message
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"> &lt;?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 "&lt;b&gt;Line $line_num:&lt;/b&gt; " . htmlspecialchars ($line) . "&lt;br&gt;\n"; } -// get a web page into a string +// naèti WWW stránku do øetìzce $fcontents = join ('', file ('http://www.php.net')); ?&gt; </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>
« previous php.doc (#969339093) next »