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: