/********************************************************************** transcode.c - $Author$ created at: Tue Oct 30 16:10:22 JST 2007 Copyright (C) 2007 Martin Duerst **********************************************************************/ #include "ruby/ruby.h" #include "ruby/encoding.h" #define PType (int) #include "transcode_data.h" #include static VALUE sym_invalid, sym_ignore; #define INVALID_IGNORE 0x1 /* * Dispatch data and logic */ static st_table *transcoder_table, *transcoder_lib_table; #define TRANSCODER_INTERNAL_SEPARATOR '\t' static char * transcoder_key(const char *from_e, const char *to_e) { int to_len = strlen(to_e); int from_len = strlen(from_e); char *const key = xmalloc(to_len + from_len + 2); memcpy(key, to_e, to_len); memcpy(key + to_len + 1, from_e, from_len + 1); key[to_len] = TRANSCODER_INTERNAL_SEPARATOR; return key; } void rb_register_transcoder(const rb_transcoder *tr) { st_data_t k, val = 0; const char *const from_e = tr->from_encoding; const char *const to_e = tr->to_encoding; char *const key = transcoder_key(from_e, to_e); if (st_lookup(transcoder_table, (st_data_t)key, &val)) { xfree(key); rb_raise(rb_eArgError, "transcoder from %s to %s has been already registered", from_e, to_e); } k = (st_data_t)key; if (st_delete(transcoder_lib_table, &k, &val)) { xfree((char *)k); } st_insert(transcoder_table, (st_data_t)key, (st_data_t)tr); } static void declare_transcoder(const char *to, const char *from, const char *lib) { const char *const key = transcoder_key(to, from); st_data_t k = (st_data_t)key, val; if (st_delete(transcoder_lib_table, &k, &val)) { xfree((char *)k); } st_insert(transcoder_lib_table, (st_data_t)key, (st_data_t)lib); } #define MAX_TRANSCODER_LIBNAME_LEN 64 static const char transcoder_lib_prefix[] = "enc/trans/"; void rb_declare_transcoder(const char *enc1, const char *enc2, const char *lib) { if (!lib || strlen(lib) > MAX_TRANSCODER_LIBNAME_LEN) { rb_raise(rb_eArgError, "invalid library name - %s", lib ? lib : "(null)"); } declare_transcoder(enc1, enc2, lib); declare_transcoder(enc2, enc1, lib); } #define encoding_equal(enc1, enc2) (STRCASECMP(enc1, enc2) == 0) static const rb_transcoder * transcode_dispatch(const char* from_encoding, const char* to_encoding) { char *const key = transcoder_key(from_encoding, to_encoding); st_data_t k, val = 0; while (!st_lookup(transcoder_table, (k = (st_data_t)key), &val) && st_delete(transcoder_lib_table, &k, &val)) { const char *const lib = (const char *)val; int len = strlen(lib); char path[sizeof(transcoder_lib_prefix) + MAX_TRANSCODER_LIBNAME_LEN]; xfree((char *)k); if (len > MAX_TRANSCODER_LIBNAME_LEN) return NULL; memcpy(path, transcoder_lib_prefix, sizeof(transcoder_lib_prefix) - 1); memcpy(path + sizeof(transcoder_lib_prefix) - 1, lib, len + 1); if (!rb_require(path)) return NULL; } if (!val) { if (!st_lookup(transcoder_table, (st_data_t)key, &val)) { /* multistep logic, via UTF-8 */ if (!encoding_equal(from_encoding, "UTF-8") && !encoding_equal(to_encoding, "UTF-8") && transcode_dispatch("UTF-8", to_encoding)) { /* check that we have a second step */ return transcode_dispatch(from_encoding, "UTF-8"); /* return first step */ } return NULL; } } return (rb_transcoder *)val; } /* * Transcoding engine logic */ static void transcode_loop(unsigned char **in_pos, unsigned char **out_pos, unsigned char *in_stop, unsigned char *out_stop, const rb_transcoder *my_transcoder, rb_transcoding *my_transcoding, const int opt) { unsigned char *in_p = *in_pos, *out_p = *out_pos; const BYTE_LOOKUP *conv_tree_start = my_transcoder->conv_tree_start; const BYTE_LOOKUP *next_table; unsigned char *char_start; unsigned int next_offset; VALUE next_info; unsigned char next_byte; int from_utf8 = my_transcoder->from_utf8; unsigned char *out_s = out_stop - my_transcoder->max_output + 1; while (in_p < in_stop) { char_start = in_p; next_table = conv_tree_start; if (out_p >= out_s) { int len = (out_p - *out_pos); int new_len = (len + my_transcoder->max_output) * 2; *out_pos = (*my_transcoding->flush_func)(my_transcoding, len, new_len); out_p = *out_pos + len; out_s = *out_pos + new_len - my_transcoder->max_output; } next_byte = (unsigned char)*in_p++; follow_byte: next_offset = next_table->base[next_byte]; next_info = (VALUE)next_table->info[next_offset]; follow_info: switch (next_info & 0x1F) { case NOMAP: *out_p++ = next_byte; continue; case 0x00: case 0x04: case 0x08: case 0x0C: case 0x10: case 0x14: case 0x18: case 0x1C: if (in_p >= in_stop) { /* todo: deal with the case of backtracking */ /* todo: deal with incomplete input (streaming) */ goto invalid; } next_byte = (unsigned char)*in_p++; if (from_utf8) { if ((next_byte&0xC0) == 0x80) next_byte -= 0x80; else { in_p--; /* may need to add more code later to revert other things */ goto invalid; } } next_table = (const BYTE_LOOKUP *)next_info; goto follow_byte; /* maybe rewrite the following cases to use fallthrough???? */ case ZERObt: /* drop input */ continue; case ONEbt: *out_p++ = getBT1(next_info); continue; case TWObt: *out_p++ = getBT1(next_info); *out_p++ = getBT2(next_info); continue; case FOURbt: *out_p++ = getBT0(next_info); case THREEbt: /* fall through */ *out_p++ = getBT1(next_info); *out_p++ = getBT2(next_info); *out_p++ = getBT3(next_info); continue; case FUNii: next_info = (VALUE)(*my_transcoder->func_ii)(next_info); goto follow_info; case FUNsi: next_info = (VALUE)(*my_transcoder->func_si)(char_start); goto follow_info; break; case FUNio: out_p += (VALUE)(*my_transcoder->func_io)(next_info, out_p); break; case FUNso: out_p += (VALUE)(*my_transcoder->func_so)(char_start, out_p); break; case INVALID: goto invalid; case UNDEF: /* todo: add code for alternate behaviors */ rb_raise(rb_eRuntimeError /*@@@change exception*/, "conversion undefined for byte sequence (maybe invalid byte sequence)"); continue; } continue; invalid: /* deal with invalid byte sequence */ /* todo: add more alternative behaviors */ if (opt&INVALID_IGNORE) { continue; } rb_raise(rb_eRuntimeError /*change exception*/, "invalid byte sequence"); continue; } /* cleanup */ *in_pos = in_p; *out_pos = out_p; } /* * String-specific code */ static unsigned char * str_transcoding_resize(rb_transcoding *my_transcoding, int len, int new_len) { VALUE dest_string = my_transcoding->ruby_string_dest; rb_str_resize(dest_string, new_len); return (unsigned char *)RSTRING_PTR(dest_string); } static int str_transcode(int argc, VALUE *argv, VALUE *self) { VALUE dest; VALUE str = *self; long blen, slen; unsigned char *buf, *bp, *sp, *fromp; rb_encoding *from_enc, *to_enc; const char *from_e, *to_e; int from_encidx, to_encidx; VALUE from_encval, to_encval; const rb_transcoder *my_transcoder; rb_transcoding my_transcoding; int final_encoding = 0; VALUE opt; int options = 0; opt = rb_check_convert_type(argv[argc-1], T_HASH, "Hash", "to_hash"); if (!NIL_P(opt)) { VALUE v; argc--; v = rb_hash_aref(opt, sym_invalid); if (NIL_P(v)) { rb_raise(rb_eArgError, "unknown value for invalid: setting"); } else if (v==sym_ignore) { options |= INVALID_IGNORE; } } if (argc < 1 || argc > 2) { rb_raise(rb_eArgError, "wrong number of arguments (%d for 1..2)", argc); } if ((to_encidx = rb_to_encoding_index(to_encval = argv[0])) < 0) { to_enc = 0; to_encidx = 0; to_e = StringValueCStr(to_encval); } else { to_enc = rb_enc_from_index(to_encidx); to_e = rb_enc_name(to_enc); } if (argc==1) { from_encidx = rb_enc_get_index(str); from_enc = rb_enc_from_index(from_encidx); from_e = rb_enc_name(from_enc); } else if ((from_encidx = rb_to_encoding_index(from_encval = argv[1])) < 0) { from_enc = 0; from_e = StringValueCStr(from_encval); } else { from_enc = rb_enc_from_index(from_encidx); from_e = rb_enc_name(from_enc); } if (from_enc && from_enc == to_enc) { return -1; } if (from_enc && to_enc && rb_enc_asciicompat(from_enc) && rb_enc_asciicompat(to_enc)) { if (ENC_CODERANGE(str) == ENC_CODERANGE_7BIT) { return to_encidx; } } if (encoding_equal(from_e, to_e)) { return -1; } do { /* loop for multistep transcoding */ /* later, maybe use smaller intermediate strings for very long strings */ if (!(my_transcoder = transcode_dispatch(from_e, to_e))) { rb_raise(rb_eArgError, "transcoding not supported (from %s to %s)", from_e, to_e); } my_transcoding.transcoder = my_transcoder; if (my_transcoder->preprocessor) { fromp = sp = (unsigned char *)RSTRING_PTR(str); slen = RSTRING_LEN(str); blen = slen + 30; /* len + margin */ dest = rb_str_tmp_new(blen); bp = (unsigned char *)RSTRING_PTR(dest); my_transcoding.ruby_string_dest = dest; (*my_transcoder->preprocessor)(&fromp, &bp, (sp+slen), (bp+blen), &my_transcoding); if (fromp != sp+slen) { rb_raise(rb_eArgError, "not fully converted, %td bytes left", sp+slen-fromp); } buf = (unsigned char *)RSTRING_PTR(dest); *bp = '\0'; rb_str_set_len(dest, bp - buf); str = dest; } fromp = sp = (unsigned char *)RSTRING_PTR(str); slen = RSTRING_LEN(str); blen = slen + 30; /* len + margin */ dest = rb_str_tmp_new(blen); bp = (unsigned char *)RSTRING_PTR(dest); my_transcoding.ruby_string_dest = dest; my_transcoding.flush_func = str_transcoding_resize; transcode_loop(&fromp, &bp, (sp+slen), (bp+blen), my_transcoder, &my_transcoding, options); if (fromp != sp+slen) { rb_raise(rb_eArgError, "not fully converted, %td bytes left", sp+slen-fromp); } buf = (unsigned char *)RSTRING_PTR(dest); *bp = '\0'; rb_str_set_len(dest, bp - buf); if (my_transcoder->postprocessor) { str = dest; fromp = sp = (unsigned char *)RSTRING_PTR(str); slen = RSTRING_LEN(str); blen = slen + 30; /* len + margin */ dest = rb_str_tmp_new(blen); bp = (unsigned char *)RSTRING_PTR(dest); my_transcoding.ruby_string_dest = dest; (*my_transcoder->postprocessor)(&fromp, &bp, (sp+slen), (bp+blen), &my_transcoding); if (fromp != sp+slen) { rb_raise(rb_eArgError, "not fully converted, %td bytes left", sp+slen-fromp); } buf = (unsigned char *)RSTRING_PTR(dest); *bp = '\0'; rb_str_set_len(dest, bp - buf); } if (encoding_equal(my_transcoder->to_encoding, to_e)) { final_encoding = 1; } else { from_e = my_transcoder->to_encoding; str = dest; } } while (!final_encoding); /* set encoding */ if (!to_enc) { to_encidx = rb_define_dummy_encoding(to_e); } *self = dest; return to_encidx; } /* * call-seq: * str.encode!(encoding [, options] ) => str * str.encode!(to_encoding, from_encoding [, options] ) => str * * The first form transcodes the contents of str from * str.encoding to +encoding+. * The second form transcodes the contents of str from * from_encoding to to_encoding. * The options Hash gives details for conversion. See String#encode * for details. * Returns the string even if no changes were made. */ static VALUE str_encode_bang(int argc, VALUE *argv, VALUE str) { VALUE newstr = str; int encidx = str_transcode(argc, argv, &newstr); int cr = 0; if (encidx < 0) return str; rb_str_shared_replace(str, newstr); rb_enc_associate_index(str, encidx); /* transcoded string never be broken. */ if (rb_enc_asciicompat(rb_enc_from_index(encidx))) { rb_str_coderange_scan_restartable(RSTRING_PTR(str), RSTRING_END(str), 0, &cr); } else { cr = ENC_CODERANGE_VALID; } ENC_CODERANGE_SET(str, cr); return str; } /* * call-seq: * str.encode(encoding [, options] ) => str * str.encode(to_encoding, from_encoding [, options] ) => str * * The first form returns a copy of str transcoded * to encoding +encoding+. * The second form returns a copy of str transcoded * from from_encoding to to_encoding. * The options Hash gives details for conversion. Details * to be added. */ static VALUE str_encode(int argc, VALUE *argv, VALUE str) { str = rb_str_dup(str); return str_encode_bang(argc, argv, str); } VALUE rb_str_transcode(VALUE str, VALUE to) { return str_encode(1, &to, str); } void Init_transcode(void) { transcoder_table = st_init_strcasetable(); transcoder_lib_table = st_init_strcasetable(); sym_invalid = ID2SYM(rb_intern("invalid")); sym_ignore = ID2SYM(rb_intern("ignore")); rb_define_method(rb_cString, "encode", str_encode, -1); rb_define_method(rb_cString, "encode!", str_encode_bang, -1); }