返回值
-
成功返回详细结果信息(BSONObj 对象),结构如下:
{
InsertedNum : <INT32> 成功插入的记录数,不包含替代和忽略的记录,
DuplicatedNum : <INT32> 因重复键冲突被忽略或替代的记录数
}
-
当用户开启
flag
参数的 SDB_INSERT_RETURN_ID 选项或者options
参数的 ReturnOID 选项时,详细结果信息中还包含 "_id" 字段,情况如下:- 单条插入:直接返回插入记录的“_id”字段的内容。
- 批量插入:以数组的方式返回插入记录的“_id”字段的内容。
-
出错抛异常。
错误
insert()
函数常见异常如下:
当异常抛出时,可以通过getLastError()获取错误码, 或通过getLastErrMsg()获取错误信息。 可以参考常见错误处理指南了解更多内容。
版本
v1.0及以上版本。
点击巨杉数据库文档中心了解更多信息