| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287 |
- const addressRegex = /^[A-Z]+\d+$/;
- // =========================================================================
- // Column Letter to Number conversion
- const colCache = {
- _dictionary: [
- 'A',
- 'B',
- 'C',
- 'D',
- 'E',
- 'F',
- 'G',
- 'H',
- 'I',
- 'J',
- 'K',
- 'L',
- 'M',
- 'N',
- 'O',
- 'P',
- 'Q',
- 'R',
- 'S',
- 'T',
- 'U',
- 'V',
- 'W',
- 'X',
- 'Y',
- 'Z',
- ],
- _l2nFill: 0,
- _l2n: {},
- _n2l: [],
- _level(n) {
- if (n <= 26) {
- return 1;
- }
- if (n <= 26 * 26) {
- return 2;
- }
- return 3;
- },
- _fill(level) {
- let c;
- let v;
- let l1;
- let l2;
- let l3;
- let n = 1;
- if (level >= 4) {
- throw new Error('Out of bounds. Excel supports columns from 1 to 16384');
- }
- if (this._l2nFill < 1 && level >= 1) {
- while (n <= 26) {
- c = this._dictionary[n - 1];
- this._n2l[n] = c;
- this._l2n[c] = n;
- n++;
- }
- this._l2nFill = 1;
- }
- if (this._l2nFill < 2 && level >= 2) {
- n = 27;
- while (n <= 26 + (26 * 26)) {
- v = n - (26 + 1);
- l1 = v % 26;
- l2 = Math.floor(v / 26);
- c = this._dictionary[l2] + this._dictionary[l1];
- this._n2l[n] = c;
- this._l2n[c] = n;
- n++;
- }
- this._l2nFill = 2;
- }
- if (this._l2nFill < 3 && level >= 3) {
- n = 26 + (26 * 26) + 1;
- while (n <= 16384) {
- v = n - ((26 * 26) + 26 + 1);
- l1 = v % 26;
- l2 = Math.floor(v / 26) % 26;
- l3 = Math.floor(v / (26 * 26));
- c = this._dictionary[l3] + this._dictionary[l2] + this._dictionary[l1];
- this._n2l[n] = c;
- this._l2n[c] = n;
- n++;
- }
- this._l2nFill = 3;
- }
- },
- l2n(l) {
- if (!this._l2n[l]) {
- this._fill(l.length);
- }
- if (!this._l2n[l]) {
- throw new Error(`Out of bounds. Invalid column letter: ${l}`);
- }
- return this._l2n[l];
- },
- n2l(n) {
- if (n < 1 || n > 16384) {
- throw new Error(`${n} is out of bounds. Excel supports columns from 1 to 16384`);
- }
- if (!this._n2l[n]) {
- this._fill(this._level(n));
- }
- return this._n2l[n];
- },
- // =========================================================================
- // Address processing
- _hash: {},
- // check if value looks like an address
- validateAddress(value) {
- if (!addressRegex.test(value)) {
- throw new Error(`Invalid Address: ${value}`);
- }
- return true;
- },
- // convert address string into structure
- decodeAddress(value) {
- const addr = value.length < 5 && this._hash[value];
- if (addr) {
- return addr;
- }
- let hasCol = false;
- let col = '';
- let colNumber = 0;
- let hasRow = false;
- let row = '';
- let rowNumber = 0;
- for (let i = 0, char; i < value.length; i++) {
- char = value.charCodeAt(i);
- // col should before row
- if (!hasRow && char >= 65 && char <= 90) {
- // 65 = 'A'.charCodeAt(0)
- // 90 = 'Z'.charCodeAt(0)
- hasCol = true;
- col += value[i];
- // colNumber starts from 1
- colNumber = (colNumber * 26) + char - 64;
- } else if (char >= 48 && char <= 57) {
- // 48 = '0'.charCodeAt(0)
- // 57 = '9'.charCodeAt(0)
- hasRow = true;
- row += value[i];
- // rowNumber starts from 0
- rowNumber = (rowNumber * 10) + char - 48;
- } else if (hasRow && hasCol && char !== 36) {
- // 36 = '$'.charCodeAt(0)
- break;
- }
- }
- if (!hasCol) {
- colNumber = undefined;
- } else if (colNumber > 16384) {
- throw new Error(`Out of bounds. Invalid column letter: ${col}`);
- }
- if (!hasRow) {
- rowNumber = undefined;
- }
- // in case $row$col
- value = col + row;
- const address = {
- address: value,
- col: colNumber,
- row: rowNumber,
- $col$row: `$${col}$${row}`,
- };
- // mem fix - cache only the tl 100x100 square
- if (colNumber <= 100 && rowNumber <= 100) {
- this._hash[value] = address;
- this._hash[address.$col$row] = address;
- }
- return address;
- },
- // convert r,c into structure (if only 1 arg, assume r is address string)
- getAddress(r, c) {
- if (c) {
- const address = this.n2l(c) + r;
- return this.decodeAddress(address);
- }
- return this.decodeAddress(r);
- },
- // convert [address], [tl:br] into address structures
- decode(value) {
- const parts = value.split(':');
- if (parts.length === 2) {
- const tl = this.decodeAddress(parts[0]);
- const br = this.decodeAddress(parts[1]);
- const result = {
- top: Math.min(tl.row, br.row),
- left: Math.min(tl.col, br.col),
- bottom: Math.max(tl.row, br.row),
- right: Math.max(tl.col, br.col),
- };
- // reconstruct tl, br and dimensions
- result.tl = this.n2l(result.left) + result.top;
- result.br = this.n2l(result.right) + result.bottom;
- result.dimensions = `${result.tl}:${result.br}`;
- return result;
- }
- return this.decodeAddress(value);
- },
- // convert [sheetName!][$]col[$]row[[$]col[$]row] into address or range structures
- decodeEx(value) {
- const groups = value.match(/(?:(?:(?:'((?:[^']|'')*)')|([^'^ !]*))!)?(.*)/);
- const sheetName = groups[1] || groups[2]; // Qouted and unqouted groups
- const reference = groups[3]; // Remaining address
- const parts = reference.split(':');
- if (parts.length > 1) {
- let tl = this.decodeAddress(parts[0]);
- let br = this.decodeAddress(parts[1]);
- const top = Math.min(tl.row, br.row);
- const left = Math.min(tl.col, br.col);
- const bottom = Math.max(tl.row, br.row);
- const right = Math.max(tl.col, br.col);
- tl = this.n2l(left) + top;
- br = this.n2l(right) + bottom;
- return {
- top,
- left,
- bottom,
- right,
- sheetName,
- tl: {address: tl, col: left, row: top, $col$row: `$${this.n2l(left)}$${top}`, sheetName},
- br: {
- address: br,
- col: right,
- row: bottom,
- $col$row: `$${this.n2l(right)}$${bottom}`,
- sheetName,
- },
- dimensions: `${tl}:${br}`,
- };
- }
- if (reference.startsWith('#')) {
- return sheetName ? {sheetName, error: reference} : {error: reference};
- }
- const address = this.decodeAddress(reference);
- return sheetName ? {sheetName, ...address} : address;
- },
- // convert row,col into address string
- encodeAddress(row, col) {
- return colCache.n2l(col) + row;
- },
- // convert row,col into string address or t,l,b,r into range
- encode() {
- switch (arguments.length) {
- case 2:
- return colCache.encodeAddress(arguments[0], arguments[1]);
- case 4:
- return `${colCache.encodeAddress(arguments[0], arguments[1])}:${colCache.encodeAddress(
- arguments[2],
- arguments[3]
- )}`;
- default:
- throw new Error('Can only encode with 2 or 4 arguments');
- }
- },
- // return true if address is contained within range
- inRange(range, address) {
- const [left, top, , right, bottom] = range;
- const [col, row] = address;
- return col >= left && col <= right && row >= top && row <= bottom;
- },
- };
- module.exports = colCache;
|