char-ci=?(3scm)

✨ NAME ✨

okay so this is the char-ci=?(3scm) page from the Scheme Programmer's Manual, and it's all about char-ci=?, char-ci<?, char-ci>?, char-ci<=?, char-ci>=? — the case-folded comparison girlies 💅. They do case-folded comparison, no cap.

📚 LIBRARY 📚

(import (rnrs))                     ;R6RS
(import (rnrs unicode))             ;R6RS
(import (scheme r5rs))              ;R7RS
(import (scheme char))              ;R7RS

🪄 SYNOPSIS 🪄

(char-ci=? char char char ...)
(char-ci<? char char char ...)
(char-ci>? char char char ...)
(char-ci<=? char char char ...)
(char-ci>=? char char char ...)

💖 DESCRIPTION 💖

These procedures are literally similar to char=?, etc., but they operate on the case-folded versions of the characters. The -ci mnemonic stands for "case insensitive", periodt.

🫶 RETURN VALUES 🫶

Returns a single boolean value. Simple, iconic, done.

🌸 EXAMPLES 🌸

(char-ci<? #\z #\Z)  =>  #f
(char-ci=? #\z #\Z)  =>  #t
(char-ci=? #\ς #\σ)  =>  #t    ;not required by R7RS

⚠️ COMPATIBILITY ⚠️

These procedures are defined in terms of char-foldcase(3scm). Whatever compatibility concerns apply to that procedure also apply here, in addition to any concerns applicable to char<? etc.

These procedures exist in R5RS and earlier reports, but they were only required to support two arguments. IEEE Scheme uses the ≤ and ≥ characters instead of <= and >= in the procedure entries, but this is probably a typo.

💀 ERRORS 💀

This procedure can raise exceptions with the following condition types:

• &assertion (R6RS) — The wrong number of arguments was passed or an argument was outside its domain.
• R7RS — The assertions described above are errors. Implementations may signal an error, extend the procedure's domain of definition to include such arguments, or fail catastrophically.

👀 SEE ALSO 👀

• char=?(3scm)
• char-foldcase(3scm)

🌈 STANDARDS 🌈

R4RS, IEEE Scheme, R5RS, R6RS, R7RS

👑 AUTHORS 👑

This page is part of the scheme-manpages project. It includes materials from the RnRS documents. More information can be found at https://github.com/schemedoc/manpages/.

Signed off with maximum sparkle on 2021-02-20 — footer tag char-ci=?(3scm) 💖✨