Home
Client APIs and tools
You can use the HCL Informix® implementation of client APIs to develop applications for Informix database servers.
Informix® Object Interface for C++ Guide
The Informix® Object Interface for C++ Programmer's Guide describes how to develop HCL Informix client applications by using the object-oriented C++ programming language.
Appendixes
This section contains additional reference information.
The ITLocale class
This section describes the ITLocale class, which encapsulates the GLS API.
String processing methods
This section describes the ITLocale methods for processing strings.
The MConcatenate method
This method appends multibyte character string s2 to the end of multibyte character string s1. If the two strings overlap, the results are undefined.

Client APIs and tools
You can use the HCL Informix® implementation of client APIs to develop applications for Informix database servers.
- Change Data Capture API Programmer's Guide
  The Informix® Change Data Capture API Programmer's Guide describes how to program applications to process changed data from HCL Informix databases using the Informix Change Data Capture API.
- Embedded SQLJ for HCL Informix®
  The Informix® Embedded SQLJ User's Guide contains information about using Informix Embedded SQLJ.
- ESQL/C Guide
  The Informix® ESQL/C Programmer's Manual explains how to use Informix ESQL/C, the Informix implementation of Embedded Structured Query Language (SQL) for C (ESQL/C), to create client applications with database-management capabilities.
- GLS User's Guide
  The Informix® GLS User's Guide describes the Global Language Support (GLS) feature available in Informix products.
- API
  The Informix® GLS API Programmer's Guide describes the global language support (GLS) application programming interface (API) available in Informix ESQL/C and HCL Informix DataBlade® modules.
- Informix® Object Interface for C++ Guide
  The Informix® Object Interface for C++ Programmer's Guide describes how to develop HCL Informix client applications by using the object-oriented C++ programming language.
  - Architecture of the object interface for C++
    The encapsulates HCL Informix® database server features into a class hierarchy.
  - Issue database queries and retrieve results
    To interact with a database, your C++ client application uses the operation classes of the . These classes have methods for opening database connections, submitting queries, and manipulating database cursors. This section describes how to use these methods.
  - Access data values
    This section describes the specific value interfaces in detail, and shows how to modify value objects and extract information through the value interfaces into host variables in your application.
  - Create and extend value objects
    When you retrieve values from the HCL Informix® database by using the , the values are returned as value objects. Value objects are created by the Object Interface for C++ by using an extensible class factory that maps Informix data types to C++ objects.
  - Operation class reference
    This section is an alphabetized reference that lists and describes the operation classes. Each class has an assignment operator and a copy constructor, which are not listed in the tables of methods.
  - Value interface reference
    This section lists and describes the value interfaces. The ITFactoryList and ITPreserveData classes provide support for value interfaces.
  - Appendixes
    This section contains additional reference information.
    - Supported data types
      This section lists the server data types and the interfaces supported for them.
    - Example programs
    - The ITLocale class
      This section describes the ITLocale class, which encapsulates the GLS API.
      - Multibyte character string termination
      - Multibyte character termination
      - Memory allocation
      - Access the ITLocale object
      - Error return method
        This method returns a GLS error number.
      - String comparison methods
        This section describes the ITLocale methods for comparing strings.
      - String processing methods
        This section describes the ITLocale methods for processing strings.
        The MConcatenate method
        This method appends multibyte character string s2 to the end of multibyte character string s1. If the two strings overlap, the results are undefined.
        The MScan method
        This method searches for the first occurrence of the multibyte character mchar in the multibyte character string s.
        The MCopy method
        This method copies the multibyte character string from to the location pointed to by to. If from and to overlap, the results of the method are undefined.
        The MComplSpanSize method
        This method returns the number of characters in the longest initial substring of multibyte character string s1 that consists entirely of multibyte characters not in the string s2.
        The MLength method
        This method returns the number of characters (not bytes) in the multibyte character string s, not including the null terminator, if there is one.
        The MFindSubstr method
        This method searches for the first occurrence of the multibyte string s2 in the multibyte string s1.
        The MNConcatenate method
        This method appends one or more multibyte characters in the from multibyte string to the end of the multibyte string to. If from and to overlap, the results of this method are undefined.
        The MNCopy method
        This method copies the specified number of multibyte characters in from to the location pointed to by to.
        The MNTSBytes method
        This method returns the number of bytes in the multibyte character string s, not including any trailing space characters. The characters not included in the count are the ASCII space character and any multibyte characters equivalent to the ASCII space character.
        The MNTSLength method
        This method returns the number of characters in the multibyte character string s, not including any trailing space characters.
        The MSpan method
        This method searches for the first occurrence in the multibyte character string s1 of any character from the multibyte character string s2.
        The MRScan method
        This method locates the last occurrence of multibyte character c in the multibyte character string s.
        The MSpanSize method
        This method returns the number of characters in the longest initial substring of multibyte character string s1 that consists entirely of multibyte characters in the string s2.
        The WConcatenate method
        This method appends a copy of the wide character string from to the end of the wide character string to. If from and to overlap, the results of this method are undefined.
        The WScan method
        This method locates the first occurrence of wide character c in the wide character string s.
        The WCopy method
        This method copies the wide character string from to the location pointed to by to. If the strings overlap, the result is undefined.
        The WComplSpanSize method
        The WLength method
        This method returns the number of wide characters in the wide character string s, not including the null terminator, if there is one. No errors are defined for this method.
        The WNConcatenate method
        This method appends wide character string from to the end of wide character string to. If from and to overlap, the results of this method are undefined.
        The WNCopy method
        This method copies wide character string from to the location pointed to by to. If from and to overlap, the results of this method are undefined.
        The WNTSLength method
        This method returns the number of characters in the wide character string s, not including any trailing space characters.
        The WSpan method
        This method searches for the first occurrence in the wide character string s1 of any wide character from the string s2.
        The WRScan method
        This method locates the last occurrence of wide character c in the wide character string s.
        The WSpanSize method
        This method returns the number of characters in the longest initial substring of the wide character string s1 that consists entirely of characters from the wide character string s2.
        The WFindSubstr method
        This method searches for the first occurrence of the wide character string s2 in the wide character string s1.
      - Environment method
        This topic describes the ITLocale method for determining the client locale.
      - Code set conversion methods
        This section describes the ITLocale methods for converting code sets.
      - Character classification methods
        This section describes the ITLocale methods for classifying characters.
      - Character case conversion methods
        This section describes the ITLocale methods for converting the case of characters.
      - Built-in data type conversion methods
        This section describes the ITLocale methods for converting built-in data types to an internal representation.
      - Multibyte and wide character conversion methods
        This section describes the ITLocale methods for converting characters and character strings between their multibyte and wide character representations.
      - Multibyte string traversal and indexing methods
        This section describes the following ITLocale methods for converting built-in data types to an internal representation.
