• Chapter 1: Getting Started with Stylus Studio®
• Chapter 2: Editing and Querying XML
• Chapter 3: Converting Non-XML Files to XML
• Chapter 4: Working with XSLT
• Chapter 5: Creating XSLT Using the XSLT Mapper
• Chapter 6: Debugging Stylesheets
• Chapter 7: Defining XML Schemas
• Chapter 8: Defining Document Type Definitions
• Chapter 9: Writing XPath Expressions
  • About the XPath Processor
  • Sample Data for Examples and Testing
  • Getting Started with Queries
  • Specifying the Nodes to Evaluate
  • Handling Strings and Text
  • Specifying Boolean Expressions and Functions
    • Using Boolean Expressions
    • Calling Boolean Functions
      • Converting an Object to Boolean
      • Obtaining Boolean Values
      • Determining the Context Node Language
  • Specifying Number Operations and Functions
  • Comparing Values
  • Finding a Particular Node
  • Obtaining a Union
  • Obtaining Information About a Node or a Node Set
  • Using XPath Expressions in Stylesheets
  • Accessing Other Documents During Query Execution
  • XPath Quick Reference
• Chapter 10: Working with XQuery in Stylus Studio
• Chapter 11: Composing Web Service Calls
• Chapter 12: Accessing Relational Data as XML
• Chapter 13: Integrating with Third-Party File Systems
• Chapter 14: Extending Stylus Studio
• Chapter 15: Stylus Studio GUI Reference

Home > Online Product Documentation > Table of Contents > Calling Boolean Functions

Calling Boolean Functions

This section describes the Boolean functions that you can call in a query. The operations you can perform are

Converting an Object to Boolean

In some situations, you might want to force a Boolean comparison. The XPath processor performs a Boolean comparison if either operand is a Boolean value. Consequently, if neither operand is a Boolean value, call the boolean() function on one operand to convert it to a Boolean value. The XPath processor automatically converts the other operand to a Boolean value. The format of the boolean() function is

boolean boolean(object) 
       

    

The boolean() function converts its argument to Boolean as follows:

The boolean() function is useful in comparisons. For example, the following query returns b elements that either contain both c and d elements as children or contain neither c nor d elements as children:

/a/b[boolean(c) = d]
               

            

This query is equivalent to the following query:

/a/b [(c and d) or (not(c) and not(d))]
               

            

Obtaining Boolean Values

To obtain the opposite Boolean value, call the not() function. The format is

boolean not(boolean) 
               

            

The not() function returns true if its argument is false, and returns false if its argument is true. For example, the following query finds all authors who have publications but no degrees or awards:

author[not(degree or award) and publication] 
               

            

To obtain the value true, call the true() function. The format is

boolean true() 
               

            

The true() function returns true.

To obtain the value false, call the false() function. The format is

boolean false() 
               

            

The false() function returns false.

Determining the Context Node Language

To determine whether the language of the context node is the language you expect it to be, call the lang() function. The format is

boolean lang(string) 
               

            

The lang() function returns true or false depending on whether the language of the context node as specified by the xml:lang attribute is the same as, or is a sublanguage of, the language specified by the argument string. The language of the context node is determined by the value of the xml:lang attribute on the context node or, if the context node has no xml:lang attribute, by the value of the xml:lang attribute on the nearest ancestor of the context node that has an xml:lang attribute.

If there is no such attribute, then lang() returns false. If there is such an attribute, lang() returns true in the following situations:

In both situations, case is ignored. For example:

lang("en")
       

    

This returns true if the context node is any of these elements: