percent-format: simple printf-style string formatting
This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.
Warnings:
- These packages miss upper bounds: - leancheck Please add them, using `cabal gen-bounds` for suggestions. For more information see: https://pvp.haskell.org/
The Text.PercentFormat library provides printf-style string formatting. It
provides a % operator (as in Ruby or Python) and uses the old
C-printf-style format you know and love.
[Skip to Readme]
Properties
| Versions | 0.0.1, 0.0.2, 0.0.4, 0.0.4 |
|---|---|
| Change log | None available |
| Dependencies | base (>=4 && <5) [details] |
| License | BSD-3-Clause |
| Author | Rudy Matela <rudy@matela.com.br> |
| Maintainer | Rudy Matela <rudy@matela.com.br> |
| Category | Testing |
| Home page | https://github.com/rudymatela/percent-format#readme |
| Source repo | head: git clone https://github.com/rudymatela/percent-format this: git clone https://github.com/rudymatela/percent-format(tag v0.0.4) |
| Uploaded | by rudymatela at 2023-07-06T14:35:31Z |
Modules
[Index] [Quick Jump]
Downloads
- percent-format-0.0.4.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
Package maintainers
For package maintainers and hackage trustees
Readme for percent-format-0.0.4
[back to package description]PercentFormat -- C-like printf-style string formatting for Haskell
The Text.PercentFormat library provides printf-style string formatting. It
provides a % operator (as in Ruby or Python) and uses the old C-printf-style
format you know and love.
This library differs from Text.Printf in that it does not rely on custom
typeclasses -- it works on anything that is a Show instance.
Formatting one value:
> import Text.PercentFormat
> "Hello %s!" -% "World"
"Hello World!"
Formatting three values, tuple style, using -%%%:
> "load average: %1.2f %1.2f %1.2f" -%%% (0.00, 0.066, 0.11)
"load average: 0.00 0.07 0.11"
Formatting three values, chain style, using % and -%:
> "load average: %1.2f %1.2f %1.2f" % 0.00 % 0.066 -% 0.11
"load average: 0.00 0.07 0.11"
To produce a string with a percent sign (%),
use two percent signs (%%):
> "memory usage: %i%%" -% 13
"memory usage: 13%"
Percent signs are duplicated when using the % operator to allow chaining:
> "percent sign: %s, memory usage: %i%%" % "%" % 87
"percent sign: %%, memory usage: 87%%"
Always use the -% operator when formatting the last value
to remove duplicate % signs:
> "percent sign: %s, memory usage: %i%%" % "%" -% 87
"percent sign: %, memory usage: 87%"
To print, just prefix you format expression with putStrLn $:
> putStrLn $ "Hello %s!" -% "World"
Hello World!
For more information and a detailed list of options, see PercentFormat's Haddock Documentation.
PercentFormat is a work in progress. Any help or pull requests are welcome. See PercentFormat's TO DO list for ideas on how to contribute.
Installing
To install the latest PercentFormat version from Hackage, just run:
$ cabal update
$ cabal install percent-format