Share via


getSubString Method (SQLServerNClob)

Retrieves a copy of the specified substring in the NCLOB based on the specified starting position and the number of characters to copy.

Note

This feature is introduced starting with the Microsoft SQL Server JDBC Driver version 2.0.

public java.lang.String getSubString(long pos,
                                  int length)

Parameters

pos

The first character of the substring to be extracted. The first character is at position 1.

length

The number of consecutive characters to be copied.

Return Value

A String that is the specified substring in the NCLOB.

Exceptions

SQLServerException

Remarks

This getSubString method is specified by the getSubString method in the java.sql.NClob interface.

Trying to get zero characters from a null or zero-length NCLOB returns an empty string. Trying to get any length of characters at any position other than position 1 in a zero-length NCLOB will cause a position exception to be thrown.

See Also

Reference

SQLServerNClob Class

Concepts

SQLServerNClob Methods
SQLServerNClob Members