[BACK]Return to README CVS log [TXT][DIR] Up to [local] / OpenXM / src / ox_toolkit

Diff for /OpenXM/src/ox_toolkit/README between version 1.7 and 1.10

version 1.7, 2000/01/14 10:23:34 version 1.10, 2000/03/10 12:24:38
Line 1 
Line 1 
 # Author: 小原功任 @ 金沢大学理学部計算科学教室  # Author: 小原功任 @ 金沢大学理学部計算科学教室
 # URI:    http://omega.s.kanazawa-u.ac.jp/ohara/  # URI:    http://omega.s.kanazawa-u.ac.jp/ohara/
 # $OpenXM: OpenXM/src/ox_toolkit/README,v 1.6 1999/12/22 11:29:15 ohara Exp $  # $OpenXM: OpenXM/src/ox_toolkit/README,v 1.9 2000/01/20 17:18:55 ohara Exp $
   
 /*&ja ox_toolkit ユーザガイド  /*&ja ox_toolkit ユーザガイド
   
Line 25  In order to use libox.a, you need to include the follo
Line 25  In order to use libox.a, you need to include the follo
 */  */
 /*&common  /*&common
   
 #include <oxtag.h>  #include <ox_toolkit.h>
 #include <ox.h>  
 #include <parse.h>  
   
 */  */
 /*&ja  /*&ja
Line 42  In order to use libox.a, you need to include the follo
Line 40  In order to use libox.a, you need to include the follo
 1. Types  1. Types
   
 1.1 CMO (Common Math Object)  1.1 CMO (Common Math Object)
 The following structures are defined in ox.h:  The following structures are defined in ox_toolkit.h:
 */  */
 /*&common  /*&common
   
Line 82  class.
Line 80  class.
 */  */
 /*&en  /*&en
 1.2 OX objects  1.2 OX objects
 The following structures are defined in ox.h:  The following structures are defined in ox_toolkit.h:
 */  */
 /*&common  /*&common
   
Line 222  void  ox_push_cmd(ox_file_t sv, int sm_code);
Line 220  void  ox_push_cmd(ox_file_t sv, int sm_code);
 */  */
 /*&en  /*&en
 ox_push_cmd() sends an operation code to an OpenXM stack machine.  ox_push_cmd() sends an operation code to an OpenXM stack machine.
 See OpenXM/src/ox_toolkit/oxtag.h for a list of operation codes.  See OpenXM/include/ox_toolkit_tags.h for a list of operation codes.
   
 */  */
 /*&ja  /*&ja
Line 424  receive_ox_tag() reads a tag and a serial number of an
Line 422  receive_ox_tag() reads a tag and a serial number of an
 */  */
 /*&common  /*&common
   
 4.6  4.6 Sending OX messages.
   
 */  */
 /*&common  /*&common
Line 434  void send_ox_command(int fd, int sm_command);
Line 432  void send_ox_command(int fd, int sm_command);
   
 */  */
 /*&ja  /*&ja
 ox メッセージを送信する。  OX メッセージを送信する。
 */  */
   
 /*&ja  /*&ja
Line 442  ox メッセージを送信する。
Line 440  ox メッセージを送信する。
 5. OX expression パーサ  5. OX expression パーサ
   
 */  */
   /*&en
   
   5. Parser for OX expressions
   
   */
 /*&ja  /*&ja
 OpenXM C library には 文字列表現された  OpenXM C library には 文字列表現された OX expression および CMO
 OX expression および CMO expression から、  expression から、ox 構造体または cmo 構造体を生成するためのパーサが付
 ox 構造体または cmo 構造体を生成するためのパーサが付属している。  属している。ここではこのパーサについて説明する。
   */
   /*&en
   We have a parser which generate an OX object or a CMO from a string
   encoded OX/CMO expression.  In this section, we explain the parser.
   */
   /*&en
   
 ここではこのパーサについて説明する。  5.1 Setting an option
   */
   /*&ja
   
   5.1 オプション
 */  */
 /*&common  /*&common
   
 int setflag_parse(int flag);  int setflag_parse(int flag);
   
 */  */
 /*&ja  /*&ja
 setflag_parse(PFLAG_ADDREV) によって、CMO の短縮表現を許す。  setflag_parse(PFLAG_ADDREV) によって、CMO の短縮表現を許す。
   */
   /*&en
   We set an option for the parser.  If we call
   setflag_parse(PFLAG_ADDREV), then the parser admits external
   expressios.
   */
   /*&en
   
   5.2 Initializing
 */  */
   /*&ja
   
   5.2 初期化
   */
 /*&common  /*&common
   
 int init_parser(char *str);  int init_parser(char *str);
   
 */  */
 /*&ja  /*&ja
 パーサが処理すべき文字列をセットする。  パーサが処理すべき文字列をセットする。
   */
   /*&en
   We give the parser an OX/CMO expression, that is, a Lisp style string.
   */
   /*&en
   
   5.3 Getting an object
 */  */
   /*&ja
   
   5.3 結果を得る
   */
 /*&common  /*&common
   
 cmo *parse();  cmo *parse();
   
 */  */
