9 releases

0.3.1 Jul 14, 2024
0.3.0 May 31, 2024
0.2.1 Feb 12, 2024
0.1.4 Sep 10, 2023
0.1.1 Aug 30, 2021

#66 in WebAssembly

Download history 4695/week @ 2024-04-05 4506/week @ 2024-04-12 5697/week @ 2024-04-19 5958/week @ 2024-04-26 4331/week @ 2024-05-03 5406/week @ 2024-05-10 4480/week @ 2024-05-17 3844/week @ 2024-05-24 2724/week @ 2024-05-31 2803/week @ 2024-06-07 3324/week @ 2024-06-14 4457/week @ 2024-06-21 3564/week @ 2024-06-28 3466/week @ 2024-07-05 3949/week @ 2024-07-12 3078/week @ 2024-07-19

14,509 downloads per month
Used in 9 crates (4 directly)

MIT license

32KB
705 lines

sprintf-rs

a clone of C sprintf in Rust

This crate was created out of a desire to provide C printf-style formatting in a WASM program, where there is no libc.

Note: You're probably better off using standard Rust string formatting instead of this crate unless you specificaly need printf compatibility.

This crate implements a dynamically type-checked function vsprintf and macro sprintf!.

Usage example:

use sprintf::sprintf;
let s = sprintf!("%d + %d = %d\n", 3, 9, 3+9).unwrap();
assert_eq!(s, "3 + 9 = 12\n");

libc is a dev dependency as it is used in the tests to compare results. std is used for some maths functions.


lib.rs:

Libc s(n)printf clone written in Rust, so you can use printf-style formatting without a libc (e.g. in WebAssembly).

Note: You're probably better off using standard Rust string formatting instead of thie crate unless you specificaly need printf compatibility.

It follows the standard C semantics, except:

  • Locale-aware UNIX extensions (' and GNU’s I) are not supported.
  • %a/%A (hexadecimal floating point) are currently not implemented.
  • Length modifiers (h, l, etc.) are checked, but ignored. The passed type is used instead.

Usage example:

 use sprintf::sprintf;
 let s = sprintf!("%d + %d = %d\n", 3, 9, 3+9).unwrap();
 assert_eq!(s, "3 + 9 = 12\n");

The types of the arguments are checked at runtime.

Dependencies

~280–740KB
~17K SLoC