dbplus_add

(4.1.0 - 4.2.3 only)

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'erreurs db++.