Mimer JDBC Engine 2.12

com.mimer.jdbc
Class Clob

java.lang.Object
  |
  +--com.mimer.jdbc.Clob
All Implemented Interfaces:
Clob

public class Clob
extends Object
implements Clob

The Clob object corresponds to a CLOB LOCATOR or NCLOB LOCATOR in the SQL-99 standard. This object may only be used to represent the Mimer SQL type CHARACTER LARGE OBJECT (CLOB) or NATIONAL CHARACTER LARGE OBJECT (NCLOB). Any attempts to use this object on other datatypes will cause an SQLException to be raised. For more information see Blob .


Method Summary
 InputStream getAsciiStream()
          Returns an InputStream to access the data this CLOB LOCATOR represents.
 Reader getCharacterStream()
          Returns a CharacterStream to access the data this CLOB LOCATOR represents.
 String getSubString(long pos, int length)
          Returns a String object holding the data this CLOB LOCATOR object represents.
 long length()
          Returns the length of the data this CLOB LOCATOR represents.
 long position(Clob pattern, long start)
          Searches for a position within the CLOB object.
 long position(String pattern, long start)
          Searches for a position within the CLOB object.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface java.sql.Clob
setAsciiStream, setCharacterStream, setString, setString, truncate
 

Method Detail

getAsciiStream

public InputStream getAsciiStream()
                           throws SQLException
Returns an InputStream to access the data this CLOB LOCATOR represents.

Specified by:
getAsciiStream in interface Clob
Returns:
A stream.
Throws:
SQLException - if an error occurs. SQLSTATE 25000 is thrown if this Blob object was invalidated because the transaction in which it was created has ended.

getCharacterStream

public Reader getCharacterStream()
                          throws SQLException
Returns a CharacterStream to access the data this CLOB LOCATOR represents.

Specified by:
getCharacterStream in interface Clob
Returns:
A stream.
Throws:
SQLException - if an error occurs. SQLSTATE 25000 is thrown if this Blob object was invalidated because the transaction in which it was created has ended.

getSubString

public String getSubString(long pos,
                           int length)
                    throws SQLException
Returns a String object holding the data this CLOB LOCATOR object represents.

Specified by:
getSubString in interface Clob
Parameters:
pos - The offset within the CLOB to start returning data.
length - The number of characters at most to return.
Returns:
The string.
Throws:
SQLException - if an error occurs. SQLSTATE 25000 is thrown if this Blob object was invalidated because the transaction in which it was created has ended.

length

public long length()
            throws SQLException
Returns the length of the data this CLOB LOCATOR represents.

Specified by:
length in interface Clob
Returns:
The length in characters.
Throws:
SQLException - if an error occurs. SQLSTATE 25000 is thrown if this Blob object was invalidated because the transaction in which it was created has ended.

position

public long position(Clob pattern,
                     long start)
              throws SQLException
Searches for a position within the CLOB object.

Searches within CLOB:s are not supported yet.

Specified by:
position in interface Clob
SQLException

position

public long position(String pattern,
                     long start)
              throws SQLException
Searches for a position within the CLOB object.

Searches within CLOB:s are not supported yet.

Specified by:
position in interface Clob
SQLException

Mimer JDBC Engine 2.12

Submit a comment or suggestion Version 2.12 of Mimer JDBC Engine
Copyright Upright Database Technology AB, Box 1713, SE-751 47 UPPSALA, Sweden. All Rights Reserved.