Files
doc-fr/reference/ibase/constants.xml
2021-09-24 04:13:47 +01:00

646 lines
17 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4d8da419011b34623bc91aab8d5ef7f5b6bfb128 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="ibase.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<para>
Les constantes suivantes peuvent être passées à <function>ibase_trans</function>
pour spécifier le comportement des transactions.
<table>
<title>Constantes Firebird/InterBase</title>
<tgroup cols="2">
<thead>
<row>
<entry>Constante</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>IBASE_DEFAULT</entry>
<entry>
Définit le comportement par défaut. Ce comportement est déterminé par la bibliothèque cliente,
qui est définie comme IBASE_WRITE|IBASE_CONCURRENCY|IBASE_WAIT dans
la plupart des cas.
</entry>
</row>
<row>
<entry>IBASE_READ</entry>
<entry>Démarre une transaction en lecture seul</entry>
</row>
<row>
<entry>IBASE_WRITE</entry>
<entry>Démarre une transaction en lecture / écriture</entry>
</row>
<row>
<entry>IBASE_CONSISTENCY</entry>
<entry>
Démarre une transaction avec le niveau d'isolation définie à
'consistency', ce qui signifie que le transaction courante
ne peut lire depuis des tables qui ont été modifiées par d'autres transactions.
</entry>
</row>
<row>
<entry>IBASE_CONCURRENCY</entry>
<entry>
Démarre une transaction avec le niveau d'isolation définie à
'concurrency' (ou 'snapshot'), ce qui signifie
que la transaction peut accéder à toutes les tables, mais ne peut pas voir les
modifications apportées par d'autres transactions une fois que la transaction
a débuté.
</entry>
</row>
<row>
<entry>IBASE_COMMITTED</entry>
<entry>
Démarre une transaction avec le niveau d'isolation définie à
'read committed'. Ce flag doit être associé avec
soit la constante <constant>IBASE_REC_VERSION</constant>, soit
la constante <constant>IBASE_REC_NO_VERSION</constant>.
Ce niveau d'isolation vous permet d'accéder aux modifications effectuées
après le début de la transaction. Si la constante
<constant>IBASE_REC_NO_VERSION</constant> est spécifiée,
seulement la dernière version des lignes pourra être lue.
Si la constante <constant>IBASE_REC_VERSION</constant> est spécifiée,
une ligne peut toujours être lue lorsqu'une modification est en attente dans
une transaction concurrente.
</entry>
</row>
<row>
<entry>IBASE_WAIT</entry>
<entry>
Indique que la transaction peut attendre, puis réessayer lorsqu'un conflit apparaît.
</entry>
</row>
<row>
<entry>IBASE_NOWAIT</entry>
<entry>
Indique que la transaction échouera immédiatement lorsqu'un conflit apparaît.
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
Les constantes suivantes peuvent être passées aux fonctions
<function>ibase_fetch_row</function>,
<function>ibase_fetch_assoc</function> ou <function>ibase_fetch_object</function>
pour spécifier leurs comportements.
<table>
<title>Constantes Firebird/InterBase</title>
<tgroup cols="2">
<thead>
<row>
<entry>Constante</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>IBASE_FETCH_BLOBS</entry>
<entry>
Aussi disponible sous le nom <constant>IBASE_TEXT</constant> pour des raisons de
compatibilité ascendante.
Permet de lire le contenu d'un BLOB "inline" au lieu
de le parcourir en utilisant un identifiant de BLOB.
</entry>
</row>
<row>
<entry>IBASE_FETCH_ARRAYS</entry>
<entry>
Permet de lire un tableau "inline".
Sinon, les identifiants de tableaux sont retournés.
Les identifiants de tableaux ne peuvent être passés uniquement comme arguments
aux requêtes INSERT, car aucune fonction pour traiter les identifiants de tableaux
n'est actuellement disponible.
</entry>
</row>
<row>
<entry>IBASE_UNIXTIME</entry>
<entry>
Permet de retourner les champs date et heure non pas comme des chaînes de caractères
mais comme des timestamps UNIX (le nombre de secondes depuis l'époque UNIX, qui
est le 1-Jan-1970 0:00 UTC). Cela peut être problématique si vous utilisez des dates
antérieures à 1970 sur quelques systèmes.
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
Les constantes suivantes sont utilisées pour passer des requêtes et des options à
l'API (<function>ibase_server_info</function>, <function>ibase_db_info</function>,
<function>ibase_backup</function>, <function>ibase_restore</function> et
<function>ibase_maintain_db</function>).
Merci de consulter le manuel Firebird/InterBase pour plus d'informations
sur la significations de ces options.
<variablelist>
<varlistentry xml:id="constant.ibase-bkp-ignore-checksums">
<term>
<constant>IBASE_BKP_IGNORE_CHECKSUMS</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_backup</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-bkp-ignore-limbo">
<term>
<constant>IBASE_BKP_IGNORE_LIMBO</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_backup</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-bkp-metadata-only">
<term>
<constant>IBASE_BKP_METADATA_ONLY</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_backup</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-bkp-no-garbage-collect">
<term>
<constant>IBASE_BKP_NO_GARBAGE_COLLECT</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_backup</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-bkp-old-descriptions">
<term>
<constant>IBASE_BKP_OLD_DESCRIPTIONS</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_backup</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-bkp-non-transportable">
<term>
<constant>IBASE_BKP_NON_TRANSPORTABLE</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_backup</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-bkp-convert">
<term>
<constant>IBASE_BKP_CONVERT</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_backup</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-res-deactivate-idx">
<term>
<constant>IBASE_RES_DEACTIVATE_IDX</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_restore</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-res-no-shadow">
<term>
<constant>IBASE_RES_NO_SHADOW</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_restore</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-res-no-validity">
<term>
<constant>IBASE_RES_NO_VALIDITY</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_restore</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-res-one-at-a-time">
<term>
<constant>IBASE_RES_ONE_AT_A_TIME</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_restore</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-res-replace">
<term>
<constant>IBASE_RES_REPLACE</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-res-create">
<term>
<constant>IBASE_RES_CREATE</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_restore</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-res-use-all-space">
<term>
<constant>IBASE_RES_USE_ALL_SPACE</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_restore</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-page-buffers">
<term>
<constant>IBASE_PRP_PAGE_BUFFERS</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-sweep-interval">
<term>
<constant>IBASE_PRP_SWEEP_INTERVAL</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-shutdown-db">
<term>
<constant>IBASE_PRP_SHUTDOWN_DB</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-deny-new-transactions">
<term>
<constant>IBASE_PRP_DENY_NEW_TRANSACTIONS</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-deny-new-attachments">
<term>
<constant>IBASE_PRP_DENY_NEW_ATTACHMENTS</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-reserve-space">
<term>
<constant>IBASE_PRP_RESERVE_SPACE</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-res-use-full">
<term>
<constant>IBASE_PRP_RES_USE_FULL</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-res">
<term>
<constant>IBASE_PRP_RES</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-write-mode">
<term>
<constant>IBASE_PRP_WRITE_MODE</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-wm-async">
<term>
<constant>IBASE_PRP_WM_ASYNC</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-wm-sync">
<term>
<constant>IBASE_PRP_WM_SYNC</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-access-mode">
<term>
<constant>IBASE_PRP_ACCESS_MODE</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-am-readonly">
<term>
<constant>IBASE_PRP_AM_READONLY</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-am-readwrite">
<term>
<constant>IBASE_PRP_AM_READWRITE</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-set-sql-dialect">
<term>
<constant>IBASE_PRP_SET_SQL_DIALECT</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-activate">
<term>
<constant>IBASE_PRP_ACTIVATE</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-prp-db-online">
<term>
<constant>IBASE_PRP_DB_ONLINE</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-rpr-check-db">
<term>
<constant>IBASE_RPR_CHECK_DB</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-rpr-ignore-checksum">
<term>
<constant>IBASE_RPR_IGNORE_CHECKSUM</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-rpr-kill-shadows">
<term>
<constant>IBASE_RPR_KILL_SHADOWS</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-rpr-mend-db">
<term>
<constant>IBASE_RPR_MEND_DB</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-rpr-validate-db">
<term>
<constant>IBASE_RPR_VALIDATE_DB</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-rpr-full">
<term>
<constant>IBASE_RPR_FULL</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-rpr-sweep-db">
<term>
<constant>IBASE_RPR_SWEEP_DB</constant>
</term>
<listitem>
<simpara>
Options de <function>ibase_maintain_db</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-sts-data-pages">
<term>
<constant>IBASE_STS_DATA_PAGES</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-sts-db-log">
<term>
<constant>IBASE_STS_DB_LOG</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-sts-hdr-pages">
<term>
<constant>IBASE_STS_HDR_PAGES</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-sts-idx-pages">
<term>
<constant>IBASE_STS_IDX_PAGES</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-sts-sys-relations">
<term>
<constant>IBASE_STS_SYS_RELATIONS</constant>
</term>
<listitem>
<simpara>
Options de <function>ibase_db_info</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-svc-server-version">
<term>
<constant>IBASE_SVC_SERVER_VERSION</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_server_info</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-svc-implementation">
<term>
<constant>IBASE_SVC_IMPLEMENTATION</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_server_info</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-svc-get-env">
<term>
<constant>IBASE_SVC_GET_ENV</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_server_info</function>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-svc-get-env-lock">
<term>
<constant>IBASE_SVC_GET_ENV_LOCK</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-svc-get-env-msg">
<term>
<constant>IBASE_SVC_GET_ENV_MSG</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-svc-user-dbpath">
<term>
<constant>IBASE_SVC_USER_DBPATH</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-svc-svr-db-info">
<term>
<constant>IBASE_SVC_SVR_DB_INFO</constant>
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ibase-svc-get-users">
<term>
<constant>IBASE_SVC_GET_USERS</constant>
</term>
<listitem>
<simpara>
Options pour <function>ibase_server_info</function>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</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
-->