7.21.7 dbplus_add()Ajoute une ligne à une relation[ Exemples avec dbplus_add ] 4.1.0 - 4.2.3 only
int
dbplus_add (
resource
relation
,
array
tuple
)
Attention |
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 par exemple les séquences.
dbplus_add
va retourner zéro
(alias
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'erreurs.
|