cvs: phpdoc-cs /reference/mysql/functions mysql-insert-id.xml mysql-list-dbs.xml mysql-list-fields.xml mysql-list-tables.xml mysql-num-fields.xml
mysql-num-rows.xml mysql-pconnect.xml mysql-query.xml
| From: | Pavel Novak | Date: | Wed, 29 May 2002 22:14:32 +0000 |
| Subject: | cvs: phpdoc-cs /reference/mysql/functions mysql-insert-id.xml mysql-list-dbs.xml mysql-list-fields.xml mysql-list-tables.xml mysql-num-fields.xml mysql-num-rows.xml mysql-pconnect.xml mysql-query.xml |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969345996@lists.php.net to get a copy of this message | ||
costra Wed May 29 18:14:32 2002 EDT
Modified files:
/phpdoc-cs/reference/mysql/functions mysql-insert-id.xml
mysql-list-dbs.xml
mysql-list-fields.xml
mysql-list-tables.xml
mysql-num-fields.xml
mysql-num-rows.xml
mysql-pconnect.xml
mysql-query.xml
Log:
Milk and butter.
Index: phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml:1.2 phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml:1.3 --- phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml:1.2 Tue May 28 18:24:04 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml Wed May 29 18:14:32 2002 @@ -27,15 +27,14 @@ <function>mysql_insert_id</function> vrací 0 pokud pro pøedchozí dotaz nebyla vygenerována ¾ádná hodnota pomocí AUTO_INCREMENT. I v pøípadì, ¾e potøebujete hodnotu pou¾ít pozdìji, dbejte na to, abyste funkci -<function>mysql_insert_id</function> okam¾itì po dotazu, pro nìj¾ byla +<function>mysql_insert_id</function> volali okam¾itì po dotazu, pro nìj¾ byla vygenerována hodnota pomocí AUTO_INCREMENT. </para> <note> <para> - Hodnota MySQL SQL funkce - <literal>LAST_INSERT_ID()</literal> v¾dy obsahuje nejvy¹¹í poslednì -vygenerovanou hodnotu AUTO_INCREMENT a není mezi dal¹ími dotazy -vynulována. + Hodnota MySQL SQL funkce <literal>LAST_INSERT_ID()</literal> v¾dy obsahuje +nejvy¹¹í poslednì vygenerovanou hodnotu AUTO_INCREMENT a není mezi dal¹ími +dotazy vynulována. </para> </note> <warning> @@ -44,9 +43,9 @@ API funkcí <literal>mysql_insert_id()</literal> z typu <literal>long</literal> (ekvivalent v PHP <type>int</type>). Pokud je sloupec AUTO_INCREMENT typu BIGINT, hodnota vrácená <function>mysql_insert_id</function> -bude nesprávná. Místo toho pou¾ijte vnitøní MySQL SQL funkci -<literal>LAST_INSERT_ID()</literal> pøímo v SQL dotazu. </para> - </warning> +bude nesprávná (pouze v pøípadì, ¾e i samotná hodnota bude mít velikost BIGINT). +Místo toho pou¾ijte vnitøní MySQL SQL funkci <literal>LAST_INSERT_ID()</literal> +pøímo v SQL dotazu. </para> </warning> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml:1.1 Sun Apr 14 19:47:09 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml Wed May 29 18:14:32 2002 @@ -5,7 +5,7 @@ <refnamediv> <refname>mysql_list_dbs</refname> <refpurpose> - Naète v¹echny databáze dostupné na MySQL serveru + Naète v¹echny dostupné databáze na MySQL serveru </refpurpose> </refnamediv> <refsect1> @@ -17,18 +17,19 @@ </parameter></methodparam> </methodsynopsis> <para> - <function>mysql_list_dbs</function> will return a result pointer - containing the databases available from the current mysql - daemon. Use the <function>mysql_tablename</function> function to - traverse this result pointer, or any function for result tables. - </para> + <function>mysql_list_dbs</function> vrací ukazatel výsledku obsahující + databáze dostupné na aktuálním mysql démonovi. Lze pou¾ít + napøíklad spoleènì s funkcí <function>mysql_tablename</function> + k získání názvù tabulek, pøípadnì jiných funkcích k získání dal¹ích + informací o tabulkách. + </para> <para> <example> - <title><function>mysql_list_dbs</function> example</title> + <title><function>mysql_list_dbs</function> pøíklad</title> <programlisting role="php"> <![CDATA[ <?php -$link = mysql_connect('localhost', 'myname', 'secret'); +$link = mysql_connect('localhost', 'mojejmeno', 'tajne'); $db_list = mysql_list_dbs($link); while ($row = mysql_fetch_object($db_list)) { @@ -38,12 +39,12 @@ ]]> </programlisting> <para> - The above example would produce the following output: + Pøedchozí pøíklad by mìl následující výstup: <screen> <![CDATA[ -database1 -database2 -database3 +databaze1 +databaze2 +databaze3 ... ]]> </screen> @@ -52,13 +53,13 @@ </para> <note> <para> - The above code would just as easily work with - <function>mysql_fetch_row</function> or other similar functions. - </para> - </note> + Pøedchozí kód by tak snadno pracoval i s + <function>mysql_fetch_row</function> èi podobnými funkcemi. +</para> </note> <para> - For downward compatibility <function>mysql_listdbs</function> can - also be used. This is deprecated however. + Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_listdbs</function>. Tuto funkci v¹ak nedoporuèujeme pou¾ívat, +nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> <para> Viz. také <function>mysql_db_name</function>. Index: phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml:1.1 Sun Apr 14 19:47:09 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml Wed May 29 18:14:32 2002 @@ -4,7 +4,7 @@ <refentry id="function.mysql-list-fields"> <refnamediv> <refname>mysql_list_fields</refname> - <refpurpose>Naète výsledek s obsahem polo¾ky</refpurpose> + <refpurpose>Naète výsledek s obsahem sloupce</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -17,23 +17,22 @@ </parameter></methodparam> </methodsynopsis> <para> - <function>mysql_list_fields</function> retrieves information - about the given tablename. Arguments are the database name and - the table name. A result pointer is returned which can be used - with <function>mysql_field_flags</function>, - <function>mysql_field_len</function>, - <function>mysql_field_name</function>, and - <function>mysql_field_type</function>. - </para> + <function>mysql_list_fields</function> vrací ukazatel výsledku o sloupcích +uvedené tabulky. Argumentu jsou jméno databáze a jméno tabulky. +Vrácený ukazatel výsledku mù¾e být pou¾it spolu s funkcemi +<function>mysql_field_flags</function>, +<function>mysql_field_len</function>, +<function>mysql_field_name</function>, a +<function>mysql_field_type</function>. </para> <para> <example> - <title><function>mysql_list_fields</function> example</title> + <title><function>mysql_list_fields</function> pøíklad</title> <programlisting role="php"> <![CDATA[ <?php -$link = mysql_connect('localhost', 'myname', 'secret'); +$link = mysql_connect('localhost', 'mojejmeno', 'tajne'); -$fields = mysql_list_fields("database1", "table1", $link); +$fields = mysql_list_fields("databaze1", "tabulka1", $link); $columns = mysql_num_fields($fields); for ($i = 0; $i < $columns; $i++) { @@ -42,12 +41,12 @@ ]]> </programlisting> <para> - The above example would produce the following output: + Pøedchozí pøíklad by mìl následující výstup: <screen> <![CDATA[ -field1 -field2 -field3 +sloupec1 +sloupec2 +sloupec3 ... ]]> </screen> @@ -55,8 +54,9 @@ </example> </para> <para> - For downward compatibility <function>mysql_listfields</function> - can also be used. This is deprecated however. + Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_listfields</function>. Tuto funkci v¹ak nedoporuèujeme pou¾ívat, +nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> <!-- TODO: this is equiv. with 'select * from $table where &false;,' which implies you can better use the field-research functions Index: phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml:1.1 Sun Apr 14 19:47:09 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml Wed May 29 18:14:32 2002 @@ -17,16 +17,16 @@ </parameter></methodparam> </methodsynopsis> <para> - <function>mysql_list_tables</function> takes a database name and - returns a result pointer much like the - <function>mysql_db_query</function> function. You can use the - <function>mysql_tablename</function> function to extract the - actual table names from the result pointer, or any other result - table function. - </para> - <para> - For downward compatibility <function>mysql_listtables</function> - can also be used. This is deprecated however. + <function>mysql_list_tables</function> Na základì jména databáze vrací + ukazatel výsledku na tabulky pøesnì tak jako + <function>mysql_db_query</function>. Mù¾ete napø. pou¾ítím + funkce <function>mysql_tablename</function> zjistit jména v¹ech tabulek + z ukazatele výsledku nebo pou¾ít jiné funkce k zji¹tìní dal¹ích + informcí o tabulkách. + </para> +<para> Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_listtables</function>. Tuto funkci v¹ak nedoporuèujeme +pou¾ívat, nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml:1.1 Sun Apr 14 19:47:09 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml Wed May 29 18:14:32 2002 @@ -4,28 +4,51 @@ <refentry id="function.mysql-num-fields"> <refnamediv> <refname>mysql_num_fields</refname> - <refpurpose>Vrátí poèet polo¾ek ve výsledku</refpurpose> + <refpurpose>Vrátí poèet sloupcù ve výsledku</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <methodsynopsis> <type>int</type><methodname>mysql_num_fields</methodname> - + <methodparam><type>resource</type><parameter>výsledek</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_num_fields</function> returns the number of - fields in a result set. - </para> + <function>mysql_num_fields</function> vrací poèet sloupcù získaných +sql dotazem. </para> <para> Viz. také: <function>mysql_db_query</function>, <function>mysql_query</function>, <function>mysql_fetch_field</function>, <function>mysql_num_rows</function>.</para> + + <para> + <example> + <title><function>mysql_num_fields</function> pøíklad</title> + <programlisting role="php"> +<![CDATA[ +<?php +$r = mysql_query("SELECT sloupec1, sloupec2, sloupec3 FROM tabulka"; +$pocet_sloupcu = mysql_num_fields($r); +echo "Poèet sloupcù ve výsledku: " . $pocet_sloupcu; +]]> + </programlisting> + <para> + Pøedchozí pøíklad by mìl následující výstup: + <screen> +<![CDATA[ +Poèet sloupcù ve výsledku: 3 +]]> + </screen> + </para> + </example> + </para> + <para> - For downward compatibility <function>mysql_numfields</function> - can also be used. This is deprecated however. + Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_numfields</function>. Tuto funkci v¹ak nedoporuèujeme pou¾ívat, +nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml:1.1 Sun Apr 14 19:47:10 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml Wed May 29 18:14:32 2002 @@ -10,27 +10,27 @@ <title>Popis</title> <methodsynopsis> <type>int</type><methodname>mysql_num_rows</methodname> - + <methodparam><type>resource</type><parameter>výsledek</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_num_rows</function> returns the number of rows in - a result set. This command is only valid for SELECT statements. - To retrieve the number of rows affected by a INSERT, UPDATE or - DELETE query, use <function>mysql_affected_rows</function>. - <example> - <title><function>mysql_num_rows</function> example</title> + <function>mysql_num_rows</function> vrací poèet záznamù ve výsledku +dotazu. Tento pøíkaz je pou¾itelný pouze pro dotaz typu SELECT. Potøebujete-li +získat poèet záznamù ovlivnìných dotazy INSERT, UPDATE nebo DELETE, pou¾ijte +<function>mysql_affected_rows</function>. +<example> + <title><function>mysql_num_rows</function> pøíklad</title> <programlisting role="php"> <![CDATA[ <?php -$link = mysql_connect("localhost", "username", "password"); -mysql_select_db("database", $link); +$link = mysql_connect("localhost", "mojejmeno", "heslo"); +mysql_select_db("databaze", $link); -$result = mysql_query("SELECT * FROM table1", $link); +$result = mysql_query("SELECT * FROM tabulka1", $link); $num_rows = mysql_num_rows($result); -echo "$num_rows Rows\n"; +echo "$num_rows øádkù\n"; ?> ]]> @@ -41,13 +41,13 @@ Viz. také: <function>mysql_affected_rows</function>, <function>mysql_connect</function>, - <function>mysql_select_db</function>, and + <function>mysql_select_db</function>, a <function>mysql_query</function>. </para> <para> - For downward compatibility <function>mysql_numrows</function> can - also be used. This is deprecated however. - </para> + Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_numrows</function>. Tuto funkci v¹ak nedoporuèujeme pou¾ívat, +nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml:1.1 Sun Apr 14 19:47:11 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml Wed May 29 18:14:32 2002 @@ -16,71 +16,71 @@ server </parameter></methodparam> <methodparam - choice="opt"><type>string</type><parameter>username</parameter></methodparam> + choice="opt"><type>string</type><parameter>jmeno</parameter></methodparam> <methodparam - choice="opt"><type>string</type><parameter>password</parameter></methodparam> + choice="opt"><type>string</type><parameter>heslo</parameter></methodparam> </methodsynopsis> <para> - Returns a positive MySQL persistent link identifier on success, - or &false; on error. - </para> - <para> - <function>mysql_pconnect</function> establishes a connection - to a MySQL server. The following defaults are assumed for - missing optional parameters: <parameter>server</parameter> = - 'localhost:3306', <parameter>username</parameter> = name of the - user that owns the server process and - <parameter>password</parameter> = empty password. - </para> - <para> - The <parameter>server</parameter> parameter can also include a port - number. eg. "hostname:port" or a path to a socket - eg. ":/path/to/socket" for the localhost. - <note> + Vytvoøí persistentní (trvalé) spojení s MySQL serverem a vrací + identifikátor spojení. Pøi neúspì¹ném pokusu o spojení vrací +&false;. </para> + <para> + <function>mysql_pconnect</function> otevøe spojení s MySQL server. +Je-li funkce volána bez nepovinných paramtrù, jsou u nich pøedpokládány +následující výchozí hodnoty: <parameter>server</parameter> = 'localhost:3306', +<parameter>jmeno</parameter> = jméno vlastníka procesu a +<parameter>heslo</parameter> = prázdné heslo. </para> + <para> + Parametr <parameter>server</parameter> mù¾e obsahovat èíslo portu + ve stylu "hostname:port" nebo cestu k soketu ve stylu +":/cesta/k/soketu" pro localhost. + <note> <para> - Support for ":port" was added in 3.0B4. + Podpora pro ":port" byla pøidána v PHP 3.0B4. </para> <para> - Support for the ":/path/to/socket" was added in - 3.0.10. + Podpora pro ":/cesta/k/soketu" byla pøidána v PHP 3.0.10. </para> </note> </para> <!-- TODO move the story to features.persistent, and refer to that --> <para> - <function>mysql_pconnect</function> acts very much like - <function>mysql_connect</function> with two major differences. + Funkce <function>mysql_pconnect</function> je velmi podobná funkci + <function>mysql_connect</function> s dvìma hlavními rozdíly. </para> <para> - First, when connecting, the function would first try to find a - (persistent) link that's already open with the same host, - username and password. If one is found, an identifier for it - will be returned instead of opening a new connection. + Za prvé, funkce se nejprve pokusí nalézt ji¾ existující (persistentní) + spojení otevøené na stejném portu pod stejným jménem a heslem. Je-li + takové spojení nalezeno, pou¾ije se namísto vytváøení nového. </para> <para> - Second, the connection to the SQL server will not be closed when - the execution of the script ends. Instead, the link will remain - open for future use (<function>mysql_close</function> will not - close links established by <function>mysql_pconnect</function>). + Za druhé, spojení s SQL serverem nebude uzavøeno pøi ukonèení bìhu skriptu. + Zùstane otevøeno pro pou¾ití v dal¹ích skriptech, které teprve budou + spou¹tìny (<function>mysql_close</function> neuzavøe persistentní + spojení vytvoøené pomocí <function>mysql_pconnect</function>). +</para> <para> + Proto je tento typ spojení nazýván jako 'persistentní' - trvalý. </para> <para> - This type of link is therefore called 'persistent'. - </para> +If you need to close idle persistent connections, set a low wait_timeout in +MySQL + Potøebujete-li uzavírat persistentní spojení døíve, nastavte ni¾¹í +hodnotu promìnné <parameter>wait_timeout</parameter> v MySQL. +</para> <note> <para> - Note, that these kind of links only work if you are using - a module version of PHP. See the - <link linkend="features.persistent-connections">Persistent - Database Connections</link> section for more information. + Persistentní spojení je podporováno pouze v pøípadì, kdy je PHP spu¹tìno +jako modul (nikoli CGI). Více o této problematice naleznete v sekci + <link linkend="features.persistent-connections">Persistentní + databázová spojení</link>. </para> </note> <warning> <para> - Using persistent connections can require a bit of tuning of your Apache - and MySQL configurations to ensure that you do not exceed the number of - connections allowed by MySQL. - </para> + Pou¾ívání persistetního spojení mù¾e vy¾adovat malou úpravu v +konfiguraci Apache a MySQL k zaji¹tìní nepøekroèení maximálního limitu +povolených pøipojení k MySQL. </para> </warning> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-query.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-query.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-query.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-query.xml:1.1 Sun Apr 14 19:47:11 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-query.xml Wed May 29 18:14:32 2002 @@ -15,86 +15,73 @@ choice="opt"><type>resource</type><parameter>spojeni</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_query</function> sends a query to the currently - active database on the server that's associated with the - specified link identifier. If - <parameter>spojeni</parameter> isn't specified, the last - opened link is assumed. If no link is open, the function tries - to establish a link as if <function>mysql_connect</function> was - called with no arguments, and use it. - </para> - <note> - <para> - The query string should not end with a semicolon. - </para> + <function>mysql_query</function> Provede dotaz na aktuálním spojení v +aktivní databázi na serveru a vrátí identifikátor výsledku. Není-li +parametr <parameter>spojeni</parameter> uveden, pou¾ije poslednì otevøené +spojení. Pokud není ¾ádné otevøené spojení nalezeno, funkce se ho pokusí +vytvoøit za pou¾ití výchozích hodnot funkce <function>mysql_connect</function> +(jakoby byla volána bez parametrù) </para> +<note> + <para> + Øetìzec dotazu by nemìl konèit støedníkem. + </para> </note> <para> - Only for SELECT statements <function>mysql_query</function> - returns a resource identifier or &false; if the query was - not executed correctly. For other type of SQL statements, - <function>mysql_query</function> returns &true; on success - and &false; on error. A non-&false; return value - means that the query was legal and could be executed by - the server. It does not indicate anything about the number of - rows affected or returned. It is perfectly possible for a query - to succeed but affect no rows or return no rows. - </para> - <para> - The following query is syntactically invalid, so - <function>mysql_query</function> fails and returns &false;: - <example> - <title><function>mysql_query</function></title> - <programlisting role="php"> -<![CDATA[ + Pouze pøi pou¾ití dotazu typu SELECT je vrácen identifikátor výsledku èi +&false; pokud pøi vykonávání dotazu do¹lo k chybì. Pøi ostatních typech dotazù +<function>mysql_query</function> vrací &true; pøi úspì¹ném dotazu nebo +&false; dojde-li k chybì. Ne-&false; vrácená hodnota znamená, ¾e dotaz byl +vykonán serverem bez chyb. Tato funkce nezaznamenává ¾ádné údaje o poètu +ovlivnìných nebo vrácených øádkù. Lze pouze zjistit, zda dotaz probìhl v +poøádku.</para> +<para> +Následující dotaz je syntakticky nesprávný, tak¾e jeho vykonávání v +<function>mysql_query</function> sel¾e a vrátí &false;: +<example> +<title><function>mysql_query</function></title> <programlisting +role="php"> <![CDATA[ <php $result = mysql_query("SELECT * WHERE 1=1") - or die("Invalid query"); + or die("©patný dotaz!"); ?> ]]> </programlisting> </example> </para> <para> - The following query is semantically invalid if - <literal>my_col</literal> is not a column in the table - <literal>my_tbl</literal>, so <function>mysql_query</function> - fails and returns &false;: + Následující dotaz je významovì nesprávný + <literal>my_col</literal> není sloupec v tabulce + <literal>my_tbl</literal>, tak¾e <function>mysql_query</function> + sel¾e a vrátí &false;: <example> <title><function>mysql_query</function></title> <programlisting role="php"> <![CDATA[ <?php $result = mysql_query("SELECT my_col FROM my_tbl") - or exit ("Invalid query"); + or exit ("©patný dotaz!"); ?> ]]> </programlisting> </example> </para> <para> - <function>mysql_query</function> will also fail and return &false; - if you don't have permission to access the table(s) referenced by - the query. - </para> - <para> - Assuming the query succeeds, you can call - <function>mysql_num_rows</function> to find out how many rows - were returned for a SELECT statment or - <function>mysql_affected_rows</function> to find out how many - rows were affected by a DELETE, INSERT, REPLACE, or UPDATE - statement. - </para> - <para> - Only for SELECT statements, <function>mysql_query</function> - returns a new result identifier that you can pass to - <function>mysql_fetch_array</function> and other - functions dealing with result tables. When you are done with the - result set, you can free the resources associated with it by - calling <function>mysql_free_result</function>. Although, the - memory will automatically be freed at the end of the script's - execution. - </para> - <para> + <function>mysql_query</function> také v¾dy sel¾e a vrátí &false; + jestli¾e nemáte dostateèné oprávnìní pøístupu do tabulky (tabulek) +uvedených v dotazu.</para> + <para> + Potøebujete-li zjistit poèet záznamù vrácených dotazem typu SELECT, +pou¾ijte následnì funkci <function>mysql_num_rows</function> èi pøípadnì funkci +<function>mysql_affected_rows</function>, pokud potøebujete zjistit poèet v¹ech +ovlivnìných záznamù dotazy typù DELETE, INSERT, REPLACE nebo UPDATE. </para> + <para> + Pouze pøi dotazu typu SELECT <function>mysql_query</function> + vrací nový identifikátor dotazu, který lze pou¾ít napøíklad pro volání +funkce <function>mysql_fetch_array</function> a dal¹ích funkcí pro zpracování +výsledkù dotazu. Nepotøebujete-li ji¾ obsah výsledku dotazu, mù¾ete uvolnit +pamìt voláním funkce <function>mysql_free_result</function>. Nicménì pamìt bude +uvolnìna automaticky na konci bìhu skriptu. </para> + <para> Viz. také: <function>mysql_num_rows</function> <function>mysql_affected_rows</function>, <function>mysql_unbuffered_query</function>, @@ -103,7 +90,7 @@ <function>mysql_fetch_row</function>, <function>mysql_fetch_assoc</function>, <function>mysql_result</function>, - <function>mysql_select_db</function>, and + <function>mysql_select_db</function>, a <function>mysql_connect</function>. </para> </refsect1>
Index: phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml:1.2 phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml:1.3 --- phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml:1.2 Tue May 28 18:24:04 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-insert-id.xml Wed May 29 18:14:32 2002 @@ -27,15 +27,14 @@ <function>mysql_insert_id</function> vrací 0 pokud pro pøedchozí dotaz nebyla vygenerována ¾ádná hodnota pomocí AUTO_INCREMENT. I v pøípadì, ¾e potøebujete hodnotu pou¾ít pozdìji, dbejte na to, abyste funkci -<function>mysql_insert_id</function> okam¾itì po dotazu, pro nìj¾ byla +<function>mysql_insert_id</function> volali okam¾itì po dotazu, pro nìj¾ byla vygenerována hodnota pomocí AUTO_INCREMENT. </para> <note> <para> - Hodnota MySQL SQL funkce - <literal>LAST_INSERT_ID()</literal> v¾dy obsahuje nejvy¹¹í poslednì -vygenerovanou hodnotu AUTO_INCREMENT a není mezi dal¹ími dotazy -vynulována. + Hodnota MySQL SQL funkce <literal>LAST_INSERT_ID()</literal> v¾dy obsahuje +nejvy¹¹í poslednì vygenerovanou hodnotu AUTO_INCREMENT a není mezi dal¹ími +dotazy vynulována. </para> </note> <warning> @@ -44,9 +43,9 @@ API funkcí <literal>mysql_insert_id()</literal> z typu <literal>long</literal> (ekvivalent v PHP <type>int</type>). Pokud je sloupec AUTO_INCREMENT typu BIGINT, hodnota vrácená <function>mysql_insert_id</function> -bude nesprávná. Místo toho pou¾ijte vnitøní MySQL SQL funkci -<literal>LAST_INSERT_ID()</literal> pøímo v SQL dotazu. </para> - </warning> +bude nesprávná (pouze v pøípadì, ¾e i samotná hodnota bude mít velikost BIGINT). +Místo toho pou¾ijte vnitøní MySQL SQL funkci <literal>LAST_INSERT_ID()</literal> +pøímo v SQL dotazu. </para> </warning> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml:1.1 Sun Apr 14 19:47:09 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-list-dbs.xml Wed May 29 18:14:32 2002 @@ -5,7 +5,7 @@ <refnamediv> <refname>mysql_list_dbs</refname> <refpurpose> - Naète v¹echny databáze dostupné na MySQL serveru + Naète v¹echny dostupné databáze na MySQL serveru </refpurpose> </refnamediv> <refsect1> @@ -17,18 +17,19 @@ </parameter></methodparam> </methodsynopsis> <para> - <function>mysql_list_dbs</function> will return a result pointer - containing the databases available from the current mysql - daemon. Use the <function>mysql_tablename</function> function to - traverse this result pointer, or any function for result tables. - </para> + <function>mysql_list_dbs</function> vrací ukazatel výsledku obsahující + databáze dostupné na aktuálním mysql démonovi. Lze pou¾ít + napøíklad spoleènì s funkcí <function>mysql_tablename</function> + k získání názvù tabulek, pøípadnì jiných funkcích k získání dal¹ích + informací o tabulkách. + </para> <para> <example> - <title><function>mysql_list_dbs</function> example</title> + <title><function>mysql_list_dbs</function> pøíklad</title> <programlisting role="php"> <![CDATA[ <?php -$link = mysql_connect('localhost', 'myname', 'secret'); +$link = mysql_connect('localhost', 'mojejmeno', 'tajne'); $db_list = mysql_list_dbs($link); while ($row = mysql_fetch_object($db_list)) { @@ -38,12 +39,12 @@ ]]> </programlisting> <para> - The above example would produce the following output: + Pøedchozí pøíklad by mìl následující výstup: <screen> <![CDATA[ -database1 -database2 -database3 +databaze1 +databaze2 +databaze3 ... ]]> </screen> @@ -52,13 +53,13 @@ </para> <note> <para> - The above code would just as easily work with - <function>mysql_fetch_row</function> or other similar functions. - </para> - </note> + Pøedchozí kód by tak snadno pracoval i s + <function>mysql_fetch_row</function> èi podobnými funkcemi. +</para> </note> <para> - For downward compatibility <function>mysql_listdbs</function> can - also be used. This is deprecated however. + Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_listdbs</function>. Tuto funkci v¹ak nedoporuèujeme pou¾ívat, +nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> <para> Viz. také <function>mysql_db_name</function>. Index: phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml:1.1 Sun Apr 14 19:47:09 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-list-fields.xml Wed May 29 18:14:32 2002 @@ -4,7 +4,7 @@ <refentry id="function.mysql-list-fields"> <refnamediv> <refname>mysql_list_fields</refname> - <refpurpose>Naète výsledek s obsahem polo¾ky</refpurpose> + <refpurpose>Naète výsledek s obsahem sloupce</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -17,23 +17,22 @@ </parameter></methodparam> </methodsynopsis> <para> - <function>mysql_list_fields</function> retrieves information - about the given tablename. Arguments are the database name and - the table name. A result pointer is returned which can be used - with <function>mysql_field_flags</function>, - <function>mysql_field_len</function>, - <function>mysql_field_name</function>, and - <function>mysql_field_type</function>. - </para> + <function>mysql_list_fields</function> vrací ukazatel výsledku o sloupcích +uvedené tabulky. Argumentu jsou jméno databáze a jméno tabulky. +Vrácený ukazatel výsledku mù¾e být pou¾it spolu s funkcemi +<function>mysql_field_flags</function>, +<function>mysql_field_len</function>, +<function>mysql_field_name</function>, a +<function>mysql_field_type</function>. </para> <para> <example> - <title><function>mysql_list_fields</function> example</title> + <title><function>mysql_list_fields</function> pøíklad</title> <programlisting role="php"> <![CDATA[ <?php -$link = mysql_connect('localhost', 'myname', 'secret'); +$link = mysql_connect('localhost', 'mojejmeno', 'tajne'); -$fields = mysql_list_fields("database1", "table1", $link); +$fields = mysql_list_fields("databaze1", "tabulka1", $link); $columns = mysql_num_fields($fields); for ($i = 0; $i < $columns; $i++) { @@ -42,12 +41,12 @@ ]]> </programlisting> <para> - The above example would produce the following output: + Pøedchozí pøíklad by mìl následující výstup: <screen> <![CDATA[ -field1 -field2 -field3 +sloupec1 +sloupec2 +sloupec3 ... ]]> </screen> @@ -55,8 +54,9 @@ </example> </para> <para> - For downward compatibility <function>mysql_listfields</function> - can also be used. This is deprecated however. + Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_listfields</function>. Tuto funkci v¹ak nedoporuèujeme pou¾ívat, +nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> <!-- TODO: this is equiv. with 'select * from $table where &false;,' which implies you can better use the field-research functions Index: phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml:1.1 Sun Apr 14 19:47:09 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-list-tables.xml Wed May 29 18:14:32 2002 @@ -17,16 +17,16 @@ </parameter></methodparam> </methodsynopsis> <para> - <function>mysql_list_tables</function> takes a database name and - returns a result pointer much like the - <function>mysql_db_query</function> function. You can use the - <function>mysql_tablename</function> function to extract the - actual table names from the result pointer, or any other result - table function. - </para> - <para> - For downward compatibility <function>mysql_listtables</function> - can also be used. This is deprecated however. + <function>mysql_list_tables</function> Na základì jména databáze vrací + ukazatel výsledku na tabulky pøesnì tak jako + <function>mysql_db_query</function>. Mù¾ete napø. pou¾ítím + funkce <function>mysql_tablename</function> zjistit jména v¹ech tabulek + z ukazatele výsledku nebo pou¾ít jiné funkce k zji¹tìní dal¹ích + informcí o tabulkách. + </para> +<para> Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_listtables</function>. Tuto funkci v¹ak nedoporuèujeme +pou¾ívat, nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml:1.1 Sun Apr 14 19:47:09 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-num-fields.xml Wed May 29 18:14:32 2002 @@ -4,28 +4,51 @@ <refentry id="function.mysql-num-fields"> <refnamediv> <refname>mysql_num_fields</refname> - <refpurpose>Vrátí poèet polo¾ek ve výsledku</refpurpose> + <refpurpose>Vrátí poèet sloupcù ve výsledku</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <methodsynopsis> <type>int</type><methodname>mysql_num_fields</methodname> - + <methodparam><type>resource</type><parameter>výsledek</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_num_fields</function> returns the number of - fields in a result set. - </para> + <function>mysql_num_fields</function> vrací poèet sloupcù získaných +sql dotazem. </para> <para> Viz. také: <function>mysql_db_query</function>, <function>mysql_query</function>, <function>mysql_fetch_field</function>, <function>mysql_num_rows</function>.</para> + + <para> + <example> + <title><function>mysql_num_fields</function> pøíklad</title> + <programlisting role="php"> +<![CDATA[ +<?php +$r = mysql_query("SELECT sloupec1, sloupec2, sloupec3 FROM tabulka"; +$pocet_sloupcu = mysql_num_fields($r); +echo "Poèet sloupcù ve výsledku: " . $pocet_sloupcu; +]]> + </programlisting> + <para> + Pøedchozí pøíklad by mìl následující výstup: + <screen> +<![CDATA[ +Poèet sloupcù ve výsledku: 3 +]]> + </screen> + </para> + </example> + </para> + <para> - For downward compatibility <function>mysql_numfields</function> - can also be used. This is deprecated however. + Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_numfields</function>. Tuto funkci v¹ak nedoporuèujeme pou¾ívat, +nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml:1.1 Sun Apr 14 19:47:10 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-num-rows.xml Wed May 29 18:14:32 2002 @@ -10,27 +10,27 @@ <title>Popis</title> <methodsynopsis> <type>int</type><methodname>mysql_num_rows</methodname> - + <methodparam><type>resource</type><parameter>výsledek</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_num_rows</function> returns the number of rows in - a result set. This command is only valid for SELECT statements. - To retrieve the number of rows affected by a INSERT, UPDATE or - DELETE query, use <function>mysql_affected_rows</function>. - <example> - <title><function>mysql_num_rows</function> example</title> + <function>mysql_num_rows</function> vrací poèet záznamù ve výsledku +dotazu. Tento pøíkaz je pou¾itelný pouze pro dotaz typu SELECT. Potøebujete-li +získat poèet záznamù ovlivnìných dotazy INSERT, UPDATE nebo DELETE, pou¾ijte +<function>mysql_affected_rows</function>. +<example> + <title><function>mysql_num_rows</function> pøíklad</title> <programlisting role="php"> <![CDATA[ <?php -$link = mysql_connect("localhost", "username", "password"); -mysql_select_db("database", $link); +$link = mysql_connect("localhost", "mojejmeno", "heslo"); +mysql_select_db("databaze", $link); -$result = mysql_query("SELECT * FROM table1", $link); +$result = mysql_query("SELECT * FROM tabulka1", $link); $num_rows = mysql_num_rows($result); -echo "$num_rows Rows\n"; +echo "$num_rows øádkù\n"; ?> ]]> @@ -41,13 +41,13 @@ Viz. také: <function>mysql_affected_rows</function>, <function>mysql_connect</function>, - <function>mysql_select_db</function>, and + <function>mysql_select_db</function>, a <function>mysql_query</function>. </para> <para> - For downward compatibility <function>mysql_numrows</function> can - also be used. This is deprecated however. - </para> + Z dùvodù zpìtné kompatibility mù¾ete také narazit na funkci +<function>mysql_numrows</function>. Tuto funkci v¹ak nedoporuèujeme pou¾ívat, +nebo» nemusí být ji¾ v dal¹ích verzích PHP podporována. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml:1.1 Sun Apr 14 19:47:11 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-pconnect.xml Wed May 29 18:14:32 2002 @@ -16,71 +16,71 @@ server </parameter></methodparam> <methodparam - choice="opt"><type>string</type><parameter>username</parameter></methodparam> + choice="opt"><type>string</type><parameter>jmeno</parameter></methodparam> <methodparam - choice="opt"><type>string</type><parameter>password</parameter></methodparam> + choice="opt"><type>string</type><parameter>heslo</parameter></methodparam> </methodsynopsis> <para> - Returns a positive MySQL persistent link identifier on success, - or &false; on error. - </para> - <para> - <function>mysql_pconnect</function> establishes a connection - to a MySQL server. The following defaults are assumed for - missing optional parameters: <parameter>server</parameter> = - 'localhost:3306', <parameter>username</parameter> = name of the - user that owns the server process and - <parameter>password</parameter> = empty password. - </para> - <para> - The <parameter>server</parameter> parameter can also include a port - number. eg. "hostname:port" or a path to a socket - eg. ":/path/to/socket" for the localhost. - <note> + Vytvoøí persistentní (trvalé) spojení s MySQL serverem a vrací + identifikátor spojení. Pøi neúspì¹ném pokusu o spojení vrací +&false;. </para> + <para> + <function>mysql_pconnect</function> otevøe spojení s MySQL server. +Je-li funkce volána bez nepovinných paramtrù, jsou u nich pøedpokládány +následující výchozí hodnoty: <parameter>server</parameter> = 'localhost:3306', +<parameter>jmeno</parameter> = jméno vlastníka procesu a +<parameter>heslo</parameter> = prázdné heslo. </para> + <para> + Parametr <parameter>server</parameter> mù¾e obsahovat èíslo portu + ve stylu "hostname:port" nebo cestu k soketu ve stylu +":/cesta/k/soketu" pro localhost. + <note> <para> - Support for ":port" was added in 3.0B4. + Podpora pro ":port" byla pøidána v PHP 3.0B4. </para> <para> - Support for the ":/path/to/socket" was added in - 3.0.10. + Podpora pro ":/cesta/k/soketu" byla pøidána v PHP 3.0.10. </para> </note> </para> <!-- TODO move the story to features.persistent, and refer to that --> <para> - <function>mysql_pconnect</function> acts very much like - <function>mysql_connect</function> with two major differences. + Funkce <function>mysql_pconnect</function> je velmi podobná funkci + <function>mysql_connect</function> s dvìma hlavními rozdíly. </para> <para> - First, when connecting, the function would first try to find a - (persistent) link that's already open with the same host, - username and password. If one is found, an identifier for it - will be returned instead of opening a new connection. + Za prvé, funkce se nejprve pokusí nalézt ji¾ existující (persistentní) + spojení otevøené na stejném portu pod stejným jménem a heslem. Je-li + takové spojení nalezeno, pou¾ije se namísto vytváøení nového. </para> <para> - Second, the connection to the SQL server will not be closed when - the execution of the script ends. Instead, the link will remain - open for future use (<function>mysql_close</function> will not - close links established by <function>mysql_pconnect</function>). + Za druhé, spojení s SQL serverem nebude uzavøeno pøi ukonèení bìhu skriptu. + Zùstane otevøeno pro pou¾ití v dal¹ích skriptech, které teprve budou + spou¹tìny (<function>mysql_close</function> neuzavøe persistentní + spojení vytvoøené pomocí <function>mysql_pconnect</function>). +</para> <para> + Proto je tento typ spojení nazýván jako 'persistentní' - trvalý. </para> <para> - This type of link is therefore called 'persistent'. - </para> +If you need to close idle persistent connections, set a low wait_timeout in +MySQL + Potøebujete-li uzavírat persistentní spojení døíve, nastavte ni¾¹í +hodnotu promìnné <parameter>wait_timeout</parameter> v MySQL. +</para> <note> <para> - Note, that these kind of links only work if you are using - a module version of PHP. See the - <link linkend="features.persistent-connections">Persistent - Database Connections</link> section for more information. + Persistentní spojení je podporováno pouze v pøípadì, kdy je PHP spu¹tìno +jako modul (nikoli CGI). Více o této problematice naleznete v sekci + <link linkend="features.persistent-connections">Persistentní + databázová spojení</link>. </para> </note> <warning> <para> - Using persistent connections can require a bit of tuning of your Apache - and MySQL configurations to ensure that you do not exceed the number of - connections allowed by MySQL. - </para> + Pou¾ívání persistetního spojení mù¾e vy¾adovat malou úpravu v +konfiguraci Apache a MySQL k zaji¹tìní nepøekroèení maximálního limitu +povolených pøipojení k MySQL. </para> </warning> </refsect1> </refentry> Index: phpdoc-cs/reference/mysql/functions/mysql-query.xml diff -u phpdoc-cs/reference/mysql/functions/mysql-query.xml:1.1 phpdoc-cs/reference/mysql/functions/mysql-query.xml:1.2 --- phpdoc-cs/reference/mysql/functions/mysql-query.xml:1.1 Sun Apr 14 19:47:11 2002 +++ phpdoc-cs/reference/mysql/functions/mysql-query.xml Wed May 29 18:14:32 2002 @@ -15,86 +15,73 @@ choice="opt"><type>resource</type><parameter>spojeni</parameter></methodparam> </methodsynopsis> <para> - <function>mysql_query</function> sends a query to the currently - active database on the server that's associated with the - specified link identifier. If - <parameter>spojeni</parameter> isn't specified, the last - opened link is assumed. If no link is open, the function tries - to establish a link as if <function>mysql_connect</function> was - called with no arguments, and use it. - </para> - <note> - <para> - The query string should not end with a semicolon. - </para> + <function>mysql_query</function> Provede dotaz na aktuálním spojení v +aktivní databázi na serveru a vrátí identifikátor výsledku. Není-li +parametr <parameter>spojeni</parameter> uveden, pou¾ije poslednì otevøené +spojení. Pokud není ¾ádné otevøené spojení nalezeno, funkce se ho pokusí +vytvoøit za pou¾ití výchozích hodnot funkce <function>mysql_connect</function> +(jakoby byla volána bez parametrù) </para> +<note> + <para> + Øetìzec dotazu by nemìl konèit støedníkem. + </para> </note> <para> - Only for SELECT statements <function>mysql_query</function> - returns a resource identifier or &false; if the query was - not executed correctly. For other type of SQL statements, - <function>mysql_query</function> returns &true; on success - and &false; on error. A non-&false; return value - means that the query was legal and could be executed by - the server. It does not indicate anything about the number of - rows affected or returned. It is perfectly possible for a query - to succeed but affect no rows or return no rows. - </para> - <para> - The following query is syntactically invalid, so - <function>mysql_query</function> fails and returns &false;: - <example> - <title><function>mysql_query</function></title> - <programlisting role="php"> -<![CDATA[ + Pouze pøi pou¾ití dotazu typu SELECT je vrácen identifikátor výsledku èi +&false; pokud pøi vykonávání dotazu do¹lo k chybì. Pøi ostatních typech dotazù +<function>mysql_query</function> vrací &true; pøi úspì¹ném dotazu nebo +&false; dojde-li k chybì. Ne-&false; vrácená hodnota znamená, ¾e dotaz byl +vykonán serverem bez chyb. Tato funkce nezaznamenává ¾ádné údaje o poètu +ovlivnìných nebo vrácených øádkù. Lze pouze zjistit, zda dotaz probìhl v +poøádku.</para> +<para> +Následující dotaz je syntakticky nesprávný, tak¾e jeho vykonávání v +<function>mysql_query</function> sel¾e a vrátí &false;: +<example> +<title><function>mysql_query</function></title> <programlisting +role="php"> <![CDATA[ <php $result = mysql_query("SELECT * WHERE 1=1") - or die("Invalid query"); + or die("©patný dotaz!"); ?> ]]> </programlisting> </example> </para> <para> - The following query is semantically invalid if - <literal>my_col</literal> is not a column in the table - <literal>my_tbl</literal>, so <function>mysql_query</function> - fails and returns &false;: + Následující dotaz je významovì nesprávný + <literal>my_col</literal> není sloupec v tabulce + <literal>my_tbl</literal>, tak¾e <function>mysql_query</function> + sel¾e a vrátí &false;: <example> <title><function>mysql_query</function></title> <programlisting role="php"> <![CDATA[ <?php $result = mysql_query("SELECT my_col FROM my_tbl") - or exit ("Invalid query"); + or exit ("©patný dotaz!"); ?> ]]> </programlisting> </example> </para> <para> - <function>mysql_query</function> will also fail and return &false; - if you don't have permission to access the table(s) referenced by - the query. - </para> - <para> - Assuming the query succeeds, you can call - <function>mysql_num_rows</function> to find out how many rows - were returned for a SELECT statment or - <function>mysql_affected_rows</function> to find out how many - rows were affected by a DELETE, INSERT, REPLACE, or UPDATE - statement. - </para> - <para> - Only for SELECT statements, <function>mysql_query</function> - returns a new result identifier that you can pass to - <function>mysql_fetch_array</function> and other - functions dealing with result tables. When you are done with the - result set, you can free the resources associated with it by - calling <function>mysql_free_result</function>. Although, the - memory will automatically be freed at the end of the script's - execution. - </para> - <para> + <function>mysql_query</function> také v¾dy sel¾e a vrátí &false; + jestli¾e nemáte dostateèné oprávnìní pøístupu do tabulky (tabulek) +uvedených v dotazu.</para> + <para> + Potøebujete-li zjistit poèet záznamù vrácených dotazem typu SELECT, +pou¾ijte následnì funkci <function>mysql_num_rows</function> èi pøípadnì funkci +<function>mysql_affected_rows</function>, pokud potøebujete zjistit poèet v¹ech +ovlivnìných záznamù dotazy typù DELETE, INSERT, REPLACE nebo UPDATE. </para> + <para> + Pouze pøi dotazu typu SELECT <function>mysql_query</function> + vrací nový identifikátor dotazu, který lze pou¾ít napøíklad pro volání +funkce <function>mysql_fetch_array</function> a dal¹ích funkcí pro zpracování +výsledkù dotazu. Nepotøebujete-li ji¾ obsah výsledku dotazu, mù¾ete uvolnit +pamìt voláním funkce <function>mysql_free_result</function>. Nicménì pamìt bude +uvolnìna automaticky na konci bìhu skriptu. </para> + <para> Viz. také: <function>mysql_num_rows</function> <function>mysql_affected_rows</function>, <function>mysql_unbuffered_query</function>, @@ -103,7 +90,7 @@ <function>mysql_fetch_row</function>, <function>mysql_fetch_assoc</function>, <function>mysql_result</function>, - <function>mysql_select_db</function>, and + <function>mysql_select_db</function>, a <function>mysql_connect</function>. </para> </refsect1>