ℹ️ Skipped - page is already crawled
| Filter | Status | Condition | Details |
|---|---|---|---|
| HTTP status | PASS | download_http_code = 200 | HTTP 200 |
| Age cutoff | PASS | download_stamp > now() - 6 MONTH | 0.6 months ago |
| History drop | PASS | isNull(history_drop_reason) | No drop reason |
| Spam/ban | PASS | fh_dont_index != 1 AND ml_spam_score = 0 | ml_spam_score=0 |
| Canonical | PASS | meta_canonical IS NULL OR = '' OR = src_unparsed | Not set |
| Property | Value |
|---|---|
| URL | https://cplusplus.com/reference/queue/queue/push/ |
| Last Crawled | 2026-03-20 09:30:00 (17 days ago) |
| First Indexed | 2022-06-09 03:40:42 (3 years ago) |
| HTTP Status Code | 200 |
| Meta Title | null |
| Meta Description | null |
| Meta Canonical | null |
| Boilerpipe Text | public member function
<queue>
std::
queue
::push
C++98
C++11
void push (const value_type& val);
void push (const value_type& val);void push (value_type&& val);
Insert element
Inserts a new element at the end of the
queue
, after its current last element. The content of this new element is initialized to
val
.
This member function effectively calls the member function
push_back
of the
underlying container
object.
Parameters
val
Value to which the inserted element is initialized.
Member type
value_type
is the type of the elements in the container (defined as an alias of the first class template parameter,
T
).
Return value
none
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// queue::push/pop
#include <iostream>
// std::cin, std::cout
#include <queue>
// std::queue
int
main ()
{
std::queue<
int
> myqueue;
int
myint;
std::cout <<
"Please enter some integers (enter 0 to end):\n"
;
do
{
std::cin >> myint;
myqueue.push (myint);
}
while
(myint);
std::cout <<
"myqueue contains: "
;
while
(!myqueue.empty())
{
std::cout <<
' '
<< myqueue.front();
myqueue.pop();
}
std::cout <<
'\n'
;
return
0;
}
The example uses
push
to add a new elements to the queue, which are then popped out in the same order.
Complexity
One call to
push_back
on the
underlying container
.
Data races
The container and up to all its contained elements are modified.
Exception safety
Provides the same level of guarantees as the operation performed on the
underlying container
object.
See also
queue::pop
Remove next element
(public member function)
queue::size
Return size
(public member function) |
| Markdown | [cplusplus .com](https://cplusplus.com/)
- [TUTORIALS](https://cplusplus.com/doc/)
- [REFERENCE](https://cplusplus.com/reference/)
- [ARTICLES](https://cplusplus.com/articles/)
- [FORUM](https://cplusplus.com/forum/)

please wait
[try again]() [cancel]()
[forgot your password?](https://cplusplus.com/user/access.cgi?w=lostpass)
[sign up](https://cplusplus.com/user/access.cgi?w=signup) [log in]()
[\[Legacy version\]](https://legacy.cplusplus.com/reference/queue/queue/push/)
### **[C++](https://cplusplus.com/)**
- [Tutorials](https://cplusplus.com/doc/)
- [Reference](https://cplusplus.com/reference/)
- [Articles](https://cplusplus.com/articles/)
- [Forum](https://cplusplus.com/forum/)
### **[Reference](https://cplusplus.com/reference/)**
- #### [C library:](https://cplusplus.com/reference/clibrary/)
- [\<cassert\> (assert.h)](https://cplusplus.com/reference/cassert/ "<cassert> (assert.h)")
- [\<cctype\> (ctype.h)](https://cplusplus.com/reference/cctype/ "<cctype> (ctype.h)")
- [\<cerrno\> (errno.h)](https://cplusplus.com/reference/cerrno/ "<cerrno> (errno.h)")
- C++11
[\<cfenv\> (fenv.h)](https://cplusplus.com/reference/cfenv/ "<cfenv> (fenv.h)")
- [\<cfloat\> (float.h)](https://cplusplus.com/reference/cfloat/ "<cfloat> (float.h)")
- C++11
[\<cinttypes\> (inttypes.h)](https://cplusplus.com/reference/cinttypes/ "<cinttypes> (inttypes.h)")
- [\<ciso646\> (iso646.h)](https://cplusplus.com/reference/ciso646/ "<ciso646> (iso646.h)")
- [\<climits\> (limits.h)](https://cplusplus.com/reference/climits/ "<climits> (limits.h)")
- [\<clocale\> (locale.h)](https://cplusplus.com/reference/clocale/ "<clocale> (locale.h)")
- [\<cmath\> (math.h)](https://cplusplus.com/reference/cmath/ "<cmath> (math.h)")
- [\<csetjmp\> (setjmp.h)](https://cplusplus.com/reference/csetjmp/ "<csetjmp> (setjmp.h)")
- [\<csignal\> (signal.h)](https://cplusplus.com/reference/csignal/ "<csignal> (signal.h)")
- [\<cstdarg\> (stdarg.h)](https://cplusplus.com/reference/cstdarg/ "<cstdarg> (stdarg.h)")
- C++11
[\<cstdbool\> (stdbool.h)](https://cplusplus.com/reference/cstdbool/ "<cstdbool> (stdbool.h)")
- [\<cstddef\> (stddef.h)](https://cplusplus.com/reference/cstddef/ "<cstddef> (stddef.h)")
- C++11
[\<cstdint\> (stdint.h)](https://cplusplus.com/reference/cstdint/ "<cstdint> (stdint.h)")
- [\<cstdio\> (stdio.h)](https://cplusplus.com/reference/cstdio/ "<cstdio> (stdio.h)")
- [\<cstdlib\> (stdlib.h)](https://cplusplus.com/reference/cstdlib/ "<cstdlib> (stdlib.h)")
- [\<cstring\> (string.h)](https://cplusplus.com/reference/cstring/ "<cstring> (string.h)")
- C++11
[\<ctgmath\> (tgmath.h)](https://cplusplus.com/reference/ctgmath/ "<ctgmath> (tgmath.h)")
- [\<ctime\> (time.h)](https://cplusplus.com/reference/ctime/ "<ctime> (time.h)")
- C++11
[\<cuchar\> (uchar.h)](https://cplusplus.com/reference/cuchar/ "<cuchar> (uchar.h)")
- [\<cwchar\> (wchar.h)](https://cplusplus.com/reference/cwchar/ "<cwchar> (wchar.h)")
- [\<cwctype\> (wctype.h)](https://cplusplus.com/reference/cwctype/ "<cwctype> (wctype.h)")
- #### [Containers:](https://cplusplus.com/reference/stl/)
- C++11
[\<array\>](https://cplusplus.com/reference/array/ "<array>")
- [\<deque\>](https://cplusplus.com/reference/deque/ "<deque>")
- C++11
[\<forward\_list\>](https://cplusplus.com/reference/forward_list/ "<forward_list>")
- [\<list\>](https://cplusplus.com/reference/list/ "<list>")
- [\<map\>](https://cplusplus.com/reference/map/ "<map>")
- [\<queue\>](https://cplusplus.com/reference/queue/ "<queue>")
- [\<set\>](https://cplusplus.com/reference/set/ "<set>")
- [\<stack\>](https://cplusplus.com/reference/stack/ "<stack>")
- C++11
[\<unordered\_map\>](https://cplusplus.com/reference/unordered_map/ "<unordered_map>")
- C++11
[\<unordered\_set\>](https://cplusplus.com/reference/unordered_set/ "<unordered_set>")
- [\<vector\>](https://cplusplus.com/reference/vector/ "<vector>")
- #### [Input/Output:](https://cplusplus.com/reference/iolibrary/)
- [\<fstream\>](https://cplusplus.com/reference/fstream/ "<fstream>")
- [\<iomanip\>](https://cplusplus.com/reference/iomanip/ "<iomanip>")
- [\<ios\>](https://cplusplus.com/reference/ios/ "<ios>")
- [\<iosfwd\>](https://cplusplus.com/reference/iosfwd/ "<iosfwd>")
- [\<iostream\>](https://cplusplus.com/reference/iostream/ "<iostream>")
- [\<istream\>](https://cplusplus.com/reference/istream/ "<istream>")
- [\<ostream\>](https://cplusplus.com/reference/ostream/ "<ostream>")
- [\<sstream\>](https://cplusplus.com/reference/sstream/ "<sstream>")
- [\<streambuf\>](https://cplusplus.com/reference/streambuf/ "<streambuf>")
- #### [Multi-threading:](https://cplusplus.com/reference/multithreading/)
- C++11
[\<atomic\>](https://cplusplus.com/reference/atomic/ "<atomic>")
- C++11
[\<condition\_variable\>](https://cplusplus.com/reference/condition_variable/ "<condition_variable>")
- C++11
[\<future\>](https://cplusplus.com/reference/future/ "<future>")
- C++11
[\<mutex\>](https://cplusplus.com/reference/mutex/ "<mutex>")
- C++11
[\<thread\>](https://cplusplus.com/reference/thread/ "<thread>")
- #### [Other:](https://cplusplus.com/reference/std/)
- [\<algorithm\>](https://cplusplus.com/reference/algorithm/ "<algorithm>")
- [\<bitset\>](https://cplusplus.com/reference/bitset/ "<bitset>")
- C++11
[\<chrono\>](https://cplusplus.com/reference/chrono/ "<chrono>")
- C++11
[\<codecvt\>](https://cplusplus.com/reference/codecvt/ "<codecvt>")
- [\<complex\>](https://cplusplus.com/reference/complex/ "<complex>")
- [\<exception\>](https://cplusplus.com/reference/exception/ "<exception>")
- [\<functional\>](https://cplusplus.com/reference/functional/ "<functional>")
- C++11
[\<initializer\_list\>](https://cplusplus.com/reference/initializer_list/ "<initializer_list>")
- [\<iterator\>](https://cplusplus.com/reference/iterator/ "<iterator>")
- [\<limits\>](https://cplusplus.com/reference/limits/ "<limits>")
- [\<locale\>](https://cplusplus.com/reference/locale/ "<locale>")
- [\<memory\>](https://cplusplus.com/reference/memory/ "<memory>")
- [\<new\>](https://cplusplus.com/reference/new/ "<new>")
- [\<numeric\>](https://cplusplus.com/reference/numeric/ "<numeric>")
- C++11
[\<random\>](https://cplusplus.com/reference/random/ "<random>")
- C++11
[\<ratio\>](https://cplusplus.com/reference/ratio/ "<ratio>")
- C++11
[\<regex\>](https://cplusplus.com/reference/regex/ "<regex>")
- [\<stdexcept\>](https://cplusplus.com/reference/stdexcept/ "<stdexcept>")
- [\<string\>](https://cplusplus.com/reference/string/ "<string>")
- C++11
[\<system\_error\>](https://cplusplus.com/reference/system_error/ "<system_error>")
- C++11
[\<tuple\>](https://cplusplus.com/reference/tuple/ "<tuple>")
- C++11
[\<type\_traits\>](https://cplusplus.com/reference/type_traits/ "<type_traits>")
- C++11
[\<typeindex\>](https://cplusplus.com/reference/typeindex/ "<typeindex>")
- [\<typeinfo\>](https://cplusplus.com/reference/typeinfo/ "<typeinfo>")
- [\<utility\>](https://cplusplus.com/reference/utility/ "<utility>")
- [\<valarray\>](https://cplusplus.com/reference/valarray/ "<valarray>")
- [\<algorithm\>](https://cplusplus.com/reference/algorithm/ "<algorithm>")
- [\<bitset\>](https://cplusplus.com/reference/bitset/ "<bitset>")
- [\<cassert\> (assert.h)](https://cplusplus.com/reference/cassert/ "<cassert> (assert.h)")
- [\<cctype\> (ctype.h)](https://cplusplus.com/reference/cctype/ "<cctype> (ctype.h)")
- [\<cerrno\> (errno.h)](https://cplusplus.com/reference/cerrno/ "<cerrno> (errno.h)")
- [\<cfloat\> (float.h)](https://cplusplus.com/reference/cfloat/ "<cfloat> (float.h)")
- [\<ciso646\> (iso646.h)](https://cplusplus.com/reference/ciso646/ "<ciso646> (iso646.h)")
- [\<climits\> (limits.h)](https://cplusplus.com/reference/climits/ "<climits> (limits.h)")
- [\<clocale\> (locale.h)](https://cplusplus.com/reference/clocale/ "<clocale> (locale.h)")
- [\<cmath\> (math.h)](https://cplusplus.com/reference/cmath/ "<cmath> (math.h)")
- [\<complex\>](https://cplusplus.com/reference/complex/ "<complex>")
- [\<csetjmp\> (setjmp.h)](https://cplusplus.com/reference/csetjmp/ "<csetjmp> (setjmp.h)")
- [\<csignal\> (signal.h)](https://cplusplus.com/reference/csignal/ "<csignal> (signal.h)")
- [\<cstdarg\> (stdarg.h)](https://cplusplus.com/reference/cstdarg/ "<cstdarg> (stdarg.h)")
- [\<cstddef\> (stddef.h)](https://cplusplus.com/reference/cstddef/ "<cstddef> (stddef.h)")
- [\<cstdio\> (stdio.h)](https://cplusplus.com/reference/cstdio/ "<cstdio> (stdio.h)")
- [\<cstdlib\> (stdlib.h)](https://cplusplus.com/reference/cstdlib/ "<cstdlib> (stdlib.h)")
- [\<cstring\> (string.h)](https://cplusplus.com/reference/cstring/ "<cstring> (string.h)")
- [\<ctime\> (time.h)](https://cplusplus.com/reference/ctime/ "<ctime> (time.h)")
- [\<cwchar\> (wchar.h)](https://cplusplus.com/reference/cwchar/ "<cwchar> (wchar.h)")
- [\<cwctype\> (wctype.h)](https://cplusplus.com/reference/cwctype/ "<cwctype> (wctype.h)")
- [\<deque\>](https://cplusplus.com/reference/deque/ "<deque>")
- [\<exception\>](https://cplusplus.com/reference/exception/ "<exception>")
- [\<fstream\>](https://cplusplus.com/reference/fstream/ "<fstream>")
- [\<functional\>](https://cplusplus.com/reference/functional/ "<functional>")
- [\<iomanip\>](https://cplusplus.com/reference/iomanip/ "<iomanip>")
- [\<ios\>](https://cplusplus.com/reference/ios/ "<ios>")
- [\<iosfwd\>](https://cplusplus.com/reference/iosfwd/ "<iosfwd>")
- [\<iostream\>](https://cplusplus.com/reference/iostream/ "<iostream>")
- [\<istream\>](https://cplusplus.com/reference/istream/ "<istream>")
- [\<iterator\>](https://cplusplus.com/reference/iterator/ "<iterator>")
- [\<limits\>](https://cplusplus.com/reference/limits/ "<limits>")
- [\<list\>](https://cplusplus.com/reference/list/ "<list>")
- [\<locale\>](https://cplusplus.com/reference/locale/ "<locale>")
- [\<map\>](https://cplusplus.com/reference/map/ "<map>")
- [\<memory\>](https://cplusplus.com/reference/memory/ "<memory>")
- [\<new\>](https://cplusplus.com/reference/new/ "<new>")
- [\<numeric\>](https://cplusplus.com/reference/numeric/ "<numeric>")
- [\<ostream\>](https://cplusplus.com/reference/ostream/ "<ostream>")
- [\<queue\>](https://cplusplus.com/reference/queue/ "<queue>")
- [\<set\>](https://cplusplus.com/reference/set/ "<set>")
- [\<sstream\>](https://cplusplus.com/reference/sstream/ "<sstream>")
- [\<stack\>](https://cplusplus.com/reference/stack/ "<stack>")
- [\<stdexcept\>](https://cplusplus.com/reference/stdexcept/ "<stdexcept>")
- [\<streambuf\>](https://cplusplus.com/reference/streambuf/ "<streambuf>")
- [\<string\>](https://cplusplus.com/reference/string/ "<string>")
- [\<typeinfo\>](https://cplusplus.com/reference/typeinfo/ "<typeinfo>")
- [\<utility\>](https://cplusplus.com/reference/utility/ "<utility>")
- [\<valarray\>](https://cplusplus.com/reference/valarray/ "<valarray>")
- [\<vector\>](https://cplusplus.com/reference/vector/ "<vector>")
- C++11
[\<array\>](https://cplusplus.com/reference/array/ "<array>")
- C++11
[\<atomic\>](https://cplusplus.com/reference/atomic/ "<atomic>")
- C++11
[\<cfenv\> (fenv.h)](https://cplusplus.com/reference/cfenv/ "<cfenv> (fenv.h)")
- C++11
[\<chrono\>](https://cplusplus.com/reference/chrono/ "<chrono>")
- C++11
[\<cinttypes\> (inttypes.h)](https://cplusplus.com/reference/cinttypes/ "<cinttypes> (inttypes.h)")
- C++11
[\<codecvt\>](https://cplusplus.com/reference/codecvt/ "<codecvt>")
- C++11
[\<condition\_variable\>](https://cplusplus.com/reference/condition_variable/ "<condition_variable>")
- C++11
[\<cstdbool\> (stdbool.h)](https://cplusplus.com/reference/cstdbool/ "<cstdbool> (stdbool.h)")
- C++11
[\<cstdint\> (stdint.h)](https://cplusplus.com/reference/cstdint/ "<cstdint> (stdint.h)")
- C++11
[\<ctgmath\> (tgmath.h)](https://cplusplus.com/reference/ctgmath/ "<ctgmath> (tgmath.h)")
- C++11
[\<cuchar\> (uchar.h)](https://cplusplus.com/reference/cuchar/ "<cuchar> (uchar.h)")
- C++11
[\<forward\_list\>](https://cplusplus.com/reference/forward_list/ "<forward_list>")
- C++11
[\<future\>](https://cplusplus.com/reference/future/ "<future>")
- C++11
[\<initializer\_list\>](https://cplusplus.com/reference/initializer_list/ "<initializer_list>")
- C++11
[\<mutex\>](https://cplusplus.com/reference/mutex/ "<mutex>")
- C++11
[\<random\>](https://cplusplus.com/reference/random/ "<random>")
- C++11
[\<ratio\>](https://cplusplus.com/reference/ratio/ "<ratio>")
- C++11
[\<regex\>](https://cplusplus.com/reference/regex/ "<regex>")
- C++11
[\<system\_error\>](https://cplusplus.com/reference/system_error/ "<system_error>")
- C++11
[\<thread\>](https://cplusplus.com/reference/thread/ "<thread>")
- C++11
[\<tuple\>](https://cplusplus.com/reference/tuple/ "<tuple>")
- C++11
[\<type\_traits\>](https://cplusplus.com/reference/type_traits/ "<type_traits>")
- C++11
[\<typeindex\>](https://cplusplus.com/reference/typeindex/ "<typeindex>")
- C++11
[\<unordered\_map\>](https://cplusplus.com/reference/unordered_map/ "<unordered_map>")
- C++11
[\<unordered\_set\>](https://cplusplus.com/reference/unordered_set/ "<unordered_set>")
### **[\<queue\>](https://cplusplus.com/reference/queue/)**
- [priority\_queue](https://cplusplus.com/reference/queue/priority_queue/ "priority_queue")
- [queue](https://cplusplus.com/reference/queue/queue/ "queue")
### **[queue](https://cplusplus.com/reference/queue/queue/)**
- [queue::queue](https://cplusplus.com/reference/queue/queue/queue/ "queue::queue")
- #### member functions
- [queue::back](https://cplusplus.com/reference/queue/queue/back/ "queue::back")
- C++11
[queue::emplace](https://cplusplus.com/reference/queue/queue/emplace/ "queue::emplace")
- [queue::empty](https://cplusplus.com/reference/queue/queue/empty/ "queue::empty")
- [queue::front](https://cplusplus.com/reference/queue/queue/front/ "queue::front")
- [queue::pop](https://cplusplus.com/reference/queue/queue/pop/ "queue::pop")
- [queue::push](https://cplusplus.com/reference/queue/queue/push/ "queue::push")
- [queue::size](https://cplusplus.com/reference/queue/queue/size/ "queue::size")
- C++11
[queue::swap](https://cplusplus.com/reference/queue/queue/swap/ "queue::swap")
- #### non-member overloads
- [relational operators (queue)](https://cplusplus.com/reference/queue/queue/operators/ "relational operators (queue)")
- C++11
[swap (queue)](https://cplusplus.com/reference/queue/queue/swap-free/ "swap (queue)")
- #### non-member specializations
- C++11
[uses\_allocator\<queue\>](https://cplusplus.com/reference/queue/queue/uses_allocator/ "uses_allocator<queue>")
- C++11
[queue::emplace](https://cplusplus.com/reference/queue/queue/emplace/ "queue::emplace")
- C++11
[queue::swap](https://cplusplus.com/reference/queue/queue/swap/ "queue::swap")
- C++11
[swap (queue)](https://cplusplus.com/reference/queue/queue/swap-free/ "swap (queue)")
- C++11
[uses\_allocator\<queue\>](https://cplusplus.com/reference/queue/queue/uses_allocator/ "uses_allocator<queue>")
- [queue::back](https://cplusplus.com/reference/queue/queue/back/ "queue::back")
- [queue::empty](https://cplusplus.com/reference/queue/queue/empty/ "queue::empty")
- [queue::front](https://cplusplus.com/reference/queue/queue/front/ "queue::front")
- [queue::pop](https://cplusplus.com/reference/queue/queue/pop/ "queue::pop")
- [queue::push](https://cplusplus.com/reference/queue/queue/push/ "queue::push")
- [queue::queue](https://cplusplus.com/reference/queue/queue/queue/ "queue::queue")
- [queue::size](https://cplusplus.com/reference/queue/queue/size/ "queue::size")
- [relational operators (queue)](https://cplusplus.com/reference/queue/queue/operators/ "relational operators (queue)")
- [Reference](https://cplusplus.com/reference/)
- [\<queue\>](https://cplusplus.com/reference/queue/)
- [queue](https://cplusplus.com/reference/queue/queue/)
- push
public member function
\<queue\>
# std::[queue](https://cplusplus.com/reference/queue/queue/)::push
- [C++98]()
- [C++11]()
```
void push (const value_type& val);
```
```
void push (const value_type& val);void push (value_type&& val);
```
Insert element
Inserts a new element at the end of the
[queue](https://cplusplus.com/queue)
, after its current last element. The content of this new element is initialized to
val
.
This member function effectively calls the member function
[push\_back](https://cplusplus.com/deque::push_back)
of the *underlying container* object.
### Parameters
val
Value to which the inserted element is initialized.
Member type
value\_type
is the type of the elements in the container (defined as an alias of the first class template parameter,
T
).
### Return value
none
### Example
[Edit & run on cpp.sh](https://cplusplus.com/reference/queue/queue/push/ "Open C++ Shell (in a new window)")
The example uses
push
to add a new elements to the queue, which are then popped out in the same order.
### Complexity
One call to
[push\_back](https://cplusplus.com/deque::push_back)
on the *underlying container*.
### Data races
The container and up to all its contained elements are modified.
### Exception safety
Provides the same level of guarantees as the operation performed on the *underlying container* object.
### See also
[**queue::pop**](https://cplusplus.com/reference/queue/queue/pop/)
Remove next element (public member function)
[**queue::size**](https://cplusplus.com/reference/queue/queue/size/)
Return size (public member function)
[Home page](https://cplusplus.com/) \| [Privacy policy](https://cplusplus.com/privacy.do)
© cplusplus.com, 2000-2025 - All rights reserved - *v3.3.4s*
[Spotted an error? contact us](https://cplusplus.com/contact.do?referrer=%2Freference%2Fqueue%2Fqueue%2Fpush%2F) |
| Readable Markdown | null |
| Shard | 14 (laksa) |
| Root Hash | 7671136614093794214 |
| Unparsed URL | com,cplusplus!/reference/queue/queue/push/ s443 |