[#bitdeque-insert-09]
= xref:bitdeque.adoc[bitdeque]::insert
:relfileprefix: ../
:mrdocs:

Insert count copies of a bit before the given position.

== Synopsis

Declared in `<util/bitdeque.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bitdeque/iterator-05.adoc[iterator]
insert(
    xref:bitdeque/const_iterator.adoc[const_iterator] pos,
    xref:bitdeque/size_type.adoc[size_type] count,
    bool val);
----

== Return Value

Iterator to the first inserted bit.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *pos*
| Iterator before which the bits are inserted.
| *count*
| Number of bits to insert.
| *val*
| Value assigned to every inserted bit.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#