Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.
Эта функция добавляет пару/tuple к relation/реляции. tuple это массив пар attribute/value, вставляемых в данную
relation. После успешного выполнения массив tuple будет содержать полные данные о вновь созданном tuple, включая все неявно
устанавливаемые поля домена вроде sequences.
Эта функция возвращает нуль (aka. DBPLUS_ERR_NOERR) при успехе или db++
код ошибки - при неудаче. См. dbplus_errcode() или введение к этой главе на предмемт информации ол кодах ошибок db++.