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

Parse a string and return an encoded segment view

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
system::result<segments_encoded_view>
parse_path(core::string_view s) noexcept;
----

== Description

This function parses the string and returns the corresponding path object if the string is valid, otherwise returns an error.

== BNF
[,cpp]
----
path          = [ "/" ] segment *( "/" segment )
----
== Exception Safety
No‐throw guarantee.

== Specification
* https://datatracker.ietf.org/doc/html/rfc3986#section-3.3[]

== Return Value

A valid view on success, otherwise an error code.

== Parameters

[cols=2]
|===
| Name
| Description
| *s*
| The string to parse
|===

== See Also

xref:boost/urls/segments_encoded_view.adoc[`segments_encoded_view`].


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