@qooxdoo/framework
Version:
The JS Framework for Coders
75 lines (64 loc) • 2.19 kB
JavaScript
/* ************************************************************************
qooxdoo - the new era of web development
http://qooxdoo.org
Copyright:
2004-2008 1&1 Internet AG, Germany, http://www.1und1.de
License:
MIT: https://opensource.org/licenses/MIT
See the LICENSE file in the project's top-level directory for details.
Authors:
* Fabian Jakobs (fjakobs)
************************************************************************ */
/**
* Escaping and unescaping of XML strings.
*/
qx.Class.define("qx.xml.String", {
statics: {
/** Mapping of XML entity names to the corresponding char code */
TO_CHARCODE: {
quot: 34, // " - double-quote
amp: 38, // &
lt: 60, // <
gt: 62, // >
apos: 39 // XML apostrophe
},
/** Mapping of char codes to XML entity names */
FROM_CHARCODE: {
34: "quot", // " - double-quote
38: "amp", // &
60: "lt", // <
62: "gt", // >
39: "apos" // XML apostrophe
},
/**
* Escapes the characters in a <code>String</code> using XML entities.
*
* For example: <tt>"bread" & "butter"</tt> =>
* <tt>&quot;bread&quot; &amp; &quot;butter&quot;</tt>.
*
* Supports only the four basic XML entities (gt, lt, quot, amp).
* Does not support DTDs or external entities.
* Note that unicode characters greater than 0x7f are currently escaped to their numerical \\u equivalent.
*
* @param str {String} the string to be escaped
* @return {String} the escaped string
*/
escape(str) {
return qx.util.StringEscape.escape(str, this.FROM_CHARCODE);
},
/**
* Unescapes a string containing XML entity escapes to a string
* containing the actual Unicode characters corresponding to the
* escapes.
*
* Supports only the four basic XML entities (gt, lt, quot, amp).
* Does not support DTDs or external entities.
*
* @param str {String} the string to be unescaped
* @return {String} the unescaped string
*/
unescape(str) {
return qx.util.StringEscape.unescape(str, this.TO_CHARCODE);
}
}
});