Casefold
Casefold( value, [ normalizer ] )
Description
The Casefold
function returns a normalized string. When strings are
transformed into their normalized forms, canonical-equivalent strings
have precisely the same binary representation. Then, a binary comparison
function such as equals
can compare two strings for case-insensitive
matching.
The Unicode Standard provides well-defined normalization forms (see Section 5.18, Case Mappings).
By default, Fauna uses NKFCCaseFold
as recommended by the
W3C, but provides NFKCCaseFold
,
NFC
, NFD
, NFKC
, NFKD
.
Parameters
Argument | Type | Definition and Requirements |
---|---|---|
|
String |
A string to normalize. |
|
String |
Optional - The name of the normalizer method to use. Must be one of "NFKCCaseFold", "NFC", "NFD", "NFKC", or "NFKD". Defaults to "NFKCCaseFold". |
Examples
The query below converts the string "Hen Wen" to "hen wen" to support case-insensitive matching.
client.query(q.Casefold('Hen Wen'))
.then((ret) => console.log(ret))
hen wen
Is this article helpful?
Tell Fauna how the article can be improved:
Visit Fauna's forums
or email docs@fauna.com
Thank you for your feedback!