👔String extension

JS ⟩ value ⟩ primitive ⟩ String ⟩ extension

add custom methods to String.prototype.

// 🔸 str.characters                - iterable iterator of characters
// 🔸 str.codePoints                - array of code points
// 🔸 str.codeUnits                 - array of code units
// 🔹 str.replaceWhitespaces()

💾 程式

• replit ⟩ String extension

// ⭐ install "grapheme-splitter": `npm install grapheme-splitter`

// 2023.01.03 - 19:40 + .codeUnits, .codePoints (support `GraphemeSplitter`)
//
// ⭐  String extension
// -------------------------------------------------------------------
// 🔸 str.characters                - iterable iterator of characters
// 🔸 str.codePoints                - array of code points
// 🔸 str.codeUnits                 - array of code units
// 🔹 str.replaceWhitespaces()
// -------------------------------------------------------------------

const { range } = require('./Iterable.js');      // iterable methods

// ⭐ import 'grapheme-splitter'
const GraphemeSplitter = require('grapheme-splitter');
const splitter = new GraphemeSplitter();
// -------------------------------------------------------------------

// String extension
Object.defineProperties(String.prototype, {

    // 🔹 str.replaceWhitespaces()
    replaceWhitespaces: {
        value: function(str = ',') {
            return this
                .trim()    // ⭐️ removes whitespace from both ends
                .replace(/\s+/g, str);
        },
    },

    // 🔸 str.characters
    // - real characters (grapheme clusters, may contain many code points)
    characters: {
        get: function() {
            // string -> iterable iterator
            return splitter.iterateGraphemes(this);
        },
    },

    // 🔸 str.codePoints
    // - 1 code point may contain 1 ~ 2 code units.
    codePoints: {
        get: function() {
            let codePoints = [];
            for (const char of this) {    // an iterator of "code points"
                codePoints.push(char.codePointAt(0));
            }
            return codePoints;
        },
    },

    // 🔸 str.codeUnits
    // - 16-bit code units
    codeUnits: {
        get: function() {
            return [...range(0, this.length - 1).map(i => this.charCodeAt(i))];
        },
    },
});

// export
module.exports = {};

💈範例

const _Number = require('./ext/Number_ext.js');      // Number extension
const _String = require('./ext/String_ext.js');      // String extension
const { range } = require('./ext/Iterable.js');      // iterable methods
// ---------------------------------------------------------------------------

// ⭐ import 'grapheme-splitter'
const GraphemeSplitter = require('grapheme-splitter');
const ilove = 'I❤️🏳️‍🌈';

// `.characters` iterates over "grapheme clusters".
ilove.characters.array,    // [ 'I', '❤️', '🏳️‍🌈' ]    (3 characters)
ilove.characters.map(ch => ch.codePoints).array,
// [ [ 73 ], [ 10084, 65039 ], [ 127987, 65039, 8205, 127752 ] ]    (7 code points)
//           [ '❤'  ,     ? ]  [ '🏳'  ,     ?,    ?, '🌈'  ]
//   ╰─I──╯  ╰───── ❤️ ─────╯  ╰──────────── 🏳️‍🌈 ─────────────╯

// `str.map` iterates over "code points"❗
// code point -> 1 or 2 code units
ilove.map(cp => cp.codeUnits).array,            // (9 code units)
// [
//   [ 73 ],
//   [ 10084 ],
//   [ 65039 ],
//   [ 55356, 57331 ],   // surrogate pair
//   [ 65039 ],
//   [ 8205 ],
//   [ 55356, 57096 ]    // surrogate pair
// ]

🔸 屬性

• str.isKeyword - check if a string is a keyword

• str.isReservedWord - check if a string a reserved word

• str.isPunctuator - check if a string is a punctuator

👥 相關

• Unicode - about code points, code units ...

⬇️ 應用

• grapheme cluster

• flag /u