|Oracle® Call Interface Programmer's Guide
11g Release 2 (11.2)
Part Number E10646-06
This chapter completes the description of the OCI relational functions started in the previous chapter. It includes information about calling OCI functions in your application, along with detailed descriptions of each function call.
See Also:For code examples, see the demonstration programs included with your Oracle Database installation. For additional information, see Appendix B.
This chapter contains these topics:
This chapter describes the OCI relational function calls. This chapter and the previous one, cover the functions in the basic OCI.
See Also:"Error Handling in OCI" for information about return codes and error handling
A description of each of the function's parameters. This includes the parameter's mode. The mode of a parameter has three possible values, as described in Table 17-1.
More detailed information about the function (if available). This may include restrictions on the use of the function, or other information that might be useful when using the function in an application.
This optional section describes the possible values that can be returned. It can be found either before or after the Comments section.
A complete or partial code example demonstrating the use of the function call being described. Not all function descriptions include an example.
Unlike earlier versions of the OCI, in and after release 8, you cannot pass -1 for the string length parameter of a
NULL-terminated string. When you pass string lengths as parameters, do not include the
NULL terminator byte in the length. OCI does not expect strings to be
amount parameters in some LOB calls are in characters.
When UTF-16 encoding of text is used in function parameters, the length is in character points.
For a table showing the number of server round-trips required for individual OCI LOB functions, see Appendix C.