ext.test4j.apache.commons.lang.StringEscapeUtils Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of test4j.nodep Show documentation

There is a newer version: 2.5.0

package ext.test4j.apache.commons.lang;

import ext.test4j.apache.commons.lang.Entities;

public class StringEscapeUtils {
	/**
	 * 
	 * Escapes the characters in a String using XML entities.
	 * 
	 * 
	 * 
	 * For example: "bread" & "butter" =>
	 * &quot;bread&quot; &amp; &quot;butter&quot;.
	 * 
	 * 
	 * 
	 * Supports only the five basic XML entities (gt, lt, quot, amp, apos). Does
	 * not support DTDs or external entities.
	 * 
	 * 
	 * 
	 * Note that unicode characters greater than 0x7f are currently escaped to
	 * their numerical \\u equivalent. This may change in future releases.
	 * 
	 * 
	 * @param str
	 *            the String to escape, may be null
	 * @return a new escaped String, null if null
	 *         string input
	 * @see #unescapeXml(java.lang.String)
	 */
	public static String escapeXml(String str) {
		if (str == null) {
			return null;
		}
		return Entities.XML.escape(str);
	}
}