cpiSetElementValue

目的

指定したエレメントの値を設定するためのオプションの関数。 これは、構文エレメントの値が設定される際に、ブローカーによって呼び出されます。 ここで、ユーザー定義パーサーには、エレメント値の設定の動作を変更する機会が提供されます。

定義されている場所 タイプ メンバー
CPI_VFT オプション iFpSetElementValue

構文

void cpiSetElementValue(
  CciParser*     parser,
  CciElement*       currentElement,
  CciElementValue*  value);

パラメーター

parser
パーサー・オブジェクトのアドレス (入力)。
currentElement
現行の構文エレメントのアドレス (入力)。
value
値 (入力)。

戻り値

なし。

サンプル

この例は、サンプル・パーサー・ファイル 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 でのパーサーの作成
関連資料
cpiElementValue
C パーサー・インプリメンテーション関数
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as08190_