Method cloneCursor

java/java/de/crupp/upscaledb/Cursor.java:126–136

Clones a Database Cursor This method wraps the native ups_cursor_clone function. Clones an existing Cursor. The new Cursor will point to exactly the same item as the old Cursor. If the old Cursor did not point to any item, so will the new Cursor. More information: <a href="http://files.u

()

   * @return the new Cursor object
   */
  public Cursor cloneCursor()
      throws DatabaseException {
    if (m_handle == 0)
      throw new DatabaseException(Const.UPS_INV_PARAMETER);
    long newhandle = ups_cursor_clone(m_handle);
    if (newhandle == 0)
      throw new DatabaseException(Const.UPS_INTERNAL_ERROR);
    Cursor c = new Cursor(m_db, newhandle);
    m_db.addCursor(c);
    return c;
  }

  /**
   * Moves the Cursor to the direction specified in the flags.