C 编程

为提高应用程序的可移植性，请在 #include 预处理器伪指令上以小写形式对头文件名称进行编码：

#include "cmqec.h"

使用 C typedef 语句定义所有数据类型。 对于每种数据类型，还定义相应的指针数据类型。 指针数据类型的名称是以字母 P（表示指针）为前缀的基本或结构数据类型的名称。 使用 MQPOINTER 宏变量定义指针的属性; 此宏变量的值取决于环境。 下面说明了如何声明指针数据类型:

#define MQPOINTER *                /* depends on environment */
...
typedef MQLONG MQPOINTER PMQLONG;  /* pointer to MQLONG */
typedef MQMD   MQPOINTER PMQMD;    /* pointer to MQMD */

每当复制，比较或设置此类型的字段时，请使用 C 函数 memcpy， memcmp或 memset ; 例如:

#include <string.h>
#include "cmqc.h"

MQMD MyMsgDesc;
 
memcpy(MyMsgDesc.MsgId,           /* set "MsgId" field to nulls    */
       MQMI_NONE,                 /* ...using named constant       */
       sizeof(MyMsgDesc.MsgId));
 
memset(MyMsgDesc.CorrelId,        /* set "CorrelId" field to nulls */
       0x00,                      /* ...using a different method   */
       sizeof(MQBYTE24));

这些宏变量具有 MQxxx_DEFAULT 形式的名称，其中 MQxxx 表示结构的名称。 它们的使用方式如下:

MQMD   MyMsgDesc = {MQMD_DEFAULT};
MQPMO  MyPutOpts = {MQPMO_DEFAULT};

对于某些字符字段 (例如，大多数结构中出现的 StrucId 字段或 MQMD 中出现的 Format 字段) ， MQI 定义了有效的特定值。 对于每个有效值，将提供 两个 宏变量:

• 一个宏变量将值定义为具有长度的字符串，但不包括隐含的空匹配项，这正好是定义的字段长度。 例如，对于 MQMD 中的 Format 字段，提供了以下宏变量 (¬ 表示单个空白字符):

  #define MQFMT_STRING "MQSTR¬¬¬"
  

  将此表单与 memcpy 和 memcmp 函数配合使用。
• 另一个宏变量将值定义为字符数组; 此宏变量的名称是以 _ARRAY 为后缀的字符串格式的名称。 例如：

  #define MQFMT_STRING_ARRAY 'M','Q','S','T','R','¬','¬','¬'
  

  当您声明具有与 MQMD_DEFAULT 宏变量提供的值不同的值的结构实例时，请使用此表单来初始化该字段。 (这并非总是必要的; 在某些环境中，您可以在这两种情况下都使用值的字符串形式。 但是，您可以将数组表单用于声明，因为这是与 C++ 编程语言兼容所必需的。)

当需要可变数量的结构实例时，通常会在使用 calloc 或 malloc 函数动态获取的主存储器中创建这些实例。 要初始化此类结构中的字段，请考虑以下方法:

1. 使用相应的 MQxxx_DEFAULT 宏变量声明结构的实例以初始化该结构。 此实例将成为其他实例的模型:

   MQMD Model = {MQMD_DEFAULT}; /* declare model instance */
   

   可以在声明上对 static 或 auto 关键字进行编码，以便根据需要提供模型实例静态或动态生存期。
2. 使用 calloc 或 malloc 函数来获取结构的动态实例的存储器:

   PMQMD Instance;
   Instance = malloc(sizeof(MQMD)); /* get storage for dynamic instance */
   

3. 使用 memcpy 函数将模型实例复制到动态实例:

   memcpy(Instance,&Model,sizeof(MQMD)); /* initialize dynamic instance */
   

对于 C++ 编程语言，头文件包含仅在使用 C++ 编译器时包含的以下附加语句:

#ifdef __cplusplus
  extern "C" {
#endif

/* rest of header file */

#ifdef __cplusplus
  }
#endif