ruby-oci8 2.1.5.1-x64-mingw32

data/lib/oci8/encoding-init.rb

@@ -0,0 +1,79 @@
+#
+# setup default OCI encoding from NLS_LANG.
+#
+
+#
+class OCI8
+
+  # get the environment variable NLS_LANG.
+  nls_lang = ENV['NLS_LANG']
+
+  if nls_lang.is_a? String and nls_lang.length == 0
+    nls_lang = nil
+  end
+
+  # if NLS_LANG is not set, get it from the Windows registry.
+  if nls_lang.nil? and defined? OCI8::Win32Util
+    dll_path = OCI8::Win32Util.dll_path.upcase
+    if dll_path =~ %r{\\BIN\\OCI.DLL}
+      oracle_home = $`
+      OCI8::Win32Util.enum_homes do |home, lang|
+        if oracle_home == home.upcase
+          nls_lang = lang
+          break
+        end
+      end
+    end
+  end
+
+  # extract the charset name.
+  if nls_lang
+    if nls_lang =~ /\.([[:alnum:]]+)$/
+      @@client_charset_name = $1.upcase
+    else
+      raise "Invalid NLS_LANG format: #{nls_lang}"
+    end
+  else
+    warn "Warning: NLS_LANG is not set. fallback to US7ASCII."
+    # @private
+    @@client_charset_name = 'US7ASCII'
+  end
+
+  # Ruby encoding name for ruby 1.9.
+  if OCI8.respond_to? :encoding
+    if defined? DEFAULT_OCI8_ENCODING
+      enc = DEFAULT_OCI8_ENCODING
+    else
+      require 'yaml'
+      enc = YAML::load_file(File.dirname(__FILE__) + '/encoding.yml')[@@client_charset_name]
+      if enc.nil?
+        raise "Ruby encoding name is not found in encoding.yml for NLS_LANG #{nls_lang}."
+      end
+      if enc.is_a? Array
+        # Use the first available encoding in the array.
+        enc = enc.find do |e| Encoding.find(e) rescue false; end
+      end
+    end
+    OCI8.encoding = enc
+  else
+    # NLS ratio, maximum number of bytes per one chracter
+    case @@client_charset_name
+    when 'UTF8'
+      OCI8.nls_ratio = 3
+    when 'AL16UTF16'
+      OCI8.nls_ratio = 4
+    when /^[[:alpha:]]+(\d+)/
+      # convert maximum number of bits per one chracter to NLS ratio.
+      #   charset name  max bits  max bytes
+      #   ------------  --------  ---------
+      #   US7ASCII          7         1
+      #   WE8ISO8859P1      8         1
+      #   JA16SJIS         16         2
+      #   AL32UTF8         32         4
+      #   ...
+      OCI8.nls_ratio = (($1.to_i + 7) >> 3)
+    else
+      raise "Unknown NLS character set name format: #{@@client_charset_name}"
+    end
+  end
+end

data/lib/oci8/encoding.yml

@@ -0,0 +1,537 @@
+#
+# Mapping table from Oracle charset name to Ruby encoding name
+#
+
+############################################################
+# Oracle Database Globalization Support Guide 11g Release 1 (11.1)
+#
+# Table A-4 Recommended ASCII Database Character Sets
+
+#
+# Asian
+#
+
+# EUC 24-bit Japanese
+JA16EUC:           EUC-JP
+
+# The same as JA16EUC except for the way that the wave dash and the
+# tilde are mapped to and from Unicode.
+JA16EUCTILDE:      CP51932      # or eucJP-ms
+
+# Shift-JIS 16-bit Japanese
+JA16SJIS:          Shift_JIS
+
+# The same as JA16SJIS except for the way that the wave dash and the
+# tilde are mapped to and from Unicode.
+JA16SJISTILDE:     Windows-31J
+
+# MS Windows Code Page 949 Korean
+KO16MSWIN949:      CP949
+
+# Thai Industrial Standard 620-2533 - ASCII 8-bit
+TH8TISASCII:       Windows-874  # or TIS-620
+
+# MS Windows Code Page 1258 8-bit Vietnamese
+VN8MSWIN1258:      Windows-1258
+
+# GBK 16-bit Simplified Chinese
+ZHS16GBK:          GBK
+
+# MS Windows Code Page 950 with Hong Kong Supplementary Character
+# Set HKSCS-2001 (character set conversion to and from Unicode is
+# based on Unicode 3.0)
+ZHT16HKSCS:        [CP951, Big5-HKSCS, Big5]
+
+# MS Windows Code Page 950 Traditional Chinese
+ZHT16MSWIN950:     [CP950, Big5]
+
+# EUC 32-bit Traditional Chinese
+ZHT32EUC:          EUC-TW       # Who use this?
+
+#
+# European
+#
+
+# ISO 8859-13 Baltic
+BLT8ISO8859P13:    ISO-8859-13
+
+# MS Windows Code Page 1257 8-bit Baltic
+BLT8MSWIN1257:     Windows-1257
+
+# ISO 8859-5 Latin/Cyrillic
+CL8ISO8859P5:      ISO-8859-5
+
+# MS Windows Code Page 1251 8-bit Latin/Cyrillic
+CL8MSWIN1251:      Windows-1251
+
+# ISO 8859-2 East European
+EE8ISO8859P2:      ISO-8859-2
+
+# ISO 8859-7 Latin/Greek
+EL8ISO8859P7:      ISO-8859-7
+
+# MS Windows Code Page 1253 8-bit Latin/Greek
+EL8MSWIN1253:      Windows-1253
+
+# MS Windows Code Page 1250 8-bit East European
+EE8MSWIN1250:      Windows-1250
+
+# ISO 8859-10 North European
+NE8ISO8859P10:     ISO-8859-10
+
+# ISO 8859-4 North and North-East European
+NEE8ISO8859P4:     ISO-8859-4
+
+# ISO 8859-15 West European
+WE8ISO8859P15:     ISO-8859-15
+
+# MS Windows Code Page 1252 8-bit West European
+WE8MSWIN1252:      Windows-1252
+
+#
+# Middle Eastern
+#
+
+# ISO 8859-6 Latin/Arabic
+AR8ISO8859P6:      ISO-8859-6
+
+# MS Windows Code Page 1256 8-Bit Latin/Arabic
+AR8MSWIN1256:      Windows-1256
+
+# ISO 8859-8 Latin/Hebrew
+IW8ISO8859P8:      ISO-8859-8
+
+# MS Windows Code Page 1255 8-bit Latin/Hebrew
+IW8MSWIN1255:      Windows-1255
+
+# MS Windows Code Page 1254 8-bit Turkish
+TR8MSWIN1254:      Windows-1254
+
+# ISO 8859-9 West European & Turkish
+WE8ISO8859P9:      ISO-8859-9
+
+#
+# Universal
+#
+
+# Unicode 5.0 UTF-8 Universal character set
+AL32UTF8:          UTF-8
+
+#
+############################################################
+
+
+############################################################
+# Oracle Database Globalization Support Guide 11g Release 1 (11.1)
+#
+# Table A-6 Other ASCII-based Database Character Sets
+
+#
+# Asian
+#
+
+# Bangladesh National Code 8-bit BSCII
+BN8BSCII:          nil          # FIXME
+
+# Multiple-Script Indian Standard 8-bit Latin/Indian Languages
+IN8ISCII:          nil          # FIXME
+
+# JVMS 16-bit Japanese
+JA16VMS:           nil          # FIXME
+
+# KSC5601 16-bit Korean
+KO16KSC5601:       EUC-KR # This should be 'CP949'?
+
+# KSCCS 16-bit Korean
+KO16KSCCS:         nil          # FIXME
+
+# Mac Server 8-bit Latin/Thai
+TH8MACTHAIS:       macThai
+
+# VN3 8-bit Vietnamese
+VN8VN3:            nil          # FIXME
+
+# CGB2312-80 16-bit Simplified Chinese
+ZHS16CGB231280:    GB2312
+
+# BIG5 16-bit Traditional Chinese
+ZHT16BIG5:         Big5
+
+# HP CCDC 16-bit Traditional Chinese
+ZHT16CCDC:         nil          # FIXME
+
+# Taiwan Taxation 16-bit Traditional Chinese
+ZHT16DBT:          nil          # FIXME
+
+# MS Windows Code Page 950 with Hong Kong Supplementary Character
+# Set HKSCS-2001 (character set conversion to and from Unicode is
+# based on Unicode 3.1)
+ZHT16HKSCS31:      [CP951, Big5-HKSCS, Big5]
+
+# SOPS 32-bit Traditional Chinese
+ZHT32SOPS:         nil          # FIXME
+
+# TRIS 32-bit Traditional Chinese
+ZHT32TRIS:         nil          # FIXME
+
+#
+# Middle Eastern
+#
+
+# Arabic MS-DOS 710 Server 8-bit Latin/Arabic
+AR8ADOS710:        nil          # FIXME
+
+# Arabic MS-DOS 720 Server 8-bit Latin/Arabic
+AR8ADOS720:        nil          # FIXME
+
+# APTEC 715 Server 8-bit Latin/Arabic
+AR8APTEC715:       nil          # FIXME
+
+# ASMO Extended 708 8-bit Latin/Arabic
+AR8ASMO8X:         nil          # FIXME
+
+# Mussa'd Alarabi/2 768 Server 8-bit Latin/Arabic
+AR8MUSSAD768:      nil          # FIXME
+
+# Nafitha Enhanced 711 Server 8-bit Latin/Arabic
+AR8NAFITHA711:     nil          # FIXME
+
+# Nafitha International 721 Server 8-bit Latin/Arabic
+AR8NAFITHA721:     nil          # FIXME
+
+# SAKHR 706 Server 8-bit Latin/Arabic
+AR8SAKHR706:       nil          # FIXME
+
+# SAKHR 707 Server 8-bit Latin/Arabic
+AR8SAKHR707:       nil          # FIXME
+
+# ISO 8859-9 Latin Azerbaijani
+AZ8ISO8859PE:      nil          # What is this different with WE8ISO8859P9?
+
+# Multiple-Script Indian Standard 8-bit Latin/Indian Languages
+IN8ISCII:          nil          # FIXME
+
+# Mac Client 8-bit Hebrew
+IW8MACHEBREW:      nil          # FIXME
+
+# IBM-PC Code Page 1507/862 8-bit Latin/Hebrew
+IW8PC1507:         IBM862
+
+# ISO 6937 8-bit Coded Character Set for Text Communication
+LA8ISO6937:        nil          # FIXME
+
+# DEC 8-bit Turkish
+TR8DEC:            nil          # FIXME
+
+# IBM-PC Code Page 857 8-bit Turkish
+TR8PC857:          IBM857
+
+#
+#European
+#
+
+# Mac Client 8-bit Latin/Arabic
+AR8ARABICMAC:      nil          # FIXME
+
+# Mac Server 8-bit Latin/Arabic
+AR8ARABICMACS:     nil          # FIXME
+
+# MS Windows 8-bit Bulgarian Cyrillic
+BG8MSWIN:          nil          # FIXME
+
+# IBM-PC Code Page 437 8-bit (Bulgarian Modification)
+BG8PC437S:         nil          # What is differnt with US8PC437?
+
+# Latvian Standard LVS8-92(1) Windows/Unix 8-bit Baltic
+BLT8CP921:         nil          # FIXME
+
+#IBM-PC Code Page 775 8-bit Baltic
+BLT8PC775:         IBM775
+
+# IBM-PC Code Page 863 8-bit Canadian French
+CDN8PC863:         IBM863
+
+# ISO 8859-14 Celtic
+CEL8ISO8859P14:    ISO-8859-14
+
+# ISOIR111 Cyrillic
+CL8ISOIR111:       nil          # FIXME
+
+# RELCOM Internet Standard 8-bit Latin/Cyrillic
+CL8KOI8R:          KOI8-R
+
+# KOI8 Ukrainian Cyrillic
+CL8KOI8U:          KOI8-U
+
+# Mac Server 8-bit Latin/Cyrillic
+CL8MACCYRILLICS:   macCyrillic
+
+# Mac Server 8-bit Central European
+EE8MACCES:         macCentEuro
+
+# Mac Server 8-bit Croatian
+EE8MACCROATIANS:   macCroatian
+
+# IBM-PC Code Page 852 8-bit East European
+EE8PC852:          IBM852       # or 'CP852'
+
+# DEC 8-bit Latin/Greek
+EL8DEC:            nil          # FIXME
+
+# Mac Server 8-bit Greek
+EL8MACGREEKS:      macGreek
+
+# IBM-PC Code Page 437 8-bit (Greek modification)
+EL8PC437S:         nil          # What is differnt with US8PC437?
+
+# IBM-PC Code Page 851 8-bit Greek/Latin
+EL8PC851:          nil          # FIXME
+
+# IBM-PC Code Page 869 8-bit Greek/Latin
+EL8PC869:          IBM869
+
+# MS Windows Code Page 923 8-bit Estonian
+ET8MSWIN923:       nil          # FIXME
+
+# Hungarian 8-bit Special AB Mod
+HU8ABMOD:          nil          # FIXME
+
+# Hungarian 8-bit CWI-2
+HU8CWI2:           nil          # FIXME
+
+# IBM-PC Code Page 861 8-bit Icelandic
+IS8PC861:          IBM861
+
+# German Government Printer 8-bit All-European Latin
+LA8PASSPORT:       nil          # FIXME
+
+# MS Windows Code Page 921 8-bit Lithuanian
+LT8MSWIN921:       nil          # FIXME
+
+# IBM-PC Code Page 772 8-bit Lithuanian (Latin/Cyrillic)
+LT8PC772:          nil          # FIXME
+
+# IBM-PC Code Page 774 8-bit Lithuanian (Latin)
+LT8PC774:          nil          # FIXME
+
+#Latvian Version IBM-PC Code Page 866 8-bit Latin/Cyrillic
+LV8PC8LR:          nil         # What is it differnt with RU8PC866?
+
+# IBM-PC Code Page 1117 8-bit Latvian
+LV8PC1117:         nil          # FIXME
+
+# IBM-PC Alternative Code Page 8-bit Latvian (Latin/Cyrillic)
+LV8RST104090:      nil          # FIXME
+
+# IBM-PC Code Page 865 8-bit Norwegian
+N8PC865:           IBM865
+
+# BESTA 8-bit Latin/Cyrillic
+RU8BESTA:          nil          # FIXME
+
+# IBM-PC Code Page 855 8-bit Latin/Cyrillic
+RU8PC855:          IBM855 # or 'CP855'
+
+# IBM-PC Code Page 866 8-bit Latin/Cyrillic
+RU8PC866:          IBM866
+
+# ISO 8859-3 South European
+SE8ISO8859P3:      ISO-8859-3
+
+# Mac Client 8-bit Turkish
+TR8MACTURKISH:     macTurkish
+
+# Mac Server 8-bit Turkish
+TR8MACTURKISHS:    macTurkish
+
+# ASCII 7-bit American
+US7ASCII:          US-ASCII
+
+# IBM-PC Code Page 437 8-bit American
+US8PC437:          IBM437
+
+# DEC 8-bit West European
+WE8DEC:            nil          # FIXME
+
+# DG 8-bit West European
+WE8DG:             nil          # FIXME
+
+# ISO 8859-1 West European
+WE8ISO8859P1:      ISO-8859-1
+
+#Mac Server 8-bit Extended Roman8 West European
+WE8MACROMAN8S:     macRoman
+
+# NCR 4970 8-bit West European
+WE8NCR4970:        nil          # FIXME
+
+# NeXTSTEP PostScript 8-bit West European
+WE8NEXTSTEP:       nil          # FIXME
+
+# IBM-PC Code Page 850 8-bit West European
+WE8PC850:          CP850
+
+# IBM-PC Code Page 858 8-bit West European
+WE8PC858:          nil          # FIXME
+
+# IBM-PC Code Page 860 8-bit West European
+WE8PC860:          IBM860
+
+# HP Roman8 8-bit West European
+WE8ROMAN8:         nil          # FIXME
+
+#
+# Universal
+#
+
+# Unicode 5.0 UTF-8 Universal character set, CESU-8 compliant
+UTF8:              UTF-8
+
+#
+############################################################
+
+############################################################
+# Oracle Database Globalization Support Guide 11g Release 1 (11.1)
+#
+# Table A-9 Client-Only Character Sets
+
+#
+# Asian
+#
+
+# EUC 24-bit Japanese with '\' mapped to the Japanese yen character
+JA16EUCYEN:        nil          # FIXME
+
+# Mac client Shift-JIS 16-bit Japanese
+JA16MACSJIS:       MacJapanese
+
+# Shift-JIS 16-bit Japanese with '\' mapped to the Japanese yen character
+JA16SJISYEN:       nil          # FIXME
+
+# Mac Client 8-bit Latin/Thai
+TH8MACTHAI:        macThai
+
+# GB18030-2000
+ZHS32GB18030:      GB18030
+
+# Mac client CGB2312-80 16-bit Simplified Chinese
+ZHS16MACCGB231280: nil          # FIXME
+
+#
+# European
+#
+
+# DEC VT100 7-bit Swiss (German/French)
+CH7DEC:            nil          # FIXME
+
+# Mac Client 8-bit Latin/Cyrillic
+CL8MACCYRILLIC:    macCyrillic
+
+# Siemens 97801/97808 7-bit German
+D7SIEMENS9780X:    nil          # FIXME
+
+# DEC VT100 7-bit German
+D7DEC:             nil          # FIXME
+
+# EEC Targon 35 ASCI West European/Greek
+EEC8EUROASCI:      nil          # FIXME
+
+# EEC EUROPA3 8-bit West European/Greek
+EEC8EUROPA3:       nil          # FIXME
+
+# Mac Client 8-bit Croatian
+EE8MACCROATIAN:    macCroatian
+
+# Mac Client 8-bit Central European
+EE8MACCE:          macCentEuro
+
+# IBM-PC Code Page 737 8-bit Greek/Latin
+EL8PC737:          IBM737
+
+# Mac Client 8-bit Greek
+EL8MACGREEK:       macGreek
+
+# DEC VT100 7-bit Spanish
+E7DEC:             nil          # FIXME
+
+# Siemens 97801/97808 7-bit Spanish
+E7SIEMENS9780X:    nil          # FIXME
+
+# DEC VT100 7-bit French
+F7DEC:             nil          # FIXME
+
+# Siemens 97801/97808 7-bit French
+F7SIEMENS9780X:    nil          # FIXME
+
+# DEC VT100 7-bit Italian
+I7DEC:             nil          # FIXME
+
+# Siemens 97801/97808 7-bit Italian
+I7SIEMENS9780X:    nil          # FIXME
+
+# Mac Server 8-bit Icelandic
+IS8MACICELANDICS:  macIceland
+
+# Mac Client 8-bit Icelandic
+IS8MACICELANDIC:   macIceland
+
+# DEC VT100 7-bit Dutch
+NL7DEC:            nil          # FIXME
+
+# DEC VT100 7-bit Norwegian/Danish
+NDK7DEC:           nil          # FIXME
+
+# Siemens 97801/97808 7-bit Norwegian
+N7SIEMENS9780X:    nil          # FIXME
+
+# DEC VT100 7-bit Finnish
+SF7DEC:            nil          # FIXME
+
+# Siemens 97801/97808 7-bit Swedish
+S7SIEMENS9780X:    nil          # FIXME
+
+# DEC VT100 7-bit Swedish
+S7DEC:             nil          # FIXME
+
+# ASCII 7-bit Finnish
+SF7ASCII:          nil          # FIXME
+
+# DEC VT100 7-bit Turkish
+TR7DEC:            nil          # FIXME
+
+# ICL special version ISO8859-1
+WE8ISOICLUK:       nil          # What is this different with ISO-8859-1?
+
+# Mac Client 8-bit Extended Roman8 West European
+WE8MACROMAN8:      macRoman
+
+# HP LaserJet 8-bit West European
+WE8HP:             nil          # FIXME
+
+# ASCII 7-bit Yugoslavian
+YUG7ASCII:         nil          # FIXME
+
+#
+# Middle Eastern
+#
+
+# Israeli Standard 960 7-bit Latin/Hebrew
+IW7IS960:          nil          # FIXME
+
+#
+############################################################
+
+
+############################################################
+# Oracle Database Globalization Support Guide 11g Release 1 (11.1)
+#
+# Table A-10 Universal Character Sets
+
+# Unicode 5.0 UTF-16 Universal character set
+AL16UTF16:         UTF-16BE
+
+#
+############################################################
+
+# Other
+AL16UTF16LE:       UTF-16LE