Package net.sf.saxon.functions.regex
Class JDK15RegexTranslator
java.lang.Object
net.sf.saxon.functions.regex.RegexTranslator
net.sf.saxon.functions.regex.JDK15RegexTranslator
This class translates XML Schema regex syntax into JDK 1.5 regex syntax. This differs from the JDK 1.4
translator because JDK 1.5 handles non-BMP characters (wide characters) in places where JDK 1.4 does not,
for example in a range such as [X-Y]. This enables much of the code from the 1.4 translator to be
removed.
Author: James Clark, Thai Open Source Software Center Ltd. See statement at end of file.
Modified by Michael Kay (a) to integrate the code into Saxon, and (b) to support XPath additions
to the XML Schema regex syntax. This version also removes most of the complexities of handling non-BMP
characters, since JDK 1.5 handles these natively.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescription(package private) static class
protected static class
protected static class
(package private) static class
(package private) static class
(package private) static class
(package private) static class
(package private) static class
(package private) static class
(package private) static class
Nested classes/interfaces inherited from class net.sf.saxon.functions.regex.RegexTranslator
RegexTranslator.Range
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final JDK15RegexTranslator.CharClass[]
Translates XML Schema and XPath regexes intojava.util.regex
regexes.static final JDK15RegexTranslator.CharClass[]
Fields inherited from class net.sf.saxon.functions.regex.RegexTranslator
ALL, captures, caseBlind, curChar, currentCapture, eos, expandComplementBlockNames, ignoreWhitespace, inCharClassExpr, isXPath, isXPath30, length, NONE, NOT_ALLOWED_CLASS, pos, regExp, result, SOME, SURROGATES1_CLASS, SURROGATES2_CLASS, warnings, xmlVersion, xsdVersion
-
Method Summary
Modifier and TypeMethodDescriptionstatic void
Main method for testing.static String
translate
(CharSequence regExp, int options, int flagbits, List<RegexSyntaxException> warnings) Translates a regular expression in the syntax of XML Schemas Part 2 into a regular expression in the syntax ofjava.util.regex.Pattern
.protected boolean
If what follows is an Atom, translate it and return true; otherwise return falseMethods inherited from class net.sf.saxon.functions.regex.RegexTranslator
absorbSurrogatePair, advance, copyCurChar, expect, highSurrogateRanges, isAsciiAlnum, isJavaMetaChar, lowSurrogateRanges, makeException, makeException, parseQuantExact, recede, translateBranch, translateQuantifier, translateQuantity, translateRegExp, translateTop
-
Field Details
-
categoryCharClasses
Translates XML Schema and XPath regexes intojava.util.regex
regexes.- See Also:
-
subCategoryCharClasses
-
-
Method Details
-
translate
public static String translate(CharSequence regExp, int options, int flagbits, List<RegexSyntaxException> warnings) throws RegexSyntaxException Translates a regular expression in the syntax of XML Schemas Part 2 into a regular expression in the syntax ofjava.util.regex.Pattern
. The translation assumes that the string to be matched against the regex uses surrogate pairs correctly. If the string comes from XML content, a conforming XML parser will automatically check this; if the string comes from elsewhere, it may be necessary to check surrogate usage before matching.- Parameters:
regExp
- a String containing a regular expression in the syntax of XML Schemas Part 2options
- bit-wise option settingsflagbits
- Java bit-wise options settings based on supplied flagswarnings
- a list to contain any warnings generated. If no list is supplied, this indicates that the caller is not interested in knowing about any warnings.- Returns:
- a JDK 1.5 regular expression
- Throws:
RegexSyntaxException
- ifregexp
is not a regular expression in the syntax of XML Schemas Part 2, or XPath 2.0, as appropriate- See Also:
-
translateAtom
Description copied from class:RegexTranslator
If what follows is an Atom, translate it and return true; otherwise return false- Specified by:
translateAtom
in classRegexTranslator
- Returns:
- true if we found an atom
- Throws:
RegexSyntaxException
- if the regex syntax is incorrect
-
main
Main method for testing. Outputs to System.err the Java translation of a supplied regular expression- Parameters:
args
- command line arguments arg[0] a regular expression arg[1] = xpath to invoke the XPath rules- Throws:
RegexSyntaxException
- if the regex is invalid
-