(4.1.0 - 4.2.3 only, PECL)
dbplus_add -- Ajoute une ligne à une relation
Description
int
dbplus_add ( resource relation, array tuple )
| Avertissement |
Cette fonction est
EXPERIMENTALE. Cela signifie que le comportement de
cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut
changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez
cette fonction à vos risques et périls. |
dbplus_add() va ajouter la ligne
tuple à la relation relation.
tuple est un tableau associatif de paires
attribut/valeur, qui seront insérées dans la relation
relation. Après une exécution réussie,
tuple contiendra toutes les données de la
nouvelle ligne, y compris tous les champs implicitement créés,
comme les séquences.
dbplus_add() va retourner zéro
(DBPLUS_ERR_NOERR) en cas de succès,
ou bien un code d'erreur DB++ en cas d'échec. Voyez la fonction
dbplus_errcode() ou l'introduction de ce chapitre
pour plus d'informations sur les codes d'erreur db++.