[#boost-urls-static_url-set_fragment]
= xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::xref:boost/urls/static_url.adoc[static_url]::set_fragment
:relfileprefix: ../../../
:mrdocs:


Set the fragment.

== Synopsis


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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:boost/urls/static_url.adoc[static_url]&
set_fragment(core::string_view s);
----

== Description


This function sets the fragment to the        specified string, which may be empty.        An empty fragment is distinct from        having no fragment.        Reserved characters in the string are        percent‐escaped in the result.


=== Example

[,cpp]
----
assert( url("?first=john&last=doe" ).set_encoded_fragment( "john doe" ).encoded_fragment() == "john%20doe" );
----

=== Postconditions

[,cpp]
----
this->has_fragment() == true && this->fragment() == s
----

=== Complexity

Linear in `this‐>size() + s.size()`.


=== Exception Safety

Strong guarantee.        Calls to allocate may throw.


=== BNF

[,cpp]
----
fragment    = *( pchar / "/" / "?" )
----

=== Specification

* link:https://datatracker.ietf.org/doc/html/rfc3986#section-3.5[3.5.  Fragment]



== Parameters


|===
| Name | Description

| *s*
| The string to set.


|===

== See Also


xref:boost/urls/url_base/remove_fragment.adoc[remove_fragment],            xref:boost/urls/url_base/set_encoded_fragment.adoc[set_encoded_fragment].






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