778baaecb5
The size was used to keep track of the number of bits of the input type the `Arg::SInt` variant was created from. This was only relevant for arguments defined in Rust, since the `printf` command takes all arguments as strings. The only thing the size was used for is for printing negative numbers with the `x` and `X` format specifiers. In these cases, the `i64` stored in the `SInt` variant would be cast to a `u64`, but only the number of bits present in the original argument would be kept, so `-1i8` would be formatted as `ff` instead of `ffffffffffffffff`. There are no users of this feature, so let's simplify the code by removing it. While we're at it, also remove the unused `bool` returned by `as_wrapping_sint`. Closes #11889
fish-printf
The printf implementation used in fish-shell, based on musl printf.
Licensed under the MIT license.
Usage
Run cargo add fish-printf to add this crate to your Cargo.toml file.
Notes
fish-printf attempts to match the C standard for printf. It supports the following features:
- Locale-specific formatting (decimal point, thousands separator, etc.)
- Honors the current rounding mode.
- Supports the
%nmodifier for counting characters written.
fish-printf does not support positional arguments, such as printf("%2$d", 1, 2).
Prefixes like l or ll are recognized, but only used for validating the format string.
The size of integer values is taken from the argument type.
fish-printf can output to an std::fmt::Write object, or return a string.
For reasons related to fish-shell, fish-printf has a feature "widestring" which uses the widestring crate. This is off by default. If enabled, run cargo add widestring to add the widestring crate.
Examples
use fish_printf::sprintf;
// Create a `String` from a format string.
let s = sprintf!("%0.5g", 123456.0) // 1.2346e+05
// Append to an existing string.
let mut s = String::new();
sprintf!(=> &mut s, "%0.5g", 123456.0) // 1.2346e+05
See the crate documentation for additional examples.