Skip to content

[expr.new], [class.free] Remove "free store" from the index #7041

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
wants to merge 3 commits into from
Closed

[expr.new], [class.free] Remove "free store" from the index #7041

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ea8e4ba
[intro.scope], [expr.new], [class.free] Remove remaining "free store"
frederick-vs-ja May 31, 2024
d46318b
[intro.scope] Note allocation and deallocation "operator" functions
frederick-vs-ja Jun 1, 2024
c56e9f3
[intro.scope] Revert changes
frederick-vs-ja Jun 18, 2025
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
1 change: 0 additions & 1 deletion source/classes.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2805,7 +2805,6 @@
\end{example}

\rSec2[class.free]{Allocation and deallocation functions}%
\indextext{free store}%

\pnum
\indextext{\idxcode{new}!type of}%
Expand Down
2 changes: 0 additions & 2 deletions source/expressions.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5141,8 +5141,6 @@

\pnum
\indextext{expression!\idxcode{new}}%
\indextext{free store|seealso{\tcode{new}}}%
\indextext{free store|seealso{\tcode{delete}}}%
\indextext{memory management|see{\tcode{new}}}%
\indextext{memory management|see{\tcode{delete}}}%
\indextext{storage management|see{\tcode{new}}}%
Expand Down
4 changes: 2 additions & 2 deletions source/intro.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@
\Cpp{} provides many facilities
beyond those provided by C, including additional data types,
classes, templates, exceptions, namespaces, operator
overloading, function name overloading, references, free store
management operators, and additional library facilities.%
overloading, function name overloading, references, allocation and
Copy link
Member

Choose a reason for hiding this comment

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

This doesn't preserve the meaning of the original wording, which describes features that C++ has beyond C. C also has allocation and deallocation functions (malloc and free).

If we said replaceable or class-specific allocation functions, that would be a beyond-C feature.

Copy link
Member

Choose a reason for hiding this comment

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

Or just keep the word operators, since that's what it originally said, and C doesn't have those. The operators construct and destroy objects instead of just allocating. C doesn't have that (just calloc which doesn't work for non-trivial types).

Copy link
Contributor Author

@frederick-vs-ja frederick-vs-ja Jun 1, 2024 •
edited
Loading

Choose a reason for hiding this comment

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

This doesn't preserve the meaning of the original wording, which describes features that C++ has beyond C. C also has allocation and deallocation functions (malloc and free).

In the C++ standard wording, allocation and deallocation functions are operator new/operator new[] and operator delete/operator delete[] but not other functions. But such meaning seems confusing in more general contexts.

I'm now using "allocation and deallocation operator functions", as these functions are also operator functions ([over.oper.general]/1) and operator functions are clearly beyond C.

Copy link
Contributor Author

@frederick-vs-ja frederick-vs-ja Jun 1, 2024 •
edited
Loading

Choose a reason for hiding this comment

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

Or just keep the word operators, since that's what it originally said, and C doesn't have those. The operators construct and destroy objects instead of just allocating. C doesn't have that (just calloc which doesn't work for non-trivial types).

Hmm, however, as you said here, the new and delete operators are more than "free store management" which seemingly just refers to allocating and deallocating. The original meaning is unclear to me.

An early draft seemingly indicated that free storage management operators are allocation and deallocation functions (in Clause 12).

Copy link
Contributor

Choose a reason for hiding this comment

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

@jwakely, @jensmaurer Thoughts on "allocation operator functions"?

Copy link
Member

Choose a reason for hiding this comment

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

We never call those "allocation operator functions". They're just "allocation functions". Also, the original wording talks about "free store management operators", which is something like "new T" (allocates and constructs), whereas allocation functions just allocate raw bytes --- and C has those, too, sort-of.

I think "free store management operators" is good enough for this intro paragraph.

Copy link
Contributor

Choose a reason for hiding this comment

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

Thanks, Jens, agreed!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

But if we keep using "free store management operators", #5558 and #7040 won't be addressed, as it will be still unclear what free store is.

deallocation functions, and additional library facilities.%
\indextext{scope|)}

\rSec0[intro.refs]{Normative references}%
Expand Down
Loading