diff --git a/src/documentation/language/filter-expressions.malloynb b/src/documentation/language/filter-expressions.malloynb index ae10132b..788243e5 100644 --- a/src/documentation/language/filter-expressions.malloynb +++ b/src/documentation/language/filter-expressions.malloynb @@ -32,6 +32,8 @@ dimension: | \null | Is the string `null` | | ten\\% | Is the string `ten%` | | empty | Is the empty string or is `NULL` | +| none | Matches nothing (always false) | +| \none | Is the string `none` | * The \\ character is used to escape any special meaning @@ -43,6 +45,7 @@ dimension: | -empty | Is not an empty string | | -%anger | Does not end with `anger` | | -null | Is not a `NULL` value | +| -none | Matches everything (always true) | * A - before a string expression means "not" @@ -66,7 +69,7 @@ A string of clauses seperated by , will have all the positive match * Spaces at the beginning or end of a match * Any of , | ; \\ ( ) * The match charcacters % and _ - * `\null` or `\empty` + * `\null`, `\empty`, or `\none` # Numeric Filter Expressions @@ -79,6 +82,7 @@ A string of clauses seperated by , will have all the positive match | (1 to 5) | 1, 2, 3, 4, or 5 | | [1 to 5] | 2, 3, or 4 | | null | The `NULL` value | +| none | Matches nothing (always false) | * In to ranges the () characters indicate inclusion of the endpoints, and [] indicate exclusion. @@ -90,6 +94,7 @@ A string of clauses seperated by , will have all the positive match | not 21 | Does not equal 21 | | not (1,2,3) | Less than 1 or greater than 3 | | not null | Is not a `NULL` value | +| not none | Matches everything (always true) | ## Combining Numeric Filter Expressions @@ -161,6 +166,7 @@ includes the beginning, and extends up to, but not including the end. | next 2 weeks | 2 weeks of data, does not include today | | 2 days | 2 days of data, yesterday and today | | null | The `NULL` value | +| none | Matches nothing (always false) | ## Combining Temporal Filter Expressions @@ -177,9 +183,10 @@ Because a boolean value might equal NULL, the true `true` and `false` filters tr | false | `false` | `true` | `false` | | =false | `false` | `true` | `NULL` | | null | `false` | `false` | `true` | +| none | `false` | `false` | `false` | -Boolean filters are negated with `not`. There are no combination or grouping operators. +Boolean filters are negated with `not`, so `not none` matches everything (always true). There are no combination or grouping operators. # More About F-Strings