www.aleph1.co.uk Git - yaffs-website/blob - node_modules/iconv-lite/lib/index.js

   1 "use strict"
   2
   3 var bomHandling = require('./bom-handling'),
   4     iconv = module.exports;
   5
   6 // All codecs and aliases are kept here, keyed by encoding name/alias.
   7 // They are lazy loaded in `iconv.getCodec` from `encodings/index.js`.
   8 iconv.encodings = null;
   9
  10 // Characters emitted in case of error.
  11 iconv.defaultCharUnicode = '�';
  12 iconv.defaultCharSingleByte = '?';
  13
  14 // Public API.
  15 iconv.encode = function encode(str, encoding, options) {
  16     str = "" + (str || ""); // Ensure string.
  17
  18     var encoder = iconv.getEncoder(encoding, options);
  19
  20     var res = encoder.write(str);
  21     var trail = encoder.end();
  22
  23     return (trail && trail.length > 0) ? Buffer.concat([res, trail]) : res;
  24 }
  25
  26 iconv.decode = function decode(buf, encoding, options) {
  27     if (typeof buf === 'string') {
  28         if (!iconv.skipDecodeWarning) {
  29             console.error('Iconv-lite warning: decode()-ing strings is deprecated. Refer to https://github.com/ashtuchkin/iconv-lite/wiki/Use-Buffers-when-decoding');
  30             iconv.skipDecodeWarning = true;
  31         }
  32
  33         buf = new Buffer("" + (buf || ""), "binary"); // Ensure buffer.
  34     }
  35
  36     var decoder = iconv.getDecoder(encoding, options);
  37
  38     var res = decoder.write(buf);
  39     var trail = decoder.end();
  40
  41     return trail ? (res + trail) : res;
  42 }
  43
  44 iconv.encodingExists = function encodingExists(enc) {
  45     try {
  46         iconv.getCodec(enc);
  47         return true;
  48     } catch (e) {
  49         return false;
  50     }
  51 }
  52
  53 // Legacy aliases to convert functions
  54 iconv.toEncoding = iconv.encode;
  55 iconv.fromEncoding = iconv.decode;
  56
  57 // Search for a codec in iconv.encodings. Cache codec data in iconv._codecDataCache.
  58 iconv._codecDataCache = {};
  59 iconv.getCodec = function getCodec(encoding) {
  60     if (!iconv.encodings)
  61         iconv.encodings = require("../encodings"); // Lazy load all encoding definitions.
  62
  63     // Canonicalize encoding name: strip all non-alphanumeric chars and appended year.
  64     var enc = (''+encoding).toLowerCase().replace(/[^0-9a-z]|:\d{4}$/g, "");
  65
  66     // Traverse iconv.encodings to find actual codec.
  67     var codecOptions = {};
  68     while (true) {
  69         var codec = iconv._codecDataCache[enc];
  70         if (codec)
  71             return codec;
  72
  73         var codecDef = iconv.encodings[enc];
  74
  75         switch (typeof codecDef) {
  76             case "string": // Direct alias to other encoding.
  77                 enc = codecDef;
  78                 break;
  79
  80             case "object": // Alias with options. Can be layered.
  81                 for (var key in codecDef)
  82                     codecOptions[key] = codecDef[key];
  83
  84                 if (!codecOptions.encodingName)
  85                     codecOptions.encodingName = enc;
  86
  87                 enc = codecDef.type;
  88                 break;
  89
  90             case "function": // Codec itself.
  91                 if (!codecOptions.encodingName)
  92                     codecOptions.encodingName = enc;
  93
  94                 // The codec function must load all tables and return object with .encoder and .decoder methods.
  95                 // It'll be called only once (for each different options object).
  96                 codec = new codecDef(codecOptions, iconv);
  97
  98                 iconv._codecDataCache[codecOptions.encodingName] = codec; // Save it to be reused later.
  99                 return codec;
 100
 101             default:
 102                 throw new Error("Encoding not recognized: '" + encoding + "' (searched as: '"+enc+"')");
 103         }
 104     }
 105 }
 106
 107 iconv.getEncoder = function getEncoder(encoding, options) {
 108     var codec = iconv.getCodec(encoding),
 109         encoder = new codec.encoder(options, codec);
 110
 111     if (codec.bomAware && options && options.addBOM)
 112         encoder = new bomHandling.PrependBOM(encoder, options);
 113
 114     return encoder;
 115 }
 116
 117 iconv.getDecoder = function getDecoder(encoding, options) {
 118     var codec = iconv.getCodec(encoding),
 119         decoder = new codec.decoder(options, codec);
 120
 121     if (codec.bomAware && !(options && options.stripBOM === false))
 122         decoder = new bomHandling.StripBOM(decoder, options);
 123
 124     return decoder;
 125 }
 126
 127
 128 // Load extensions in Node. All of them are omitted in Browserify build via 'browser' field in package.json.
 129 var nodeVer = typeof process !== 'undefined' && process.versions && process.versions.node;
 130 if (nodeVer) {
 131
 132     // Load streaming support in Node v0.10+
 133     var nodeVerArr = nodeVer.split(".").map(Number);
 134     if (nodeVerArr[0] > 0 || nodeVerArr[1] >= 10) {
 135         require("./streams")(iconv);
 136     }
 137
 138     // Load Node primitive extensions.
 139     require("./extend-node")(iconv);
 140 }
 141