- Informix® ODBC Driver Guide
  The Informix® ODBC Driver Programmer's Manual serves as a user guide and reference for Informix ODBC Driver, which is the Informix implementation of the Microsoft™ Open Database Connectivity (ODBC) interface, Version 3.0.
- .NET provider options
  The Data Server Provider for .NET DB2® provider option is the preferred Informix® provider for developing new applications.
- Informix 4GL
  This topic provides a link to the documentation.
- Informix® JDBC Driver Guide
  The Informix® JDBC Driver Programmer's Guide describes how to install, load, and use Informix JDBC Driver to connect to the Informix database from within a Java™ application or applet.
- Informix International Language Supplement (ILS) User Guide
  These topics include information about the translated user interface files for Informix® UNIX™ products, locales, and code set conversion tables
- Informix® OLE DB Provider Guide
  The Informix® OLE DB Provider Programmer's Guide describes the software requirements for using Informix OLE DB Provider, show how to install and configure the provider for your use, and explain how to use Informix OLE DB Provider to enable client applications, such as ActiveX Data Object (ADO) applications and web pages, to access data on the Informix server.

The MConcatenate method

This method appends multibyte character string s2 to the end of multibyte character string s1. If the two strings overlap, the results are undefined.

int MConcatenate(char *s1, const char *s2, 
   int nbytes1 = ITLocale::ScanToNul, 
   int nbytes2 = ITLocale::ScanToNul) const

The nbytes1 and nbytes2 parameters specify the length of the s1 and s2 strings. You can provide an integer to specify the number of bytes in the corresponding string. Or you can use the constant ITLocale::ScanToNul (the default) to specify that the corresponding string is null-terminated.

This method returns the length in bytes of the resulting concatenated string, not including the null terminator if there is one.

If there is an error, this method returns -1. Call ITLocale::GetError() to retrieve a specific error message.