Sds buildlistのソースを表示

; 構文
: struct sds_resbuf *sds_buildlist (int rtype, ...);


; 機能
: アイテムのリンクリストを作成する。

; 引数
:* rtype : ペアデータ。最初の値は、データタイプ（以下の表参照）。2番目の値は、データ。

; 戻り値
: リストのポインターを返す。それが有効でないばあいはNULLポインターを返す。
: 失敗は、不正なリストか、メモリーリークによることがありえる。


* DXFグループコードが使用されるときは、グループ0 は結果タイプコード RTDXF0 で表現さなければならない。そうでなければ、sds_buildlist はリストが終了されたものとみなす。
* ペアデータには4つの例外がある。
** -3のコードは拡張データ。
** rtlb (リスト開始)。
** rtle (リスト終了)。
** rtdote (ドット・ペア)。
* 各ペアはデータタイプ（例えば RTREAL や RTSTR）とアイテムの値（たとえば99.94 や「アインシュタイン」）が続く。
* 最後のドット・ペアは一組でなく、0（ゼロ）または RTNONE でなければならない。
* リストを使用している場合は、 sds_relrb で使っているリストを解除しなければならない。



{| class="wikitable"
! colspan="2"| データタイプ
|-
! タイプ !! 意味
|-
| RTNONE    || 戻り値無し。  
|-
| RTREAL    || 実数。  
|-
| RTPOINT   || 2D点。（x,y 座標）
|-
| RTSHORT   || 短整数。
|-
| RTANG     || 角度。
|-
| RTSTR     || 文字列。  
|-
| RTENAME   || エンティティ名。  
|-
| RTPICKS   || 選択セット。
|-
| RTORINT   || 角度。
|-
| RT3DPOINT || 3D点 (x,y,z 座標).  
|-
| RTLONG    || 長整数。  
|-
| RTVOID    || ブランクシンボル。  
|-
| RTNIL     || Nil。
|-
| RTDXF0    || DXF code 0.  
|-
| RTT       || T (true) アトム.  
|-
| RTRESBUF  || リザルトバッファリスト。  
|}

以下のタイプはペアにされない。
{| class="wikitable"
! colspan="2"| データタイプ
|-
! タイプ !! 意味
|-
| RTLB || リスト開始。
|-
| RTLE || リスト終了。  
|-
| RTDOTE || ドットペアリスト。  
|-
| RTNONE || リスト終了。  
|}


; サンプル
<pre class="brush: cpp;">
struct sds_resbuf *listbuf = NULL;
listbuf=sds_buildlist(RTREAL,3.57,RTSHORT,12,RTSTR,"My Cat",RTNONE);
sds_retlist(listbuf); 
if(listbuf != NULL)
sds_relrb(listbuf);
</pre>

結果:
 (3.57 12 "My Cat")


-----
関連事項
* [[sds_retlist]]

[[Category:SDS]]