Skip to content

Commit

Permalink
MySQLi section sync with EN (#893)
Browse files Browse the repository at this point in the history
  • Loading branch information
@devnexen
devnexen authored Apr 23, 2024
1 parent ed5a043 commit 9c46ec9
Show file tree
Hide file tree
Showing 4 changed files with 34 additions and 144 deletions.
3 changes: 2 additions & 1 deletion reference/mysqli/functions/mysqli-get-client-stats.xml
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 473b5ab2c14369c0bc9f17a7f122c9669718c3e3 Maintainer: girgias Status: ready -->
<!-- EN-Revision: 62126c55f1c6ed444043e7272c4f9e233818a44b Maintainer: girgias Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mysqli-get-client-stats" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -26,6 +26,7 @@

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
Expand Down
68 changes: 5 additions & 63 deletions reference/mysqli/mysqli_result/fetch-field-direct.xml
View file
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c56455e0f9db0c9338d129c060c9ff7f080305c4 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 5152c78db935ea2463e20a01ae0e3f3573314d78 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="mysqli-result.fetch-field-direct" xmlns="http://docbook.org/ns/docbook">
<refentry xml:id="mysqli-result.fetch-field-direct" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>mysqli_result::fetch_field_direct</refname>
<refname>mysqli_fetch_field_direct</refname>
Expand Down Expand Up @@ -52,67 +52,9 @@
ou &false; si aucune métadonnée n'est spécifiée pour le champ
<parameter>index</parameter>.
</para>
<para>
<table xml:id="mysqli-result.fetch-field-direct.returnvalues">
<title>Attributs de l'objet</title>
<tgroup cols="2">
<thead>
<row>
<entry>Attribut</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>Le nom de la colonne</entry>
</row>
<row>
<entry>orgname</entry>
<entry>Le nom original de la colonne si un alias a été spécifié</entry>
</row>
<row>
<entry>table</entry>
<entry>Le nom de la table à laquelle ce champ appartient (s'il n'a pas été calculé)</entry>
</row>
<row>
<entry>orgtable</entry>
<entry>Le nom original de la table si un alias a été spécifié</entry>
</row>
<row>
<entry>def</entry>
<entry>La valeur par défaut du champ, représentée par une chaîne de caractères</entry>
</row>
<row>
<entry>max_length</entry>
<entry>La longueur maximale du champ pour le jeu de résultats.
À partir de PHP 8.1, cette valeur est toujours <literal>0</literal>.
</entry>
</row>
<row>
<entry>length</entry>
<entry>La largeur du champ, comme spécifiée dans la définition de table</entry>
</row>
<row>
<entry>charsetnr</entry>
<entry>Le numéro du jeu de caractères pour ce champ</entry>
</row>
<row>
<entry>flags</entry>
<entry>Un entier représentant le bit-flags pour ce champ</entry>
</row>
<row>
<entry>type</entry>
<entry>Le type de données utilisées pour ce champ</entry>
</row>
<row>
<entry>decimals</entry>
<entry>Le nombre de décimales utilisées (pour les champs numériques)</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('mysqli-result.fetch-fields')/db:refsect1[@role='returnvalues']/db:table)">
<xi:fallback/>
</xi:include>
</refsect1>

