cpiAddAsFirstChild

目的

将新的(和当前不连接的)语法元素添加到语法元素树,作为指定的目标元素的第一个子代。

语法

void cpiAddAsFirstChild(
  int*                returnCode,
  CciElement*               targetElement,
CciElement*  newElement);

参数

returnCode
接收来自函数(输出)的返回码。可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
指定目标语法元素对象(输入)的地址。
newElement
指定要添加到树结构的新语法元素对象的地址(输入)。

返回值

无。 如果发生错误,则 returnCode 表明错误原因。

样本

此示例取自样本解析器文件 BipSampPluginParser.c(675 到 698 行):

void cpiSetElementValue(
  CciParser*  parser,
  CciElement*      element,
  CciElementValue* value
){
  CciElement*        newElement;
  int             rc;
  if ((cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_VALUE) ||
      (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME_VALUE))  {
    cpiSetElementValueValue(&rc, element, value);
}
  else if (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME) {
    /* Create a new value element, add as a first child, and set the value */
        newElement = cpiCreateElement(&rc, parser);
    cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_VALUE);
    cpiSetElementValueValue(&rc, newElement, value);
    cpiAddAsFirstChild(&rc, element, newElement);
}
else {
}
  return;
}
相关概念
用户定义的解析器
用户定义的扩展
相关任务
使用 C 创建解析器
相关参考
cpiAddAsLastChild
C 解析器实用程序函数
声明 | 商标 | 下载 | | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后更新:2006/05/19
as08370_