libcruft-util/uri.hpp

103 lines
3.4 KiB
C++
Raw Normal View History

2015-02-11 16:18:18 +11:00
/*
2015-04-13 18:05:28 +10:00
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
2015-02-11 16:18:18 +11:00
*
2015-04-13 18:05:28 +10:00
* http://www.apache.org/licenses/LICENSE-2.0
2015-02-11 16:18:18 +11:00
*
2015-04-13 18:05:28 +10:00
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
2015-02-11 16:18:18 +11:00
*
* Copyright 2015, 2017 Danny Robson <danny@nerdcruft.net>
2015-02-11 16:18:18 +11:00
*/
2015-02-09 17:43:24 +11:00
#ifndef CRUFT_UTIL_URI_HPP
#define CRUFT_UTIL_URI_HPP
2015-02-09 17:43:24 +11:00
#include "view.hpp"
#include <array>
2015-02-09 17:43:24 +11:00
#include <string>
#include <stdexcept>
namespace util {
// parsing of rfc3986 uniform resource identifiers
//
// does not currently perform normalisation (scheme or protocol),
// comparison, or other associated operations. though these should be
// added in the future.
//
// note that the parsed results may not always conform to expectations
// for some protocols. eg, mailto identifiers are complex to parse
// reliably and would require a specialised parser to be reliable.
//
// not all fields will be present for all protocols (or all instances of
// any given protocol). eg, the "tel" is unlikely to have port numbers.
2015-02-09 17:43:24 +11:00
class uri {
public:
explicit uri (std::string &&);
explicit uri (const char *str);
2015-02-09 17:43:24 +11:00
uri (const char *first, const char *last);
class parse_error : public std::runtime_error
{ using runtime_error::runtime_error; };
// URI: 'https://user:password@example.com:80/path/to?foo=bar#fragment'
//
// SCHEME: 'https'
// HIERARCHICAL: 'user:password@example.com:80/path/to'
// AUTHORITY: 'user:password@example.com:80'
// USER: 'user:password'
// HOST: 'example.com'
// PORT: '80'
// PATH: '/path/to'
// QUERY: 'foo=bar'
// FRAGMENT: 'fragment'
enum component {
2015-02-09 17:43:24 +11:00
SCHEME,
HIERARCHICAL,
AUTHORITY,
USER,
HOST,
PORT,
PATH,
2015-02-09 17:43:24 +11:00
QUERY,
FRAGMENT,
NUM_COMPONENTS
};
view<const char*> get (component) const;
view<const char*> scheme (void) const { return get (SCHEME); }
view<const char*> heirarchical (void) const { return get (HIERARCHICAL); }
view<const char*> authority (void) const { return get (AUTHORITY); }
view<const char*> user (void) const { return get (USER); }
view<const char*> host (void) const { return get (HOST); }
view<const char*> port (void) const { return get (PORT); }
view<const char*> path (void) const { return get (PATH); }
view<const char*> query (void) const { return get (QUERY); }
view<const char*> fragment (void) const { return get (FRAGMENT); }
auto components (void) const noexcept { return m_views; }
2015-02-09 17:43:24 +11:00
static std::string percent_decode (view<const char*>);
2015-02-09 17:43:24 +11:00
private:
std::array<view<const char*>, NUM_COMPONENTS> m_views;
2015-02-09 17:43:24 +11:00
std::string m_value;
};
std::ostream& operator<< (std::ostream&, const uri&);
2015-02-09 17:43:24 +11:00
std::ostream& operator<< (std::ostream&, uri::component);
}
#endif