alt-tek
/
printf
1
0
Fork 0
Code Releases Activity

Fixed spelling and corrected capital letters in titles (https://grammarsherpa.wordpress.com/2011/08/13/capital-letters-in-titles-headline-styling/).

Browse Source
development
Fabian Zahn 7 years ago
parent c669417cd0
commit 1552c5856e
1 changed files with 30 additions and 30 deletions
Show Stats Download Patch File Download Diff File

34
README.md
Unescape Escape View File

@ -1,4 +1,4 @@
# printf / sprintf for embedded systems # A printf / sprintf Implementation for Embedded Systems
[![Build Status](https://travis-ci.org/mpaland/printf.svg?branch=master)](https://travis-ci.org/mpaland/printf) [![Build Status](https://travis-ci.org/mpaland/printf.svg?branch=master)](https://travis-ci.org/mpaland/printf)
[![codecov](https://codecov.io/gh/mpaland/printf/branch/master/graph/badge.svg)](https://codecov.io/gh/mpaland/printf) [![codecov](https://codecov.io/gh/mpaland/printf/branch/master/graph/badge.svg)](https://codecov.io/gh/mpaland/printf)
@ -16,7 +16,7 @@ If memory footprint is really a critical issue, floating point and 'long long' s
When using printf (instead of sprintf/snprintf) you have to provide your own `_putchar()` low level function as console/serial output. When using printf (instead of sprintf/snprintf) you have to provide your own `_putchar()` low level function as console/serial output.
## Highligths and design goals ## Highlights and Design Goals
There is a boatload of so called 'tiny' printf implementations around. So why this one? There is a boatload of so called 'tiny' printf implementations around. So why this one?
I've tested many implementations, but most of them have very limited flag/specifier support, a lot of other dependencies or are just not standard compliant and failing most of the test suite. I've tested many implementations, but most of them have very limited flag/specifier support, a lot of other dependencies or are just not standard compliant and failing most of the test suite.
@ -55,10 +55,10 @@ int vsnprintf(char* buffer, size_t count, const char* format, va_list va);
int fctprintf(void (*out)(char character, void* arg), void* arg, const char* format, ...); int fctprintf(void (*out)(char character, void* arg), void* arg, const char* format, ...);
``` ```
**Due to genaral security reasons it is highly recommended to prefer and use `snprintf` (with the max buffer size as `count` parameter) instead of `sprintf`.** **Due to general security reasons it is highly recommended to prefer and use `snprintf` (with the max buffer size as `count` parameter) instead of `sprintf`.**
`sprintf` has no buffer limitation, so when needed - use it really with care! `sprintf` has no buffer limitation, so when needed - use it really with care!
### Streamlike usage ### Streamlike Usage
Besides the regular standard `printf()` functions, this module also provides `fctprintf()`, which takes an output function as first parameter to build a streamlike output like `fprintf()`: Besides the regular standard `printf()` functions, this module also provides `fctprintf()`, which takes an output function as first parameter to build a streamlike output like `fprintf()`:
```C ```C
// define the output function // define the output function
@ -75,13 +75,13 @@ void my_stream_output(char character, void* arg)
} }
``` ```
## Format specifiers ## Format Specifiers
A format specifier follows this prototype: `%[flags][width][.precision][length]type` A format specifier follows this prototype: `%[flags][width][.precision][length]type`
The following format specifiers are supported: The following format specifiers are supported:
### Supported types ### Supported Types
| Type | Output | | Type | Output |
|--------|--------| |--------|--------|
@ -98,18 +98,18 @@ The following format specifiers are supported:
| % | A % followed by another % character will write a single % | | % | A % followed by another % character will write a single % |
### Supported flags ### Supported Flags
| Flags | Description | | Flags | Description |
|-------|-------------| |-------|-------------|
| - | Left-justify within the given field width; Right justification is the default. | | - | Left-justify within the given field width; Right justification is the default. |
| + | Forces to preceed the result with a plus or minus sign (+ or -) even for positive numbers.<br>By default, only negative numbers are preceded with a - sign. | | + | Forces to precede the result with a plus or minus sign (+ or -) even for positive numbers.<br>By default, only negative numbers are preceded with a - sign. |
| (space) | If no sign is going to be written, a blank space is inserted before the value. | | (space) | If no sign is going to be written, a blank space is inserted before the value. |
| # | Used with o, b, x or X specifiers the value is preceeded with 0, 0b, 0x or 0X respectively for values different than zero.<br>Used with f, F it forces the written output to contain a decimal point even if no more digits follow. By default, if no digits follow, no decimal point is written. | | # | Used with o, b, x or X specifiers the value is preceded with 0, 0b, 0x or 0X respectively for values different than zero.<br>Used with f, F it forces the written output to contain a decimal point even if no more digits follow. By default, if no digits follow, no decimal point is written. |
| 0 | Left-pads the number with zeroes (0) instead of spaces when padding is specified (see width sub-specifier). | | 0 | Left-pads the number with zeros (0) instead of spaces when padding is specified (see width sub-specifier). |
### Supported width ### Supported Width
| Width | Description | | Width | Description |
|----------|-------------| |----------|-------------|
@ -117,7 +117,7 @@ The following format specifiers are supported:
| * | The width is not specified in the format string, but as an additional integer value argument preceding the argument that has to be formatted. | | * | The width is not specified in the format string, but as an additional integer value argument preceding the argument that has to be formatted. |
### Supported precision ### Supported Precision
| Precision | Description | | Precision | Description |
|-----------|-------------| |-----------|-------------|
@ -125,7 +125,7 @@ The following format specifiers are supported:
| .* | The precision is not specified in the format string, but as an additional integer value argument preceding the argument that has to be formatted. | | .* | The precision is not specified in the format string, but as an additional integer value argument preceding the argument that has to be formatted. |
### Supported length ### Supported Length
The length sub-specifier modifies the length of the data type. The length sub-specifier modifies the length of the data type.
@ -141,7 +141,7 @@ The length sub-specifier modifies the length of the data type.
| t | ptrdiff_t | ptrdiff_t (if PRINTF_SUPPORT_PTRDIFF_T is defined) | | t | ptrdiff_t | ptrdiff_t (if PRINTF_SUPPORT_PTRDIFF_T is defined) |
### Return value ### Return Value
Upon successful return, all functions return the number of characters written, _excluding_ the terminating null character used to end the string. Upon successful return, all functions return the number of characters written, _excluding_ the terminating null character used to end the string.
Functions `snprintf()` and `vsnprintf()` don't write more than `count` bytes, _including_ the terminating null byte ('\0'). Functions `snprintf()` and `vsnprintf()` don't write more than `count` bytes, _including_ the terminating null byte ('\0').
@ -156,7 +156,7 @@ int length = sprintf(NULL, "Hello, world"); // length is set to 12
``` ```
## Compiler switches/defines ## Compiler Switches/Defines
| Name | Default value | Description | | Name | Default value | Description |
|------|---------------|-------------| |------|---------------|-------------|
@ -174,12 +174,12 @@ int length = sprintf(NULL, "Hello, world"); // length is set to 12
- `double` type is not supported in the moment, downcast to `float` might by required. - `double` type is not supported in the moment, downcast to `float` might by required.
## Test suite ## Test Suite
For testing just compile, build and run the test suite located in `test/test_suite.cpp`. This uses the [catch](https://github.com/catchorg/Catch2) framework for unit-tests, which is auto-adding main(). For testing just compile, build and run the test suite located in `test/test_suite.cpp`. This uses the [catch](https://github.com/catchorg/Catch2) framework for unit-tests, which is auto-adding main().
Running with the `--wait-for-keypress exit` option waits for the enter key after test end. Running with the `--wait-for-keypress exit` option waits for the enter key after test end.
## Projects using printf ## Projects Using printf
- [turnkey-board](https://github.com/mpaland/turnkey-board) uses printf as log and generic display formatting/output. - [turnkey-board](https://github.com/mpaland/turnkey-board) uses printf as log and generic display formatting/output.
(Just send me a mail/issue to get your project listed here) (Just send me a mail/issue to get your project listed here)

Write Preview
Loading…
Cancel
Save