cvs: phpdoc-sk /reference/mysql/functions mysql-affected-rows.xml mysql-client-encoding.xml mysql-close.xml mysql-connect.xml
[email protected] ("Robert Novotny")
| Newsgroups | php.doc.sk |
|---|---|
| Message-ID | <cvsnovotnyr1045479913@cvsserver> |
novotnyr Mon Feb 17 06:05:13 2003 EDT
Added files:
/phpdoc-sk/reference/mysql/functions mysql-affected-rows.xml
mysql-client-encoding.xml
mysql-close.xml
mysql-connect.xml
Log:
new pieces
novotnyr-20030217060513.txt
(text/plain, 13.7 KB)
Index: phpdoc-sk/reference/mysql/functions/mysql-affected-rows.xml
+++ phpdoc-sk/reference/mysql/functions/mysql-affected-rows.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.6 Maintainer: novotnyr Status: ready -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
<refentry id="function.mysql-affected-rows">
<refnamediv>
<refname>mysql_affected_rows</refname>
<refpurpose>Zistí poèet riadkov, ktoré boli ovplyvnené predchádzajúcou
operáciou.</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<methodsynopsis>
<type>int</type><methodname>mysql_affected_rows</methodname>
<methodparam choice="opt"><type>resource</type><parameter>
identifikátor_pripojenia
</parameter></methodparam>
</methodsynopsis>
<para>
<function>mysql_affected_rows</function> vráti poèet riadkov, ktoré
boli ovplyvnené posledným dopytom typu INSERT, UPDATE alebo DELETE
asociovanom s pripojením, ktoré je ¹pecifikované v parametri
<parameter>identifikátor_pripojenia</parameter>. Ak tento identifikátor
pripojenia nie je uvedený, pou¾ije sa identifikátor z posledného
volania funkcie <function>mysql_connect</function>.
</para>
<note>
<para>
Ak pou¾ívate transakcie, volanie funkcie
<function>mysql_affected_rows</function> musí by» uskutoènené po
vykonaní dopytu INSERT, UPDATE, èi DELETE query, nie po
odoslaní transakcie (operácia commit).
</para>
</note>
<para>
Ak posledný dopyt bol typu DELETE bez uvedenej klauzuly WHERE,
odstránia sa síce v¹etky záznamy, ale táto funkcia vráti
nulu.
</para>
<note>
<para>
Pri pou¾ívaní dopytov UPDATE, MySQL nebude aktualizova» ståpèeky,
v ktorých je stará hodnota rovná novej hodnote. To mô¾e spôsobi»
situáciu, v ktorej sa návratová hodnota
<function>mysql_affected_rows</function> nemusí rovna»
skutoènému poètu ovplyvnených riadkov. Jej návratovou hodnotou bude
poèet riadkov, ktoré boli naozaj zmenené, odstránené, èi inak ovplyvnené
dopytom.
</para>
</note>
<para>
<function>mysql_affected_rows</function> nepracuje so dopytmi typu
SELECT - len na dopytoch, ktoré modifikujú záznamy.
Na zistenie poètu záznamov vrátených dopytom SELECT je potrebné
pou¾i» funkciu <function>mysql_num_rows</function>.
</para>
<para>
Ak posledný dopyt zlyhal, funkcia vráti -1.
<example>
<title>Odstraòovanie záznamov - dopyty typu DELETE</title>
<programlisting role="php">
<![CDATA[
<?php
/* pripojme sa k databáze */
mysql_pconnect("localhost", "mysql_u¾ívateµ", "mysql_heslo") or
die("Nemo¾no sa pripoji»: " . mysql_error());
/* toto by malo vráti» správny poèet odstránených záznamov */
mysql_query("DELETE FROM mytable WHERE id < 10");
printf ("Poèet odstránených záznamov: %d\n", mysql_affected_rows());
/* klauzula WHERE je v dopyte prázdna, funkcia by mala vráti» 0 */
mysql_query("DELETE FROM mytable");
printf ("Poèet odstránených záznamov: %d\n", mysql_affected_rows());
?>
]]>
</programlisting>
<para>
Predchádzajúci príklad vypí¹e nasledovné riadky:
<screen>
<![CDATA[
Poèet odstránených záznamov: 10
Poèet odstránených záznamov: 0
]]>
</screen>
</para>
</example>
<example>
<title>Modifikácia záznamov - dopyty typu UPDATE</title>
<programlisting role="php">
<![CDATA[
<?php
/* pripojme sa k databáze */
mysql_pconnect("localhost", "mysql_u¾ívateµ", "mysql_heslo") or
die("Nemo¾no sa pripoji»: " . mysql_error());
/* modifikujme záznamy */
mysql_query("UPDATE mytable SET used=1 WHERE id < 10");
printf ("Poèet zmenených záznamov: %d\n", mysql_affected_rows());
/* funkciu mysql_affected_rows() sme zavolali pred odoslaním
transakcie */
mysql_query("COMMIT");
?>
]]>
</programlisting>
<para>
Uvedený príklad vypí¹e nasledovné riadky:
<screen>
<![CDATA[
Poèet zmenených záznamov: 10
]]>
</screen>
</para>
</example>
</para>
<para>
Pozri tie¾: <function>mysql_num_rows</function>,
<function>mysql_info</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc-sk/reference/mysql/functions/mysql-client-encoding.xml
+++ phpdoc-sk/reference/mysql/functions/mysql-client-encoding.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.2 Maintainer: novotnyr Status: ready -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.100 -->
<refentry id="function.mysql-character-set-name">
<refnamediv>
<refname>mysql_client_encoding</refname>
<refpurpose>Vráti názov pou¾itej znakovej sady</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<methodsynopsis>
<type>int</type><methodname>mysql_client_encoding</methodname>
<methodparam choice="opt"><type>resource</type><parameter>identifikátor_pripojenia</parameter></methodparam>
</methodsynopsis>
<para>
Funkcia <function>mysql_client_encoding</function> vráti názov
implicitnej znakovej sady pre aktuálne pripojenie.
</para>
<example>
<title>Príklad na <function>mysql_client_encoding</function></title>
<programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect('localhost', 'mysql_u¾ívateµ', 'mysql_heslo');
$charset = mysql_client_encoding($link);
printf ("Aktuálna znaková sada je: %s\n", $charset);
?>
]]>
</programlisting>
<para>
Uvedený príklad vypí¹e nasledovný výstup:
<screen>
<![CDATA[
Aktuálna znaková sada je: latin1
]]>
</screen>
</para>
</example>
<para>
Pozri tie¾:
<function>mysql_real_escape_string</function>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc-sk/reference/mysql/functions/mysql-close.xml
+++ phpdoc-sk/reference/mysql/functions/mysql-close.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.3 Maintainer: novotnyr Status: ready -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
<refentry id="function.mysql-close">
<refnamediv>
<refname>mysql_close</refname>
<refpurpose>Ukonèí pripojenie k serveru MySQL</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<methodsynopsis>
<type>bool</type><methodname>mysql_close</methodname>
<methodparam choice="opt"><type>resource</type><parameter>
identifikátor_pripojenia
</parameter></methodparam>
</methodsynopsis>
<para>
&return.success;
</para>
<para>
Funkcia <function>mysql_close</function> ukonèí pripojenie
asociované s príslu¹ným identifikátorom pripojenia k
serveru MySQL. Ak parameter
<parameter>identifikátor_pripojenia</parameter> nie je ¹pecifikovaný,
ukonèí sa posledné otvorené pripojenie.
</para>
<para>
Pou¾itie <function>mysql_close</function> nie je zvyèajne potrebné,
preto¾e neperzistentné pripojenia sú automaticky ukonèené po
skonèení vykonávania skriptu. Pozri tie¾
<link linkend="language.types.resource.self-destruct">Uvoµòovanie
zdrojov</link>.
</para>
<note>
<para>
Funkcia <function>mysql_close</function> neuzatvorí perzistentné
pripojenia vytvorené funkciou <function>mysql_pconnect</function>.
</para>
</note>
<example>
<title>Príklad na ukonèenie pripojenia k MySQL</title>
<programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect("localhost", "mysql_u¾ívateµ", "mysql_heslo")
or die("Nemo¾no sa pripoji»: " . mysql_error());
print ("Pripojenie bolo úspe¹né");
mysql_close($link);
?>
]]>
</programlisting>
</example>
<para>
Pozri tie¾: <function>mysql_connect</function> a
<function>mysql_pconnect</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc-sk/reference/mysql/functions/mysql-connect.xml
+++ phpdoc-sk/reference/mysql/functions/mysql-connect.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
<refentry id="function.mysql-connect">
<refnamediv>
<refname>mysql_connect</refname>
<refpurpose>Ustanoví pripojenie k serveru MySQL</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<methodsynopsis>
<type>resource</type><methodname>mysql_connect</methodname>
<methodparam choice="opt"><type>string</type><parameter>
server
</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>
u¾ívateµské_meno
</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>
heslo
</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>
nové_pripojenie
</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>
príznaky_klienta
</parameter></methodparam>
</methodsynopsis>
<para>
Vráti identifikátor pripojenia k MySQL alebo link &false; v prípade chyby.
</para>
<para>
<function>mysql_connect</function> ustanoví pripojenie k serveru
MySQL. Implicitné hodnoty pre neuvedené parametre sú nasledovné:
<parameter>server</parameter> =
'localhost:3306', <parameter>u¾ívateµské_meno</parameter> = meno u¾ívateµa,
ktorý vlastní proces servera a
<parameter>heslo</parameter> = prázdne heslo.
</para>
<para>
Parameter <parameter>server</parameter> mô¾e tie¾ obsahova» èíslo portu
napr. "hostiteµ:port" alebo cestu k socketu
":/cesta/k/socketu" v prípade miestneho servera localhost.
<note>
<para>
Podpora pre ":port" bola pridaná v PHP 3.0B4.
</para>
<para>
Podpora pre sockety typu ":/cesta/k/socketu" bola pridaná v
PHP 3.0.10.
</para>
<para>
Chybové hlásenia v prípade zlyhania mo¾no potlaèi» predradením operátora
<link linkend="language.operators.errorcontrol">@</link>
pred názov volanej funkcie.
</para>
</note>
</para>
<para>
Ak je <function>mysql_connect</function> volaná druhýkrát s rovnakými
parametrami, nebude ustanovené nové pripojenie. Namiesto toho bude
vrátený identifikátor u¾ vytvoreného pripojenia. Toto správanie
mo¾no zmeni» nastavením parametra <parameter>nové_pripojenie</parameter> na
&TRUE;. Potom bude funkcia <function>mysql_connect</function> v¾dy
navraca» identifikátor nového pripojenia, aj keï u¾ bola
<function>mysql_connect</function> volaná s rovnakými parametrami.
Parameter <parameter>príznaky_klienta</parameter> mô¾e obsahova»
kombináciu kon¹tánt MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE alebo
MYSQL_CLIENT_INTERACTIVE.
</para>
<note>
<para>
Parameter <parameter>nové_pripojenie</parameter> je k dispozícii od
PHP 4.2.0
</para>
<para>
Parameter <parameter>príznaky_klienta</parameter> je k dispozícii
od PHP 4.3.0
</para>
</note>
<para>
Pripojenie k serveru bude ukonèené po vykonaní skriptu, resp. po
predchádzajúcom explicitnom zavolaní funkcie
<function>mysql_close</function>.
</para>
<example>
<title>Príklad na pripojenie k MySQL</title>
<programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect("localhost", "mysql_u¾ívateµ", "mysql_heslo")
or die("Nemo¾no sa pripoji»: " . mysql_error());
print ("Pripojenie bolo úspe¹né");
mysql_close($link);
?>
]]>
</programlisting>
</example>
<para> Pozri tie¾
<function>mysql_pconnect</function> a
<function>mysql_close</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->