Files
doc-fr/reference/pgsql/constants.xml
Yannick Torres 9d5862e6df sync with EN
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@324183 c90b9560-bf6c-de11-be94-00142212c4b1
2012-03-13 10:42:24 +00:00

575 lines
17 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4de5cce5d886bf7ea08db8583141ff9715b47073 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<appendix xml:id="pgsql.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<variablelist>
<varlistentry xml:id="constant.pgsql-assoc">
<term>
<constant>PGSQL_ASSOC</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_fetch_array</function>. Retourne un tableau
associatif des noms et valeurs des champs.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-num">
<term>
<constant>PGSQL_NUM</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_fetch_array</function>. Retourne un tableau à index
numérique des numéros et valeurs des champs.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-both">
<term>
<constant>PGSQL_BOTH</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_fetch_array</function>. Retourne un tableau des
valeurs des champs qui est indexés numériquement (par le numéro des
champs) et indexés littéralement (par le nom des champs).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-connect-force-new">
<term>
<constant>PGSQL_CONNECT_FORCE_NEW</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_connect</function> pour forcer la création d'une
nouvelle connexion, plutôt que de réutiliser une connexion identique
existante.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-connection-bad">
<term>
<constant>PGSQL_CONNECTION_BAD</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_connection_status</function> indiquant que la
connexion à la base de données est invalide.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-connection-ok">
<term>
<constant>PGSQL_CONNECTION_OK</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_connection_status</function> indiquant que la
connexion à la base de données est valide.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-seek-set">
<term>
<constant>PGSQL_SEEK_SET</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_lo_seek</function>. Le positionnement commencera au
début de l'objet.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-seek-cur">
<term>
<constant>PGSQL_SEEK_CUR</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_lo_seek</function>. Le positionnement commencera à
la position courante.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-seek-end">
<term>
<constant>PGSQL_SEEK_END</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_lo_seek</function>. Le positionnement commencera à
la fin de l'objet.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-empty-query">
<term>
<constant>PGSQL_EMPTY_QUERY</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_result_status</function>. La chaîne de
caractères envoyée au serveur était vide.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-command-ok">
<term>
<constant>PGSQL_COMMAND_OK</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_result_status</function>. Commande correctement
complétée ne retournant aucune donnée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-tuples-ok">
<term>
<constant>PGSQL_TUPLES_OK</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_result_status</function>. Commande
correctement complétée retournant des données (comme
<literal>SELECT</literal> ou <literal>SHOW</literal>).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-copy-out">
<term>
<constant>PGSQL_COPY_OUT</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_result_status</function>. Copie (à partir du
serveur) de transfert de données commencée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-copy-in">
<term>
<constant>PGSQL_COPY_IN</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_result_status</function>. Copie (vers le
serveur) de transfert de données commencée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-bad-response">
<term>
<constant>PGSQL_BAD_RESPONSE</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_result_status</function>. La réponse du
serveur n'a pas été comprise.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-nonfatal-error">
<term>
<constant>PGSQL_NONFATAL_ERROR</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_result_status</function>. Une erreur non
fatale (de niveau notice ou warning) s'est produite.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-fatal-error">
<term>
<constant>PGSQL_FATAL_ERROR</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_result_status</function>. Une erreur fatale
s'est produite.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-transaction-idle">
<term>
<constant>PGSQL_TRANSACTION_IDLE</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_transaction_Status</function>. La connexion
est actuellement libre, aucune transaction en cours.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-transaction-active">
<term>
<constant>PGSQL_TRANSACTION_ACTIVE</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_transaction_status</function>. Une commande
est en cours sur la connexion. Une requête a été envoyée sur la connexion
et n'a toujours pas été complétée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-transaction-intrans">
<term>
<constant>PGSQL_TRANSACTION_INTRANS</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_transaction_status</function>. La connexion
est libre, dans un bloc de transaction.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-transaction-inerror">
<term>
<constant>PGSQL_TRANSACTION_INERROR</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_transaction_status</function>. La connexion
est libre, dans un bloc de transaction échoué.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-transaction-unknown">
<term>
<constant>PGSQL_TRANSACTION_UNKNOWN</constant>
(&integer;)
</term>
<listitem>
<simpara>
Retournée par <function>pg_transaction_status</function>. La connexion
est mauvaise.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-severity">
<term>
<constant>PGSQL_DIAG_SEVERITY</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
La sévérité; le contenu du champ est <literal>ERROR</literal>,
<literal>FATAL</literal> ou <literal>PANIC</literal> (dans un message
d'erreur) ou <literal>WARNING</literal>, <literal>NOTICE</literal>, <literal>DEBUG</literal>,
<literal>INFO</literal> ou <literal>LOG</literal> (dans un message
d'avertissement) ou une traduction localisée parmi celles-ci. Toujours
présent.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-sqlstate">
<term>
<constant>PGSQL_DIAG_SQLSTATE</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Le code SQLSTATE pour cette erreur. Le code SQLSTATE identifie le type
d'erreur qui s'est produite; cela peut être utilisé par des applications
d'entrée pour effectuer des opérations spécifiques (comme la gestion
d'erreur) en réponse à une erreur de base de données particulière.
Ce champ ne peut être localisé et est toujours présent.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-message-primary">
<term>
<constant>PGSQL_DIAG_MESSAGE_PRIMARY</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Le champ d'erreur primaire interprétable pour l'utilisateur (normalement
une ligne). Toujours présent.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-message-detail">
<term>
<constant>PGSQL_DIAG_MESSAGE_DETAIL</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Détail : un second optionnel message d'erreur apportant plus de détails à
propos du problème. Peut être sur plusieurs lignes.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-message-hint">
<term>
<constant>PGSQL_DIAG_MESSAGE_HINT</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Conseil : une suggestion optionnelle qui indique que faire à propos du
problème. Ceci est prévu d'être différent de l'erreur puisqu'elle offre
un conseil (potentiellement inadéquat) plutôt que les faits véridiques.
Peut être sur plusieurs lignes.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-statement-position">
<term>
<constant>PGSQL_DIAG_STATEMENT_POSITION</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Une chaîne de caractères contenant une valeur entière décimale indiquant
une erreur de position du curseur en tant qu'index dans la requête
originale. Le premier caractère a l'index 1 et les positions sont
mesurées en caractères, non en octets.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-internal-position">
<term>
<constant>PGSQL_DIAG_INTERNAL_POSITION</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Ceci est défini étant la même chose que le champ
<constant>PG_DIAG_STATEMENT_POSITION</constant>, mais cela est utilisé
lorsque la position du curseur réfère à une commande générée internement
plutôt que d'une envoyée par le client. Le champ
<constant>PG_DIAG_INTERNAL_QUERY</constant> apparaîtra toujours lorsque
ce champ apparaît.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-internal-query">
<term>
<constant>PGSQL_DIAG_INTERNAL_QUERY</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Le texte d'une commande générée internement échouée. Cela peut être, par
exemple, une requête SQL envoyée par une fonction PL/pgSQL.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-context">
<term>
<constant>PGSQL_DIAG_CONTEXT</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Une indication du contexte dans lequel l'erreur s'est produit.
Présentement, ceci inclut une pile d'appel des traceback des fonctions
procédurales actives ainsi que des requête générées à l'interne. Le
traçage est une entrée par ligne, les plus récentes en premier.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-source-file">
<term>
<constant>PGSQL_DIAG_SOURCE_FILE</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Le nom du fichier de l'emplacement du code source PostgreSQL où l'erreur
a été reportée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-source-line">
<term>
<constant>PGSQL_DIAG_SOURCE_LINE</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Le nombre de ligne de l'emplacement du code source PostgreSQL où l'erreur
a été reportée.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-diag-source-function">
<term>
<constant>PGSQL_DIAG_SOURCE_FUNCTION</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_error_field</function>.
Le nom de la fonction de source code PostgreSQL reportant l'erreur.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-errors-terse">
<term>
<constant>PGSQL_ERRORS_TERSE</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_set_error_verbosity</function>.
Spécifie que les messages retournés incluent la sévérité, le texte
primaire ainsi que la position seulement; ceci devrait entrer sur une
seule ligne.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-errors-default">
<term>
<constant>PGSQL_ERRORS_DEFAULT</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_set_error_verbosity</function>.
Le mode par défaut produit des messages qui incluent ce qui est plus haut
et des détails en plus, conseil ou des champs contextes (ceci peut être
sur plusieurs lignes).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-errors-verbose">
<term>
<constant>PGSQL_ERRORS_VERBOSE</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_set_error_verbosity</function>.
Le mode verbeux inclut tous les champs disponibles.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-status-long">
<term>
<constant>PGSQL_STATUS_LONG</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_status</function>. Indique que le code
résultat est désiré numérique.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-status-string">
<term>
<constant>PGSQL_STATUS_STRING</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_result_status</function>. Indique que le tag de
résultat de commande est désiré textuel.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-conv-ignore-default">
<term>
<constant>PGSQL_CONV_IGNORE_DEFAULT</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_convert</function>.
Ignore les valeurs par défaut dans la table pendant la conversion.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-conv-force-null">
<term>
<constant>PGSQL_CONV_FORCE_NULL</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_convert</function>.
Utilise &null; à la place d'une chaîne de caractères vide.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-conv-ignore-not-null">
<term>
<constant>PGSQL_CONV_IGNORE_NOT_NULL</constant>
(&integer;)
</term>
<listitem>
<simpara>
Passée à <function>pg_convert</function>.
Ignore la conversion de &null; à l'intérieur des colonnes <literal>NOT
NULL</literal>.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</appendix>
<!-- 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:"~/.phpdoc/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
-->