Line 474  cmo *parse();
Line 511  cmo *parse();
 Lisp 表現による OX expression, CMO expression の構文解析器。あらかじめ  Lisp 表現による OX expression, CMO expression の構文解析器。あらかじめ
 設定された文字列を解析して ox 構造体、あるいは cmo 構造体を生成する。  設定された文字列を解析して ox 構造体、あるいは cmo 構造体を生成する。
 */  */
   /*&en
   The parser returns an OX/CMO object.  If the given string is illegal,
   then the parser returns NULL.
   */
 /*&ja  /*&ja
   
 7. 付属プログラムについて  7. 付属プログラムについて
Line 512  bconv
Line 553  bconv
 A byte code encoder.  It shows a byte stream which corresponds to an  A byte code encoder.  It shows a byte stream which corresponds to an
 OX expression.  OX expression.
   
   */
 /*&common  /*&common
 ox_Xsample  ox_Xsample
   
Line 520  ox_Xsample
Line 562  ox_Xsample
 GUI 表示する OpenXM サーバのサンプル。  GUI 表示する OpenXM サーバのサンプル。
   
 */  */
   /*&ja
   8. 付録
   
   8.1 ox.c における関数の命名規則
   
   (1) receive_cmo 関数はCMOタグとデータ本体を受信する. この関数は CMOタ
   グの値が事前に分からないときに使用する. 返り値として、cmo へのポインタ
   を返す.
   (2) receive_cmo_X 関数は, CMOタグを親の関数で受信してから呼び出される
   関数で、データ本体のみを受信し、cmo_X へのポインタを返す.  しかも、関
   数内部で new_cmo_X 関数を呼び出す.
   (3) send_cmo 関数はCMOタグとデータ本体を送信する.
   (4) send_cmo_X 関数はCMOタグを親の関数で送信してから呼び出される関数で、
   データ本体のみを送信する.
   (5) ただし receive_ox_tag を除いて, receive_ox_X 関数は作らない.
   receive_cmo を利用する.
   (6) send_ox_X 関数は OX タグを含めて送信する.
   (7) ox_X 関数は一連の送受信を含むより抽象的な操作を表現する.  ox_X 関
   数は、第一引数として、ox_file_t型の変数 sv をとる.
   (8) Y_cmo 関数と Y_cmo_X 関数の関係は次の通り:
   まず Y_cmo 関数で cmo のタグを処理し、タグを除いた残りの部分をY_cmo_X
   関数が処理する.  cmo の内部に cmo_Z へのポインタがあるときには、その種
   類によらずに Y_cmo 関数を呼び出す.
   
   */
   
Legend:
Removed from v.1.7  
changed lines
  Added in v.1.10
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>