getCurrentValue()

名称

getCurrentValue - 获取序列的当前值

语法

sequence.getCurrentValue()

类别

SdbSequence

描述

当用户需要知道序列进度时，可以使用该函数用获取序列的当前值。

参数

无

返回值

函数执行成功时，将以数值形式返回序列的当前值。

函数执行失败时，将抛异常并输出错误信息。

错误

getCurrentValue() 函数常见异常如下：

当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。

版本

v3.4.2 及以上版本

示例

• 如果获取未经使用的序列当前值，则获取失败

  > var sequence = db.createSequence("IDSequence")
  > sequence.getCurrentValue()
  (shell):1 uncaught exception: -362
  Sequence has never been used

• 如果获取已使用的序列当前值，则获取成功

  > sequence.getCurrentValue()
  1