Retours de objet_modifier et objet_inserer et PHPDoc

Quand on fait appel à objet_inserer ou objet_modifier, on aimerait savoir si l'opération s'est bien passée.

Le PHPDoc sur le retour de ces fonctions n'est pas très dissert, j'aimerais le compléter.

À la lecture du code, ça donnerait ça :

objet_inserer :

• Succès : (int) numéro de l'objet
• Erreur :
  • (bool) false : sql_insertq() a échoué
  • (int) 0 : le type d'objet n'existe pas ou la table est mal déclarée

objet_modifier :

• Succès : (string) chaîne vide
• Erreur : (string) message d'erreur

Est-ce qu'on est bon là ? Edit : mis à jour, objet_inserer peut aussi renvoyer un int en cas d'erreur.

Sachant qu'il peut y avoir d'autres types retournés si des fonctions modifier_patates existent et font les choses à leur sauce.

Pour référence le PHPDoc indique ça actuellement :

/**
 * Insere en base un objet generique
 *
 * @return bool|int
 */
function objet_inserer($objet, $id_parent = null, $set = null) {

/**
 * Appelle toutes les fonctions de modification d'un objet
 * $err est un message d'erreur eventuelle
 *
 * @return mixed|string
 */
function objet_modifier($objet, $id, $set = null) {