<refsect1 role="examples">
Expand Down
74 changes: 5 additions & 69 deletions reference/mysqli/mysqli_result/fetch-field.xml
View file
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: jpauli Status: ready -->
<!-- EN-Revision: 5152c78db935ea2463e20a01ae0e3f3573314d78 Maintainer: jpauli Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="mysqli-result.fetch-field" xmlns="http://docbook.org/ns/docbook">
<refentry xml:id="mysqli-result.fetch-field" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>mysqli_result::fetch_field</refname>
<refname>mysqli_fetch_field</refname>
Expand Down Expand Up @@ -43,73 +43,9 @@
Retourne un objet qui contient les informations d'un champ ou &false;
si aucune information n'est disponible pour ce champs.
</para>
<para>
<table xml:id="mysqli-result.fetch-field.returnvalues">
<title>Propriétés de l'objet</title>
<tgroup cols="2">
<thead>
<row>
<entry>Propriété</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry>
<entry>Le nom de la colonne</entry>
</row>
<row>
<entry>orgname</entry>
<entry>Le nom original de la colonne si un alias a été spécifié</entry>
</row>
<row>
<entry>table</entry>
<entry>Le nom de la table à laquelle ce champs appartient (s'il n'a pas été calculé)</entry>
</row>
<row>
<entry>orgtable</entry>
<entry>Le nom original de la table si un alias a été spécifié</entry>
</row>
<row>
<entry>def</entry>
<entry>Réservé pour la valeur par défaut. Actuellement toujours ""</entry>
</row>
<row>
<entry>db</entry>
<entry>Le nom de la base de donnée</entry>
</row>
<row>
<entry>catalog</entry>
<entry>Nom du catalogue, toujours "def"</entry>
</row>
<row>
<entry>max_length</entry>
<entry>La longueur maximale du champs pour le jeu de résultats</entry>
</row>
<row>
<entry>length</entry>
<entry>La largeur du champs, comme spécifiée dans la définition de table</entry>
</row>
<row>
<entry>charsetnr</entry>
<entry>Le numéro du jeu de caractères pour ce champs</entry>
</row>
<row>
<entry>flags</entry>
<entry>Un entier représentant le bit-flags pour ce champs</entry>
</row>
<row>
<entry>type</entry>
<entry>Le type de données utilisées pour ce champs</entry>
</row>
<row>
<entry>decimals</entry>
<entry>Le nombre de décimales utilisées (pour les champs de type entier)</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('mysqli-result.fetch-fields')/db:refsect1[@role='returnvalues']/db:table)">
<xi:fallback/>
</xi:include>
</refsect1>

<refsect1 role="examples">
Expand Down
33 changes: 22 additions & 11 deletions reference/mysqli/mysqli_result/fetch-fields.xml
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 301d51acc2b8f54edbbd00ce4fdbbe649e4ae192 Maintainer: jpauli Status: ready -->
<!-- EN-Revision: 5152c78db935ea2463e20a01ae0e3f3573314d78 Maintainer: jpauli Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli-result.fetch-fields" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -43,8 +43,7 @@
<para>
Renvoie un tableau d'objets contenant des informations sur la définition des champs.
</para>
<para>
<table xml:id="mysqli-result.fetch-fields.returnvalues">
<table>
<title>Propriétés de l'objet</title>
<tgroup cols="2">
<thead>
Expand All @@ -70,23 +69,36 @@
<entry>orgtable</entry>
<entry>Le nom original de la table si un alias a été spécifié</entry>
</row>
<row>
<entry>def</entry>
<entry>Inutilisé. Toujours une chaîne vide</entry>
</row>
<row>
<entry>db</entry>
<entry>Le nom de la base de données</entry>
</row>
<row>
<entry>catalog</entry>
<entry>Inutilisé. Toujours <literal>"def"</literal></entry>
</row>
<row>
<entry>max_length</entry>
<entry>La longueur maximale du champ pour le jeu de résultats. À partir de PHP 8.1, cette valeur est toujours <literal>0</literal>.</entry>
</row>
<row>
<entry>length</entry>
<entry>
La largeur du champ, en octets, telle que spécifiée dans la définition de la table.
Notez que ce nombre (octets) peut différer de la valeur de votre définition de
table (caractères), en fonction du jeu de caractères que vous utilisez.
Par exemple, le jeu de caractères utf8 contient 3 octets par caractère, donc
varchar(10) renverra une longueur de 30 pour utf8 (10*3), mais 10 pour latin1 (10*1).
La largeur du champ en octets. Pour les colonnes de type chaîne de caractères,
la valeur de longueur varie en fonction du jeu de caractères de la connexion.
Par exemple, si le jeu de caractères est <literal>latin1</literal>, un jeu de caractères mono-octet,
la valeur de longueur pour une requête <literal>SELECT 'abc'</literal> est 3.
Si le jeu de caractères est <literal>utf8mb4</literal>, un jeu de caractères multioctets
dans lequel les caractères occupent jusqu'à 4 octets, la valeur de longueur est 12.
</entry>
</row>
<row>
<entry>charsetnr</entry>
<entry>Le numéro (id) du jeu de caractères pour ce champs</entry>
<entry>Le numéro du jeu de caractères pour ce champs</entry>
</row>
<row>
<entry>flags</entry>
Expand All @@ -98,12 +110,11 @@
</row>
<row>
<entry>decimals</entry>
<entry>Le nombre de décimales utilisées (pour les champs de type entier)</entry>
<entry>Le nombre de décimales pour les champs numériques et la précision des secondes fractionnaires pour les champs temporels.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1>

<refsect1 role="examples">
Expand Down

0 comments on commit 9c46ec9

Please sign in to comment.