Skip to content

gh-110383: Added explanation in Doc about array data types range. Based on GNU docs#113708

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
LombardiDaniel wants to merge 5 commits into from
Closed

gh-110383: Added explanation in Doc about array data types range. Based on GNU docs #113708

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fab94a1
gh-110383: Added explanation about
LombardiDaniel Jan 4, 2024
27aa110
Merge branch 'main' into main
LombardiDaniel Jan 15, 2024
eb1b5b3
fix trailing whitespace lint
LombardiDaniel Jan 20, 2024
5b697cb
Merge branch 'main' into main
LombardiDaniel Jan 20, 2024
bf06b75
Update Doc/library/array.rst
LombardiDaniel Mar 14, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 9 additions & 6 deletions Doc/library/array.rst
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -30,17 +30,17 @@ defined:
+-----------+--------------------+-------------------+-----------------------+-------+
| ``'H'`` | unsigned short | int | 2 | |
+-----------+--------------------+-------------------+-----------------------+-------+
| ``'i'`` | signed int | int | 2 | |
| ``'i'`` | signed int | int | 2 | \(2) |
+-----------+--------------------+-------------------+-----------------------+-------+
| ``'I'`` | unsigned int | int | 2 | |
| ``'I'`` | unsigned int | int | 2 | \(2) |
+-----------+--------------------+-------------------+-----------------------+-------+
| ``'l'`` | signed long | int | 4 | |
| ``'l'`` | signed long | int | 4 | \(2) |
+-----------+--------------------+-------------------+-----------------------+-------+
| ``'L'`` | unsigned long | int | 4 | |
| ``'L'`` | unsigned long | int | 4 | \(2) |
+-----------+--------------------+-------------------+-----------------------+-------+
| ``'q'`` | signed long long | int | 8 | |
| ``'q'`` | signed long long | int | 8 | \(2) |
+-----------+--------------------+-------------------+-----------------------+-------+
| ``'Q'`` | unsigned long long | int | 8 | |
| ``'Q'`` | unsigned long long | int | 8 | \(2) |
+-----------+--------------------+-------------------+-----------------------+-------+
| ``'f'`` | float | float | 4 | |
+-----------+--------------------+-------------------+-----------------------+-------+
Expand All@@ -60,6 +60,9 @@ Notes:
.. deprecated-removed:: 3.3 3.16
Please migrate to ``'w'`` typecode.

(2)
As of 2024, 'h', 'i', 'l', and 'q' are usually 2, 4, 4 on Windows else 8, and 8 bytes.
Copy link
Member

@encukouencukouMay 30, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This note talks about h, so if it's kept, the \(2) should be added to the h & H lines in the table.

But, maybe this PR should be closed without merging. If you're wrinting cross-platform code you shouldn't rely on “common” values; if not you can use itemsize to find values that are actually right for your platform.



The actual representation of values is determined by the machine architecture
(strictly speaking, by the C implementation). The actual size can be accessed
Expand Down