depend jstrs: encodeUTF8 & decodeUTF8

zswang · Mar 1, 2016 · 8f1522f · 8f1522f
1 parent b4ccff6
commit 8f1522f
Show file tree

Hide file tree

Showing 6 changed files with 54 additions and 32 deletions.
diff --git a/bower.json b/bower.json
@@ -1,7 +1,7 @@
 {
   "name": "jpacks",
   "description": "Binary data packing and unpacking.",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "homepage": "https://github.com/zswang/jpacks",
   "authors": {
     "name": "zswang",

diff --git a/jpacks.dev.js b/jpacks.dev.js
@@ -5,8 +5,8 @@
    * Binary data packing and unpacking.
    * @author
    *   zswang (http://weibo.com/zswang)
-   * @version 0.6.3
-   * @date 2016-02-29
+   * @version 0.6.5
+   * @date 2016-03-01
    */
   function createSchema() {
   /**
@@ -1008,21 +1008,38 @@
     fn.args = args;
   });
   Schema.register('enums', enums);
+  /*<function name="encodeUTF8">*/
   /**
    * 对字符串进行 utf8 编码
    *
    * param {string} str 原始字符串
+   '''<example>'''
+   * @example encodeUTF8():base
+    ```js
+    console.log(jstrs.encodeUTF8('汉'));
+    // > æ±
+    ```
+   '''</example>'''
    */
   function encodeUTF8(str) {
     if (/[\u0080-\uffff]/.test(str)) {
       return unescape(encodeURIComponent(str));
     }
     return str;
   }
+  /*</function>*/
+  /*<function name="decodeUTF8">*/
   /**
    * 对 utf8 字符串进行解码
    *
    * @param {string} str 编码字符串
+   '''<example>'''
+   * @example decodeUTF8():base
+    ```js
+    console.log(jstrs.decodeUTF8('æ±'));
+    // > 汉
+    ```
+   '''</example>'''
    */
   function decodeUTF8(str) {
     if (/[\u00c0-\u00df][\u0080-\u00bf]/.test(str) ||
@@ -1031,6 +1048,7 @@
     }
     return str;
   }
+  /*</function>*/
   /**
    * 将字符串转换为字节数组
    *

diff --git a/jpacks.js b/jpacks.js
@@ -5,8 +5,8 @@
    * Binary data packing and unpacking.
    * @author
    *   zswang (http://weibo.com/zswang)
-   * @version 0.6.3
-   * @date 2016-02-29
+   * @version 0.6.5
+   * @date 2016-03-01
    */
   function createSchema() {
   /**
@@ -945,21 +945,38 @@
     fn.args = args;
   });
   Schema.register('enums', enums);
+  /*<function name="encodeUTF8">*/
   /**
    * 对字符串进行 utf8 编码
    *
    * param {string} str 原始字符串
+   '''<example>'''
+   * @example encodeUTF8():base
+    ```js
+    console.log(jstrs.encodeUTF8('汉'));
+    // > æ±
+    ```
+   '''</example>'''
    */
   function encodeUTF8(str) {
     if (/[\u0080-\uffff]/.test(str)) {
       return unescape(encodeURIComponent(str));
     }
     return str;
   }
+  /*</function>*/
+  /*<function name="decodeUTF8">*/
   /**
    * 对 utf8 字符串进行解码
    *
    * @param {string} str 编码字符串
+   '''<example>'''
+   * @example decodeUTF8():base
+    ```js
+    console.log(jstrs.decodeUTF8('æ±'));
+    // > 汉
+    ```
+   '''</example>'''
    */
   function decodeUTF8(str) {
     if (/[\u00c0-\u00df][\u0080-\u00bf]/.test(str) ||
@@ -968,6 +985,7 @@
     }
     return str;
   }
+  /*</function>*/
   /**
    * 将字符串转换为字节数组
    *