cniSearchElement 组

搜索前一个指定的元素的兄弟获取与指定的标准相匹配的元素。搜索开始于在 targetElement 参数中指定的语法元素,并且四个函数的每一个都提供对不同树方向的搜索:
  1. cniSearchFirstChild 从第一个子代搜索启动元素的立即子元素,直到找到匹配的子元素或到达子元素链的末端。
  2. cniSearchLastChild 从最后一个子代搜索启动元素的立即子代元素,直到找到匹配的子元素或到达子元素链的末端。
  3. cniSearchNextSiblingInNamespace 从启动元素搜索到下一个兄弟,直到找到匹配的元素或到达兄弟链的末端。
  4. cniSearchPreviousSiblingInNamespace 从启动元素搜索到前一个兄弟,直到找到匹配的元素或到达兄弟链的起始处。

如果您使用此命令在属于名称空间域的消息内搜索元素,则仅在那些名称空间为空字符串的元素上执行搜索。如果您要在任何名称空间中搜索元素,则使用 cniSearchElementNamespace 命令中的一个。

语法

CciElement* cniSearchFirstChild(
    int*                returnCode,
    CciElement*               targetElement,
    CciCompareMode* mode,
    CciElementType  type,
    CciChar         name);
CciElement* cniSearchLastChild(
    int*                returnCode,
    CciElement*               targetElement,
    CciCompareMode* mode,
    CciElementType  type,
    CciChar         name);
CciElement* cniSearchNextSibling(
    int*                returnCode,
    CciElement*               targetElement,
    CciCompareMode* mode,
    CciElementType  type,
    CciChar         name);
CciElement* cniSearchPreviousSibling(
    int*                returnCode,
    CciElement*               targetElement,
    CciCompareMode* mode,
    CciElementType  type,
    CciChar         name);

参数

returnCode
来自函数(输出)的返回码。
可能的返回码是:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
语法元素对象的地址(从此处可以开始搜索)(输入)。
mode
要使用的搜索方式(输入)。这表明要搜索的元素类型和元素名的组合。可能的值为:
  • CCI_COMPARE_MODE_FULL
  • CCI_COMPARE_MODE_FULL_TYPE
  • CCI_COMPARE_MODE_GENERIC_TYPE
  • CCI_COMPARE_MODE_SPECIFIC_TYPE
  • CCI_COMPARE_MODE_NAME
  • CCI_COMPARE_MODE_NAME_SPECIFIC_TYPE
  • CCI_COMPARE_MODE_NAME_GENERIC_TYPE
  • CCI_COMPARE_MODE_NAME_FULL_TYPE
  • CCI_COMPARE_MODE_NULL
type
要搜索(输入)的元素类型。仅当搜索方式涉及与类型有关的匹配时才使用。
name
要搜索(输入)的元素名称。仅当搜索方式涉及与名称有关的匹配时才使用。

示例

  int rc;
    CciElement* firstChild = cniSearchFirstChild(
                                                                                                 &rc,
                                                                              inRootElement,
                                                                              CCI_COMPARE_MODE_NAME,
                                                                                              elementName, 
                                                                       0);

返回值

  • 如果成功,则元素请求的语法元素对象的地址。
  • 如果没有匹配的元素,则返回零。
  • 如果发生错误,则返回零(CCI_NULL_ADDR),并且 returnCode 参数表明错误原因。
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as07740_