cpiSetElementNamespace

用途

为指定的语法元素设置“namespace”属性。

在其中定义 类型 成员
CPI_VFT 可选 iFpSetElementValue

语法

void             cpiSetElementNamespace(
  int*                returnCode,
  CciElement*               targetElement,
		const CciChar*  nameSpace);

参数

returnCode
NULL 指针输入表示用户定义的节点不要处理错误。在执行此调用期间别的任何异常都重新抛出到流中的下一个上 行节点。如果输入不是 NULL,则输出表示调用的成功状态。如果执行期间发生异常,则 *returnCode 设置为输出上的 CCI_EXCEPTION。对 CciGetLastExceptionData 的调用将提供异常的详细信息。(输入)。
可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
currentElement
当前语法元素的地址(输入)。
targetElement
指定目标语法元素对象的地址。
value
指定表示名称空间值的以空值终止的 CciChars 字符串的地址。空字符串对名称空间是有效值。事实上,缺省情况下在空字符串名称空间中创建元素,因此通过此 API 指定空字符串作为名称空间仅当该元素先前位于另一个名称空间中时有效,且期望的效果将更改名称空间值为空字符串。

返回值

无。

样本

          /* Convert the attribute value into broker form */
          data = CciNString((char *)startMarker, markedSize, pc->iCcsid);

          /* Create a new name-value element for the attribute */
                  newElement = cpiCreateElement(&rc, parser);
                    cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
                  cpiSetElementName(&rc, newElement, data);
                    cpiSetElementNamespace(&rc, newElement, data);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMESPACEVALUE element;
                                      object=0x%x type=0x%x name=",
                                        newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
            fprintf(pc->tracefile, "%s\n", mbData);
            fflush(pc->tracefile);
                      free((void *)mbData);
          }
                    /* Free the memory created in CciNString() */
                    free((void *)data);
                  /* Add the element */
                    cpiAddAsLastChild(&rc, element, newElement);
相关概念
用户定义的解析器
用户定义的扩展
相关任务
使用 C 创建解析器
相关参考
cpiElementNameSpace
C 解析器实施函数
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as08185_