|Oracle® Call Interface Programmer's Guide
11g Release 2 (11.2)
Part Number E10646-06
Oracle Call Interface (OCI) is an application programming interface (API) that lets applications written in C or C++ interact with one or more Oracle database servers. OCI gives your programs the capability to perform the full range of database operations that are possible with a Oracle Database, including SQL statement processing and object manipulation.
This guide is intended for programmers developing new applications or converting existing applications to run in the Oracle Database environment. This comprehensive treatment of OCI is also valuable to systems analysts, project managers, and others interested in the development of database applications.
This guide assumes that you have a working knowledge of application programming using C. Readers should also be familiar with the use of structured query language (SQL) to access information in relational database systems. In addition, some sections of this guide assume knowledge of the basic concepts of object-oriented programming.
Oracle Database New Features Guide for information about the differences between the Standard Edition and the Enterprise Edition and all the features and options that are available to you
Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at
Accessibility of Code Examples in Documentation
Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.
Accessibility of Links to External Web Sites in Documentation
This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.
Access to Oracle Support
Oracle customers have access to electronic support through My Oracle Support. For information, visit
http://www.oracle.com/support/contact.html or visit
http://www.oracle.com/accessibility/support.html if you are hearing impaired.
Many of the examples in this book use the sample schemas, which are installed by default when you select the Basic Installation option with an Oracle Database installation. See Oracle Database Sample Schemas for information about how these schemas were created and how you can use them.
To download free release notes, installation documentation, white papers, or other collateral, visit the Oracle Technology Network (OTN). You must register online before using OTN; registration is free and can be done at
If you have a user name and password for OTN, then you can go directly to the documentation section of the OTN Web site at
The Oracle Call Interface Programmer's Guide does not contain all information that describes the features and functionality of OCI in the Oracle Database Standard Edition and Enterprise Edition products. Explore the following documents for additional information about OCI.
Oracle Database Data Cartridge Developer's Guide provides information about cartridge services and OCI calls pertaining to development of data cartridges.
Oracle Database Globalization Support Guide explains OCI calls pertaining to NLS settings and globalization support.
Oracle Streams Advanced Queuing User's Guide supplies information about OCI calls pertaining to Advanced Queuing.
Oracle Database Advanced Application Developer's Guide explains how to use OCI with the XA library.
Oracle Database SecureFiles and Large Objects Developer's Guide provides information about using OCI calls to manipulate LOBs, including code examples.
Oracle Database Object-Relational Developer's Guide offers a detailed explanation of object types.
For additional information about Oracle Database, consult the following documents.
The Oracle C++ Call Interface provides OCI functionality for C++ programs and enables programmers to manipulate database objects of user-defined types as C++ objects. For more information about OCI functionality for C++, see the Oracle C++ Call Interface Programmer's Guide.
The following text conventions are used in this document:
|boldface||Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.|
|italic||Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.|
||Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.|