cvs: phpdoc-da /reference/mysql/functions mysql-affected-rows.xml
| From: | Mads N. Vestergaard | Date: | Tue, 07 Jun 2005 18:41:06 +0000 |
| Subject: | cvs: phpdoc-da /reference/mysql/functions mysql-affected-rows.xml | ||
| Groups: | php.doc.da | ||
| Request: | Send a blank email to doc-da+get-348@lists.php.net to get a copy of this message | ||
mnv Tue Jun 7 14:41:06 2005 EDT
Modified files:
/phpdoc-da/reference/mysql/functions mysql-affected-rows.xml
Log:
Sync with EN
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:
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: