【JavaScript之String系列】

字符创扩展：

/**
 * 文本扩展
 * @class $Kit.String
 * @requires kit.js
 * @see <a href="https://github.com/xueduany/KitJs/blob/master/KitJs/src/js/string.js">Source code</a>
 */
$Kit.String = function() {
    //
}
$kit.merge($Kit.String.prototype,
/**
 * @lends $Kit.String.prototype
 */
{
    /**
     * 断句
     * @param {String}
     * @return {String}
     */
    breakSentence : function(str) {
        return str.replace(/([,\.\?!;:][\s"'’”)])(\n?)/g, '$1\n');
    },
    /**
     * HTML字符串转移，如&转移为&amp;保证可以在页面显示html代码，而不是实际内容
     * @param {String}
     * @return {String}
     */
    HTMLEncode : function(str) {
        return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/ /g, '&nbsp;').replace(/\'/g, '&#39;').replace(/\"/g, '&quot;');
    },
    /**
     * 解码转义过的html
     * @param {String}
     * @return {String}
     */
    HTMLDecode : function(str) {
        return str.replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&nbsp;/g, ' ').replace(/&#39;'/g, '\'').replace(/&quot/g, '"');
    },
    /**
     * gb2312转换unicode进制
     * @param {String}
     * @return {String}
     */
    ChineseToUnicode : function(str) {
        return escape(str).replace(/%u/g, '\\u').replace(/%([0-9a-f]{2})/ig, '\\u00$1');
    },
    /**
     * unicode进制转换gb2312
     * @param {String}
     * @return {String}
     */
    UnicodeToChinese : function(str) {
        return unescape(str.replace(/\\u00/g, '%').replace(/\\u/g, '%u'));
    },
    /**
     * &#xxx;转义中文
     * @param {String}
     * @return {String}
     */
    HTMLEntityToChinese : function(str) {
        var regExp = /&#([0-9]+);/ig;
        while(str.match(regExp) && str.match(regExp).length) {
            var find = str.match(regExp)[0];
            str = str.replace(find, String.fromCharCode(find.substring(2, find.length - 1)));
        }
        return str;
    },
    /**
     * 中文转html实体
     * @param {String}
     * @return {String}
     */
    ChineseToHTMLEntity : function(str) {
        var re = [];
        for(var i = 0; i < str.length; i++) {
            var charCode = str.charCodeAt(i);
            re.push('&#' + charCode + ';');
        }
        return re.join('');
    },
    /**
     * html实体字符&#xxx;转换unicode
     * @param {String}
     * @return {String}
     */
    HTMLEntityToUnicode : function(str) {
        var regExp = /&#([0-9]+);/ig;
        while(str.match(regExp) && str.match(regExp).length) {
            var find = str.match(regExp)[0];
            var code = find.substring(2, find.length - 1);
            str = str.replace(find, '\\u' + $kit.math.padZero($kit.math.convert(code, 10, 16), 4));
        }
        return str;
    },
    /**
     * unicode转html实体
     * @param {String}
     * @return {String}
     */
    UnicodeToHTMLEntity : function(str) {
        var regExp = /\\u([0-9a-f]+)/ig;
        while(str.match(regExp) && str.match(regExp).length) {
            var find = str.match(regExp)[0];
            var code = find.substring(2);
            str = str.replace(find, '&#' + $kit.math.convert(code, 16, 10) + ';');
        }
        return str;
    },
    /**
     * convert方法 统一接口
     * @param {String}
     * @param {String}
     * @param {String}
     * @return {String}
     */
    convert : function(str, oldEncoding, newEncoding) {
        switch (oldEncoding.toLowerCase()) {
            case 'unicode':
            case 'utf':
                switch (newEncoding.toLowerCase()) {
                    case 'gbk':
                    case 'gb2312':
                    case 'gb':
                    case 'chinese':
                        return this.UnicodeToChinese(str);
                        break;
                    case 'htmlentity':
                    case 'entity':
                        return this.UnicodeToHTMLEntity(str);
                        break;
                }
                break;
            case 'gbk':
            case 'gb2312':
            case 'gb':
            case 'chinese':
                switch (newEncoding.toLowerCase()) {
                    case 'unicode':
                    case 'utf':
                        return this.ChineseToUnicode(str);
                        break;
                    case 'htmlentity':
                    case 'entity':
                        return this.ChineseToHTMLEntity(str);
                        break;
                }
                break;
            case 'htmlentity':
            case 'entity':
                switch (newEncoding.toLowerCase()) {
                    case 'gbk':
                    case 'gb2312':
                    case 'gb':
                    case 'chinese':
                        return this.HTMLEntityToChinese(str);
                        break;
                    case 'unicode':
                    case 'utf':
                        return this.HTMLEntityToUnicode(str);
                        break;
                }
                break;
        }
    }
});
/**
 * $Kit.String的实例，直接通过这个实例访问$Kit.String所有方法
 * @global
 * @alias $kit.str
 * @type $Kit.String
 */
$kit.str = $kit.string = new $Kit.String();