cvs: phpdoc-da /reference/mysql/functions mysql-affected-rows.xml
[email protected] ("Mads N. Vestergaard") Tue, 07 Jun 2005 18:41:06 -0000
| Newsgroups | php.doc.da |
|---|---|
| Message-ID | <cvsmnv1118169666@cvsserver> |
mnv Tue Jun 7 14:41:06 2005 EDT
Modified files:
/phpdoc-da/reference/mysql/functions mysql-affected-rows.xml
Log:
Sync with EN
mnv-20050607144106.txt
(text/plain, 8.8 KB)
http://cvs.php.net/diff.php/phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml?r1=1.5&r2=1.6&ty=u
Index: phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml
diff -u phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml:1.5 phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml:1.6
--- phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml:1.5 Sat Mar 5 06:02:44 2005
+++ phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml Tue Jun 7 14:41:05 2005
@@ -1,118 +1,151 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.17 Maintainer: mnv Status: ready -->
- <refentry id="function.mysql-affected-rows">
- <refnamediv>
- <refname>mysql_affected_rows</refname>
- <refpurpose>Find ud af hvor mange rækker der blev påvirket, ved sidste MySQL forespørgsel</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beskrivelse</title>
- <methodsynopsis>
- <type>int</type><methodname>mysql_affected_rows</methodname>
- <methodparam choice="opt"><type>resource</type><parameter>
- link_identifier
- </parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>mysql_affected_rows</function> returnerer antallet af påvirkede rækker ved sidste brug af INSERT, UPDATE eller DELETE i en forespørgsel
- associeret med <parameter>link_identifier</parameter>. Hvis link
- beskriveren, vil den sidst åbnede forbindelse, der er åbnet af <function>mysql_connect</function> blive brugt.
- </para>
- <note>
- <para>
- Hvis du bruger transaktioner, er du nødt til at kalde
- <function>mysql_affected_rows</function> efter brug af INSERT,
- UPDATE, eller DELETE forespørgslen, ikke efter du har committed.
- </para>
- </note>
- <para>
- Hvis den sidste forespørgsel var en DELETE forespørgsel uden en WHERE
- klausul, vil alle rækker blive slettet, men denne funktion vil returnere 0.
- </para>
- <note>
- <para>
- Når du bruger UPDATE, vil MySQL ikke opdatere kolonner, hvor den nye værdi er det samme som den gamle. Dette giver mulighed for at <function>mysql_affected_rows</function> ikke gengiver det præcise nummer af matchende rækker, men kun det antal af rækker der blev påvirket af forespørgslen.
- </para>
- <para>
- REPLACE forspørgslen sletter først rækker med samme primære nøgle og
- indsætter derefter de nye rækker. Denne funktion returnerer derfor nummeret
- af de slettede rækker plus antalet af de nye rækker.
- </para>
- </note>
- <para>
- For at finde ud af hvor mange rækker der blev returneret fra en SELECT forspørgsel,
- kan du bruge <function>mysql_num_rows</function>.
- </para>
- <para>
- Hvis den sidste forespørgsel ikke blev udført korrekt, vil denne funktion returnere -1.
- <example>
- <title>Delete-Forespørgsel</title>
- <programlisting role="php">
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.21 Maintainer: mnv Status: ready -->
+<refentry id="function.mysql-affected-rows">
+ <refnamediv>
+ <refname>mysql_affected_rows</refname>
+ <refpurpose>Find ud af hvor mange rækker der blev berørt af sidste MySQL kald</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>mysql_affected_rows</methodname>
+ <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Find ud af hvor mange rækker, der blev berørt, af den sidste INSERT, UPDATE
+ or DELETE foresprøgsel associeret med <parameter>link_identifier</parameter>.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &mysql.linkid.description;
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Returnerer antal rækker der var berørt ved succes, og -1 hvis sidste forespørgsel
+ mislykkes.
+ </para>
+ <para>
+ Hvis sidste forespørgsel var en DELETE forespørgsel, hvor ingen
+ WHERE klausul, var angivet vil alle rækker være blevet slettet,
+ men denne funktion vil returnere nul, ved MySQL versioner før 4.1.2.
+ of the records will have been deleted from the table but this
+ function will return zero with MySQL versions prior to 4.1.2.
+ </para>
+ <para>
+ Når man bruger UPDATE, vil MySQL ikke opdatere kolonner hvor den
+ nye værdi er identisk med den gamle. Det vil skabe muligheden for at
+ <function>mysql_affected_rows</function> ikke angiver det samme antal rækker,
+ som der blev genkendt, men kun dem der var berørt af forespørgslen.
+ </para>
+ <para>
+ REPLACE udsagnet, sletter først registrering med samme primær nøgle,
+ og derefter indsætter den en ny registrering. Denne funktion vil dermed
+ returnere nummeret af slettede registreringer, og nummeret af indsatte
+ registreringer.
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>mysql_affected_rows</function> eksempel</title>
+ <programlisting role="php">
<![CDATA[
<?php
-/* forbinder til databasen */
-$link = mysql_connect('localhost', 'mysql_bruger', 'mysql_password');
+$link = mysql_connect('localhost', 'mysql_bruger', 'mysql_kode');
if (!$link) {
- die('Kunne ikke forbinde til databasen: ' . mysql_error());
+ die('Kunne ikke forbinde: ' . mysql_error());
}
-mysql_select_db('mindb');
+mysql_select_db('midb');
+
+/* detet skulle returnere det korrekte antal slettede registre */
+mysql_query('DELETE FROM mintabel WHERE id < 10');
+printf("Registre slettet: %d\n", mysql_affected_rows());
-/* dette vil returnere det korrekte antal af slettede rækker */
-mysql_query('DELETE FROM mintable WHERE id < 10');
-printf("Rækker slettet: %d\n", mysql_affected_rows());
-
-/* med en WHERE klausul er der aldrig er korrekt, bør det returnere 0 */
-mysql_query('DELETE FROM mintable WHERE 0');
-printf("Rækker slettet: %d\n", mysql_affected_rows());
+/* med en where klausul der aldrig er san, det burde returnere 0 */
+mysql_query('DELETE FROM mytable WHERE 0');
+printf("Registre slettet: %d\n", mysql_affected_rows());
?>
]]>
- </programlisting>
- <para>
- Ovenstående eksempel vil give følgende output:
- </para>
- <screen>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
<![CDATA[
-Rækker slettet: 10
-Rækker slettet: 0
+Registre slettet: 10
+Registre slettet: 0
]]>
- </screen>
- </example>
- </para>
- <para>
- <example>
- <title>Update-Forespørgsel</title>
- <programlisting role="php">
+ </screen>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title><function>mysql_affected_rows</function> eksempel der bruger transaktioner</title>
+ <programlisting role="php">
<![CDATA[
<?php
-/* forbinder til databasen */
-mysql_connect("localhost", "mysql_bruger", "mysql_password") or
- die("Kunne ikke forbinde til databasen: " . mysql_error());
-mysql_select_db("mindb");
-
-/* opdatere rækker */
-mysql_query("UPDATE mintable SET used=1 WHERE id < 10");
-printf ("Opdaterede rækker: %d\n", mysql_affected_rows());
+$link = mysql_connect('localhost', 'mysql_bruger', 'mysql_kode');
+if (!$link) {
+ die('Kunne ikke forbinde: ' . mysql_error());
+}
+mysql_select_db('mindb');
+
+/* Opdater registre */
+mysql_query("UPDATE mintable SET brugt=1 WHERE id < 10");
+printf ("Opdaterede registre: %d\n", mysql_affected_rows());
mysql_query("COMMIT");
?>
]]>
- </programlisting>
- <para>
- Ovenstående eksempel vil give følgende output:
- </para>
- <screen>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
<![CDATA[
-Opdaterede rækker: 10
+Opdaterede registre: 10
]]>
- </screen>
- </example>
- </para>
- <para>
- Se også <function>mysql_num_rows</function> og
- <function>mysql_info</function>.
- </para>
- </refsect1>
- </refentry>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <title>Transaktioner</title>
+ <para>
+ Hvis du bruger transaktioner, skal du kalde
+ <function>mysql_affected_rows</function> efter hver INSERT, UPDATE, eller
+ DELETE forespørgsel, ikke efter COMMIT.
+ </para>
+ </note>
+ <note>
+ <title>SELECT udsagn</title>
+ <para>
+ For at returnere antallet af rækker, returneret af et SELECT udsagn, kan du
+ bruge <function>mysql_num_rows</function>.
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>mysql_num_rows</function></member>
+ <member><function>mysql_info</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables: