Since: API Level 1
public interface

Clob

java.sql.Clob

Class Overview

A Java interface mapping for the SQL CLOB type.

An SQL CLOB type stores a large array of characters as the value in a column of a database.

The java.sql.Clob interface provides methods for setting and retrieving data in the Clob, for querying Clob data length, for searching for data within the Clob.

Summary

Public Methods
abstract InputStream getAsciiStream()
Gets the value of this Clob object as an ASCII stream.
abstract Reader getCharacterStream()
Gets the data of this Clob object in a java.io.Reader.
abstract String getSubString(long pos, int length)
Gets a copy of a specified substring in this Clob.
abstract long length()
Retrieves the number of characters in this Clob object.
abstract long position(String searchstr, long start)
Retrieves the character position at which a specified substring appears in this Clob object.
abstract long position(Clob searchstr, long start)
Retrieves the character position at which a specified Clob object appears in this Clob object.
abstract OutputStream setAsciiStream(long pos)
Retrieves a stream which can be used to write Ascii characters to this Clob object, starting at specified position.
abstract Writer setCharacterStream(long pos)
Retrieves a stream which can be used to write a stream of unicode characters to this Clob object, at a specified position.
abstract int setString(long pos, String str)
Writes a given Java String to this Clob object at a specified position.
abstract int setString(long pos, String str, int offset, int len)
Writes len characters of a string, starting at a specified character offset, to this Clob.
abstract void truncate(long len)
Truncates this Clob after the specified number of characters.

Public Methods

public abstract InputStream getAsciiStream ()

Since: API Level 1

Gets the value of this Clob object as an ASCII stream.

Returns
  • an ASCII InputStream giving access to the Clob data.
Throws
SQLException if an error occurs accessing the Clob.

public abstract Reader getCharacterStream ()

Since: API Level 1

Gets the data of this Clob object in a java.io.Reader.

Returns
  • a character stream Reader object giving access to the Clob data.
Throws
SQLException if an error occurs accessing the Clob.

public abstract String getSubString (long pos, int length)

Since: API Level 1

Gets a copy of a specified substring in this Clob.

Parameters
pos the index of the start of the substring in the Clob.
length the length of the data to retrieve.
Returns
  • A string containing the requested data.
Throws
SQLException if an error occurs accessing the Clob.

public abstract long length ()

Since: API Level 1

Retrieves the number of characters in this Clob object.

Returns
  • a long value with the number of character in this Clob.
Throws
SQLException if an error occurs accessing the Clob.

public abstract long position (String searchstr, long start)

Since: API Level 1

Retrieves the character position at which a specified substring appears in this Clob object.

Parameters
searchstr the string to search for.
start the position at which to start the search within this Clob.
Returns
  • a long value with the position at which the specified string occurs within this Clob.
Throws
SQLException if an error occurs accessing the Clob.

public abstract long position (Clob searchstr, long start)

Since: API Level 1

Retrieves the character position at which a specified Clob object appears in this Clob object.

Parameters
searchstr the specified Clob to search for.
start the position within this Clob to start the search
Returns
  • a long value with the position at which the specified Clob occurs within this Clob.
Throws
SQLException if an error occurs accessing the Clob.

public abstract OutputStream setAsciiStream (long pos)

Since: API Level 1

Retrieves a stream which can be used to write Ascii characters to this Clob object, starting at specified position.

Parameters
pos the position at which to start the writing.
Returns
  • an OutputStream which can be used to write ASCII characters to this Clob.
Throws
SQLException if an error occurs accessing the Clob.

public abstract Writer setCharacterStream (long pos)

Since: API Level 1

Retrieves a stream which can be used to write a stream of unicode characters to this Clob object, at a specified position.

Parameters
pos the position at which to start the writing.
Returns
  • a Writer which can be used to write unicode characters to this Clob.
Throws
SQLException if an error occurs accessing the Clob.

public abstract int setString (long pos, String str)

Since: API Level 1

Writes a given Java String to this Clob object at a specified position.

Parameters
pos the position at which to start the writing.
str the string to write.
Returns
  • the number of characters written.
Throws
SQLException if an error occurs accessing the Clob.

public abstract int setString (long pos, String str, int offset, int len)

Since: API Level 1

Writes len characters of a string, starting at a specified character offset, to this Clob.

Parameters
pos the position at which to start the writing.
str the String to write.
offset the offset within str to start writing from.
len the number of characters to write.
Returns
  • the number of characters written.
Throws
SQLException if an error occurs accessing the Clob.

public abstract void truncate (long len)

Since: API Level 1

Truncates this Clob after the specified number of characters.

Parameters
len the length in characters giving the place to truncate this Clob.
Throws
SQLException if an error occurs accessing the Clob.