[#boost-urls-operator_lshift-0c]
= xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::operator<<
:relfileprefix: ../../
:mrdocs:


Format the url to the output stream

== Synopsis


Declared in `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/url_view_base.hpp#L2656[boost/url/url_view_base.hpp]>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
std::ostream&
operator<<(
    std::ostream& os,
    xref:boost/urls/url_view_base.adoc[url_view_base] const& u);
----

== Description


This function serializes the url to        the specified output stream. Any        percent‐escapes are emitted as‐is;        no decoding is performed.


=== Example

[,cpp]
----
url_view u( "http://www.example.com/index.htm" );
std::stringstream ss;
ss << u;
assert( ss.str() == "http://www.example.com/index.htm" );
----

=== Effects

[,cpp]
----
return os << u.buffer();
----

=== Complexity

Linear in `u&period;buffer()&period;size()`


=== Exception Safety

Basic guarantee&period;

Format the url to the output stream

This function serializes the url to    the specified output stream&period; Any    percent&hyphen;escapes are emitted as&hyphen;is&semi;    no decoding is performed&period;


=== Example

[,cpp]
----
url_view u( "http://www.example.com/index.htm" );
std::stringstream ss;
ss << u;
assert( ss.str() == "http://www.example.com/index.htm" );
----

=== Effects

[,cpp]
----
return os << u.buffer();
----

=== Complexity

Linear in `u&period;buffer()&period;size()`


=== Exception Safety

Basic guarantee&period;



== Return Value


A reference to the output stream, for chaining



== Parameters


|===
| Name | Description

| *os*
| The output stream to write to&period;


| *u*
| The url to write&period;


| *os*
| The output stream to write to&period;


| *u*
| The url to write&period;


|===



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