Specifications

Match Functions
Equalizer Installation and Administration Guide 135
• Match functions for the optional <fragment> component are not provided. The fragment
portion of a URI is not transmitted by the browser to the server, but is instead retained by the
client and applied after the reply from the server is received.
The following table lists the URI matching functions that match text in the URI components shown
in Figure 62.
Table 63: URI-based Match Functions
URI Match Function Description
host(string) This function evaluates to true if the string argument exactly matches
the hostname portion of the request. In the case of HTTP 0.9, the host
is a portion of the request URI. All other HTTP protocol versions
require a Host header to specify the host, which would be compared
to the string. [Also see Item 5 on page 138.]
host_prefix(string) This function evaluates to true if the string argument is a prefix of the
hostname portion of the URI path. The prefix of the hostname includes
all text up to the first period (“www” in “www.example.com”). [Also see
Item 5 on page 138.]
host_suffix(string) This function evaluates to true if the string argument is a suffix of the
hostname portion of the URI path. The suffix of the hostname includes
all text after the first period in the hostname (“example.com” in
“www.example.com”). [Also see Item 5 on page 138.]
pathname(string) This function evaluates to true if the string argument exactly matches
the path component of the request URI.
pathname_prefix(string) This function evaluates to true if the string argument is a prefix of the
path component of the request URI.
pathname_suffix(string) This function evaluates to true if the string argument is a suffix of the
path component of the request URI.
pathname_substr(string) This function evaluates to true if the string argument is a substring of
the path component of the request URI.
pathname_regex(string) This function evaluates to true if the string argument, interpreted as a
regular expression, matches the path component of the request URI.
dirname(string) This function evaluates to true if the string argument exactly matches
the directory portion of the path component of the request URI. The
path component is the entire directory pa
th, including the trailing sla
sh
(for example, “/foo/bar/” is the directory portion of “/foo/bar/file.html”).
dirname_prefix(string) This function evaluates to true if the string argument is a prefix of the
directory portion of the path component of the request URI. The
leading slash must be included in the string (for example, “/fo” is a
prefix of “/foo/bar/file.html”).
dirname_suffix(string) This function evaluates to true if the string argument is a suffix of the
directory portion of the path component of the request URI. The
trailing slash must be included in the string (for example, “ar/” is a
suffix of the directory portion of
“/foo/bar/file.html”).
dirname_substr(string) This function evaluates to true if the string argument is a substring of
the directory portion of the path component of the request URI.
dirname_regex(string) This function evaluates to true if the string argument, interpreted as a
regular expression, matches the directory portion of the path
component of the request URI.