Oracle Call Interface Programmer's Guide Release 2 (9.2) Part Number A96584-01 |
|
More OCI Relational Functions, 32 of 106
Gets the length of a LOB.
sword OCILobGetLength ( OCISvcCtx *svchp, OCIError *errhp, OCILobLocator *locp, ub4 *lenp );
The service context handle.
An error handle you can pass to OCIErrorGet()
for diagnostic information in the event of an error.
A LOB locator that uniquely references the LOB. For internal LOBs, this locator must be a locator that was obtained from the server specified by svchp
. For FILEs, the locator can be set by OCILobFileSetName()
, by a SELECT
statement, or by OCIObjectPin()
.
On output, it is the length of the LOB if the LOB is not NULL
. For character LOBs, it is the number of characters, for binary LOBs and BFILEs
it is the number of bytes in the LOB.
Gets the length of a LOB. If the LOB is NULL
, the length is undefined. The length of a FILE includes the EOF, if it exists. The length of an empty internal LOB is zero.
Regardless of whether the client-side character set is varying-width, the output length is in characters for CLOBs
and NCLOBs
, and in bytes for BLOBs
and BFILEs
.
Note: Any zero-byte or space fillers in the LOB written by previous calls to |
OCIErrorGet(), OCILobFileSetName(), OCILobRead(), OCILobWrite(), OCILobCopy(), OCILobAppend(), OCILobLoadFromFile(), OCILobWriteAppend()
|
Copyright © 1996, 2002 Oracle Corporation. All Rights Reserved. |
|