API version 1

- ‐

truncate

配列化したオブジェクトの要素をすべて削除します。

このメソッドは配列オブジェクトのみ付加されます。配列化されていないオブジェクトではこのメソッドは無効です。

個々の配列要素に対してdeleteメソッドを繰り返すよりも高速に動作します。 配列オブジェクトに対してdeleteメソッドを呼び出した場合とは異なり定義は削除されないため、後でinsertメソッドにより配列要素を再び作成することができます。

呼出形式一覧

呼出形式	説明
void truncate()	配列化したオブジェクトの要素をすべて削除します。

戻り値一覧

戻り値	説明
void	なし

例外

なし

使用例

Record arrayRec[5] {
    Number numItem;
    String strItem;
}
arrayRec.truncate();

関連項目

insert メソッド

使用例 CRSダウンロード ダウンロード(Dialog12.crs)

Form Objcntl {
   x = 0;
   y = 0;
   width = 800;
   height = 600;
   TextBox textbox1 {
           x = 100;
           y = 120;
           width = 168;
           height = 48;
   }
   Button button1 {
           x = 100;
           y = 200;
           width = 160;
           height = 48;
           Title = "ユーザー定義イベントを\r\n発生させる" ;

           function onTouch(e) {
                   var eventname = "UserEvent";
                   var userEvent1 =
                           new Event(eventname)  {
                                   String data ;
                           }
                   userEvent1.data.Value = ^.TextBox1.Value;
                   PostEvent(userEvent1) ;
           }
   }

   function OnUserEvent(e) {
           //.MessageBox(e.data.Value) ;
           print("from = ",e.from) ;

           var child = new Number[5];
           child[0] = 5;
           child[1] = 4;
           child[2] = 3;
           child[3] = 2;
           child[4] = 1;
           append(child, "TheArray");
           print("clasName=",child.className) ;
           print("array=",child.isArray," inx= ",child.index," Len= ",child.length);
           print("name=",child.name);
           print("type=",child.subType);
           print("change=",child.useChange);

           var fun = findObject("TheArray", FIND_EVENTPATH);
           if (fun == null) { print("null return") ; } ;
           print("find=",fun);
           for (var i in child) {
                   print(" indx=",i, " value=",child[i].value, "\n");
           }
           child.insert( 0 ) ;
           var ca = getChildObjects();
           for (var j in ca) {
                   if (ca[j] != null) {
                           print("inx= ", j, " value= ",ca[j].value ) ;
                   }
           }
           //.get("dialog12.crs");
           /* child.truncate() ; #このサンプルでは使えません */
   }
}