cpiFirstChild

目的

指定したターゲット・エレメントの最初の子である構文エレメント・オブジェクトのアドレスを戻します。

構文

CciElement* cpiFirstChild(
  int*               returnCode,
  const CciElement*  targetElement);

パラメーター

returnCode
関数からの戻りコードを受け取ります (出力)。
targetElement
ターゲットの構文エレメント・オブジェクトのアドレスを指定します (入力)。

戻り値

子がなくてゼロが戻される場合以外は、 要求した構文エレメント・オブジェクトのアドレスが戻されます。 エラーが発生した場合は、ゼロ (CCI_NULL_ADDR) が戻され、returnCode がエラーの理由を示します。

サンプル

この例は、サンプル・ノード・ファイル BipSampPluginParser.c から取られています (494 行から 496 行)。

while ((!cpiElementCompleteNext(&rc, element))     &&
           (!cpiFirstChild(&rc, element)) &&
           (pc->iCurrentElement))

関連概念
ユーザー定義のパーサー
ユーザー定義拡張機能

関連タスク
C でのパーサーの作成

関連資料
cpiLastChild
パーサー・ユーティリティー関数