net.sf.saxon.functions

Class EscapeURI

public class EscapeURI extends SystemFunction

This class supports the functions encode-for-uri() and iri-to-uri()

Field Summary
static boolean[]	allowedASCII
static int	ENCODE_FOR_URI
static int	HTML_URI
static int	IRI_TO_URI

Method Summary
static void	checkPercentEncoding(String uri) Check that any percent-encoding within a URI is well-formed.
static CharSequence	escape(CharSequence s, String allowedPunctuation) Escape special characters in a URI.
Item	evaluateItem(XPathContext c) Evaluate the function
static CharSequence	iriToUri(CharSequence s) Escape special characters in a URI.

Field Detail

Method Detail

checkPercentEncoding

public static void checkPercentEncoding(String uri)

Check that any percent-encoding within a URI is well-formed. The method assumes that a percent sign followed by two hex digits represents an octet of the UTF-8 representation of a character; any other percent sign is assumed to represent itself.

Parameters: uri the string to be checked for validity

Throws: XPathException if the string is not validly percent-encoded

escape

public static CharSequence escape(CharSequence s, String allowedPunctuation)

Escape special characters in a URI. The characters that are %HH-encoded are all non-ASCII characters, plus all ASCII characters except (a) letter A-Z and a-z, (b) digits 0-9, and (c) characters listed in the allowedPunctuation argument

Parameters: s the URI to be escaped allowedPunctuation ASCII characters other than letters and digits that should NOT be %HH-encoded

Returns: the %HH-encoded string

evaluateItem

public Item evaluateItem(XPathContext c)

Evaluate the function

iriToUri

public static CharSequence iriToUri(CharSequence s)

Escape special characters in a URI. The characters that are %HH-encoded are all non-ASCII characters

Parameters: s the URI to be escaped

Returns: the %HH-encoded string