RSS Feed

Lisp Project of the Day

str

You can support this project by donating at:

Donate using PatreonDonate using Liberapay

Or see the list of project sponsors.

strutilstext

Documentation😀
Docstrings😀
Tests 😀
Examples😀
RepositoryActivity😀
CI 🥺

This is a single purpose utility library. Before switching to the str, I used cl-strings, but str library is more consistent.

I like that unlike standard functions, str is able to work with chars and strings as delimiter:

POFTHEDAY> (str:split #\Space
                      "Foo bar bazz")
("Foo" "bar" "bazz")

POFTHEDAY> (str:split " "
                      "Foo bar bazz")
("Foo" "bar" "bazz")

;; Also it is able to skip empty strings:
POFTHEDAY> (str:split " "
                      "Foo   bar   bazz")
("Foo" "" "" "bar" "" "" "bazz")

POFTHEDAY> (str:split-omit-nulls " "
                      "Foo   bar   bazz")
("Foo" "bar" "bazz")

Parameter ordering can seem a little strange at first glance, but they've made this way to make it easier to curry functions.

For example, if we have a multiline text and want to put ellipsis at the end of string longer than X, we might do:

POFTHEDAY> (defvar *text* "
This line is much longer than we need.
This one is also too long.

I can't belive!
""")

POFTHEDAY> (str:unlines
            (mapcar (alexandria:curry #'str:shorten 20)
                    (str:lines *text*)))
"
This line is much...
This one is also ...

I can't belive!"

BTW str has very cool documentation. I'd like to have such docs for other CL libraries.


Brought to you by 40Ants under Creative Commons License