32namespace multipart_body
71inline std::vector< string_view_t >
78 std::vector< string_view_t > result;
79 std::vector< string_view_t > tmp_result;
85 auto boundary_pos = body.find( boundary );
86 if( string_view_t::npos == boundary_pos )
92 if( boundary_pos != 0u &&
93 (boundary_pos < eol.size() ||
94 body.substr( boundary_pos - eol.size(), eol.size() ) != eol) )
97 auto remaining_body = body.substr( boundary_pos + boundary.size() );
104 remaining_body = remaining_body.substr( eol.size() );
106 boundary_pos = remaining_body.find( boundary );
107 if( string_view_t::npos == boundary_pos )
111 if( boundary_pos < eol.size() ||
112 remaining_body.substr( boundary_pos - eol.size(), eol.size() ) != eol )
115 tmp_result.push_back(
116 remaining_body.substr( 0u, boundary_pos - eol.size() ) );
118 remaining_body = remaining_body.substr( boundary_pos + boundary.size() );
120 if(
starts_with( remaining_body, last_separator ) )
123 swap( tmp_result, result );
158namespace parser_details
165constexpr char CR =
'\r';
166constexpr char LF =
'\n';
191 return from.fragment( from.current_position() );
214 std::string accumulator;
215 auto ch = from.
getch();
216 while( !ch.m_eof && ch.m_ch !=
CR && ch.m_ch !=
LF )
218 accumulator += ch.
m_ch;
256 using namespace parser_details;
258 return produce< parsed_part_t >(
259 produce< http_header_fields_t >(
261 produce< http_header_field_t >(
263 [](
auto & f, std::string && v) {
269 [](
auto & f, std::string && v) {
325 }.try_process( source );
366 content_type_field_not_found,
368 content_type_field_parse_error,
372 content_type_field_inappropriate_value,
375 illegal_boundary_value,
381 terminated_by_handler,
389namespace boundary_value_checkers
405 return (ch >=
'0' && ch <=
'9')
406 || ((ch >=
'A' && ch <=
'Z') || (ch >=
'a' && ch <=
'z'))
459 using namespace impl::boundary_value_checkers;
461 if( value.size() >= 1u && value.size() <= 70u )
463 const std::size_t last_index = value.size() - 1u;
464 for( std::size_t i = 0u; i != last_index; ++i )
494template<
typename Extra_Data >
507 restinio::http_field::content_type );
509 return make_unexpected(
517 return make_unexpected(
520 const auto & media_type = parse_result->media_type;
523 return make_unexpected(
526 if( expected_media_subtype &&
529 return make_unexpected(
535 parse_result->media_type.parameters,
538 return make_unexpected(
543 if( boundary_check_result )
544 return make_unexpected( *boundary_check_result );
547 std::string actual_boundary_mark;
548 actual_boundary_mark.reserve( 2 + boundary->size() );
549 actual_boundary_mark.append(
"--" );
550 actual_boundary_mark.append( boundary->data(), boundary->size() );
552 return {
std::move(actual_boundary_mark) };
567template<
typename Handler >
571 const std::vector< string_view_t > & parts,
574 std::size_t parts_processed{ 0u };
577 for(
auto current_part : parts )
581 if( !part_parse_result )
598 return make_unexpected( *error );
600 return parts_processed;
606template<
typename,
typename = restinio::utils::metaprogramming::
void_t<> >
609template<
typename T >
616 decltype(std::declval<T>()(std::declval<parsed_part_t>()))
683template<
typename User_Type,
typename Handler >
707 impl::valid_handler_type< std::decay_t<Handler> >::value,
708 "Handler should be callable object, "
709 "should accept parsed_part_t by value, const or rvalue reference, "
710 "and should return handling_result_t" );
715 expected_media_subtype );
721 return make_unexpected(
726 std::forward<Handler>(handler) );
729 return make_unexpected( boundary.error() );
Utilities for parsing values of http-fields.
The class that implements "input stream".
RESTINIO_NODISCARD character_t getch() noexcept
Get the next character from the input stream.
void putback() noexcept
Return one character back to the input stream.
RESTINIO_NODISCARD position_t current_position() const noexcept
Get the current position in the stream.
A special class to be used as the top level clause in parser.
Information about parsing error.
const http_request_header_t & header() const noexcept
Get request header.
const std::string & body() const noexcept
Get request body.
#define RESTINIO_NODISCARD
Stuff related to value of Content-Type HTTP-field.
An very small, simple and somewhat limited implementation of recursive-descent parser.
bool_constant< false > false_type
bool_constant< true > true_type
const nullopt_t nullopt((nullopt_t::init()))
void swap(optional< T > &x, optional< T > &y)
RESTINIO_NODISCARD auto symbol(char expected) noexcept
A factory function to create a clause that expects the speficied symbol, extracts it and then skips i...
@ unexpected_eof
Unexpected end of input is encontered when some character expected.
RESTINIO_NODISCARD expected_t< typename Producer::result_type, parse_error_t > try_parse(string_view_t from, Producer producer)
Perform the parsing of the specified content by using specified value producer.
RESTINIO_NODISCARD auto repeat(std::size_t min_occurences, std::size_t max_occurences, Clauses &&... clauses)
A factory function to create repetitor of subclauses.
RESTINIO_NODISCARD auto custom_consumer(F consumer)
A factory function to create a custom_consumer.
constexpr std::size_t N
A special marker that means infinite repetitions.
RESTINIO_NODISCARD auto to_lower() noexcept
A factory function to create a to_lower_transformer.
RESTINIO_NODISCARD expected_t< string_view_t, not_found_t > find_first(const parameter_with_mandatory_value_container_t &where, string_view_t what)
A helper function to find the first occurence of a parameter with the specified value.
RESTINIO_NODISCARD auto ows() noexcept
A factory function to create an OWS clause.
RESTINIO_NODISCARD auto token_p() noexcept
A factory function to create a token_producer.
bool is_equal_caseless(const char *a, const char *b, std::size_t size) noexcept
Comparator for fields names.
RESTINIO_NODISCARD constexpr bool is_bcharnospace(char ch)
RESTINIO_NODISCARD constexpr bool is_bchar(char ch)
RESTINIO_NODISCARD auto make_parser()
A factory function for a parser of a part of multipart message.
RESTINIO_NODISCARD expected_t< std::size_t, enumeration_error_t > enumerate_parts_of_request_body(const std::vector< string_view_t > &parts, Handler &&handler)
A function that parses every part of a multipart body and calls a user-provided handler for every par...
handling_result_t
The result to be returned from user-provided handler of parts of multipart body.
@ stop_enumeration
Enumeration of parts should be stopped. All remaining parts of multipart body will be skipped....
@ terminate_enumeration
Enumeration of parts should be ignored. All remaining parts of multipart body will be skipped and the...
@ continue_enumeration
Enumeration of parts should be continued. If there is another part the user-provided handler will be ...
RESTINIO_NODISCARD optional_t< enumeration_error_t > check_boundary_value(string_view_t value)
A helper function for checking the validity of 'boundary' value.
RESTINIO_NODISCARD expected_t< std::size_t, enumeration_error_t > enumerate_parts(const generic_request_t< User_Type > &req, Handler &&handler, string_view_t expected_media_type=string_view_t{ "multipart" }, optional_t< string_view_t > expected_media_subtype=nullopt)
A helper function for enumeration of parts of a multipart body.
enumeration_error_t
The result of an attempt to enumerate parts of a multipart body.
@ content_type_field_inappropriate_value
Content-Type field value parsed but doesn't contain an appropriate value. For example there can be me...
@ no_parts_found
No parts of a multipart body actually found.
@ illegal_boundary_value
Value of 'boundary' parameter is invalid (for example it contains some illegal characters).
@ content_type_field_not_found
Content-Type field is not found. If Content-Type is absent there is no way to detect 'boundary' param...
@ terminated_by_handler
Enumeration of parts was aborted by user-provided handler. This code is returned when user-provided h...
@ content_type_field_parse_error
Unable to parse Content-Type field value.
@ unexpected_error
Some unexpected error encountered during the enumeration.
RESTINIO_NODISCARD expected_t< parsed_part_t, restinio::easy_parser::parse_error_t > try_parse_part(string_view_t part)
Helper function for parsing content of one part of a multipart body.
RESTINIO_NODISCARD std::vector< string_view_t > split_multipart_body(string_view_t body, string_view_t boundary)
Helper function for spliting a multipart body into a serie of separate parts.
RESTINIO_NODISCARD expected_t< std::string, enumeration_error_t > detect_boundary_for_multipart_body(const generic_request_t< Extra_Data > &req, string_view_t expected_media_type, optional_t< string_view_t > expected_media_subtype)
Helper function for parsing Content-Type field and extracting the value of 'boundary' parameter.
RESTINIO_NODISCARD bool starts_with(const string_view_t &where, const string_view_t &what) noexcept
nonstd::string_view string_view_t
nonstd::expected< T, E > expected_t
Various string-related algorithms.
Helpers for caseless comparison of strings.
A special base class to be used with producers.
A special producer that consumes the whole remaining content from the input stream.
RESTINIO_NODISCARD expected_t< string_view_t, easy_parser::parse_error_t > try_parse(easy_parser::impl::source_t &from) const noexcept
A special producer that consumes the rest of the current line in the input stream until CR/LF will be...
RESTINIO_NODISCARD expected_t< std::string, easy_parser::parse_error_t > try_parse(easy_parser::impl::source_t &from) const
A description of parsed content of one part of a multipart body.
http_header_fields_t fields
HTTP-fields local for that part.
string_view_t body
The body of that part.