version 1.5, 1999/12/15 09:24:46 |
version 1.6, 1999/12/22 11:29:15 |
|
|
# 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.4 1999/12/15 08:04:50 ohara Exp $ |
# $OpenXM: OpenXM/src/ox_toolkit/README,v 1.5 1999/12/15 09:24:46 ohara Exp $ |
|
|
/*&ja ox_toolkit ¥æ¡¼¥¶¥¬¥¤¥É |
/*&ja ox_toolkit ¥æ¡¼¥¶¥¬¥¤¥É |
|
|
*/ |
*/ |
/*&en A user's guide for ox_toolkit. |
/*&en A user's guide for OpenXM C library. |
|
|
*/ |
*/ |
/*&ja |
/*&ja |
Line 14 libox.a ¤òÍøÍѤ¹¤ë¤Ë¤Ï¼¡¤Î¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤ò¥¤¥ó¥¯¥ë¡¼¥É |
|
Line 14 libox.a ¤òÍøÍѤ¹¤ë¤Ë¤Ï¼¡¤Î¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤ò¥¤¥ó¥¯¥ë¡¼¥É |
|
/*&en |
/*&en |
How to use OpenXM C library? |
How to use OpenXM C library? |
|
|
The OpenXM C libraiy has header files: |
In order to use libox.a, you need to include the following header files: |
*/ |
*/ |
/*&common |
/*&common |
|
|
Line 35 The OpenXM C libraiy has header files: |
|
Line 35 The OpenXM C libraiy has header files: |
|
1. Types |
1. Types |
|
|
1.1 CMO (Common Math Object) |
1.1 CMO (Common Math Object) |
The following structures is defined in ox.h: |
The following structures are defined in ox.h: |
*/ |
*/ |
/*&common |
/*&common |
|
|
|
|
|
|
*/ |
*/ |
/*&en |
/*&en |
The cmo above is similer to abstract base class; |
The cmo above is abstract base class; |
you never make an object of cmo class. |
you never make an object of cmo class. |
|
|
*/ |
*/ |
Line 75 you never make an object of cmo class. |
|
Line 75 you never make an object of cmo class. |
|
*/ |
*/ |
/*&en |
/*&en |
1.2 OX objects |
1.2 OX objects |
The following structures is defined in ox.h: |
The following structures are defined in ox.h: |
*/ |
*/ |
/*&common |
/*&common |
|
|
Line 101 The ox above is abstract base class. |
|
Line 101 The ox above is abstract base class. |
|
/*&en |
/*&en |
2. How to make CMObjects? |
2. How to make CMObjects? |
|
|
You may use new functions which generate an object and return its pointer. |
Use the following functions to generate an object. |
|
It returns a pointer to the object. |
*/ |
*/ |
/*&common |
/*&common |
|
|
Line 136 new_cmo_error2(cmo* ob); |
|
Line 137 new_cmo_error2(cmo* ob); |
|
/*&en |
/*&en |
3. High-level API |
3. High-level API |
|
|
High-level API is prepared for implementation of your OpenXM clients. |
High-level API is prepared to help an implementation of OpenXM clients. |
|
|
3.1 How to make connection to OpenXM server? |
3.1 How to make connections to OpenXM servers? |
|
|
You may call ox_start or ox_start_insecure_nonreverse. |
In order to open a connection to an OpenXM server, |
|
you need to call ox_start() or to call ox_start_insecure_nonreverse(). |
*/ |
*/ |
/*&common |
/*&common |
|
|
Line 172 portStream ¤Ï·×»»¥µ¡¼¥Ð¤È¤ÎÄÌ¿®¤Î¤¿¤á¤Î¥Ý¡¼¥ÈÈÖ¹æ¤Ç¤¢¤ |
|
Line 174 portStream ¤Ï·×»»¥µ¡¼¥Ð¤È¤ÎÄÌ¿®¤Î¤¿¤á¤Î¥Ý¡¼¥ÈÈÖ¹æ¤Ç¤¢¤ |
|
|
|
*/ |
*/ |
/*&en |
/*&en |
3.2 How to close connection to OpenXM server? |
3.2 How to close connections to OpenXM servers? |
|
|
You may call ox_close or ox_shutdown. |
In order to close a connection to an OpenXM server, |
|
you need to call ox_close() or to call ox_shutdown(). |
|
|
*/ |
*/ |
/*&common |
/*&common |
Line 192 void ox_shutdown(ox_file_t sv); |
|
Line 195 void ox_shutdown(ox_file_t sv); |
|
3.3 SM ¥³¥Þ¥ó¥É¤ÎÁ÷¿® |
3.3 SM ¥³¥Þ¥ó¥É¤ÎÁ÷¿® |
*/ |
*/ |
/*&en |
/*&en |
3.3 How to command to OpenXM stack machine? |
3.3 How to command to OpenXM stack machines? |
*/ |
*/ |
/*&common |
/*&common |
|
|
Line 204 void ox_push_cmd(ox_file_t sv, int sm_code); |
|
Line 207 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. |
Table of opecode is defined in oxtag.h. |
See oxtag.h. |
*/ |
*/ |
/*&ja |
/*&ja |
|
|
Line 244 void ox_execute_string(ox_file_t sv, char* str); |
|
Line 247 void ox_execute_string(ox_file_t sv, char* str); |
|
|
|
3.9 |
3.9 |
|
|
int ox_cmo_rpc(ox_file_t sv, char *function, int argc, cmo *argv[]); |
int ox_cmo_rpc(ox_file_t sv, char *function, int argc, cmo *argv[]); |
|
|
function(argv[1], ...) ¤ò·×»»¤·¡¢·ë²Ì¤ò¥¹¥¿¥Ã¥¯¤ËÀѤࡣ |
function(argv[1], ...) ¤ò·×»»¤·¡¢·ë²Ì¤ò¥¹¥¿¥Ã¥¯¤ËÀѤࡣ |
|
|
Line 284 int decideByteOrderServer(int fd, int order); |
|
Line 287 int decideByteOrderServer(int fd, int order); |
|
(Ãí°Õ) ¥¯¥é¥¤¥¢¥ó¥È¦¤Ç¤Î¥Ð¥¤¥È¥ª¡¼¥À¤ÎÀßÄê¤Ï¡¢¹â¿å½à API ¤Ç¼«Æ°Åª¤Ë¹Ô¤ï¤ì¤ë¡£ |
(Ãí°Õ) ¥¯¥é¥¤¥¢¥ó¥È¦¤Ç¤Î¥Ð¥¤¥È¥ª¡¼¥À¤ÎÀßÄê¤Ï¡¢¹â¿å½à API ¤Ç¼«Æ°Åª¤Ë¹Ô¤ï¤ì¤ë¡£ |
*/ |
*/ |
/*&en |
/*&en |
You must call it when your OpenXM server is initialized. |
You need to call it when your OpenXM server is initialized. |
This function always choose the network byte order for integers. |
This function always choose the network byte order |
|
as an expression for integers. |
*/ |
*/ |
/*&common |
/*&common |
|
|
Line 330 int next_serial(); |
|
Line 334 int next_serial(); |
|
¥·¥ê¥¢¥ë¥Ê¥ó¥Ð¤òÀ¸À®¤¹¤ë¡£ |
¥·¥ê¥¢¥ë¥Ê¥ó¥Ð¤òÀ¸À®¤¹¤ë¡£ |
*/ |
*/ |
/*&en |
/*&en |
next_serial() generates serial number for ox message. |
next_serial() generates a serial number for ox message. |
*/ |
*/ |
/*&common |
/*&common |
|
|
Line 346 fd ¤Ë OX ¥á¥Ã¥»¡¼¥¸¤Î¥Ø¥Ã¥À(tag+serial#)¤ò½ñ¤¹þ¤à¡£¥· |
|
Line 350 fd ¤Ë OX ¥á¥Ã¥»¡¼¥¸¤Î¥Ø¥Ã¥À(tag+serial#)¤ò½ñ¤¹þ¤à¡£¥· |
|
fd ¤«¤é OX ¥á¥Ã¥»¡¼¥¸¤Î¥Ø¥Ã¥À(tag+serial#)¤òÆɤ߹þ¤à¡£ |
fd ¤«¤é OX ¥á¥Ã¥»¡¼¥¸¤Î¥Ø¥Ã¥À(tag+serial#)¤òÆɤ߹þ¤à¡£ |
*/ |
*/ |
/*&en |
/*&en |
send_ox_tag() writes a tag and automatically generated serial number |
send_ox_tag() writes a tag and an automatically generated serial number |
of an ox message to an OpenXM conection. |
of an ox message to an OpenXM conection. |
receive_ox_tag() reads a tag and serial number of an ox message. |
receive_ox_tag() reads a tag and a serial number of an ox message. |
*/ |
*/ |
/*&common |
/*&common |
|
|
Line 361 void send_ox_command(int fd, int sm_command); |
|
Line 365 void send_ox_command(int fd, int sm_command); |
|
*/ |
*/ |
/*&ja |
/*&ja |
ox ¥á¥Ã¥»¡¼¥¸¤òÁ÷¿®¤¹¤ë¡£ |
ox ¥á¥Ã¥»¡¼¥¸¤òÁ÷¿®¤¹¤ë¡£ |
*/ |
|
|
|
|
*/ |
|
|
|
/*&ja |
|
|
|
5. OX expression ¥Ñ¡¼¥µ |
|
|
|
OpenXM C library ¤Ë¤Ï ʸ»úÎóɽ¸½¤µ¤ì¤¿ |
|
OX expression ¤ª¤è¤Ó CMO expression ¤«¤é¡¢ |
|
ox ¹½Â¤ÂΤޤ¿¤Ï cmo ¹½Â¤ÂΤòÀ¸À®¤¹¤ë¤¿¤á¤Î¥Ñ¡¼¥µ¤¬ÉÕ°¤·¤Æ¤¤¤ë¡£ |
|
|
|
¤³¤³¤Ç¤Ï¤³¤Î¥Ñ¡¼¥µ¤Ë¤Ä¤¤¤ÆÀâÌÀ¤¹¤ë¡£ |
|
|
|
int setflag_parse(int flag); |
|
|
|
setflag_parse(PFLAG_ADDREV) ¤Ë¤è¤Ã¤Æ¡¢CMO ¤Îû½Ìɽ¸½¤òµö¤¹¡£ |
|
|
|
int init_parser(char *str); |
|
|
|
¥Ñ¡¼¥µ¤¬½èÍý¤¹¤Ù¤Ê¸»úÎó¤ò¥»¥Ã¥È¤¹¤ë¡£ |
|
|
|
cmo *parse(); |
|
|
|
Lisp ɽ¸½¤Ë¤è¤ë OX expression, CMO expression ¤Î¹½Ê¸²òÀÏ´ï¡£¤¢¤é¤«¤¸¤á |
|
ÀßÄꤵ¤ì¤¿Ê¸»úÎó¤ò²òÀϤ·¤Æ ox ¹½Â¤ÂΡ¢¤¢¤ë¤¤¤Ï cmo ¹½Â¤ÂΤòÀ¸À®¤¹¤ë¡£ |
|
*/ |
|
/*&ja |
|
|
|
7. ÉÕ°¥×¥í¥°¥é¥à¤Ë¤Ä¤¤¤Æ |
|
|
|
testclient |
|
|
|
¥Æ¥¹¥ÈÍѤµ¤Ê OpenXM ¥¯¥é¥¤¥¢¥ó¥È¡£OX expression ¤òÆþÎϤ·¤ÆÁ÷¿®¤¹¤ë |
|
¤³¤È¤Î¤ß²Äǽ¡£SM_popCMO, SM_popString ¤ò´Þ¤à¥á¥Ã¥»¡¼¥¸¤òÁ÷¿®¤·¤¿¾ì¹ç¤Ë |
|
¤Ï¡¢¥µ¡¼¥Ð¤«¤éÁ÷¤é¤ì¤Æ¤¯¤ë¥á¥Ã¥»¡¼¥¸¤òɽ¼¨¤¹¤ë¡£ |
|
|
|
bconv |
|
|
|
¥Ð¥¤¥È¥³¡¼¥É¥¨¥ó¥³¡¼¥À¡£OX expression ¤¢¤ë¤¤¤Ï CMO expression ¤òÆþÎϤ¹ |
|
¤ë¤È¡¢Âбþ¤¹¤ë¥Ð¥¤¥ÈÎó¤òɽ¼¨¤¹¤ë¡£ |
|
|
|
ox_Xsample |
|
|
|
GUI ɽ¼¨¤¹¤ë OpenXM ¥µ¡¼¥Ð¤Î¥µ¥ó¥×¥ë¡£ |
|
|
|
*/ |