Categories:
Semi-structured Data Functions (Type Predicates)

IS_CHAR , IS_VARCHAR

Returns TRUE if its VARIANT argument contains a string value.

These functions are synonymous.

See also:
IS_<object_type>

Syntax

IS_CHAR( <variant_expr> )

IS_VARCHAR( <variant_expr> )

Arguments

variant_expr
An expression that evaluates to a value of type VARIANT.

Examples

This shows how to use the function:

Create a table and data:

CREATE TABLE multiple_types (
    array1 VARIANT,
    boolean1 VARIANT,
    char1 VARIANT,
    varchar1 VARIANT,
    decimal1 VARIANT,
    double1 VARIANT,
    integer1 VARIANT,
    object1 VARIANT
    );
INSERT INTO multiple_types 
     (array1, boolean1, char1, varchar1, 
      decimal1, double1, integer1, object1)
   SELECT 
     TO_VARIANT(TO_ARRAY('Example')), 
     TO_VARIANT(TRUE), 
     TO_VARIANT('X'), 
     TO_VARIANT('I am a real character'), 
     TO_VARIANT(1.23::DECIMAL(6, 3)),
     TO_VARIANT(3.21::DOUBLE),
     TO_VARIANT(15),
     TO_VARIANT(TO_OBJECT(PARSE_JSON('{"Tree": "Pine"}')))
     ;

Now run the query:

SELECT IS_CHAR(char1), IS_CHAR(boolean1) FROM multiple_types;
+----------------+-------------------+
| IS_CHAR(CHAR1) | IS_CHAR(BOOLEAN1) |
|----------------+-------------------|
| True           | False             |
+----------------+-------------------+