Describe fixed-point types #26
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
jserv
reviewed
Jul 29, 2024
|
In the CI environment, clang-format-18 is used for formatting, but the After I applied +#define twin_int_div(a, b) (((uint16_t) (a) *255) / (b))
-#define twin_int_div(a, b) (((uint16_t) (a) * 255) / (b))but in CI environment, -#define twin_int_div(a, b) (((uint16_t) (a) *255) / (b))
+#define twin_int_div(a, b) (((uint16_t) (a) * 255) / (b)) |
Make sure clang-format-18 is properly installed. See https://apt.llvm.org/ |
jserv
reviewed
Jul 29, 2024
jserv
changed the title
jserv
requested changes
Jul 29, 2024
jserv
reviewed
Jul 29, 2024
jserv
requested changes
Aug 2, 2024
jserv
reviewed
Aug 3, 2024
In the original comment, the fixed-point type was only
explained using 12.4 and 24.8, lacking details about
the number of bits allocated for the integer, fractional,
and sign parts.
Here, following the supplementary content for C99 in
'section 6.3.6.3 fixed-point types' of the ISO/IEC TR 18037:2008,
additional descriptions of these fixed-point types are provided.
In particular:
In a fixed-point type where
N bits are used to represent the value, with
L bits allocated for the integer part, the remaining
N−L bits are used for the fractional part.
The actual value range of this fixed-point type is from -2^L to 2^{L}-2^{N-L}.
Additionally, a table is provided showing hexadecimal, decimal, binary,
and actual values to help developers quickly understand
the value range of this fixed-point type.
Refs:
1. ISO/IEC TR 18037:2008
4.2 Detailed changes to ISO/IEC 9899:1999
|
Do we need to consider compatibility with one's complement? |
No. |
|
Thank @jouae for contributing! |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Describing the type using only the 12.4, 24.8, or 2.6 format is unclear for reading and doesn't clearly indicate
how many bits are used for the integer and fractional parts.
Add a brief explanation to clarify the meaning of the numbers before and after the decimal point.
The number before the decimal point represents how many bits are used for the integer part, and the number after the decimal point represents how many bits are used for the fractional part.