1 /* vi:set ts=8 sts=4 sw=4 noet: 2 * 3 * VIM - Vi IMproved by Bram Moolenaar 4 * 5 * Ruby interface by Shugo Maeda 6 * with improvements by SegPhault (Ryan Paul) 7 * with improvements by Jon Maken 8 * 9 * Do ":help uganda" in Vim to read copying and usage conditions. 10 * Do ":help credits" in Vim to see a list of people who contributed. 11 * See README.txt for an overview of the Vim source code. 12 */ 13 14 #include "protodef.h" 15 #ifdef HAVE_CONFIG_H 16 # include "auto/config.h" 17 #endif 18 19 #include <stdio.h> 20 #include <string.h> 21 22 #ifdef _WIN32 23 # if !defined(DYNAMIC_RUBY) || (RUBY_VERSION < 18) 24 # define NT 25 # endif 26 # ifndef DYNAMIC_RUBY 27 # define IMPORT // For static dll usage __declspec(dllimport) 28 # define RUBYEXTERN __declspec(dllimport) 29 # endif 30 #endif 31 #ifndef RUBYEXTERN 32 # define RUBYEXTERN extern 33 #endif 34 35 #if defined(DYNAMIC_RUBY) && RUBY_VERSION >= 24 36 # define USE_RUBY_INTEGER 37 #endif 38 39 #ifdef DYNAMIC_RUBY 40 /* 41 * This is tricky. In ruby.h there is (inline) function rb_class_of() 42 * definition. This function use these variables. But we want function to 43 * use dll_* variables. 44 */ 45 # define rb_cFalseClass (*dll_rb_cFalseClass) 46 # define rb_cFixnum (*dll_rb_cFixnum) 47 # if defined(USE_RUBY_INTEGER) 48 # define rb_cInteger (*dll_rb_cInteger) 49 # endif 50 # if RUBY_VERSION >= 20 51 # define rb_cFloat (*dll_rb_cFloat) 52 # endif 53 # define rb_cNilClass (*dll_rb_cNilClass) 54 # define rb_cString (*dll_rb_cString) 55 # define rb_cSymbol (*dll_rb_cSymbol) 56 # define rb_cTrueClass (*dll_rb_cTrueClass) 57 # if RUBY_VERSION >= 18 58 /* 59 * On ver 1.8, all Ruby functions are exported with "__declspec(dllimport)" 60 * in ruby.h. But it causes trouble for these variables, because it is 61 * defined in this file. When defined this RUBY_EXPORT it modified to 62 * "extern" and be able to avoid this problem. 63 */ 64 # define RUBY_EXPORT 65 # endif 66 67 #endif // ifdef DYNAMIC_RUBY 68 69 // suggested by Ariya Mizutani 70 #if (_MSC_VER == 1200) 71 # undef _WIN32_WINNT 72 #endif 73 74 #if defined(DYNAMIC_RUBY) && RUBY_VERSION >= 19 75 // Ruby 1.9 defines a number of static functions which use rb_num2long and 76 // rb_int2big 77 # define rb_num2long rb_num2long_stub 78 # define rb_int2big rb_int2big_stub 79 #endif 80 81 #if defined(DYNAMIC_RUBY) && RUBY_VERSION >= 19 \ 82 && VIM_SIZEOF_INT < VIM_SIZEOF_LONG 83 // Ruby 1.9 defines a number of static functions which use rb_fix2int and 84 // rb_num2int if VIM_SIZEOF_INT < VIM_SIZEOF_LONG (64bit) 85 # define rb_fix2int rb_fix2int_stub 86 # define rb_num2int rb_num2int_stub 87 #endif 88 89 #if defined(DYNAMIC_RUBY) && RUBY_VERSION == 21 90 // Ruby 2.1 adds new GC called RGenGC and RARRAY_PTR uses 91 // rb_gc_writebarrier_unprotect_promoted if USE_RGENGC 92 # define rb_gc_writebarrier_unprotect_promoted rb_gc_writebarrier_unprotect_promoted_stub 93 #endif 94 #if defined(DYNAMIC_RUBY) && RUBY_VERSION >= 22 95 # define rb_gc_writebarrier_unprotect rb_gc_writebarrier_unprotect_stub 96 #endif 97 98 #if defined(DYNAMIC_RUBY) && RUBY_VERSION >= 26 99 # define rb_ary_detransient rb_ary_detransient_stub 100 #endif 101 102 // On macOS pre-installed Ruby defines "SIZEOF_TIME_T" as "SIZEOF_LONG" so it 103 // conflicts with the definition in config.h then causes a macro-redefined 104 // warning. 105 #ifdef SIZEOF_TIME_T 106 # undef SIZEOF_TIME_T 107 #endif 108 109 #include <ruby.h> 110 #if RUBY_VERSION >= 19 111 # include <ruby/encoding.h> 112 #endif 113 #if RUBY_VERSION <= 18 114 # include <st.h> // for ST_STOP and ST_CONTINUE 115 #endif 116 117 // See above. 118 #ifdef SIZEOF_TIME_T 119 # undef SIZEOF_TIME_T 120 #endif 121 122 #undef off_t // ruby defines off_t as _int64, Mingw uses long 123 #undef EXTERN 124 #undef _ 125 126 // T_DATA defined both by Ruby and Mac header files, hack around it... 127 #if defined(MACOS_X) 128 # define __OPENTRANSPORT__ 129 # define __OPENTRANSPORTPROTOCOL__ 130 # define __OPENTRANSPORTPROVIDERS__ 131 #endif 132 133 /* 134 * The TypedData_XXX macro family can be used since Ruby 1.9.2 but 135 * rb_data_type_t changed in 1.9.3, therefore require at least 2.0. 136 * The old Data_XXX macro family was deprecated on Ruby 2.2. 137 * Use TypedData_XXX if available. 138 */ 139 #if defined(TypedData_Wrap_Struct) && (RUBY_VERSION >= 20) 140 # define USE_TYPEDDATA 1 141 #endif 142 143 /* 144 * Backward compatibility for Ruby 1.8 and earlier. 145 * Ruby 1.9 does not provide STR2CSTR, instead StringValuePtr is provided. 146 * Ruby 1.9 does not provide RXXX(s)->len and RXXX(s)->ptr, instead 147 * RXXX_LEN(s) and RXXX_PTR(s) are provided. 148 */ 149 #ifndef StringValuePtr 150 # define StringValuePtr(s) STR2CSTR(s) 151 #endif 152 #ifndef RARRAY_LEN 153 # define RARRAY_LEN(s) RARRAY(s)->len 154 #endif 155 #ifndef RARRAY_PTR 156 # define RARRAY_PTR(s) RARRAY(s)->ptr 157 #endif 158 #ifndef RSTRING_LEN 159 # define RSTRING_LEN(s) RSTRING(s)->len 160 #endif 161 #ifndef RSTRING_PTR 162 # define RSTRING_PTR(s) RSTRING(s)->ptr 163 #endif 164 165 #ifdef HAVE_DUP 166 # undef HAVE_DUP 167 #endif 168 169 #include "vim.h" 170 #include "version.h" 171 172 #ifdef DYNAMIC_RUBY 173 # if !defined(MSWIN) // must come after including vim.h, where it is defined 174 # include <dlfcn.h> 175 # define HINSTANCE void* 176 # define RUBY_PROC void* 177 # define load_dll(n) dlopen((n), RTLD_LAZY|RTLD_GLOBAL) 178 # define symbol_from_dll dlsym 179 # define close_dll dlclose 180 # else 181 # define RUBY_PROC FARPROC 182 # define load_dll vimLoadLib 183 # define symbol_from_dll GetProcAddress 184 # define close_dll FreeLibrary 185 # endif 186 #endif 187 188 #if defined(PROTO) && !defined(FEAT_RUBY) 189 // Define these to be able to generate the function prototypes. 190 # define VALUE int 191 # define RUBY_DATA_FUNC int 192 #endif 193 194 static int ruby_initialized = 0; 195 static void *ruby_stack_start; 196 static VALUE objtbl; 197 198 static VALUE mVIM; 199 static VALUE cBuffer; 200 static VALUE cVimWindow; 201 static VALUE eDeletedBufferError; 202 static VALUE eDeletedWindowError; 203 204 static int ensure_ruby_initialized(void); 205 static void error_print(int); 206 static void ruby_io_init(void); 207 static void ruby_vim_init(void); 208 static int ruby_convert_to_vim_value(VALUE val, typval_T *rettv); 209 210 #if (RUBY_VERSION >= 19) || defined(RUBY_INIT_STACK) 211 # if defined(__ia64) && !defined(ruby_init_stack) 212 # define ruby_init_stack(addr) ruby_init_stack((addr), rb_ia64_bsp()) 213 # endif 214 #endif 215 216 #if defined(DYNAMIC_RUBY) || defined(PROTO) 217 # if defined(PROTO) && !defined(HINSTANCE) 218 # define HINSTANCE int // for generating prototypes 219 # endif 220 221 /* 222 * Wrapper defines 223 */ 224 // Ruby 2.7 actually expands the following symbols as macro. 225 # if RUBY_VERSION >= 27 226 # undef rb_define_global_function 227 # undef rb_define_method 228 # undef rb_define_module_function 229 # undef rb_define_singleton_method 230 # endif 231 232 # define rb_assoc_new dll_rb_assoc_new 233 # define rb_cObject (*dll_rb_cObject) 234 # define rb_class_new_instance dll_rb_class_new_instance 235 # define rb_check_type dll_rb_check_type 236 # ifdef USE_TYPEDDATA 237 # define rb_check_typeddata dll_rb_check_typeddata 238 # endif 239 # define rb_class_path dll_rb_class_path 240 # ifdef USE_TYPEDDATA 241 # if RUBY_VERSION >= 23 242 # define rb_data_typed_object_wrap dll_rb_data_typed_object_wrap 243 # else 244 # define rb_data_typed_object_alloc dll_rb_data_typed_object_alloc 245 # endif 246 # else 247 # define rb_data_object_alloc dll_rb_data_object_alloc 248 # endif 249 # define rb_define_class_under dll_rb_define_class_under 250 # define rb_define_const dll_rb_define_const 251 # define rb_define_global_function dll_rb_define_global_function 252 # define rb_define_method dll_rb_define_method 253 # define rb_define_module dll_rb_define_module 254 # define rb_define_module_function dll_rb_define_module_function 255 # define rb_define_singleton_method dll_rb_define_singleton_method 256 # define rb_define_virtual_variable dll_rb_define_virtual_variable 257 # define rb_stdout (*dll_rb_stdout) 258 # define rb_stderr (*dll_rb_stderr) 259 # define rb_eArgError (*dll_rb_eArgError) 260 # define rb_eIndexError (*dll_rb_eIndexError) 261 # define rb_eRuntimeError (*dll_rb_eRuntimeError) 262 # define rb_eStandardError (*dll_rb_eStandardError) 263 # define rb_eval_string_protect dll_rb_eval_string_protect 264 # if RUBY_VERSION >= 21 265 # define rb_funcallv dll_rb_funcallv 266 # else 267 # define rb_funcall2 dll_rb_funcall2 268 # endif 269 # define rb_global_variable dll_rb_global_variable 270 # define rb_hash_aset dll_rb_hash_aset 271 # define rb_hash_foreach dll_rb_hash_foreach 272 # define rb_hash_new dll_rb_hash_new 273 # define rb_inspect dll_rb_inspect 274 # define rb_int2inum dll_rb_int2inum 275 276 // ruby.h may redefine rb_intern to use RUBY_CONST_ID_CACHE(), but that won't 277 // work. Not using the cache appears to be the best solution. 278 # undef rb_intern 279 # define rb_intern dll_rb_intern 280 281 # if VIM_SIZEOF_INT < VIM_SIZEOF_LONG // 64 bits only 282 # if RUBY_VERSION <= 18 283 # define rb_fix2int dll_rb_fix2int 284 # define rb_num2int dll_rb_num2int 285 # endif 286 # define rb_num2uint dll_rb_num2uint 287 # endif 288 # define rb_num2dbl dll_rb_num2dbl 289 # define rb_lastline_get dll_rb_lastline_get 290 # define rb_lastline_set dll_rb_lastline_set 291 # define rb_protect dll_rb_protect 292 # define rb_load dll_rb_load 293 # if RUBY_VERSION <= 18 294 # define rb_num2long dll_rb_num2long 295 # endif 296 # if RUBY_VERSION <= 19 297 # define rb_num2ulong dll_rb_num2ulong 298 # endif 299 # define rb_obj_alloc dll_rb_obj_alloc 300 # define rb_obj_as_string dll_rb_obj_as_string 301 # define rb_obj_id dll_rb_obj_id 302 # define rb_raise dll_rb_raise 303 # define rb_str_cat dll_rb_str_cat 304 # define rb_str_concat dll_rb_str_concat 305 # undef rb_str_new 306 # define rb_str_new dll_rb_str_new 307 # ifdef rb_str_new2 308 // Ruby may #define rb_str_new2 to use rb_str_new_cstr. 309 # define need_rb_str_new_cstr 1 310 // Ruby's headers #define rb_str_new_cstr to make use of GCC's 311 // __builtin_constant_p extension. 312 # undef rb_str_new_cstr 313 # define rb_str_new_cstr dll_rb_str_new_cstr 314 # else 315 # define rb_str_new2 dll_rb_str_new2 316 # endif 317 # if RUBY_VERSION >= 18 318 # define rb_string_value dll_rb_string_value 319 # define rb_string_value_ptr dll_rb_string_value_ptr 320 # define rb_float_new dll_rb_float_new 321 # define rb_ary_new dll_rb_ary_new 322 # ifdef rb_ary_new4 323 # define RB_ARY_NEW4_MACRO 1 324 # undef rb_ary_new4 325 # endif 326 # define rb_ary_new4 dll_rb_ary_new4 327 # define rb_ary_push dll_rb_ary_push 328 # if (RUBY_VERSION >= 19) || defined(RUBY_INIT_STACK) 329 # ifdef __ia64 330 # define rb_ia64_bsp dll_rb_ia64_bsp 331 # undef ruby_init_stack 332 # define ruby_init_stack(addr) dll_ruby_init_stack((addr), rb_ia64_bsp()) 333 # else 334 # define ruby_init_stack dll_ruby_init_stack 335 # endif 336 # endif 337 # else 338 # define rb_str2cstr dll_rb_str2cstr 339 # endif 340 # if RUBY_VERSION >= 19 341 # define rb_errinfo dll_rb_errinfo 342 # else 343 # define ruby_errinfo (*dll_ruby_errinfo) 344 # endif 345 # define ruby_init dll_ruby_init 346 # define ruby_init_loadpath dll_ruby_init_loadpath 347 # ifdef MSWIN 348 # if RUBY_VERSION >= 19 349 # define ruby_sysinit dll_ruby_sysinit 350 # else 351 # define NtInitialize dll_NtInitialize 352 # endif 353 # if RUBY_VERSION >= 18 354 # define rb_w32_snprintf dll_rb_w32_snprintf 355 # endif 356 # endif 357 358 # if RUBY_VERSION >= 19 359 # define ruby_script dll_ruby_script 360 # define rb_enc_find_index dll_rb_enc_find_index 361 # define rb_enc_find dll_rb_enc_find 362 # undef rb_enc_str_new 363 # define rb_enc_str_new dll_rb_enc_str_new 364 # define rb_sprintf dll_rb_sprintf 365 # define rb_require dll_rb_require 366 # define ruby_options dll_ruby_options 367 # endif 368 369 /* 370 * Pointers for dynamic link 371 */ 372 static VALUE (*dll_rb_assoc_new) (VALUE, VALUE); 373 VALUE *dll_rb_cFalseClass; 374 VALUE *dll_rb_cFixnum; 375 # if defined(USE_RUBY_INTEGER) 376 VALUE *dll_rb_cInteger; 377 # endif 378 # if RUBY_VERSION >= 20 379 VALUE *dll_rb_cFloat; 380 # endif 381 VALUE *dll_rb_cNilClass; 382 static VALUE *dll_rb_cObject; 383 VALUE *dll_rb_cString; 384 VALUE *dll_rb_cSymbol; 385 VALUE *dll_rb_cTrueClass; 386 static VALUE (*dll_rb_class_new_instance) (int,VALUE*,VALUE); 387 static void (*dll_rb_check_type) (VALUE,int); 388 # ifdef USE_TYPEDDATA 389 static void *(*dll_rb_check_typeddata) (VALUE,const rb_data_type_t *); 390 # endif 391 static VALUE (*dll_rb_class_path) (VALUE); 392 # ifdef USE_TYPEDDATA 393 # if RUBY_VERSION >= 23 394 static VALUE (*dll_rb_data_typed_object_wrap) (VALUE, void*, const rb_data_type_t *); 395 # else 396 static VALUE (*dll_rb_data_typed_object_alloc) (VALUE, void*, const rb_data_type_t *); 397 # endif 398 # else 399 static VALUE (*dll_rb_data_object_alloc) (VALUE, void*, RUBY_DATA_FUNC, RUBY_DATA_FUNC); 400 # endif 401 static VALUE (*dll_rb_define_class_under) (VALUE, const char*, VALUE); 402 static void (*dll_rb_define_const) (VALUE,const char*,VALUE); 403 static void (*dll_rb_define_global_function) (const char*,VALUE(*)(),int); 404 static void (*dll_rb_define_method) (VALUE,const char*,VALUE(*)(),int); 405 static VALUE (*dll_rb_define_module) (const char*); 406 static void (*dll_rb_define_module_function) (VALUE,const char*,VALUE(*)(),int); 407 static void (*dll_rb_define_singleton_method) (VALUE,const char*,VALUE(*)(),int); 408 static void (*dll_rb_define_virtual_variable) (const char*,VALUE(*)(),void(*)()); 409 static VALUE *dll_rb_stdout; 410 static VALUE *dll_rb_stderr; 411 static VALUE *dll_rb_eArgError; 412 static VALUE *dll_rb_eIndexError; 413 static VALUE *dll_rb_eRuntimeError; 414 static VALUE *dll_rb_eStandardError; 415 static VALUE (*dll_rb_eval_string_protect) (const char*, int*); 416 # if RUBY_VERSION >= 21 417 static VALUE (*dll_rb_funcallv) (VALUE, ID, int, const VALUE*); 418 # else 419 static VALUE (*dll_rb_funcall2) (VALUE, ID, int, const VALUE*); 420 # endif 421 static void (*dll_rb_global_variable) (VALUE*); 422 static VALUE (*dll_rb_hash_aset) (VALUE, VALUE, VALUE); 423 static VALUE (*dll_rb_hash_foreach) (VALUE, int (*)(VALUE, VALUE, VALUE), VALUE); 424 static VALUE (*dll_rb_hash_new) (void); 425 static VALUE (*dll_rb_inspect) (VALUE); 426 static VALUE (*dll_rb_int2inum) (long); 427 static ID (*dll_rb_intern) (const char*); 428 # if VIM_SIZEOF_INT < VIM_SIZEOF_LONG // 64 bits only 429 static long (*dll_rb_fix2int) (VALUE); 430 static long (*dll_rb_num2int) (VALUE); 431 static unsigned long (*dll_rb_num2uint) (VALUE); 432 # endif 433 static double (*dll_rb_num2dbl) (VALUE); 434 static VALUE (*dll_rb_lastline_get) (void); 435 static void (*dll_rb_lastline_set) (VALUE); 436 static VALUE (*dll_rb_protect) (VALUE (*)(VALUE), VALUE, int*); 437 static void (*dll_rb_load) (VALUE, int); 438 static long (*dll_rb_num2long) (VALUE); 439 static unsigned long (*dll_rb_num2ulong) (VALUE); 440 static VALUE (*dll_rb_obj_alloc) (VALUE); 441 static VALUE (*dll_rb_obj_as_string) (VALUE); 442 static VALUE (*dll_rb_obj_id) (VALUE); 443 static void (*dll_rb_raise) (VALUE, const char*, ...); 444 # if RUBY_VERSION >= 18 445 static VALUE (*dll_rb_string_value) (volatile VALUE*); 446 # else 447 static char *(*dll_rb_str2cstr) (VALUE,int*); 448 # endif 449 static VALUE (*dll_rb_str_cat) (VALUE, const char*, long); 450 static VALUE (*dll_rb_str_concat) (VALUE, VALUE); 451 static VALUE (*dll_rb_str_new) (const char*, long); 452 # ifdef need_rb_str_new_cstr 453 // Ruby may #define rb_str_new2 to use rb_str_new_cstr. 454 static VALUE (*dll_rb_str_new_cstr) (const char*); 455 # else 456 static VALUE (*dll_rb_str_new2) (const char*); 457 # endif 458 # if RUBY_VERSION >= 19 459 static VALUE (*dll_rb_errinfo) (void); 460 # else 461 static VALUE *dll_ruby_errinfo; 462 # endif 463 static void (*dll_ruby_init) (void); 464 static void (*dll_ruby_init_loadpath) (void); 465 # ifdef MSWIN 466 # if RUBY_VERSION >= 19 467 static void (*dll_ruby_sysinit) (int*, char***); 468 # else 469 static void (*dll_NtInitialize) (int*, char***); 470 # endif 471 # if RUBY_VERSION >= 18 472 static int (*dll_rb_w32_snprintf)(char*, size_t, const char*, ...); 473 # endif 474 # endif 475 # if RUBY_VERSION >= 18 476 static char * (*dll_rb_string_value_ptr) (volatile VALUE*); 477 static VALUE (*dll_rb_float_new) (double); 478 static VALUE (*dll_rb_ary_new) (void); 479 static VALUE (*dll_rb_ary_new4) (long n, const VALUE *elts); 480 static VALUE (*dll_rb_ary_push) (VALUE, VALUE); 481 # if RUBY_VERSION >= 26 482 static void (*dll_rb_ary_detransient) (VALUE); 483 # endif 484 # if (RUBY_VERSION >= 19) || defined(RUBY_INIT_STACK) 485 # ifdef __ia64 486 static void * (*dll_rb_ia64_bsp) (void); 487 static void (*dll_ruby_init_stack)(VALUE*, void*); 488 # else 489 static void (*dll_ruby_init_stack)(VALUE*); 490 # endif 491 # endif 492 # endif 493 # if RUBY_VERSION >= 19 494 static VALUE (*dll_rb_int2big)(SIGNED_VALUE); 495 # endif 496 497 # if RUBY_VERSION >= 19 498 static void (*dll_ruby_script) (const char*); 499 static int (*dll_rb_enc_find_index) (const char*); 500 static rb_encoding* (*dll_rb_enc_find) (const char*); 501 static VALUE (*dll_rb_enc_str_new) (const char*, long, rb_encoding*); 502 static VALUE (*dll_rb_sprintf) (const char*, ...); 503 static VALUE (*dll_rb_require) (const char*); 504 static void* (*ruby_options)(int, char**); 505 # endif 506 507 # if defined(USE_RGENGC) && USE_RGENGC 508 # if RUBY_VERSION == 21 509 static void (*dll_rb_gc_writebarrier_unprotect_promoted)(VALUE); 510 # else 511 static void (*dll_rb_gc_writebarrier_unprotect)(VALUE obj); 512 # endif 513 # endif 514 515 # if RUBY_VERSION >= 26 516 void rb_ary_detransient_stub(VALUE x); 517 # endif 518 519 # if (RUBY_VERSION >= 19) && !defined(PROTO) 520 # if RUBY_VERSION >= 22 521 long 522 rb_num2long_stub(VALUE x) 523 # else 524 SIGNED_VALUE 525 rb_num2long_stub(VALUE x) 526 # endif 527 { 528 return dll_rb_num2long(x); 529 } 530 # if RUBY_VERSION >= 26 531 VALUE 532 rb_int2big_stub(intptr_t x) 533 # else 534 VALUE 535 rb_int2big_stub(SIGNED_VALUE x) 536 # endif 537 { 538 return dll_rb_int2big(x); 539 } 540 # if (RUBY_VERSION >= 19) && (VIM_SIZEOF_INT < VIM_SIZEOF_LONG) 541 long 542 rb_fix2int_stub(VALUE x) 543 { 544 return dll_rb_fix2int(x); 545 } 546 long 547 rb_num2int_stub(VALUE x) 548 { 549 return dll_rb_num2int(x); 550 } 551 # endif 552 # if RUBY_VERSION >= 20 553 VALUE 554 rb_float_new_in_heap(double d) 555 { 556 return dll_rb_float_new(d); 557 } 558 # if RUBY_VERSION >= 22 559 unsigned long 560 rb_num2ulong(VALUE x) 561 # else 562 VALUE 563 rb_num2ulong(VALUE x) 564 # endif 565 { 566 return (long)RSHIFT((SIGNED_VALUE)(x),1); 567 } 568 # endif 569 # endif 570 571 // Do not generate a prototype here, VALUE isn't always defined. 572 # if defined(USE_RGENGC) && USE_RGENGC && !defined(PROTO) 573 # if RUBY_VERSION == 21 574 void 575 rb_gc_writebarrier_unprotect_promoted_stub(VALUE obj) 576 { 577 dll_rb_gc_writebarrier_unprotect_promoted(obj); 578 } 579 # else 580 void 581 rb_gc_writebarrier_unprotect_stub(VALUE obj) 582 { 583 dll_rb_gc_writebarrier_unprotect(obj); 584 } 585 # endif 586 # endif 587 588 # if RUBY_VERSION >= 26 589 void 590 rb_ary_detransient_stub(VALUE x) 591 { 592 dll_rb_ary_detransient(x); 593 } 594 # endif 595 596 static HINSTANCE hinstRuby = NULL; // Instance of ruby.dll 597 598 /* 599 * Table of name to function pointer of ruby. 600 */ 601 static struct 602 { 603 char *name; 604 RUBY_PROC *ptr; 605 } ruby_funcname_table[] = 606 { 607 {"rb_assoc_new", (RUBY_PROC*)&dll_rb_assoc_new}, 608 {"rb_cFalseClass", (RUBY_PROC*)&dll_rb_cFalseClass}, 609 # if defined(USE_RUBY_INTEGER) 610 {"rb_cInteger", (RUBY_PROC*)&dll_rb_cInteger}, 611 # else 612 {"rb_cFixnum", (RUBY_PROC*)&dll_rb_cFixnum}, 613 # endif 614 # if RUBY_VERSION >= 20 615 {"rb_cFloat", (RUBY_PROC*)&dll_rb_cFloat}, 616 # endif 617 {"rb_cNilClass", (RUBY_PROC*)&dll_rb_cNilClass}, 618 {"rb_cObject", (RUBY_PROC*)&dll_rb_cObject}, 619 {"rb_cString", (RUBY_PROC*)&dll_rb_cString}, 620 {"rb_cSymbol", (RUBY_PROC*)&dll_rb_cSymbol}, 621 {"rb_cTrueClass", (RUBY_PROC*)&dll_rb_cTrueClass}, 622 {"rb_class_new_instance", (RUBY_PROC*)&dll_rb_class_new_instance}, 623 {"rb_check_type", (RUBY_PROC*)&dll_rb_check_type}, 624 # ifdef USE_TYPEDDATA 625 {"rb_check_typeddata", (RUBY_PROC*)&dll_rb_check_typeddata}, 626 # endif 627 {"rb_class_path", (RUBY_PROC*)&dll_rb_class_path}, 628 # ifdef USE_TYPEDDATA 629 # if RUBY_VERSION >= 23 630 {"rb_data_typed_object_wrap", (RUBY_PROC*)&dll_rb_data_typed_object_wrap}, 631 # else 632 {"rb_data_typed_object_alloc", (RUBY_PROC*)&dll_rb_data_typed_object_alloc}, 633 # endif 634 # else 635 {"rb_data_object_alloc", (RUBY_PROC*)&dll_rb_data_object_alloc}, 636 # endif 637 {"rb_define_class_under", (RUBY_PROC*)&dll_rb_define_class_under}, 638 {"rb_define_const", (RUBY_PROC*)&dll_rb_define_const}, 639 {"rb_define_global_function", (RUBY_PROC*)&dll_rb_define_global_function}, 640 {"rb_define_method", (RUBY_PROC*)&dll_rb_define_method}, 641 {"rb_define_module", (RUBY_PROC*)&dll_rb_define_module}, 642 {"rb_define_module_function", (RUBY_PROC*)&dll_rb_define_module_function}, 643 {"rb_define_singleton_method", (RUBY_PROC*)&dll_rb_define_singleton_method}, 644 {"rb_define_virtual_variable", (RUBY_PROC*)&dll_rb_define_virtual_variable}, 645 {"rb_stdout", (RUBY_PROC*)&dll_rb_stdout}, 646 {"rb_stderr", (RUBY_PROC*)&dll_rb_stderr}, 647 {"rb_eArgError", (RUBY_PROC*)&dll_rb_eArgError}, 648 {"rb_eIndexError", (RUBY_PROC*)&dll_rb_eIndexError}, 649 {"rb_eRuntimeError", (RUBY_PROC*)&dll_rb_eRuntimeError}, 650 {"rb_eStandardError", (RUBY_PROC*)&dll_rb_eStandardError}, 651 {"rb_eval_string_protect", (RUBY_PROC*)&dll_rb_eval_string_protect}, 652 # if RUBY_VERSION >= 21 653 {"rb_funcallv", (RUBY_PROC*)&dll_rb_funcallv}, 654 # else 655 {"rb_funcall2", (RUBY_PROC*)&dll_rb_funcall2}, 656 # endif 657 {"rb_global_variable", (RUBY_PROC*)&dll_rb_global_variable}, 658 {"rb_hash_aset", (RUBY_PROC*)&dll_rb_hash_aset}, 659 {"rb_hash_foreach", (RUBY_PROC*)&dll_rb_hash_foreach}, 660 {"rb_hash_new", (RUBY_PROC*)&dll_rb_hash_new}, 661 {"rb_inspect", (RUBY_PROC*)&dll_rb_inspect}, 662 {"rb_int2inum", (RUBY_PROC*)&dll_rb_int2inum}, 663 {"rb_intern", (RUBY_PROC*)&dll_rb_intern}, 664 # if VIM_SIZEOF_INT < VIM_SIZEOF_LONG // 64 bits only 665 {"rb_fix2int", (RUBY_PROC*)&dll_rb_fix2int}, 666 {"rb_num2int", (RUBY_PROC*)&dll_rb_num2int}, 667 {"rb_num2uint", (RUBY_PROC*)&dll_rb_num2uint}, 668 # endif 669 {"rb_num2dbl", (RUBY_PROC*)&dll_rb_num2dbl}, 670 {"rb_lastline_get", (RUBY_PROC*)&dll_rb_lastline_get}, 671 {"rb_lastline_set", (RUBY_PROC*)&dll_rb_lastline_set}, 672 {"rb_protect", (RUBY_PROC*)&dll_rb_protect}, 673 {"rb_load", (RUBY_PROC*)&dll_rb_load}, 674 {"rb_num2long", (RUBY_PROC*)&dll_rb_num2long}, 675 {"rb_num2ulong", (RUBY_PROC*)&dll_rb_num2ulong}, 676 {"rb_obj_alloc", (RUBY_PROC*)&dll_rb_obj_alloc}, 677 {"rb_obj_as_string", (RUBY_PROC*)&dll_rb_obj_as_string}, 678 {"rb_obj_id", (RUBY_PROC*)&dll_rb_obj_id}, 679 {"rb_raise", (RUBY_PROC*)&dll_rb_raise}, 680 # if RUBY_VERSION >= 18 681 {"rb_string_value", (RUBY_PROC*)&dll_rb_string_value}, 682 # else 683 {"rb_str2cstr", (RUBY_PROC*)&dll_rb_str2cstr}, 684 # endif 685 {"rb_str_cat", (RUBY_PROC*)&dll_rb_str_cat}, 686 {"rb_str_concat", (RUBY_PROC*)&dll_rb_str_concat}, 687 {"rb_str_new", (RUBY_PROC*)&dll_rb_str_new}, 688 # ifdef need_rb_str_new_cstr 689 {"rb_str_new_cstr", (RUBY_PROC*)&dll_rb_str_new_cstr}, 690 # else 691 {"rb_str_new2", (RUBY_PROC*)&dll_rb_str_new2}, 692 # endif 693 # if RUBY_VERSION >= 19 694 {"rb_errinfo", (RUBY_PROC*)&dll_rb_errinfo}, 695 # else 696 {"ruby_errinfo", (RUBY_PROC*)&dll_ruby_errinfo}, 697 # endif 698 {"ruby_init", (RUBY_PROC*)&dll_ruby_init}, 699 {"ruby_init_loadpath", (RUBY_PROC*)&dll_ruby_init_loadpath}, 700 # ifdef MSWIN 701 # if RUBY_VERSION >= 19 702 {"ruby_sysinit", (RUBY_PROC*)&dll_ruby_sysinit}, 703 # else 704 {"NtInitialize", (RUBY_PROC*)&dll_NtInitialize}, 705 # endif 706 # if RUBY_VERSION >= 18 707 {"rb_w32_snprintf", (RUBY_PROC*)&dll_rb_w32_snprintf}, 708 # endif 709 # endif 710 # if RUBY_VERSION >= 18 711 {"rb_string_value_ptr", (RUBY_PROC*)&dll_rb_string_value_ptr}, 712 # if RUBY_VERSION <= 19 713 {"rb_float_new", (RUBY_PROC*)&dll_rb_float_new}, 714 # else 715 {"rb_float_new_in_heap", (RUBY_PROC*)&dll_rb_float_new}, 716 # endif 717 {"rb_ary_new", (RUBY_PROC*)&dll_rb_ary_new}, 718 # ifdef RB_ARY_NEW4_MACRO 719 {"rb_ary_new_from_values", (RUBY_PROC*)&dll_rb_ary_new4}, 720 # else 721 {"rb_ary_new4", (RUBY_PROC*)&dll_rb_ary_new4}, 722 # endif 723 {"rb_ary_push", (RUBY_PROC*)&dll_rb_ary_push}, 724 # if RUBY_VERSION >= 26 725 {"rb_ary_detransient", (RUBY_PROC*)&dll_rb_ary_detransient}, 726 # endif 727 # endif 728 # if RUBY_VERSION >= 19 729 {"rb_int2big", (RUBY_PROC*)&dll_rb_int2big}, 730 {"ruby_script", (RUBY_PROC*)&dll_ruby_script}, 731 {"rb_enc_find_index", (RUBY_PROC*)&dll_rb_enc_find_index}, 732 {"rb_enc_find", (RUBY_PROC*)&dll_rb_enc_find}, 733 {"rb_enc_str_new", (RUBY_PROC*)&dll_rb_enc_str_new}, 734 {"rb_sprintf", (RUBY_PROC*)&dll_rb_sprintf}, 735 {"rb_require", (RUBY_PROC*)&dll_rb_require}, 736 {"ruby_options", (RUBY_PROC*)&dll_ruby_options}, 737 # endif 738 # if (RUBY_VERSION >= 19) || defined(RUBY_INIT_STACK) 739 # ifdef __ia64 740 {"rb_ia64_bsp", (RUBY_PROC*)&dll_rb_ia64_bsp}, 741 # endif 742 {"ruby_init_stack", (RUBY_PROC*)&dll_ruby_init_stack}, 743 # endif 744 # if defined(USE_RGENGC) && USE_RGENGC 745 # if RUBY_VERSION == 21 746 {"rb_gc_writebarrier_unprotect_promoted", (RUBY_PROC*)&dll_rb_gc_writebarrier_unprotect_promoted}, 747 # else 748 {"rb_gc_writebarrier_unprotect", (RUBY_PROC*)&dll_rb_gc_writebarrier_unprotect}, 749 # endif 750 # endif 751 {"", NULL}, 752 }; 753 754 /* 755 * Load library and get all pointers. 756 * Parameter 'libname' provides name of DLL. 757 * Return OK or FAIL. 758 */ 759 static int 760 ruby_runtime_link_init(char *libname, int verbose) 761 { 762 int i; 763 764 if (hinstRuby) 765 return OK; 766 hinstRuby = load_dll(libname); 767 if (!hinstRuby) 768 { 769 if (verbose) 770 semsg(_(e_loadlib), libname); 771 return FAIL; 772 } 773 774 for (i = 0; ruby_funcname_table[i].ptr; ++i) 775 { 776 if (!(*ruby_funcname_table[i].ptr = symbol_from_dll(hinstRuby, 777 ruby_funcname_table[i].name))) 778 { 779 close_dll(hinstRuby); 780 hinstRuby = NULL; 781 if (verbose) 782 semsg(_(e_loadfunc), ruby_funcname_table[i].name); 783 return FAIL; 784 } 785 } 786 return OK; 787 } 788 789 /* 790 * If ruby is enabled (there is installed ruby on Windows system) return TRUE, 791 * else FALSE. 792 */ 793 int 794 ruby_enabled(int verbose) 795 { 796 return ruby_runtime_link_init((char *)p_rubydll, verbose) == OK; 797 } 798 #endif // defined(DYNAMIC_RUBY) || defined(PROTO) 799 800 void 801 ruby_end(void) 802 { 803 } 804 805 void 806 ex_ruby(exarg_T *eap) 807 { 808 int state; 809 char *script = NULL; 810 811 script = (char *)script_get(eap, eap->arg); 812 if (!eap->skip && ensure_ruby_initialized()) 813 { 814 if (script == NULL) 815 rb_eval_string_protect((char *)eap->arg, &state); 816 else 817 rb_eval_string_protect(script, &state); 818 if (state) 819 error_print(state); 820 } 821 vim_free(script); 822 } 823 824 /* 825 * In Ruby 1.9 or later, ruby String object has encoding. 826 * conversion buffer string of vim to ruby String object using 827 * VIM encoding option. 828 */ 829 static VALUE 830 vim_str2rb_enc_str(const char *s) 831 { 832 #if RUBY_VERSION >= 19 833 int isnum; 834 long lval; 835 char_u *sval; 836 rb_encoding *enc; 837 838 isnum = get_option_value((char_u *)"enc", &lval, &sval, 0); 839 if (isnum == 0) 840 { 841 enc = rb_enc_find((char *)sval); 842 vim_free(sval); 843 if (enc) 844 return rb_enc_str_new(s, (long)strlen(s), enc); 845 } 846 #endif 847 return rb_str_new2(s); 848 } 849 850 static VALUE 851 eval_enc_string_protect(const char *str, int *state) 852 { 853 #if RUBY_VERSION >= 19 854 int isnum; 855 long lval; 856 char_u *sval; 857 rb_encoding *enc; 858 VALUE v; 859 860 isnum = get_option_value((char_u *)"enc", &lval, &sval, 0); 861 if (isnum == 0) 862 { 863 enc = rb_enc_find((char *)sval); 864 vim_free(sval); 865 if (enc) 866 { 867 v = rb_sprintf("#-*- coding:%s -*-\n%s", rb_enc_name(enc), str); 868 return rb_eval_string_protect(StringValuePtr(v), state); 869 } 870 } 871 #endif 872 return rb_eval_string_protect(str, state); 873 } 874 875 void 876 ex_rubydo(exarg_T *eap) 877 { 878 int state; 879 linenr_T i; 880 buf_T *was_curbuf = curbuf; 881 882 if (ensure_ruby_initialized()) 883 { 884 if (u_save(eap->line1 - 1, eap->line2 + 1) != OK) 885 return; 886 for (i = eap->line1; i <= eap->line2; i++) 887 { 888 VALUE line; 889 890 if (i > curbuf->b_ml.ml_line_count) 891 break; 892 line = vim_str2rb_enc_str((char *)ml_get(i)); 893 rb_lastline_set(line); 894 eval_enc_string_protect((char *) eap->arg, &state); 895 if (state) 896 { 897 error_print(state); 898 break; 899 } 900 if (was_curbuf != curbuf) 901 break; 902 line = rb_lastline_get(); 903 if (!NIL_P(line)) 904 { 905 if (TYPE(line) != T_STRING) 906 { 907 emsg(_("E265: $_ must be an instance of String")); 908 return; 909 } 910 ml_replace(i, (char_u *) StringValuePtr(line), 1); 911 changed(); 912 #ifdef SYNTAX_HL 913 syn_changed(i); // recompute syntax hl. for this line 914 #endif 915 } 916 } 917 check_cursor(); 918 update_curbuf(NOT_VALID); 919 } 920 } 921 922 static VALUE 923 rb_load_wrap(VALUE file_to_load) 924 { 925 rb_load(file_to_load, 0); 926 return Qnil; 927 } 928 929 void 930 ex_rubyfile(exarg_T *eap) 931 { 932 int state; 933 934 if (ensure_ruby_initialized()) 935 { 936 VALUE file_to_load = rb_str_new2((const char *)eap->arg); 937 rb_protect(rb_load_wrap, file_to_load, &state); 938 if (state) 939 error_print(state); 940 } 941 } 942 943 void 944 ruby_buffer_free(buf_T *buf) 945 { 946 if (buf->b_ruby_ref) 947 { 948 rb_hash_aset(objtbl, rb_obj_id((VALUE) buf->b_ruby_ref), Qnil); 949 RDATA(buf->b_ruby_ref)->data = NULL; 950 } 951 } 952 953 void 954 ruby_window_free(win_T *win) 955 { 956 if (win->w_ruby_ref) 957 { 958 rb_hash_aset(objtbl, rb_obj_id((VALUE) win->w_ruby_ref), Qnil); 959 RDATA(win->w_ruby_ref)->data = NULL; 960 } 961 } 962 963 static int 964 ensure_ruby_initialized(void) 965 { 966 if (!ruby_initialized) 967 { 968 #ifdef DYNAMIC_RUBY 969 if (ruby_enabled(TRUE)) 970 { 971 #endif 972 #ifdef MSWIN 973 // suggested by Ariya Mizutani 974 int argc = 1; 975 char *argv[] = {"gvim.exe"}; 976 char **argvp = argv; 977 # if RUBY_VERSION >= 19 978 ruby_sysinit(&argc, &argvp); 979 # else 980 NtInitialize(&argc, &argvp); 981 # endif 982 #endif 983 { 984 #if (RUBY_VERSION >= 19) || defined(RUBY_INIT_STACK) 985 ruby_init_stack(ruby_stack_start); 986 #endif 987 ruby_init(); 988 } 989 #if RUBY_VERSION >= 19 990 { 991 int dummy_argc = 2; 992 char *dummy_argv[] = {"vim-ruby", "-e_=0"}; 993 ruby_options(dummy_argc, dummy_argv); 994 } 995 ruby_script("vim-ruby"); 996 #else 997 ruby_init_loadpath(); 998 #endif 999 ruby_io_init(); 1000 ruby_vim_init(); 1001 ruby_initialized = 1; 1002 #ifdef DYNAMIC_RUBY 1003 } 1004 else 1005 { 1006 emsg(_("E266: Sorry, this command is disabled, the Ruby library could not be loaded.")); 1007 return 0; 1008 } 1009 #endif 1010 } 1011 return ruby_initialized; 1012 } 1013 1014 static void 1015 error_print(int state) 1016 { 1017 #if !defined(DYNAMIC_RUBY) && (RUBY_VERSION <= 18) 1018 RUBYEXTERN VALUE ruby_errinfo; 1019 #endif 1020 VALUE error; 1021 VALUE eclass; 1022 VALUE einfo; 1023 VALUE bt; 1024 int attr; 1025 char buff[BUFSIZ]; 1026 long i; 1027 1028 #define TAG_RETURN 0x1 1029 #define TAG_BREAK 0x2 1030 #define TAG_NEXT 0x3 1031 #define TAG_RETRY 0x4 1032 #define TAG_REDO 0x5 1033 #define TAG_RAISE 0x6 1034 #define TAG_THROW 0x7 1035 #define TAG_FATAL 0x8 1036 #define TAG_MASK 0xf 1037 1038 switch (state) 1039 { 1040 case TAG_RETURN: 1041 emsg(_("E267: unexpected return")); 1042 break; 1043 case TAG_NEXT: 1044 emsg(_("E268: unexpected next")); 1045 break; 1046 case TAG_BREAK: 1047 emsg(_("E269: unexpected break")); 1048 break; 1049 case TAG_REDO: 1050 emsg(_("E270: unexpected redo")); 1051 break; 1052 case TAG_RETRY: 1053 emsg(_("E271: retry outside of rescue clause")); 1054 break; 1055 case TAG_RAISE: 1056 case TAG_FATAL: 1057 #if RUBY_VERSION >= 19 1058 error = rb_errinfo(); 1059 #else 1060 error = ruby_errinfo; 1061 #endif 1062 eclass = CLASS_OF(error); 1063 einfo = rb_obj_as_string(error); 1064 if (eclass == rb_eRuntimeError && RSTRING_LEN(einfo) == 0) 1065 { 1066 emsg(_("E272: unhandled exception")); 1067 } 1068 else 1069 { 1070 VALUE epath; 1071 char *p; 1072 1073 epath = rb_class_path(eclass); 1074 vim_snprintf(buff, BUFSIZ, "%s: %s", 1075 RSTRING_PTR(epath), RSTRING_PTR(einfo)); 1076 p = strchr(buff, '\n'); 1077 if (p) *p = '\0'; 1078 emsg(buff); 1079 } 1080 1081 attr = syn_name2attr((char_u *)"Error"); 1082 #if RUBY_VERSION >= 21 1083 bt = rb_funcallv(error, rb_intern("backtrace"), 0, 0); 1084 for (i = 0; i < RARRAY_LEN(bt); i++) 1085 msg_attr(RSTRING_PTR(RARRAY_AREF(bt, i)), attr); 1086 #else 1087 bt = rb_funcall2(error, rb_intern("backtrace"), 0, 0); 1088 for (i = 0; i < RARRAY_LEN(bt); i++) 1089 msg_attr(RSTRING_PTR(RARRAY_PTR(bt)[i]), attr); 1090 #endif 1091 break; 1092 default: 1093 vim_snprintf(buff, BUFSIZ, _("E273: unknown longjmp status %d"), state); 1094 emsg(buff); 1095 break; 1096 } 1097 } 1098 1099 static VALUE 1100 vim_message(VALUE self UNUSED, VALUE str) 1101 { 1102 char *buff, *p; 1103 1104 str = rb_obj_as_string(str); 1105 if (RSTRING_LEN(str) > 0) 1106 { 1107 // Only do this when the string isn't empty, alloc(0) causes trouble. 1108 buff = ALLOCA_N(char, RSTRING_LEN(str) + 1); 1109 strcpy(buff, RSTRING_PTR(str)); 1110 p = strchr(buff, '\n'); 1111 if (p) *p = '\0'; 1112 msg(buff); 1113 } 1114 else 1115 { 1116 msg(""); 1117 } 1118 return Qnil; 1119 } 1120 1121 static VALUE 1122 vim_set_option(VALUE self UNUSED, VALUE str) 1123 { 1124 do_set((char_u *)StringValuePtr(str), 0); 1125 update_screen(NOT_VALID); 1126 return Qnil; 1127 } 1128 1129 static VALUE 1130 vim_command(VALUE self UNUSED, VALUE str) 1131 { 1132 do_cmdline_cmd((char_u *)StringValuePtr(str)); 1133 return Qnil; 1134 } 1135 1136 #ifdef FEAT_EVAL 1137 static VALUE 1138 vim_to_ruby(typval_T *tv) 1139 { 1140 VALUE result = Qnil; 1141 1142 if (tv->v_type == VAR_STRING) 1143 { 1144 result = rb_str_new2(tv->vval.v_string == NULL 1145 ? "" : (char *)(tv->vval.v_string)); 1146 } 1147 else if (tv->v_type == VAR_NUMBER) 1148 { 1149 result = INT2NUM(tv->vval.v_number); 1150 } 1151 # ifdef FEAT_FLOAT 1152 else if (tv->v_type == VAR_FLOAT) 1153 { 1154 result = rb_float_new(tv->vval.v_float); 1155 } 1156 # endif 1157 else if (tv->v_type == VAR_LIST) 1158 { 1159 list_T *list = tv->vval.v_list; 1160 listitem_T *curr; 1161 1162 result = rb_ary_new(); 1163 1164 if (list != NULL) 1165 { 1166 FOR_ALL_LIST_ITEMS(list, curr) 1167 rb_ary_push(result, vim_to_ruby(&curr->li_tv)); 1168 } 1169 } 1170 else if (tv->v_type == VAR_DICT) 1171 { 1172 result = rb_hash_new(); 1173 1174 if (tv->vval.v_dict != NULL) 1175 { 1176 hashtab_T *ht = &tv->vval.v_dict->dv_hashtab; 1177 long_u todo = ht->ht_used; 1178 hashitem_T *hi; 1179 dictitem_T *di; 1180 1181 for (hi = ht->ht_array; todo > 0; ++hi) 1182 { 1183 if (!HASHITEM_EMPTY(hi)) 1184 { 1185 --todo; 1186 1187 di = dict_lookup(hi); 1188 rb_hash_aset(result, rb_str_new2((char *)hi->hi_key), 1189 vim_to_ruby(&di->di_tv)); 1190 } 1191 } 1192 } 1193 } 1194 else if (tv->v_type == VAR_BOOL || tv->v_type == VAR_SPECIAL) 1195 { 1196 if (tv->vval.v_number == VVAL_TRUE) 1197 result = Qtrue; 1198 else if (tv->vval.v_number == VVAL_FALSE) 1199 result = Qfalse; 1200 } 1201 else if (tv->v_type == VAR_BLOB) 1202 { 1203 result = rb_str_new(tv->vval.v_blob->bv_ga.ga_data, 1204 tv->vval.v_blob->bv_ga.ga_len); 1205 } 1206 // else return Qnil; 1207 1208 return result; 1209 } 1210 #endif 1211 1212 static VALUE 1213 vim_evaluate(VALUE self UNUSED, VALUE str) 1214 { 1215 #ifdef FEAT_EVAL 1216 typval_T *tv; 1217 VALUE result; 1218 1219 tv = eval_expr((char_u *)StringValuePtr(str), NULL); 1220 if (tv == NULL) 1221 return Qnil; 1222 result = vim_to_ruby(tv); 1223 1224 free_tv(tv); 1225 1226 return result; 1227 #else 1228 return Qnil; 1229 #endif 1230 } 1231 1232 #ifdef USE_TYPEDDATA 1233 static size_t buffer_dsize(const void *buf); 1234 1235 static const rb_data_type_t buffer_type = { 1236 "vim_buffer", 1237 {0, 0, buffer_dsize, 1238 # if RUBY_VERSION >= 27 1239 0, {0} 1240 # else 1241 {0, 0} 1242 # endif 1243 }, 1244 0, 0, 1245 # ifdef RUBY_TYPED_FREE_IMMEDIATELY 1246 0, 1247 # endif 1248 }; 1249 1250 static size_t 1251 buffer_dsize(const void *buf UNUSED) 1252 { 1253 return sizeof(buf_T); 1254 } 1255 #endif 1256 1257 static VALUE 1258 buffer_new(buf_T *buf) 1259 { 1260 if (buf->b_ruby_ref) 1261 { 1262 return (VALUE) buf->b_ruby_ref; 1263 } 1264 else 1265 { 1266 #ifdef USE_TYPEDDATA 1267 VALUE obj = TypedData_Wrap_Struct(cBuffer, &buffer_type, buf); 1268 #else 1269 VALUE obj = Data_Wrap_Struct(cBuffer, 0, 0, buf); 1270 #endif 1271 buf->b_ruby_ref = (void *) obj; 1272 rb_hash_aset(objtbl, rb_obj_id(obj), obj); 1273 return obj; 1274 } 1275 } 1276 1277 static buf_T * 1278 get_buf(VALUE obj) 1279 { 1280 buf_T *buf; 1281 1282 #ifdef USE_TYPEDDATA 1283 TypedData_Get_Struct(obj, buf_T, &buffer_type, buf); 1284 #else 1285 Data_Get_Struct(obj, buf_T, buf); 1286 #endif 1287 if (buf == NULL) 1288 rb_raise(eDeletedBufferError, "attempt to refer to deleted buffer"); 1289 return buf; 1290 } 1291 1292 static VALUE 1293 vim_blob(VALUE self UNUSED, VALUE str) 1294 { 1295 VALUE result = rb_str_new("0z", 2); 1296 char buf[4]; 1297 int i; 1298 for (i = 0; i < RSTRING_LEN(str); i++) 1299 { 1300 sprintf(buf, "%02X", (unsigned char)(RSTRING_PTR(str)[i])); 1301 rb_str_concat(result, rb_str_new2(buf)); 1302 } 1303 return result; 1304 } 1305 1306 static VALUE 1307 buffer_s_current(VALUE self UNUSED) 1308 { 1309 return buffer_new(curbuf); 1310 } 1311 1312 static VALUE 1313 buffer_s_current_getter(ID id UNUSED, VALUE *x UNUSED) 1314 { 1315 return buffer_new(curbuf); 1316 } 1317 1318 static VALUE 1319 buffer_s_count(VALUE self UNUSED) 1320 { 1321 buf_T *b; 1322 int n = 0; 1323 1324 FOR_ALL_BUFFERS(b) 1325 { 1326 // Deleted buffers should not be counted 1327 // SegPhault - 01/07/05 1328 if (b->b_p_bl) 1329 n++; 1330 } 1331 1332 return INT2NUM(n); 1333 } 1334 1335 static VALUE 1336 buffer_s_aref(VALUE self UNUSED, VALUE num) 1337 { 1338 buf_T *b; 1339 int n = NUM2INT(num); 1340 1341 FOR_ALL_BUFFERS(b) 1342 { 1343 // Deleted buffers should not be counted 1344 // SegPhault - 01/07/05 1345 if (!b->b_p_bl) 1346 continue; 1347 1348 if (n == 0) 1349 return buffer_new(b); 1350 1351 n--; 1352 } 1353 return Qnil; 1354 } 1355 1356 static VALUE 1357 buffer_name(VALUE self) 1358 { 1359 buf_T *buf = get_buf(self); 1360 1361 return buf->b_ffname ? rb_str_new2((char *)buf->b_ffname) : Qnil; 1362 } 1363 1364 static VALUE 1365 buffer_number(VALUE self) 1366 { 1367 buf_T *buf = get_buf(self); 1368 1369 return INT2NUM(buf->b_fnum); 1370 } 1371 1372 static VALUE 1373 buffer_count(VALUE self) 1374 { 1375 buf_T *buf = get_buf(self); 1376 1377 return INT2NUM(buf->b_ml.ml_line_count); 1378 } 1379 1380 static VALUE 1381 get_buffer_line(buf_T *buf, linenr_T n) 1382 { 1383 if (n <= 0 || n > buf->b_ml.ml_line_count) 1384 rb_raise(rb_eIndexError, "line number %ld out of range", (long)n); 1385 return vim_str2rb_enc_str((char *)ml_get_buf(buf, n, FALSE)); 1386 } 1387 1388 static VALUE 1389 buffer_aref(VALUE self, VALUE num) 1390 { 1391 buf_T *buf = get_buf(self); 1392 1393 if (buf != NULL) 1394 return get_buffer_line(buf, (linenr_T)NUM2LONG(num)); 1395 return Qnil; // For stop warning 1396 } 1397 1398 static VALUE 1399 set_buffer_line(buf_T *buf, linenr_T n, VALUE str) 1400 { 1401 char *line = StringValuePtr(str); 1402 aco_save_T aco; 1403 1404 if (n > 0 && n <= buf->b_ml.ml_line_count && line != NULL) 1405 { 1406 // set curwin/curbuf for "buf" and save some things 1407 aucmd_prepbuf(&aco, buf); 1408 1409 if (u_savesub(n) == OK) 1410 { 1411 ml_replace(n, (char_u *)line, TRUE); 1412 changed(); 1413 #ifdef SYNTAX_HL 1414 syn_changed(n); // recompute syntax hl. for this line 1415 #endif 1416 } 1417 1418 // restore curwin/curbuf and a few other things 1419 aucmd_restbuf(&aco); 1420 // Careful: autocommands may have made "buf" invalid! 1421 1422 update_curbuf(NOT_VALID); 1423 } 1424 else 1425 { 1426 rb_raise(rb_eIndexError, "line number %ld out of range", (long)n); 1427 } 1428 return str; 1429 } 1430 1431 static VALUE 1432 buffer_aset(VALUE self, VALUE num, VALUE str) 1433 { 1434 buf_T *buf = get_buf(self); 1435 1436 if (buf != NULL) 1437 return set_buffer_line(buf, (linenr_T)NUM2LONG(num), str); 1438 return str; 1439 } 1440 1441 static VALUE 1442 buffer_delete(VALUE self, VALUE num) 1443 { 1444 buf_T *buf = get_buf(self); 1445 long n = NUM2LONG(num); 1446 aco_save_T aco; 1447 1448 if (n > 0 && n <= buf->b_ml.ml_line_count) 1449 { 1450 // set curwin/curbuf for "buf" and save some things 1451 aucmd_prepbuf(&aco, buf); 1452 1453 if (u_savedel(n, 1) == OK) 1454 { 1455 ml_delete(n); 1456 1457 // Changes to non-active buffers should properly refresh 1458 // SegPhault - 01/09/05 1459 deleted_lines_mark(n, 1L); 1460 1461 changed(); 1462 } 1463 1464 // restore curwin/curbuf and a few other things 1465 aucmd_restbuf(&aco); 1466 // Careful: autocommands may have made "buf" invalid! 1467 1468 update_curbuf(NOT_VALID); 1469 } 1470 else 1471 { 1472 rb_raise(rb_eIndexError, "line number %ld out of range", n); 1473 } 1474 return Qnil; 1475 } 1476 1477 static VALUE 1478 buffer_append(VALUE self, VALUE num, VALUE str) 1479 { 1480 buf_T *buf = get_buf(self); 1481 char *line = StringValuePtr(str); 1482 long n = NUM2LONG(num); 1483 aco_save_T aco; 1484 1485 if (line == NULL) 1486 { 1487 rb_raise(rb_eIndexError, "NULL line"); 1488 } 1489 else if (n >= 0 && n <= buf->b_ml.ml_line_count) 1490 { 1491 // set curwin/curbuf for "buf" and save some things 1492 aucmd_prepbuf(&aco, buf); 1493 1494 if (u_inssub(n + 1) == OK) 1495 { 1496 ml_append(n, (char_u *) line, (colnr_T) 0, FALSE); 1497 1498 // Changes to non-active buffers should properly refresh screen 1499 // SegPhault - 12/20/04 1500 appended_lines_mark(n, 1L); 1501 1502 changed(); 1503 } 1504 1505 // restore curwin/curbuf and a few other things 1506 aucmd_restbuf(&aco); 1507 // Careful: autocommands may have made "buf" invalid! 1508 1509 update_curbuf(NOT_VALID); 1510 } 1511 else 1512 { 1513 rb_raise(rb_eIndexError, "line number %ld out of range", n); 1514 } 1515 return str; 1516 } 1517 1518 #ifdef USE_TYPEDDATA 1519 static size_t window_dsize(const void *buf); 1520 1521 static const rb_data_type_t window_type = { 1522 "vim_window", 1523 {0, 0, window_dsize, 1524 # if RUBY_VERSION >= 27 1525 0, {0} 1526 # else 1527 {0, 0} 1528 # endif 1529 }, 1530 0, 0, 1531 # ifdef RUBY_TYPED_FREE_IMMEDIATELY 1532 0, 1533 # endif 1534 }; 1535 1536 static size_t 1537 window_dsize(const void *win UNUSED) 1538 { 1539 return sizeof(win_T); 1540 } 1541 #endif 1542 1543 static VALUE 1544 window_new(win_T *win) 1545 { 1546 if (win->w_ruby_ref) 1547 { 1548 return (VALUE) win->w_ruby_ref; 1549 } 1550 else 1551 { 1552 #ifdef USE_TYPEDDATA 1553 VALUE obj = TypedData_Wrap_Struct(cVimWindow, &window_type, win); 1554 #else 1555 VALUE obj = Data_Wrap_Struct(cVimWindow, 0, 0, win); 1556 #endif 1557 win->w_ruby_ref = (void *) obj; 1558 rb_hash_aset(objtbl, rb_obj_id(obj), obj); 1559 return obj; 1560 } 1561 } 1562 1563 static win_T * 1564 get_win(VALUE obj) 1565 { 1566 win_T *win; 1567 1568 #ifdef USE_TYPEDDATA 1569 TypedData_Get_Struct(obj, win_T, &window_type, win); 1570 #else 1571 Data_Get_Struct(obj, win_T, win); 1572 #endif 1573 if (win == NULL) 1574 rb_raise(eDeletedWindowError, "attempt to refer to deleted window"); 1575 return win; 1576 } 1577 1578 static VALUE 1579 window_s_current(VALUE self UNUSED) 1580 { 1581 return window_new(curwin); 1582 } 1583 1584 static VALUE 1585 window_s_current_getter(ID id UNUSED, VALUE *x UNUSED) 1586 { 1587 return window_new(curwin); 1588 } 1589 1590 /* 1591 * Added line manipulation functions 1592 * SegPhault - 03/07/05 1593 */ 1594 static VALUE 1595 line_s_current(VALUE self UNUSED) 1596 { 1597 return get_buffer_line(curbuf, curwin->w_cursor.lnum); 1598 } 1599 1600 static VALUE 1601 set_current_line(VALUE self UNUSED, VALUE str) 1602 { 1603 return set_buffer_line(curbuf, curwin->w_cursor.lnum, str); 1604 } 1605 1606 static VALUE 1607 current_line_number(VALUE self UNUSED) 1608 { 1609 return INT2FIX((int)curwin->w_cursor.lnum); 1610 } 1611 1612 static VALUE 1613 window_s_count(VALUE self UNUSED) 1614 { 1615 win_T *w; 1616 int n = 0; 1617 1618 FOR_ALL_WINDOWS(w) 1619 n++; 1620 return INT2NUM(n); 1621 } 1622 1623 static VALUE 1624 window_s_aref(VALUE self UNUSED, VALUE num) 1625 { 1626 win_T *w; 1627 int n = NUM2INT(num); 1628 1629 for (w = firstwin; w != NULL; w = w->w_next, --n) 1630 if (n == 0) 1631 return window_new(w); 1632 return Qnil; 1633 } 1634 1635 static VALUE 1636 window_buffer(VALUE self) 1637 { 1638 win_T *win = get_win(self); 1639 1640 return buffer_new(win->w_buffer); 1641 } 1642 1643 static VALUE 1644 window_height(VALUE self) 1645 { 1646 win_T *win = get_win(self); 1647 1648 return INT2NUM(win->w_height); 1649 } 1650 1651 static VALUE 1652 window_set_height(VALUE self, VALUE height) 1653 { 1654 win_T *win = get_win(self); 1655 win_T *savewin = curwin; 1656 1657 curwin = win; 1658 win_setheight(NUM2INT(height)); 1659 curwin = savewin; 1660 return height; 1661 } 1662 1663 static VALUE 1664 window_width(VALUE self UNUSED) 1665 { 1666 return INT2NUM(get_win(self)->w_width); 1667 } 1668 1669 static VALUE 1670 window_set_width(VALUE self UNUSED, VALUE width) 1671 { 1672 win_T *win = get_win(self); 1673 win_T *savewin = curwin; 1674 1675 curwin = win; 1676 win_setwidth(NUM2INT(width)); 1677 curwin = savewin; 1678 return width; 1679 } 1680 1681 static VALUE 1682 window_cursor(VALUE self) 1683 { 1684 win_T *win = get_win(self); 1685 1686 return rb_assoc_new(INT2NUM(win->w_cursor.lnum), INT2NUM(win->w_cursor.col)); 1687 } 1688 1689 static VALUE 1690 window_set_cursor(VALUE self, VALUE pos) 1691 { 1692 VALUE lnum, col; 1693 win_T *win = get_win(self); 1694 1695 Check_Type(pos, T_ARRAY); 1696 if (RARRAY_LEN(pos) != 2) 1697 rb_raise(rb_eArgError, "array length must be 2"); 1698 lnum = RARRAY_PTR(pos)[0]; 1699 col = RARRAY_PTR(pos)[1]; 1700 win->w_cursor.lnum = NUM2LONG(lnum); 1701 win->w_cursor.col = NUM2UINT(col); 1702 win->w_set_curswant = TRUE; 1703 check_cursor(); // put cursor on an existing line 1704 update_screen(NOT_VALID); 1705 return Qnil; 1706 } 1707 1708 static VALUE 1709 f_nop(VALUE self UNUSED) 1710 { 1711 return Qnil; 1712 } 1713 1714 static VALUE 1715 f_p(int argc, VALUE *argv, VALUE self UNUSED) 1716 { 1717 int i; 1718 VALUE str = rb_str_new("", 0); 1719 VALUE ret = Qnil; 1720 1721 for (i = 0; i < argc; i++) 1722 { 1723 if (i > 0) rb_str_cat(str, ", ", 2); 1724 rb_str_concat(str, rb_inspect(argv[i])); 1725 } 1726 msg(RSTRING_PTR(str)); 1727 1728 if (argc == 1) 1729 ret = argv[0]; 1730 else if (argc > 1) 1731 ret = rb_ary_new4(argc, argv); 1732 return ret; 1733 } 1734 1735 static void 1736 ruby_io_init(void) 1737 { 1738 #ifndef DYNAMIC_RUBY 1739 RUBYEXTERN VALUE rb_stdout; 1740 RUBYEXTERN VALUE rb_stderr; 1741 #endif 1742 1743 rb_stdout = rb_obj_alloc(rb_cObject); 1744 rb_stderr = rb_obj_alloc(rb_cObject); 1745 rb_define_singleton_method(rb_stdout, "write", vim_message, 1); 1746 rb_define_singleton_method(rb_stdout, "flush", f_nop, 0); 1747 rb_define_singleton_method(rb_stderr, "write", vim_message, 1); 1748 rb_define_singleton_method(rb_stderr, "flush", f_nop, 0); 1749 rb_define_global_function("p", f_p, -1); 1750 } 1751 1752 static void 1753 ruby_vim_init(void) 1754 { 1755 objtbl = rb_hash_new(); 1756 rb_global_variable(&objtbl); 1757 1758 // The Vim module used to be called "VIM", but "Vim" is better. Make an 1759 // alias "VIM" for backwards compatibility. 1760 mVIM = rb_define_module("Vim"); 1761 rb_define_const(rb_cObject, "VIM", mVIM); 1762 rb_define_const(mVIM, "VERSION_MAJOR", INT2NUM(VIM_VERSION_MAJOR)); 1763 rb_define_const(mVIM, "VERSION_MINOR", INT2NUM(VIM_VERSION_MINOR)); 1764 rb_define_const(mVIM, "VERSION_BUILD", INT2NUM(VIM_VERSION_BUILD)); 1765 rb_define_const(mVIM, "VERSION_PATCHLEVEL", INT2NUM(VIM_VERSION_PATCHLEVEL)); 1766 rb_define_const(mVIM, "VERSION_SHORT", rb_str_new2(VIM_VERSION_SHORT)); 1767 rb_define_const(mVIM, "VERSION_MEDIUM", rb_str_new2(VIM_VERSION_MEDIUM)); 1768 rb_define_const(mVIM, "VERSION_LONG", rb_str_new2(VIM_VERSION_LONG)); 1769 rb_define_const(mVIM, "VERSION_LONG_DATE", rb_str_new2(VIM_VERSION_LONG_DATE)); 1770 rb_define_module_function(mVIM, "message", vim_message, 1); 1771 rb_define_module_function(mVIM, "set_option", vim_set_option, 1); 1772 rb_define_module_function(mVIM, "command", vim_command, 1); 1773 rb_define_module_function(mVIM, "evaluate", vim_evaluate, 1); 1774 rb_define_module_function(mVIM, "blob", vim_blob, 1); 1775 1776 eDeletedBufferError = rb_define_class_under(mVIM, "DeletedBufferError", 1777 rb_eStandardError); 1778 eDeletedWindowError = rb_define_class_under(mVIM, "DeletedWindowError", 1779 rb_eStandardError); 1780 1781 cBuffer = rb_define_class_under(mVIM, "Buffer", rb_cObject); 1782 rb_define_singleton_method(cBuffer, "current", buffer_s_current, 0); 1783 rb_define_singleton_method(cBuffer, "count", buffer_s_count, 0); 1784 rb_define_singleton_method(cBuffer, "[]", buffer_s_aref, 1); 1785 rb_define_method(cBuffer, "name", buffer_name, 0); 1786 rb_define_method(cBuffer, "number", buffer_number, 0); 1787 rb_define_method(cBuffer, "count", buffer_count, 0); 1788 rb_define_method(cBuffer, "length", buffer_count, 0); 1789 rb_define_method(cBuffer, "[]", buffer_aref, 1); 1790 rb_define_method(cBuffer, "[]=", buffer_aset, 2); 1791 rb_define_method(cBuffer, "delete", buffer_delete, 1); 1792 rb_define_method(cBuffer, "append", buffer_append, 2); 1793 1794 // Added line manipulation functions 1795 // SegPhault - 03/07/05 1796 rb_define_method(cBuffer, "line_number", current_line_number, 0); 1797 rb_define_method(cBuffer, "line", line_s_current, 0); 1798 rb_define_method(cBuffer, "line=", set_current_line, 1); 1799 1800 1801 cVimWindow = rb_define_class_under(mVIM, "Window", rb_cObject); 1802 rb_define_singleton_method(cVimWindow, "current", window_s_current, 0); 1803 rb_define_singleton_method(cVimWindow, "count", window_s_count, 0); 1804 rb_define_singleton_method(cVimWindow, "[]", window_s_aref, 1); 1805 rb_define_method(cVimWindow, "buffer", window_buffer, 0); 1806 rb_define_method(cVimWindow, "height", window_height, 0); 1807 rb_define_method(cVimWindow, "height=", window_set_height, 1); 1808 rb_define_method(cVimWindow, "width", window_width, 0); 1809 rb_define_method(cVimWindow, "width=", window_set_width, 1); 1810 rb_define_method(cVimWindow, "cursor", window_cursor, 0); 1811 rb_define_method(cVimWindow, "cursor=", window_set_cursor, 1); 1812 1813 rb_define_virtual_variable("$curbuf", buffer_s_current_getter, 0); 1814 rb_define_virtual_variable("$curwin", window_s_current_getter, 0); 1815 } 1816 1817 void 1818 vim_ruby_init(void *stack_start) 1819 { 1820 // should get machine stack start address early in main function 1821 ruby_stack_start = stack_start; 1822 } 1823 1824 static int 1825 convert_hash2dict(VALUE key, VALUE val, VALUE arg) 1826 { 1827 dict_T *d = (dict_T *)arg; 1828 dictitem_T *di; 1829 1830 di = dictitem_alloc((char_u *)RSTRING_PTR(RSTRING(rb_obj_as_string(key)))); 1831 if (di == NULL || ruby_convert_to_vim_value(val, &di->di_tv) != OK 1832 || dict_add(d, di) != OK) 1833 { 1834 d->dv_hashtab.ht_error = TRUE; 1835 return ST_STOP; 1836 } 1837 return ST_CONTINUE; 1838 } 1839 1840 static int 1841 ruby_convert_to_vim_value(VALUE val, typval_T *rettv) 1842 { 1843 switch (TYPE(val)) 1844 { 1845 case T_NIL: 1846 rettv->v_type = VAR_SPECIAL; 1847 rettv->vval.v_number = VVAL_NULL; 1848 break; 1849 case T_TRUE: 1850 rettv->v_type = VAR_BOOL; 1851 rettv->vval.v_number = VVAL_TRUE; 1852 break; 1853 case T_FALSE: 1854 rettv->v_type = VAR_BOOL; 1855 rettv->vval.v_number = VVAL_FALSE; 1856 break; 1857 case T_BIGNUM: 1858 case T_FIXNUM: 1859 rettv->v_type = VAR_NUMBER; 1860 rettv->vval.v_number = (varnumber_T)NUM2LONG(val); 1861 break; 1862 #ifdef FEAT_FLOAT 1863 case T_FLOAT: 1864 rettv->v_type = VAR_FLOAT; 1865 rettv->vval.v_float = (float_T)NUM2DBL(val); 1866 break; 1867 #endif 1868 default: 1869 val = rb_obj_as_string(val); 1870 // FALLTHROUGH 1871 case T_STRING: 1872 { 1873 VALUE str = (VALUE)RSTRING(val); 1874 1875 rettv->v_type = VAR_STRING; 1876 rettv->vval.v_string = vim_strnsave((char_u *)RSTRING_PTR(str), 1877 RSTRING_LEN(str)); 1878 } 1879 break; 1880 case T_ARRAY: 1881 { 1882 list_T *l; 1883 long i; 1884 typval_T v; 1885 1886 l = list_alloc(); 1887 if (l == NULL) 1888 return FAIL; 1889 1890 for (i = 0; i < RARRAY_LEN(val); ++i) 1891 { 1892 if (ruby_convert_to_vim_value((VALUE)RARRAY_PTR(val)[i], 1893 &v) != OK) 1894 { 1895 list_unref(l); 1896 return FAIL; 1897 } 1898 list_append_tv(l, &v); 1899 clear_tv(&v); 1900 } 1901 1902 rettv->v_type = VAR_LIST; 1903 rettv->vval.v_list = l; 1904 ++l->lv_refcount; 1905 } 1906 break; 1907 case T_HASH: 1908 { 1909 dict_T *d; 1910 1911 d = dict_alloc(); 1912 if (d == NULL) 1913 return FAIL; 1914 1915 rb_hash_foreach(val, convert_hash2dict, (VALUE)d); 1916 if (d->dv_hashtab.ht_error) 1917 { 1918 dict_unref(d); 1919 return FAIL; 1920 } 1921 1922 rettv->v_type = VAR_DICT; 1923 rettv->vval.v_dict = d; 1924 ++d->dv_refcount; 1925 } 1926 break; 1927 } 1928 return OK; 1929 } 1930 1931 void 1932 do_rubyeval(char_u *str, typval_T *rettv) 1933 { 1934 int retval = FAIL; 1935 1936 if (ensure_ruby_initialized()) 1937 { 1938 int state; 1939 VALUE obj; 1940 1941 obj = rb_eval_string_protect((const char *)str, &state); 1942 if (state) 1943 error_print(state); 1944 else 1945 retval = ruby_convert_to_vim_value(obj, rettv); 1946 } 1947 if (retval == FAIL) 1948 { 1949 rettv->v_type = VAR_NUMBER; 1950 rettv->vval.v_number = 0; 1951 } 1952 } 1953