viv:test

Synopsis

boolean
	viv:test
	(str, pattern, pattern-type);
string    str;
string    pattern;
"wc"|"wc-set"|"regex"| "perl-regex" | "case-insensitive-regex" | "case-insensitive-perl-regex"   pattern-type;

Description

Test if a string matches a certain pattern.

Arguments

• str: string on which to try to match the pattern
• pattern: pattern to be matched.
• pattern-type: the type of pattern-matching that should be used in the comparison, which is one of the following:
  1. wc - a single expression containing alphanumeric characters plus any number of '?' or '*' characters that can, respectively, match any single character or any sequence of characters
  2. wc-set - multiple wc expressions, separated from each other by an OR symbol ('|')
  3. regex - a single expression containing any number of alphanumeric characters and special characters such as '?', '.', '*', '+', '(', ')', '{', '}', '[', and ']', plus special characters such as '^' and '$' that combine to identify a pattern of characters to be matched. Watson Explorer Engine's regex pattern type conforms to the POSIX specification, and therefore only handles single-byte ASCII characters. To match multi-byte UTF-8 characters, you must use the perl-regex or case-insensitive-perl-regex pattern types. For more detailed information about using POSIX regular expressions in Watson Explorer Engine. see POSIX Regular Expression Syntax and Examples.
  4. cregex - a deprecated synonym for Watson Explorer Engine's case-insensitive-regex pattern type. This pattern type is only supported for backward compatibility with older releases of Watson Explorer Engine, and should not be used in new projects.
  5. perl-regex - a single expression containing any number of alphanumeric characters and special characters such as '?', '.', '*', '+', '~', '(', ')', '{', '}', '[', and ']', plus special characters such as '^' and '$' that combine to identify a pattern of characters to be matched. Watson Explorer Engine's perl-regex pattern type uses the Perl-Compatible Regular Expression (PCRE) library, and therefore conforms to the regular expression syntax supported by Perl version 5, most notably where '.' will match multi-byte UTF-8 characters. For more detailed information about using Perl-style regular expressions in Watson Explorer Engine, see Perl Compatible Regular Expression Syntax.
  6. case-insensitive-regex - a case-insensitive version of the Watson Explorer Engine regex pattern type. Any alphabetic, single-byte characters that are specified in the pattern will match both the upper and lower-case versions of that character. To match upper and lower-case versions of multi-byte UTF-8 characters, you must use the case-insentitive-perl-regex patern type.
  7. case-insensitive-perl-regex - a case-insensitive version of the Watson Explorer Engine perl-regex pattern type. Any alphabetic UTF-8 characters that are specified in the pattern will match both the upper and lower-case versions of that character.

  The default value for this parameter is wc-set.

Returns

true in case of match, false if there is no match

Example

    <xsl:if test="viv:test(document/@url, 'http://*.pdf', 'wc')">
    ...
    </xsl:if>