{"_id":"iconv-corefoundation","_rev":"4245062","name":"iconv-corefoundation","description":"Character set conversion using the macOS CoreFoundation API","dist-tags":{"latest":"1.1.7"},"maintainers":[{"name":"argvminusone","email":""}],"time":{"modified":"2026-03-29T21:30:16.000Z","created":"2019-06-12T03:50:49.160Z","1.1.7":"2021-11-28T22:58:33.858Z","1.1.6":"2021-05-13T20:37:07.308Z","1.1.5":"2020-08-05T01:13:55.607Z","1.1.4":"2020-06-09T22:04:30.430Z","1.1.3":"2019-07-21T20:11:00.254Z","1.1.2":"2019-07-18T00:34:58.850Z","1.1.1":"2019-06-26T23:54:19.259Z","1.1.0":"2019-06-15T22:00:01.627Z","1.0.0":"2019-06-12T03:50:49.160Z"},"users":{},"author":{"name":"argv-minus-one"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"versions":{"1.1.7":{"name":"iconv-corefoundation","version":"1.1.7","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"node -r ts-node/register --expose-gc node_modules/.bin/_mocha test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md","prepublishOnly":"npm test"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/mocha":"^9.0.0","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^9.1.3","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^2.1.0","node-addon-api":"^1.6.3"},"gitHead":"05394f04940a83431749c1672747eebcc8fae8ac","_id":"iconv-corefoundation@1.1.7","_nodeVersion":"17.0.1","_npmVersion":"8.1.0","dist":{"shasum":"31065e6ab2c9272154c8b0821151e2c88f1b002a","size":65652,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.1.7.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.1.7.tgz"},"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"maintainers":[{"name":"argvminusone","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.1.7_1638140313713_0.5022693227548538"},"_hasShrinkwrap":false,"publish_time":1638140313858,"_cnpm_publish_time":1638140313858,"_cnpmcore_publish_time":"2021-12-17T02:30:39.535Z"},"1.1.6":{"name":"iconv-corefoundation","version":"1.1.6","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"node -r ts-node/register --expose-gc node_modules/.bin/_mocha test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md","prepublishOnly":"npm test"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/cli-truncate":"^1.1.0","@types/mocha":"^5.2.6","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^7.2.0","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^1.1.0","node-addon-api":"^1.6.3"},"gitHead":"09fc154a7af1717eed6bb329bed86334a61cd720","_id":"iconv-corefoundation@1.1.6","_nodeVersion":"15.7.0","_npmVersion":"7.4.3","dist":{"shasum":"27c135470237f6f8d13462fa1f5eaf250523c29a","size":66115,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.1.6.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.1.6.tgz"},"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"maintainers":[{"name":"argvminusone","email":""}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.1.6_1620938227148_0.39697273736874616"},"_hasShrinkwrap":false,"publish_time":1620938227308,"_cnpm_publish_time":1620938227308,"_cnpmcore_publish_time":"2021-12-17T02:30:40.112Z"},"1.1.5":{"name":"iconv-corefoundation","version":"1.1.5","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"node -r ts-node/register --expose-gc node_modules/.bin/_mocha test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md","prepublishOnly":"npm test"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/cli-truncate":"^1.1.0","@types/mocha":"^5.2.6","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^7.2.0","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^1.1.0","node-addon-api":"^1.6.3"},"gitHead":"61009c01bbf0a3967dae0809d321cab9865e5117","_id":"iconv-corefoundation@1.1.5","_nodeVersion":"14.4.0","_npmVersion":"6.14.4","dist":{"shasum":"90596d444a579aeb109f5ca113f6bb665a41be2b","size":36649,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.1.5.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.1.5.tgz"},"maintainers":[{"name":"argvminusone","email":""}],"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.1.5_1596590035421_0.8538013676965279"},"_hasShrinkwrap":false,"publish_time":1596590035607,"_cnpm_publish_time":1596590035607,"_cnpmcore_publish_time":"2021-12-17T02:30:40.456Z"},"1.1.4":{"name":"iconv-corefoundation","version":"1.1.4","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"node -r ts-node/register --expose-gc node_modules/.bin/_mocha test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md","prepublishOnly":"npm test"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/cli-truncate":"^1.1.0","@types/mocha":"^5.2.6","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^7.2.0","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^1.1.0","node-addon-api":"^1.6.3"},"gitHead":"ccace79e837f78c17678b866c8061c13742b1aa4","_id":"iconv-corefoundation@1.1.4","_nodeVersion":"14.4.0","_npmVersion":"6.14.4","dist":{"shasum":"62986064894502920348628364a86aeb7fea59c7","size":36649,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.1.4.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.1.4.tgz"},"maintainers":[{"name":"argvminusone","email":""}],"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.1.4_1591740270272_0.9615169954944689"},"_hasShrinkwrap":false,"publish_time":1591740270430,"_cnpm_publish_time":1591740270430,"_cnpmcore_publish_time":"2021-12-17T02:30:40.961Z"},"1.1.3":{"name":"iconv-corefoundation","version":"1.1.3","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"node -r ts-node/register --expose-gc node_modules/.bin/_mocha test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md","prepublishOnly":"npm test"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/cli-truncate":"^1.1.0","@types/mocha":"^5.2.6","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^6.1.4","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^1.1.0","node-addon-api":"^1.6.3"},"gitHead":"fd99446fc04d7a6024018301b0ccfa4a3a9fba99","_id":"iconv-corefoundation@1.1.3","_nodeVersion":"12.3.0","_npmVersion":"6.9.0","dist":{"shasum":"ea395a59757013410af191138c3573214aa35a1c","size":34511,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.1.3.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.1.3.tgz"},"maintainers":[{"name":"argvminusone","email":""}],"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.1.3_1563739860108_0.08068616782006588"},"_hasShrinkwrap":false,"publish_time":1563739860254,"_cnpm_publish_time":1563739860254,"_cnpmcore_publish_time":"2021-12-17T02:30:41.282Z"},"1.1.2":{"name":"iconv-corefoundation","version":"1.1.2","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"mocha -r ts-node/register test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md","prepublishOnly":"npm test"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/cli-truncate":"^1.1.0","@types/mocha":"^5.2.6","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^6.1.4","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^1.1.0","node-addon-api":"^1.6.3"},"gitHead":"f2a4563a237a61705d9eec1b5dc78b6cdc4edb28","_id":"iconv-corefoundation@1.1.2","_nodeVersion":"12.3.0","_npmVersion":"6.9.0","dist":{"shasum":"61cc771f28129d09e6c6c3027ffdc9458bf576f2","size":34308,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.1.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.1.2.tgz"},"maintainers":[{"name":"argvminusone","email":""}],"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.1.2_1563410098660_0.6833571056135275"},"_hasShrinkwrap":false,"publish_time":1563410098850,"_cnpm_publish_time":1563410098850,"_cnpmcore_publish_time":"2021-12-17T02:30:41.566Z"},"1.1.1":{"name":"iconv-corefoundation","version":"1.1.1","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"mocha -r ts-node/register test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/cli-truncate":"^1.1.0","@types/mocha":"^5.2.6","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^6.1.4","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^1.1.0","node-addon-api":"^1.6.3"},"gitHead":"eca235f03b91d4712eac8b7024d0e8c813bfa04c","_id":"iconv-corefoundation@1.1.1","_nodeVersion":"12.3.0","_npmVersion":"6.9.0","dist":{"shasum":"64283b993c307b1f1a8d86730677c9aa8a6c57ed","size":34296,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.1.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.1.1.tgz"},"maintainers":[{"name":"argvminusone","email":""}],"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.1.1_1561593259100_0.6691936681613575"},"_hasShrinkwrap":false,"publish_time":1561593259259,"_cnpm_publish_time":1561593259259,"_cnpmcore_publish_time":"2021-12-17T02:30:41.822Z"},"1.1.0":{"name":"iconv-corefoundation","version":"1.1.0","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"mocha -r ts-node/register test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/cli-truncate":"^1.1.0","@types/mocha":"^5.2.6","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^6.1.4","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^1.1.0","node-addon-api":"^1.6.3"},"gitHead":"a4a3a374c85f80cd68fc3c64dce059012956bf1a","_id":"iconv-corefoundation@1.1.0","_nodeVersion":"12.3.0","_npmVersion":"6.9.0","dist":{"shasum":"b19837dee9b9a51aca4ecfe0ff7c98a17d71d3e4","size":34262,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.1.0.tgz"},"maintainers":[{"name":"argvminusone","email":""}],"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.1.0_1560636001270_0.9348818280829865"},"_hasShrinkwrap":false,"publish_time":1560636001627,"_cnpm_publish_time":1560636001627,"_cnpmcore_publish_time":"2021-12-17T02:30:42.089Z"},"1.0.0":{"name":"iconv-corefoundation","version":"1.0.0","description":"Character set conversion using the macOS CoreFoundation API","main":"lib/index.js","types":"lib/index.d.ts","scripts":{"prepare":"tsc && make -f native.mk","test":"mocha -r ts-node/register test/**.spec.ts","docs":"api-extractor run && api-documenter markdown --input-folder temp --output-folder docs && ln -s iconv-corefoundation.md docs/index.md"},"repository":{"type":"git","url":"git+https://github.com/argv-minus-one/iconv-corefoundation.git"},"keywords":["corefoundation","iconv","convert","charset","mac"],"author":{"name":"argv-minus-one"},"license":"MIT","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","os":["darwin"],"engines":{"node":"^8.11.2 || >=10"},"devDependencies":{"@microsoft/api-documenter":"^7.2.1","@microsoft/api-extractor":"^7.1.6","@types/bindings":"^1.3.0","@types/chai":"^4.1.7","@types/cli-truncate":"^1.1.0","@types/mocha":"^5.2.6","@types/node":"^12.0.2","chai":"^4.2.0","chai-bytes":"^0.1.2","mocha":"^6.1.4","ts-node":"^8.1.0","typescript":"^3.4.5"},"dependencies":{"cli-truncate":"^1.1.0","node-addon-api":"^1.6.3"},"gitHead":"86e9757ffd2f264e40f5a11d59e10bad4a5b25a4","_id":"iconv-corefoundation@1.0.0","_nodeVersion":"12.3.0","_npmVersion":"6.9.0","dist":{"shasum":"8964eb417dff7f8fe6d3b9600285d17d5795e5f2","size":33691,"noattachment":false,"key":"/iconv-corefoundation/-/iconv-corefoundation-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/iconv-corefoundation/download/iconv-corefoundation-1.0.0.tgz"},"maintainers":[{"name":"argvminusone","email":""}],"_npmUser":{"name":"argvminusone","email":"argv.minus.one@gmail.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/iconv-corefoundation_1.0.0_1560311448993_0.5321244971010262"},"_hasShrinkwrap":false,"publish_time":1560311449160,"_cnpm_publish_time":1560311449160,"_cnpmcore_publish_time":"2021-12-17T02:30:42.408Z"}},"readme":"# iconv-corefoundation\n\nA Node.js library for character set conversion (like [iconv-lite](https://www.npmjs.com/package/iconv-lite)), using the macOS “Core Foundation” API.\n\nThis package contains a pre-compiled native add-on for Node.js, using N-API. See “System Requirements” below for details.\n\n## Why?\n\n`CoreFoundation.framework` contains, to my knowledge, the only character set converter supporting *all* of the legacy Macintosh scripts, including non-Apple ones (such as Mac OS Inuit) and double-byte scripts (such as Mac OS Japanese). If your Node.js program needs to handle these, and runs only on macOS, this package may be your best bet.\n\nThis is not intended for general character set conversion needs. Use iconv-lite for that; it's not limited to a single platform, it doesn't have any native code, and it's probably faster. This package is for when you specifically need to use Core Foundation's character set conversion facilities.\n\n## License\n\niconv-corefoundation is provided under the terms of the MIT license. You can find the text of the MIT license in the [LICENSE](LICENSE) file.\n\n## System Requirements\n\n### Using\n\nThis package requires macOS, because it uses a macOS platform API (the Core Foundation framework) to do the actual work.\n\nThe native code portion of this package requires macOS 10.10 or newer.\n\nThis package requires [N-API](https://nodejs.org/dist/latest-v12.x/docs/api/n-api.html) version 3, which is available in Node.js versions 8.11.2, 10, and newer (but not 9).\n\n### Building\n\nBuilding this package isn't required to use it. Because this package only works on one platform, the native code is pre-compiled.\n\nIn addition to the system requirements for using this package, building it also requires the Xcode command-line tools to be installed. If they aren't, a window should appear offering to install them. If that doesn't work, run the command `xcode-select --install` to explicitly install them.\n\nGCC does not seem to work; it fails to compile Core Foundation header files.\n\n## API\n\n[API documentation is in the `docs` folder.](docs/iconv-corefoundation.md)\n\nThe API for this package centers around the `StringEncoding` class. Each instance of this class represents a character encoding, such as ASCII or Mac OS Roman. To get a `StringEncoding` instance, call one of the static methods starting with `by`, such as `byCFStringEncoding`. (`StringEncoding` may not be constructed directly. It is instantiated only by native code.) Instances of `StringEncoding` have several informational properties (such as `ianaCharSetName`, the corresponding IANA character set name) and the methods `encode` and `decode`.\n\nThere are also several top-level functions exported by this package, like `transcode` (which converts one buffer to another, without creating a JavaScript string in between) and `encodeSmallest` (which encodes a string in the byte-wise smallest available encoding).\n\n## Caveats\n\nI have not benchmarked this code. I do not expect it to be fast. Encoding and decoding strings involves copying the string at least once, which is a fairly expensive operation, especially with large strings.\n\nThere is no streaming API. Core Foundation does not seem to have any notion of streaming character set conversion, so neither does this package.\n","_attachments":{},"homepage":"https://github.com/argv-minus-one/iconv-corefoundation#readme","bugs":{"url":"https://github.com/argv-minus-one/iconv-corefoundation/issues"},"license":"MIT"}