summaryrefslogtreecommitdiff
path: root/README.EXT
diff options
context:
space:
mode:
authorYukihiro Matsumoto <matz@ruby-lang.org>1997-10-02 17:59:18 +0900
committerTakashi Kokubun <takashikkbn@gmail.com>2019-08-17 22:09:32 +0900
commit10d21745c8c1c3c78678ea7e0b62c0a7433ccfce (patch)
tree4e40254178d66c343cae763029131d959518f795 /README.EXT
parentce930d042913722f209bbd3209b6c90a3c71325f (diff)
version 1.0-971002v1_0_971002
https://cache.ruby-lang.org/pub/ruby/1.0/ruby-1.0-971002.tar.gz Thu Oct 2 17:59:18 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-971002 Wed Oct 1 14:01:49 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * ext/marshal/marshal.c (w_byte): argument must be char. Wed Oct 1 10:30:22 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * ext/marshal/marshal.c (marshal_dump): try to set binmode. * ext/marshal/marshal.c (r_object): forgot to re-regist structs in the object table. * eval.c (ruby_options): call Init_ext() before any require() calls by `-r'. Tue Sep 30 14:51:07 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-970930 Fri Sep 30 14:29:22 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * ext/marshal/marshal.c (w_object): marshal dumped core. Tue Sep 30 10:27:39 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * sample/test.rb: bignum test suits added. Mon Sep 29 13:37:58 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * ruby.c (forbid_setid): forbid some options in suid mode. Mon Sep 27 09:53:48 1997 EGUCHI Matsumoto <eguchi@shizuokanet.or.jp> * bignum.c: modified for speeding. Fri Sep 26 18:27:59 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * sample/from.rb: some extensions. Mon Sep 29 13:15:56 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * parse.y (lhs): no more syntax error on `obj.CONSTANT = value'. Fri Sep 26 14:41:46 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * eval.c (ruby_run): deferred calling Init_ext() just before eval_node. Fri Sep 26 13:27:24 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * io.c (io_isatty): forgot to return TRUE value. Fri Sep 25 11:10:58 1997 EGUCHI Osamu <eguchi@shizuokanet.or.jp> * eval.c: use _setjmp/_longjmp instead of setjmp/longjmp on some platforms. Wed Sep 24 17:43:13 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * string.c (Init_String): String#taint and String#taint? added. Wed Sep 24 00:57:00 1997 Katsuyuki Okabe <HGC02147@niftyserve.or.jp> * X68000 patch. Tue Sep 23 20:42:30 1997 EGUCHI Osamu <eguchi@shizuokanet.or.jp> * parse.y (node_newnode): SEGV on null node setup. Mon Sep 22 11:22:46 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * ruby.c (ruby_prog_init): wrong safe condition check. Sun Sep 21 14:46:02 1997 MAEDA shugo <shugo@po.aianet.ne.jp> * error.c (exc_inspect): garbage added to classpath. Fri Sep 19 11:49:23 1997 <matz@netlab.co.jp> * version 1.0-970919 * parse.y (newtok): forgot to adjust buffer size when shrinking the token buffer. * enum.c (enum_find): rb_eval_cmd() does not return value. * io.c (pipe_open): close fds on pipe exec. fcntl(fd, F_SETFD, 1) no longer used. Tue Sep 16 17:54:25 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * file.c (f_test): problem if wrong command specified. * ruby.c (ruby_prog_init): close stdaux and stdprn for MSDOS. * ruby.c (ruby_prog_init): should not add path from environment variable, if ruby is running under seuid. * process.c (init_ids): check suid check for setuid/seteuid etc. Mon Sep 15 00:42:04 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * regex.c (re_compile_pattern): \w{3} and \W{3} did not work. Thu Sep 11 10:31:48 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-970911 * ext/socket/socket.c (sock_new): no setbuf() for NT. * io.c (rb_fopen,rb_fdopen): set close-on-exec for every fd. Wed Sep 10 15:55:31 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-970910 * ext/marshal/marshal.c (r_bytes0): extra big length check. Tue Sep 9 16:27:14 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * io.c (pipe_fptr_atexit): clean up popen()'ed fptr. * error.c (set_syserr): some system has error code that is bigger than sys_nerr. grrr. Tue Sep 9 16:27:14 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-970909 * error.c (set_syserr): some system has error code that is bigger than sys_nerr. grrr. Wed Sep 3 18:11:00 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-970903 * eval.c (f_load): expand path if fname begins with `~'. Mon Sep 1 13:42:48 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * eval.c (rb_call): alias occured in the module body caused SEGV. Fri Aug 29 11:10:21 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * parse.y (yylex): spaces can follow =begin/=end. * variable.c (find_class_path): look for class_tbl also for unnamed fundamental classes, such as Object, String, etc. * variable.c (rb_name_class): can't name class before String class is initilialized. * inits.c (rb_call_inits): unrecognized dependency from GC to Array. * variable.c (find_class_path): could not find class if Object's iv_tbl is NULL. Thu Aug 28 13:12:05 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * parse.y (yylex): revised `=begin' skip code. * eval.c (is_defined): separated from rb_eval(). Wed Aug 27 11:32:42 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * variable.c (fc_i): some classes/modules does not have iv_tbl. * variable.c (find_class_path): avoid inifinite loop. Tue Aug 26 13:43:47 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * eval.c (rb_eval): undef'ing non-existing method will raise NameError exception. * object.c (class_s_new): needed to create metaclass too. * eval.c (error_print): no class name print for anonymous class. * eval.c (rb_longjmp): proper exception raised if raise() called without arguments, with $! or $@ set. * object.c (Init_Object): superclass()'s method argument setting was wrong again. Mon Aug 25 11:53:11 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * sample/ruby-mode.el (ruby-parse-region): auto-indent now supports "\\" in the strings. * struct.c (struct_getmember): new API to get member value from C language side. Fri Aug 22 14:26:40 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * eval.c (error_print): modified exception print format. Thu Aug 21 16:10:58 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * sample/ruby-mode.el (ruby-calculate-indent): wrong indent level calculated with keyword operators. Thu Aug 21 11:55:41 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-970821 Thu Aug 21 11:36:58 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * parse.y (arg): ary[0] += 1 cause SEGV Wed Aug 20 14:24:42 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-970820 * eval.c (rb_call): infinite loop bug Tue Aug 19 00:15:38 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * version 1.0-970819 * eval.c (rb_call): did not raise ArgumentError if too many arguments more than optional arguments (without rest arg). * eval.c (rb_eval): did not work well for op_asgn2 (attribute self assignment). Mon Aug 18 09:25:56 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * object.c (inspect_i): did not display T_DATA instance variables. * parse.y: provides more accurate line number information. * eval.c (thread_value): include value's backtrace information in the variable `$@'. * eval.c (f_abort): print backtrace and exit. Sat Aug 16 00:17:44 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * object.c (class_s_new): do not make subclass of singleton class. Fri Aug 15 15:49:46 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * eval.c (call_trace_func): block context switch in the trace function. * eval.c (rb_eval): clear method cache at class extention. Fri Aug 15 19:40:43 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * ext/socket/socket.c (Init_socket): small typo caused SEGV. Tue Aug 12 16:02:18 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * variable.c: option variables: $-0, $-p(readonly), $-v, $-I(load_path), $-a(readonly), $-K, $-d, $-F, $-i, $-l. * parse.y (yylex): ignore rd (ruby document) in the code. Mon Aug 11 12:37:58 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * re.c (Init_Regexp): $-K as alias to the $KCODE. * io.c (Init_IO): new virtual variable $-i for the value of -i option. * enum.c (Init_Enumerable): include? as alias of member? Fri Aug 8 11:16:50 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * io.c (io_foreach): now the record separator can be specified. * io.c (io_s_readlines): new method to read in whole file (or command output) from path. * ext/socket/socket.c (Init_socket): recvfrom did not work. * ext/socket/socket.c (sock_send): forgot to check nil for false value. Thu Aug 7 11:40:01 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * object.c (Init_Object): remove private_attr/public_attr. Wed Aug 6 14:21:36 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * object.c (mod_attr): forgot to check nil for false value. Mon Aug 4 11:50:28 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * variable.c (rb_class_path): scan class constants for anonymous classes/modules to make up pathes. Wed Jul 30 08:45:12 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * eval.c (rb_eval): stop to cache const value in nodes. Sat Jul 26 03:17:22 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * numeric.c (flo_to_s): wrong .0 at end. Sat Jul 26 00:36:36 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * eval.c (error_print): always print exception type in the toplevel exception handler. * string.c (str_hash): wrong hash value. Thu Jul 24 11:05:51 1997 Yukihiro Matsumoto <matz@netlab.co.jp> * string.c (uscore_get): proper error message for unset $_. Wed Jul 23 09:56:55 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * object.c (obj_methods): returns list of method names of the specified object. * class.c (mod_instance_methods): returns list of method names of the class instnace. Fri Jul 11 22:38:55 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * object.c (class_superclass): returns class's superclass itself. (1.1) * object.c (obj_type): returns object's class itself. (1.1) * class.c (mod_included_modules): list included modules. * object.c (class_superclass): raises error for Object. Thu Jul 3 09:54:02 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (SETUP_ARGS): save source position, remove nd_line(). * eval.c (rb_call): replace modulo by bit-masking. * eval.c (POP_SCOPE): force recycle scope object to reduce gc rate. * gc.c (obj_free): aboid calling run_final() when no finalizer is set. * eval.c (PUSH_VARS): do not allocate the dynamic scope's end-mark object. Wed Jul 2 14:25:07 1997 KIMURA Koichi <kkimura@pure.cpdc.canon.co.jp> * Native mswin32 support. Tue Jul 1 09:59:00 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970701 * parse.y (mrhs): allow rest-star(*) in right hand side. Tue Jun 24 19:04:31 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970624 Sat Jun 20 22:22:51 1997 Michio "Karl" Jinbo <karl@marcer.nagaokaut.ac.jp> * eval.c: freebsd 3.0 <sys/select.h> support. Fri Jun 20 01:24:45 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970620 * gc.c: eliminate uninitilalized field of Hash, Array etc., to avoid dumping core. Thu Jun 19 01:29:44 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970619 * string.c (str_split_method): wrong limit. Sat Jun 14 01:54:16 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * class.c (rb_singleton_class): no singleton for special constants (now raises exception). * eval.c (ruby_init): cbase in TOPLEVEL_BINDING need to be initialized. Sat Jun 14 01:01:16 1997 maeda shugo <shugo@po.aianet.ne.jp> * array.c (sort_2): wrong comparison. Sat Jun 14 00:53:44 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * hash.c (hash_foreach): safe iteration. Fri Jun 13 14:04:56 1997 Michio "Karl" Jinbo <karl@marcer.nagaokaut.ac.jp> * configure.in: -Bshareable option for netbsd. Fri Jun 13 01:16:22 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * io.c (pipe_open): call io_unbuffered() only for writable pipes. Thu Jun 12 01:14:15 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970612 * ext/socket/socket.c (sock_new): use io_unbuffered(). * ext/marshal/marshal.c (w_long): compact long format, which supports 64 bit architectures (unless longs are >32 bit size). * ext/marshal/marshal.c: allows recursive data for marshaling. * parse.y (rb_intern): raise exception for non-internable string. * ext/marshal/marshal.c (marshal_load): allows direct loading from strings. * ext/marshal/marshal.c (marshal_dump): allows direct dump to strings. * ext/marshal/marshal.c (marshal_dump): interface changed. Wed Jun 11 18:26:00 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * gc.c (rb_newobj): remove needless memset(). Mon Jun 9 13:03:43 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (rb_eval): reduce condition checks from while/until loop. * eval.c (rb_eval): wrong jump point for `next'. Fri Jun 6 11:47:39 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ruby.c (ruby_set_argv): initialize dln_argv0 for dln_a_out. * ext/socket/socket.c (open_unix): display path name for exceptions. * ruby.c (proc_options): option -S did not work well. Fri May 30 02:14:44 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970530 * eval.c (eval): set $! properly if exception raised in eval(). * io.c (io_write): now handles non T_FILE object. * io.c (io_defset): $< can be anything which has `write' method. Thu May 29 15:40:22 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (eval): $@ is always an array (not string). * pack.c (pack_unpack): avoid corrupting memory for unexpected input strings. Wed May 28 12:46:13 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970528 * process.c (rb_waitpid): do not block other threads. Tue May 27 12:02:31 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (ruby_init): split initialize and processing command line options. * ruby.c (ruby_options): ruby_init(0, 0, envp) dumps core. Tue May 20 18:59:45 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * variable.c (rb_ivar_set): invalid instance variable access for built-in object raises TypeError. Fri May 16 17:32:21 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970516 * dir.c (push_globs): was freeing non heap pointer. * gc.c: remove some duplicated prototypes. * ext/kconv/kconv.c: fix prototypes. Fri May 9 11:38:59 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970509 * gc.c (obj_free): avoid free(NULL). * eval.c (rb_check_safe_str): argument missing for TypeError(). Thu May 8 01:14:28 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * file.c (file_s_dirname): need to return "." for path without slashes. Wed May 7 19:18:48 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * process.c (f_fork): child processe does not inherit parent's itimer setting on linux. call setitimer() again in the child process. Sat May 3 02:49:43 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ext/curses/curses.c: modified for portability and add to the standard distribution. Wed Apr 30 00:34:00 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * file.c (file_s_size): returns 0 for empty files (not FALSE). Fri Apr 25 02:17:50 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970425 * eval.c (f_load): free unused name-table. * eval.c (f_load): copy local variable name-table. * gc.c (obj_free): avoid free(NULL). * eval.c (rb_eval): forgot to make link from the scope object to NODE_SCOPE. It may crash the interpreter. Thu Apr 24 00:35:09 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * random.c (f_srand): save old seed anyway. srand() returns no value on some systems. * gc.c (obj_free): avoid double free of the local variable name table. * parse.y (top_local_setup): modify realloc to handle offset. Tue Apr 22 12:58:26 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970422 Thu Apr 17 00:40:51 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * configure.in (rb_cv_bsdpgrp): proper check for BSD setpgrp/setpgrp. Wed Apr 16 16:14:02 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (proc_call): proc called in other thread must be orphan. Tue Apr 15 10:46:31 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970415 * gc.c (obj_free): NODE_SCOPE marked from SCOPE object. * gc.c (gc_mark): some nodes marked wrong. * process.c (proc_getpgrp): wrong argument Fri Apr 14 18:32:42 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970414 Fri Apr 12 01:20:12 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ruby.h: String pointer changed to unsigned char. Fri Apr 11 10:27:29 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970411 * Makefile.in: create libruby.a before linking ruby. * string.c (str_strip_bang): >0x80 characters for isspace(). * eval.c (proc_call): set safe-level temporally * eval.c (proc_s_new): save safe-level in the proc context. * eval.c (rb_eval): no class/module extention in safe mode. Thu Apr 10 02:10:41 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * gc.c (gc_mark): remove some pointer checks for speeding up. * ruby.c (ruby_options): set $0 temporally for -r option. * eval.c: built-in security feature. * gc.c (gc_sweep): do not free nodes during compile. * parse.y (yycompile): set flag when compiling. Wed Apr 9 10:19:02 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ruby.c: forgot to include <ctype.h> for isspace(). * file.c: provide S_ISREG for some platforms. * io.c (Init_IO): added some $< operations. * lib/ping.rb: check host upness using TCP echo. Tue Apr 8 00:10:15 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * io.c (arg_read): bug with 0 length input. Mon Apr 7 11:36:16 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ext/fcntl/fcntl.c: module for fcntl constants. * eval.c (rb_alias): bug when original was an alias. * parse.y (primary): syntax to access singleton class. * eval.c (mod_public_method): method's to specify visibitily of the class methods. make_method_{public,private} removed. Fri Apr 4 21:43:57 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970404 * gc.c (obj_free): finalizer added for experiment. Thu Apr 3 02:12:31 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (thread_schedule): make Fatal rise on main_thread on deadlocks. * eval.c (thread_join): raise ThreadError instead of Fatal, in case of deadlock. * regex.c (re_compile_fastmap): uninitialized local variable. * parse.y (parse_regx): new option //[nes] to specify character code for regexp literals. Last specified code option is valid. * re.c (reg_s_new): addtional 3rd argument to specify compiled regexp's character code. * re.c (reg_new_1): regexp character code can be specified for each regexp object. Wed Apr 2 14:51:06 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (thread_create): handle uncaught throw. * eval.c (thread_create): halt on some deadlock conditions. * regex.c (is_in_list): wrong result for non-mbc higher-byte characters. * regex.c (re_match): wrong skip for multi-byte characters. * regex.c (re_compile_fastmap): wrong fastmap in non-mbc mode. * hash.c (Init_Hash): hash compatible features added to ENV. Tue Apr 1 15:24:06 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (obj_extend): remove Object#extend as an iterator which is in experimental state, since it unveils internal singleton classes. Mon Mar 31 14:29:39 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970331 Sun Mar 30 19:40:57 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * parse.y (terms): avoided win32 gcc's optimization bug. Sat Mar 29 11:21:58 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * struct.c (make_struct): St[val,..] creates new structure. Fri Mar 28 11:24:51 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (obj_make_private): new method make_method_{public,private} to change visibility of singleton methods. * regex.c (re_compile_pattern): enables numeric literal >= 0x80 in the character class. * regex.c (re_compile_pattern): enabled numeric literal >= 0x80, in multibyte mode. * regex.c (re_compile_fastmap): modified exantn and charset(_not) to set fastmap for higher bytes properly. * regex.c (is_in_list): now matches numeric literals. Thu Mar 27 13:34:20 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * pack.c (pack_unpack): extra null byte after unpacked string. Wed Mar 26 15:20:34 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * regex.c (re_compile_pattern): register numbers must be fit in a byte (0 <= regnum <= 0xff). * regex.c (re_compile_fastmap): forgot to set mbchar map for charset_not if RE_MBCTYPE is on. * regex.c (re_compile_pattern): set list bits for multi-byte characters for \W, \S, \D in range expression. * object.c (obj_is_kind_of): defined that nil itself is kind of nil. TRUE is kind of TRUE, FALSE is kind of FALSE likewise. This change makes `obj.kind_of?(eval(obj.type))' always true. Tue Mar 25 14:08:43 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * lib/English.rb: provides nicer English alias for the variables. * parse.y (expr): alias $var1 $var2 makes alias of the global variable. Mon Mar 24 18:23:20 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970324 Thu Mar 20 22:04:59 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (mod_modfunc): forget to clear method cache. Wed Mar 19 17:06:55 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * parse.y (program): set methods' default private/public status correctly under eval(). * eval.c (eval): set the_class correctly while evaluating string. Tue Mar 18 12:23:53 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (eval): yield can be called from eval(). * version 1.0-970318 * parse.y (program): regexp in condition expression should do matching operation with $_. * re.c (reg_regsub): wrong substitution. Fri Mar 14 14:36:28 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * hash.c (hash_invert): returns value to key mapping of the associative array. * ext/socket/extconf.rb: set environment variable SOCKS_SERVER to compile with libsocks.a. * ext/socket/socket.c (socks_s_open): SOCKSsocket class to access internet via SOCKS library. * sprintf.c (f_sprintf): unsigned formats display leading double dots for imaginary sequence of signed bit to the left. * sprintf.c (f_sprintf): correct width and precision formatting for big integers. * parse.y (yylex): enables negative hex/octal numbers and `_' in non-decimal numbers. * sprintf.c (f_sprintf): %u added for unsigned decimal format. Thu Mar 13 10:24:27 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * sprintf.c (f_sprintf): wrong output for bignums. * array.c (ary_reverse_each): iterates in reverse order. * pack.c (pack_unpack): L unpacked signed long. * io.c (f_backquote): now returns an empty string for no output. Wed Mar 12 10:20:30 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ext/socks/socks.c: socket module with socks library. Mon Mar 10 20:44:22 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * re.c (reg_regsub): \& for substitution. \`, \', and \+ are avaiable also. Thu Mar 6 01:47:03 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970306 * sample/rubydb.el (gud): ruby debugger emacs interface * lib/debug.rb: ruby debugger * parse.y (exprs): more accurate line number display. Wed Mar 5 21:31:46 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970305 Tue Mar 4 12:28:32 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ruby.c (proc_options): search through RUBYPATH and PATH for option -S. Mon Mar 3 22:44:55 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (thread_status): returns nil for exception terminated threads. * eval.c (thread_value): re-raise exceptions. Sat Mar 1 00:59:47 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (rb_eval): restore $! value after rescue clause, to re-raise exceptions correctly. Fri Feb 28 16:43:38 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970228 Thu Feb 27 11:23:41 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (rb_yield_0): redo raises exception * eval.c (thread_schedule): bug in interrupt handling by rescue. Wed Feb 26 00:55:36 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (eval): forgot to restore dynamic local variable bindings. Tue Feb 25 11:22:08 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ext/aix_ld.rb: AIX dynamic load support (not tested). * eval.c (rb_eval): wrong return value for defined? super. * error.c (exception): more error check. * re.c (reg_regsub): wrong substitution when sub expanded to null string. Fri Feb 21 13:01:47 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970221 * eval.c (f_require): volatile added. register variable was recycled, so that GC did not mark that variable. * object.c (Init_Object): forget to mark main object (was mostly ok, but made trouble with early GC.) Thu Feb 20 11:50:50 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970220 Thu Feb 20 11:25:50 1997 Yasuo OHBA <jammy@shljapan.co.jp> * lib/date.rb: update Thu Feb 20 08:25:57 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * parse.y (yylex): forgot tokfix() before rb_intern(). * lib/tk.rb (TkVariable): give up using trace_var. Wed Feb 19 00:24:35 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970219 * pack.c (pack_pack): packed by null for A specifier. must be space filled. * pack.c (pack_unpack): bug in skipping spaces * gc.c (xmalloc): garbage collect for every 4 Meg. allocation. * string.c (str_split_method): limit worked wrong way. * io.c (io_gets_method): misunderstand 0xff in binary files when $/ == nil. * re.c (reg_regsub): re-implement. * ext/socket/socket.c (thread_connect): remove O_NONBLOCK, which is not defined on some platform like NeXT. Mon Feb 17 13:08:30 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970217 * object.c (mod_eqq): === extended for subclass check (to use case as typecase). Sat Feb 15 02:07:22 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * regex.c (re_compile_pattern): wrong match backref at end of pattern. * io.c (arg_read): now works beyond end of file. Thu Feb 13 16:21:24 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * parse.y (expr): return/yield now accept normal argument format. * parse.y (yylex): a star in `yield *x' must not be multiplication operator. Wed Feb 12 15:06:44 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * time.c (time_plus): bug in simple addition. * eval.c (thread_raise): raise exceptions from outside. * eval.c (Init_Thread): Thread#alive? -- alias for Thread#status. Mon Feb 10 00:38:55 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * ruby.h (Data_Make_Struct): rename macros. Sun Feb 8 11:48:13 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * io.c (f_syscall): argument offset was wrong. Fri Feb 7 18:01:17 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970207 * eval.c: add volatiles to avoid variable crobbering by longjmp(). * eval.c (f_raise): 1st argument can be the GlobalExit object now. * array.c (ary_unshift): no longer accept more than 2 args. * eval.c (f_raise): bug if 2nd argument is the exception. Tue Feb 4 00:37:29 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970204 * eval.c (eval): check compile errors by nerrs. * eval.c (rb_eval): check syntax error by nerrs, not by the return value, which may be NULL. * eval.c (compile): Do not clear errinfo. Mon Feb 3 10:13:06 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (obj_extend): move real inclusion to Module#extend_object to allow redfinition. * object.c (Init_Object): Kernel class is now Module. Object class became the true root class. * object.c (obj_inspect): remove useless buffer. * hash.c (any_cmp): disable interrupts and context switching. * st.c: remove ALLOW_INTS to disable interrupt during operations. Fri Jan 31 22:10:08 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * hash.c (hash_rehash): re-register all key-value. Thu Jan 30 02:14:49 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * io.c (io_reopen): re-implement according to clone() way. * io.c (io_clone): copy IO object. * struct.c (struct_eql): compare elements by eql?. * io.c (io_mode_flags): detect "rb", "wb" etc. * io.h (FMODE_BINMODE): added. * ext/socket/socket.c (Init_socket): undef BasicSocket.new * file.c (Init_File): File.new(path[,mode]) * io.c (Init_IO): IO.new(fd[,mode]) * eval.c (rb_method_boundp): forgot to enable priv argument. * object.c (Init_Object): remove `=~' from Kernel class. * ext/socket/socket.c (open_inet): initialize sockaddr before calling bind(2). * sample/ruby-mode.el (ruby-calculate-indent): skip comment lines Wed Jan 29 18:43:22 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (Init_Thread): DEFER_INTS during initializing threads. * hash.c (Init_Hash): Hash#eql? checks for object identity. * eval.c (thread_set_critical): wrong value assigned. Mon Jan 27 16:10:51 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * io.c (io_print): remove print_on(). * eval.c (f_missing): proper error message for undefined method without argument Sat Jan 25 23:32:32 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * string.c (str_sub_s): false alert - sub() does not modify string. * array.c (ary_times): negative multiplication detected * string.c (str_times): negative multiplication detected Fri Jan 24 10:51:39 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * time.c (time_arg): month -> 0 == "jan" == "1" == "01", little bit confusing but wanted to conform japanese style. * version 1.0-970124 Fri Jan 24 09:52:49 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * util.c (_fixpath): supports SJIS filenames on DJGPP. Thu Jan 23 16:52:06 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * README.EXT: update. partially translated into English. * ext/extmk.rb.in: inherit $LDFLAGS to the final link. * ext/socket/socket.c (Init_socket): add various constants. Mon Jan 23 11:40:59 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * eval.c (Init_Thread): allocate main_thread first to avoid crash. Thu Jan 23 02:09:26 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * gc.c (ObjectSpace): API modified. each_object method will do all the iteration. * eval.c (proc_call): wrong return from nested lambda. * ext/GD/GD.c: debugged. Wed Jan 22 16:12:25 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970122 * gc.c (gc_mark): forgot to mark match->str. * ext/GD/GD.c: GD interface module. * eval.c (PUSH_BLOCK): wrong value pushed as the block level. Mon Jan 20 14:01:31 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (thread_run): no context switch in the critical section. Mon Jan 20 09:40:59 1997 WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> * utils.c: supports 8+3 filenames Sat Jan 18 01:23:03 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970118 * regex.c (PATFETCH): need cast to unsigned char. * io.c (io_ctl): bug in case when arg is not a string. * lib/tk.rb: forgot that Kernel#type returns the class name now. * regex.c (re_search): "abc\n" =~ "^$" should not match. Fri Jan 17 12:31:37 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970117 * ruby.c (ruby_options): constant PLATFORM, which is in the {cpu}-{os} form, defined. * configure.in: platform infomation embedded in the interpreter. * regex.c (re_search): /^$/ did not match to "" by wrong exit condition. * lib/thread.rb: re-write Mutex/Queue based on Thread.critical. * eval.c (thread_set_critical): remove Thread.exclusive, add Thread.critical = TRUE/FALSE instead. * re.c (reg_search): re-compile pattern if needed * regex.c (PATFETCH): do translate at compile time Thu Jan 16 00:49:10 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * gc.c (gc_mark_frame): forgot to mark frame->cbase. * regex.c (re_compile_pattern): /a$|b)/ causes error. * regex.c (re_compile_pattern): /(^|b)/ causes error. * version 1.0-970116 * re.c (Init_Regexp): set RE_CONTEXTUAL_INVALID_OPS flag. Tue Jan 14 02:09:06 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (proc_call): Proc#callをイテレータとして呼んだ時に対応 * configure.in: nextstep対応? * eval.c (rb_eval): a[b]=cで無駄な配列を割り当てない * eval.c (f_send): イテレータとして呼ばれたらイテレータとしてメソッ ドを呼ぶ. * string.c (str_new4): match共有用の生成関数 * re.c (reg_search): matchの実体(文字列)をマッチを行った文字列と copy-on-writeで共有 * string.c (str_hash): toupperをかける条件が違っていた * array.c (sort_2): FixnumとStringを特別扱いして高速化 Mon Jan 13 11:03:53 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * eval.c (thread_create): threadが生成されるまで割込みを設定しない * eval.c (Init_Thread): 割込みタイミングを100msecに Sat Jan 11 00:17:05 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * regex.c (re_search): マッチに失敗する場合があった(本当に直ったか?) * io.c (io_ioctl,io_fcntl): 第2引数を省略可能に * io.c (io_ioctl,io_fcntl): 戻り値がIOだった.整数(システムコール の戻り値)を返すようにした. * io.c (io_ctl): 引数が整数の時に対応 * io.c (io_fcntl): file.cから移動 Fri Jan 10 17:01:47 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * version 1.0-970110 * ext/socket/socket.c (thread_connect): open(connect(2))で他の threadをブロックしないように * eval.c (thread_create): exitでないときにexitだと思い込む Mon Jan 6 17:42:22 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * string.c (str_sub_s): 文字列長より長いoffsetの検出 * regex.c (re_search): 空にマッチするパターン後の$で失敗 Thu Jan 2 16:36:23 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * file.c (file_reopen): Fileのreopen(pathまたはIOで指定). * io.c (io_reopen): IOのreopen(IOで指定) -- change classつき Wed Jan 1 11:09:01 1997 Yukihiro Matsumoto <matz@caelum.co.jp> * io.c (f_select): timeoutでnilを返す Fri Dec 27 13:06:44 1996 Yukihiro Matsumoto <matz@caelum.co.jp> * file.c (file_s_open): サブクラスではそのクラスのインスタンスを返 すように. Fri Dec 27 08:58:27 1996 ono@isl.nara.sharp.co.jp * numeric.c (flo_to_s): index()を使わない.strstr()に. Thu Dec 26 01:34:17 1996 Yukihiro Matsumoto <matz@caelum.co.jp> * lib/tk.rb: placeが使えるように * pack.c (endian): マクロDYNAMIC_ENDIANを指定すると実行時にendian を判定するように. * eval.c (thread_alloc): 初期化忘れのメンバがあった. Co-authored-by: EGUCHI Matsumoto <eguchi@shizuokanet.or.jp> Co-authored-by: EGUCHI Osamu <eguchi@shizuokanet.or.jp> Co-authored-by: KIMURA Koichi <kkimura@pure.cpdc.canon.co.jp> Co-authored-by: Katsuyuki Okabe <HGC02147@niftyserve.or.jp> Co-authored-by: MAEDA shugo <shugo@po.aianet.ne.jp> Co-authored-by: Michio "Karl" Jinbo <karl@marcer.nagaokaut.ac.jp> Co-authored-by: WATANABE Hirofumi <watanabe@ase.ptg.sony.co.jp> Co-authored-by: Yasuo OHBA <jammy@shljapan.co.jp> Co-authored-by: maeda shugo <shugo@po.aianet.ne.jp> Co-authored-by: ono <ono@isl.nara.sharp.co.jp>
Diffstat (limited to 'README.EXT')
-rw-r--r--README.EXT341
1 files changed, 188 insertions, 153 deletions
diff --git a/README.EXT b/README.EXT
index fdf8c96..c2f81d1 100644
--- a/README.EXT
+++ b/README.EXT
@@ -1,49 +1,50 @@
.\" README.EXT - -*- Text -*- created at: Mon Aug 7 16:45:54 JST 1995
-rubyγĥ⥸塼κޤ
+This document explains how to make extention modules for ruby.
-1μ
+1Basic knowledge
-CѿˤϷꡤǡˤϷޤ󡥤Ǥ顤
-ȤХݥ󥿤intѿȡͤȤƼ
-갷ޤդrubyѿˤϷʤǡ˷
-ΰ㤤ΤᡤCrubyߤѴʤСߤ
-ǡ򥢥Ǥޤ
+In C, variables have types and data do not have types. In contrast,
+ruby variables do not have static type and data themselves have
+types. So, data need to be converted across the languages.
+
+Data in ruby represented C type `VALUE'. Each VALUE data have its
+data-type.
rubyΥǡVALUEȤCηɽޤVALUEΥǡ
ϤΥǡפʬΤäƤޤΥǡפ
Τϥǡ(֥)μºݤι¤̣Ƥơruby
Υ饹ȤϤޤäΤǤ
-VALUECˤȤäựΤǡФˤ
+To retrieve an C data from the VALUE, you need to:
+
+ (1) Identify VALUE's data type
+ (2) Convert VALUE into C data
- (1) VALUEΥǡפΤ
- (2) VALUECΥǡѴ
+Converting to wrong data type may cause serious promblems.
-ξɬפǤ(1)˺ȴְäǡѴԤ
-ơǰץबcore dumpޤ
-1.1 ǡ
+1.1 Data-types
-rubyˤϥ桼ȤǽΤʲΥפޤ
+Ruby interpreter has data-types as below:
T_NIL nil
- T_OBJECT ̾Υ֥
- T_CLASS 饹
- T_MODULE ⥸塼
- T_FLOAT ư
- T_STRING ʸ
- T_REGEXP ɽ
- T_ARRAY
- T_FIXNUM Fixnum(31bitĹ)
- T_HASH Ϣ
- T_STRUCT (ruby)¤
- T_BIGNUM ¿Ĺ
- T_TRUE
- T_FALSE
- T_DATA ǡ
-
-¾ѤƤʲΥפޤ
+ T_OBJECT ordinaly object
+ T_CLASS class
+ T_MODULE module
+ T_FLOAT floating point number
+ T_STRING string
+ T_REGEXP regular expression
+ T_ARRAY array
+ T_FIXNUM Fixnum(31bit integer)
+ T_HASH assosiative array
+ T_STRUCT (ruby) structure
+ T_BIGNUM multi precision integer
+ T_TRUE true
+ T_FALSE false
+ T_DATA data
+
+Otherwise, there are several other types used internally:
T_ICLASS
T_MATCH
@@ -51,41 +52,42 @@ rubyˤϥ桼ȤǽΤʲΥפޤ
T_SCOPE
T_NODE
-ĤΥפCι¤ΤǼƤޤ
+Most of the types are represented by C structures.
-1.2 VALUEΥǡפå
+1.2 Check Data Type of the VALUE
-ruby.hǤTYPE()ȤޥƤơVALUEΥǡ
-פΤ뤳ȤޤTYPE()ޥϾǾҲ𤷤T_XXXX
-η֤ޤVALUEΥǡפ˱ƽ
-ˤϡTYPE()ͤʬ뤳Ȥˤʤޤ
+The macro TYPE() defined in ruby.h shows data-type of the VALUE.
+TYPE() returns the constant number T_XXXX described above. To handle
+data-types, the code will be like:
switch (TYPE(obj)) {
case T_FIXNUM:
- /* FIXNUMν */
+ /* process Fixnum */
break;
case T_STRING:
- /* ʸν */
+ /* process String */
break;
case T_ARRAY:
- /* ν */
+ /* process Array */
break;
default:
- /* 㳰ȯ */
+ /* raise exception */
Fail("not valid value");
break;
}
-ȥǡפåơʤ㳰ȯ
-ؿѰդƤޤ
+There is the data-type check function.
void Check_Type(VALUE value, int type)
-δؿvaluetype̵С㳰ȯޤ
-Ϳ줿VALUEΥǡפɤå
-뤿ˤϡδؿȤޤ
+It raises an exception, if the VALUE does not have the type specified.
+
+There are faster check-macros for fixnums and nil.
+
+ FIXNUM_P(obj)
+ NIL_P(obj)
-1.3 VALUECΥǡѴ
+1.3 Convert VALUE into C data
ǡפT_NIL, T_FALSE, T_TRUEǤǡϤ줾
nil, FALSE, TRUEǤΥǡפΥ֥ȤϤҤ
@@ -119,7 +121,7 @@ rubyι¤Τľܥ˵ĤʤФʤʤ
ʤȤǤľѹ硤֥ȤƤ
Ȥʤʤäơפ̥Хθˤʤޤ
-1.4 CΥǡVALUEѴ
+1.4 Convert C data into VALUE
VALUEμºݤι¤
@@ -151,7 +153,7 @@ FIXNUM˴ؤƤѴޥͳɬפޤC
INT2NUM()FIXNUMϰϤ˼ޤʤ硤BignumѴ
Ƥޤ(٤)
-1.5 rubyΥǡ
+1.5 Manipulate ruby data
Ҥ٤̤ꡤrubyι¤Τ򥢥Ƥι
ԤȤϴޤ󡥤ǡrubyΥǡˤ
@@ -160,39 +162,39 @@ rubyѰդƤؿѤƤ
ǤϤäȤȤǤʸ/
ؿ򤢤ޤ(ǤϤʤǤ)
- ʸФؿ
+ String funtions
str_new(char *ptr, int len)
- rubyʸ롥
+ Creates a new ruby string.
str_new2(char *ptr)
- Cʸ󤫤rubyʸ롥δؿεǽ
- str_new(ptr, strlen(ptr))ƱǤ롥
+ Creates a new ruby string from C string. This is equivalent to
+ str_new(ptr, strlen(ptr)).
str_cat(VALUE str, char *ptr, int len)
- rubyʸstrlenХȤʸptrɲä롥
+ Appends len bytes data from ptr to the ruby string.
- Фؿ
+ Array functions
ary_new()
- Ǥ0롥
+ Creates an array with no element.
ary_new2(int len)
- Ǥ0롥lenʬΰ򤢤餫
- ƤƤ
+ Creates an array with no element, with allocating internal buffer
+ for len elements.
ary_new3(int n, ...)
- ǻꤷnǤޤ롥
+ Creates an n-elements array from arguments.
- ary_new4(int n, VALUE elts[])
+ ary_new4(int n, VALUE *elts)
- ͿnǤ롥
+ Creates an n-elements array from C array.
ary_push(VALUE ary)
ary_pop(VALUE ary, VALUE val)
@@ -200,17 +202,17 @@ rubyѰդƤؿѤƤ
ary_unshift(VALUE ary, VALUE val)
ary_entry(VALUE ary, int idx)
- ArrayƱ̾Υ᥽åɤƱƯ򤹤ؿ1ɬ
- ǤʤФʤʤ
+ Array operations. The first argument to each functions must be an
+ array. They may dump core if other types given.
-2rubyεǽȤ
+2. Extend ruby with C
Ūrubyǽ񤱤뤳ȤCǤ񤱤ޤrubyΤΤCǵ
ҤƤǤ顤ȤʤǤɡ
rubyγĥ˻ȤȤ¿ͽ¬뵡ǽ濴˾
𤷤ޤ
-2.1 ruby˵ǽɲä
+2.1 Add new features to ruby
ruby󶡤ƤؿȤruby󥿥ץ꥿˿ǽ
ɲä뤳ȤǤޤrubyǤϰʲεǽɲäؿ
@@ -222,25 +224,25 @@ ruby󶡤ƤؿȤruby󥿥ץ꥿˿ǽ
ǤϽ˾Ҳ𤷤ޤ
-2.1.1 饹/⥸塼
+2.1.1 Class/module definition
饹⥸塼뤿ˤϡʲδؿȤޤ
VALUE rb_define_class(char *name, VALUE super)
- VALUE rb_define_module(char *name)
+ VALUE rb_define_module(char *name)
δؿϿ줿饹⥸塼֤ޤ
᥽åɤˤͤɬפʤΤǡۤȤɤξ
ͤѿ˳ǼƤɬפǤ礦
-2.1.2 ᥽å/ðۥ᥽å
+2.1.2 Method/singleton method definition
᥽åɤðۥ᥽åɤˤϰʲδؿȤޤ
void rb_define_method(VALUE class, char *name,
VALUE (*func)(), int argc)
- void rb_define_sigleton_method(VALUE object, char *name,
+ void rb_define_singleton_method(VALUE object, char *name,
VALUE (*func)(), int argc)
@@ -282,10 +284,16 @@ private᥽åɤȤϴؿǤƤӽФȤνʤ᥽
ȤǤȤޤ⥸塼ؿؿϰʲ
̤Ǥ
- void rb_define_module_method(VALUE module, char *name,
- VALUE (*func)(), int argc)
+ void rb_define_module_function(VALUE module, char *name,
+ VALUE (*func)(), int argc)
+
+ؿŪ᥽å(Kernel⥸塼privaet method)뤿
+δؿϰʲ̤Ǥ
+
+ void rb_define_global_function(char *name, VALUE (*func)(), int argc)
+
-2.1.3
+2.1.3 Constant definition
ĥ⥸塼뤬ɬפϤ餫Ƥɤ
Ǥ礦ؿĤޤ
@@ -296,7 +304,7 @@ private᥽åɤȤϴؿǤƤӽФȤνʤ᥽
ԤΥ饹/⥸塼°Ρ
ԤϥХΤǤ
-2.2 rubyεǽCƤӽФ
+2.2 Use ruby features from C
ˡ1.5 rubyΥǡ٤ǰҲ𤷤褦ʴؿ
ȤСrubyεǽ¸ƤؿľܸƤӽФȤ
@@ -315,9 +323,9 @@ CrubyεǽƤӽФäȤñˡȤơʸ
VALUE rb_eval_string(char *str)
ɾϸߤδĶǹԤޤĤޤꡤߤΥѿ
-selfʤɤѤޤ
+ʤɤѤޤ
-2.2.2 IDޤϥܥ
+2.2.2 ID or Symbol
CʸͳrubyΥ᥽åɤƤӽФȤǤ
ˡruby󥿥ץ꥿ǥ᥽åɤѿ̾ꤹ
@@ -331,9 +339,10 @@ IDȤѿ̾᥽å̾ɽǤrubyǤ
rb_intern(char *name)
-Ȥޤ
+Ȥޤޤʸα黻ҤϤʸɤΤޤޥ
+ܥˤʤäƤޤ
-2.2.3 CrubyΥ᥽åɤƤӽФ
+2.2.3 Invoke ruby method from C
CʸͳrubyΥ᥽åɤƤӽФˤϰʲ
δؿȤޤ
@@ -353,7 +362,7 @@ CؿȤäƻȡǤΤϡ饹󥹥
Ǥ
VALUE rb_ivar_get(VALUE obj, ID id)
- VALUE rb_ivar_get(VALUE obj, ID id, VALUE val)
+ VALUE rb_ivar_set(VALUE obj, ID id, VALUE val)
idrb_intern()ΤȤäƤ
@@ -364,24 +373,24 @@ idrb_intern()ΤȤäƤ
饹򿷤뤿ˤϡ2.1.3 ٤ǾҲ
ƤؿȤäƤ
-3rubyCȤξͭ
+3. Informatin sharing between ruby and C
Crubyδ֤ǾͭˡˤĤƲ⤷ޤ
-3.1 C黲ȤǤruby
+3.1 Ruby constant that C黲ȤǤruby
-ʲrubyCΥ٥뤫黲ȤǤ롥
+Following ruby constants can be referred from C.
TRUE
FALSE
-͡FALSECǤ⵶Ȥߤʤ롥
+Boolean values. FALSE is false in the C also (i.e. 0).
Qnil
-C줫鸫nilס
+Ruby nil in C scope.
-3.2 CrubyǶͭѿ
+3.2 Global variables shared between C and ruby
CrubyѿȤäƾͭǤޤͭǤ
ѿˤϤĤμबޤΤʤǤäȤɤȤ
@@ -399,18 +408,18 @@ CrubyѿȤäƾͭǤޤͭǤ
void rb_define_readonly_variable(char *name, VALUE *var)
ѿ¾hookĤѿǤޤhookդ
-ѿϰʲδؿѤޤ
+ѿϰʲδؿѤޤhookդѿ
+ͤλȤhookǹԤɬפޤ
void rb_define_hooked_variable(char *name, VALUE *var,
VALUE (*getter)(), VALUE (*setter)())
δؿCδؿˤähookΤĤ줿ѿ
ѿȤ줿ˤϴؿgetterѿͤåȤ
-ˤϴؿsetterƤФޤhookꤷʤgetter
-setter0ꤷƤ
+ˤϴؿsetterƤФ롥hookꤷʤgetter
+setter0ꤷޤ
-# gettersetter0ʤrb_define_variable()ƱƯ
-# ޤ
+# gettersetter0ʤrb_define_variable()Ʊˤʤ롥
줫顤CδؿˤäƼ¸rubyѿ
ؿޤ
@@ -421,7 +430,12 @@ CrubyѿȤäƾͭǤޤͭǤ
δؿˤä줿rubyѿȤ줿ˤ
getterѿͤåȤ줿ˤsetterƤФޤ
-3.3 CΥǡruby֥Ȥˤ
+The prototypes of the getter and setter functions are as following:
+
+ (*getter)(ID id, void *data, struct global_entry* entry);
+ (*setter)(VALUE val, ID id, void *data, struct global_entry* entry);
+
+3.3 Encapsulate C data into ruby object
C줿ǡ(¤)rubyΥ֥ȤȤ
갷礬ꤨޤΤ褦ʾˤϡDataȤ
@@ -431,41 +445,48 @@ ruby֥ȤCι¤(ؤΥݥ)򤯤ळȤruby
Data֥Ȥƹ¤Τruby֥Ȥ˥ץ
뤿ˤϡʲΥޥȤޤ
- Make_Data_Struct(class, type, mark, free, sval)
+ Data_Wrap_Struct(class,mark,free,ptr)
+
+Υޥͤ줿Data֥ȤǤ
-classϿ륤󥹥󥹤Υ饹type
-ץ벽CΥǡη(¤)ǤmarkϤι¤Τ
-rubyΥ֥ȤؤλȤ˻ȤؿǤΤ褦
-Ȥޤޤʤˤ0ꤷޤfreeϤι¤Τ⤦
-פˤʤä˸ƤФؿǤδؿ١쥯
-ƤФޤsvaltypeѿǡMake_Data_Struct
-Ȥޤ
+classϤData֥ȤΥ饹Ǥptrϥץ벽
+Cι¤ΤؤΥݥ󥿤ǤmarkϤι¤ΤrubyΥ֥
+ȤؤλȤ˻ȤؿǤΤ褦ʻȤޤޤʤ
+ˤ0ꤷޤ
-ޥMake_Data_StructData֥Ȥơ
-Ȥ֤ޤ
+# Τ褦ʻȤϴޤ
-ΥޥƤӽФsval˹¤Τmalloc()졤
-Ĥι¤Τ򥫥ץ벽Data֥Ȥ󥹥
-ѿȤobj˥åȤޤ
+freeϤι¤Τ⤦פˤʤä˸ƤФؿǤ
+ؿ١쥯ƤФޤ
-Data֥ȤCݥ󥿤ФˤϰʲΥޥ
-Ȥޤ
+Cι¤ΤγData֥ȤƱ˹Ԥޥ
+ưʲΤΤ󶡤Ƥޤ
- Get_Data_Struct(obj, type, sval)
+ Data_Make_Struct(class, type, mark, free, sval)
-Data֥ȤtypeCݥ󥿤Фơsval
+Υޥͤ줿Data֥ȤǤ
+
+class, mark, freeData_Wrap_StructƱƯ򤷤ޤtype
+ϳƤC¤ΤηǤƤ줿¤Τѿsval
+ޤѿη (type*) Ǥɬפޤ
+
+Data֥Ȥݥ󥿤ФΤϰʲΥޥѤ
+
+ Data_Get_Struct(obj, type, sval)
+
+Cι¤ΤؤΥݥ󥿤ѿsvalޤ
DataλȤϤäʬˤΤǡ
򻲾ȤƤ
-4 - dbmѥå
+4Example - Create dbm module
ޤǤǤȤꤢĥ⥸塼ϺϤǤ
rubyextǥ쥯ȥˤǤ˴ޤޤƤdbm⥸塼
ʳŪޤ
-(1) ǥ쥯ȥ
+(1) make the directory
% mkdir ext/dbm
@@ -473,7 +494,7 @@ rubyŸǥ쥯ȥβextǥ쥯ȥ˳ĥ
塼ѤΥǥ쥯ȥޤ̾Ŭǹ
-(2) MANIFESTե
+(2) create MANIFEST file
% cd ext/dbm
% touch MANIFEST
@@ -485,14 +506,14 @@ rubyŸǥ쥯ȥβextǥ쥯ȥ˳ĥ
MANIFESTȤեϡmakeλ˥ǥ쥯ȥ꤬ĥ⥸塼
ޤǤ뤫ɤȽꤹ뤿˻ȤƤޤ
-(3) ߷פ
+(3) design the library
ޤʤǤɡɤǽ¸뤫ɤޤ
פɬפޤɤʥ饹Ĥ뤫Υ饹ˤ
ɤʥ᥽åɤ뤫饹󶡤ʤɤˤĤ߷
ޤdbm饹ˤĤƤext/dbm.doc򻲾ȤƤ
-(4) Cɤ
+(4) write C code.
ĥ⥸塼ΤȤʤCΥ񤭤ޤCΥ
ҤȤĤλˤϡ֥⥸塼̾.cפ֤ɤǤ礦C
@@ -522,34 +543,45 @@ Init_dbm()
/* DBM饹Υ᥽å[]: 1 */
rb_define_method(cDBM, "[]", fdbm_fetch, 1);
:
+
+ /* DBMǡǼ륤󥹥ѿ̾ΤID */
+ id_dbm = rb_intern("dbm");
}
--
DBM⥸塼dbmΥǡб륪֥ȤˤʤϤ
顤Cdbmruby˼ɬפޤ
-dbm.cǤDBMΥǡǼ뤿˰ʲΤ褦ʹ¤ΤȤ
-Ƥޤ
+dbm.cǤData_Make_StructʲΤ褦˻ȤäƤޤ
+
+--
struct dbmdata {
int di_size;
DBM *di_dbm;
};
-RubyDBM֥Ȥ뤿ˤϰʲΤ褦ʥɤ
-ȤäƤޤ
- obj = Make_Data_Struct(class,struct dbmdata,0,free_dbm,dbmp);
- dbmp->di_dbm = dbm;
- dbmp->di_size = -1;
+obj = Data_Make_Struct(class,struct dbmdata,0,free_dbm,dbmp);
+--
+
+Ǥdbmstruct¤ΤؤΥݥ󥿤Data˥ץ벽Ƥ
+ޤDBM*ľܥץ벽ʤΤclose()ν
+ƤΤȤǤ
-DBM֥ȤCDBMݥ󥿤ФˤϰʲΤ
-ʥޥȤäƤޤ
+Data֥Ȥdbmstruct¤ΤΥݥ󥿤Ф
+˰ʲΥޥȤäƤޤ
+--
#define GetDBM(obj, dbmp) {\
- Get_Data_Struct(obj, struct dbmdata, dbmp);\
- if (dbmp->di_dbm == 0) closeddbm();\
+ Data_Get_Struct(obj, struct dbmdata, dbmp);\
+ if (dbmp->di_dbm == 0) closed_dbm();\
}
+--
+
+äʣʥޥǤפdbmdata¤ΤΥݥ
+μФȡcloseƤ뤫ɤΥåޤȤƤ
DBM饹ˤϤ᥽åɤޤʬह3
μޤҤȤĤϰοΤΤǡ
@@ -623,12 +655,11 @@ fdbm_indexes(obj, args)
rubyȶͭϤʤrubyΥ֥ȤǼǽΤ
CѿϰʲδؿȤäruby󥿥ץ꥿ѿ¸
-򶵤ƤƤǤʤGCǥȥ֥򵯤ǽ
+򶵤ƤƤǤʤGCǥȥ֥򵯤ޤ
void rb_global_variable(VALUE *var)
-(5) extconf.rbѰդ
+(5) prepare extconf.rb
⤷ǥ쥯ȥˡextconf.rbפȤե뤬¸ߤС
make˼¹ԤޤʤŬMakefileޤ
@@ -642,10 +673,16 @@ extconf.rbϥ⥸塼ΥѥɬפʾΥåʤ
have_header(header): إåե¸ߥå
create_makefile(target): Makefile
+ʲѿȤȤǤޤ
+
+ $CFLAGS: ѥɲŪ˻ꤹե饰(-Iʤ)
+ $LDFLAGS: 󥯻ɲŪ˻ꤹե饰(-Lʤ)
+
⥸塼򥳥ѥ뤹郎·ʤΥ⥸塼ϥ
-ѥ뤷ʤˤcreate_makefileƤФʤɤ
+ѥ뤷ʤˤcreate_makefileƤФʤMakefile
+줺ѥԤޤ
-(6) dependѰդ
+(6) prepare depend (optional)
⤷ǥ쥯ȥdependȤե뤬¸ߤС
Makefile¸طåƤޤ
@@ -661,25 +698,24 @@ Makefile¸طåƤޤ
*.o, *~ʤɬפʥեʳMANIFESTɲäƤޤ
makeˤMANIFESTƤϻȤޤΤǡΤޤޤǤ
-ϵʤǤɡѥå󥰤λ˻Ȥ뤳Ȥ
-ɬפʥե̤ǤǡѰդƤɤ
-礦
+ϵޤ󤬡ѥå󥰤λ˻Ȥ뤳ȤΤȡ
+ɬפʥե̤ǤΤǡѰդƤɤǤ
+
-(8) make
+(8) make
-rubyΥǥ쥯ȥmake¹ԤMakefileƤ
-Makefileгĥ⥸塼Υǥ쥯ȥ
-make뤳ȤǤޤextconf.rb񤭴ʤɤ
-MakefileκɬפʻϤޤrubyǥ쥯ȥmakeƤ
-
+rubyΥǥ쥯ȥmake¹ԤMakefilemake
+ɬפˤäƤϤΥ⥸塼rubyؤΥ󥯤ޤǼưŪ˼¹
+Ƥޤextconf.rb񤭴ʤɤMakefileκ
+ɬפʻϤޤrubyǥ쥯ȥmakeƤ
-(9) ǥХå
+(9) debug
ޤǥХåʤưʤǤ礦͡ext/Setup˥ǥ
ȥ̾񤯤Ū˥󥯤ΤǥǥХåȤ褦ˤ
ޤʬѥ뤬٤ʤޤɡ
-(10) Ǥ
+(10) done, now you have the extension module
ϤäȤʤꡤʤꡤʤꡤͳˤ
ȤrubyκԤϳĥ⥸塼˴ؤưڤθ
@@ -692,7 +728,7 @@ rubyΥϤĤʬह뤳ȤޤΤ
ƤޤΥϺޤǤǤۤȤǤ
פޤ
-rubyΥ
+coore ruby language
class.c
error.c
@@ -702,7 +738,7 @@ rubyΥ
parse.y
variable.c
-桼ƥƥؿ
+utility functions
dln.c
fnmatch.c
@@ -711,7 +747,7 @@ rubyΥ
st.c
util.c
-rubyޥɤμ
+ruby interpreter implementation
dmyext.c
inits.c
@@ -719,7 +755,7 @@ rubyޥɤμ
ruby.c
version.c
-饹饤֥
+class library
array.c
bignum.c
@@ -755,23 +791,23 @@ ruby֥Ȥɽ뷿ɬפ˱ƥ㥹ȤѤ롥
ΤǤ롥VALUE򤳤˥㥹Ȥ뤿RǻϤޤ빽¤
̾ʸˤ̾ΥޥѰդƤ롥
-** ѿ
+** Variables and constants
Qnil
-: nil֥
+const: nil object
TRUE
-: TRUE֥(Υǥե)
+const: TRUE object(default true value)
FALSE
-: FALSE֥
+const: FALSE object
** CǡΥץ벽
- VALUE data_new(void *sval, void (*mark)(), void (*free)())
+ Data_Wrap_Struct(VALUE class, void (*mark)(), void (*free)(), void *sval)
CǤդΥݥ󥿤򥫥ץ벽ruby֥Ȥ֤
Υݥ󥿤ruby饢ʤʤäfreeǻꤷ
@@ -779,15 +815,14 @@ CǤդΥݥ󥿤򥫥ץ벽ruby֥Ȥ֤
ȤؤƤ硤mark˻ꤹؿǥޡɬ
- Make_Data_Struct(obj, iv, type, mark, free, sval)
+ Data_Make_Struct(class, type, mark, free, sval)
typeΥmallocѿsval塤򥫥ץ
-벽ǡobjΥ󥹥ѿivޥ
+벽ǡ֤ޥ
- Get_Data_Struct(obj, iv, type, sval)
+ Data_Get_Struct(data, type, sval)
-objΥ󥹥ѿivؤǡtypeΥݥ󥿤
-Фѿsvalޥ
+datatypeΥݥ󥿤Фѿsvalޥ
** 饹/⥸塼