:relfileprefix: ../../../
[#boost-urls-url_view_base-08friend-0f]

== xref:boost.adoc[pass:[boost]]::xref:boost/urls.adoc[pass:[urls]]::operator<<


Format the url to the output stream


=== Synopsis

Declared in header `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/url_view_base.hpp#L2667[boost/url/url_view_base.hpp,window=blank_]>`

[source,cpp,subs="verbatim,macros,-callouts"]
----
friend
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.
[,cpp]
----
url_view u( "http://www.example.com/index.htm" );
std::stringstream ss;
ss << u;
assert( ss.str() == "http://www.example.com/index.htm" );
----
[,cpp]
----
return os << u.buffer();
----

=== Linear in `u.buffer().size()`

=== Basic guarantee.