kun yu 77e1ddd81b branch-0.4.0
Former-commit-id: a4df63653202df32d0b983de27f5c969905d17ac
2019-07-30 10:23:34 +08:00

71 lines
2.3 KiB
C++

// Licensed to the Apache Software Foundation (ASF) under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The ASF licenses this file
// to you 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
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// 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.
#pragma once
#include <cstdint>
#include <memory>
#include <string>
#include "arrow/status.h"
#include "arrow/util/visibility.h"
namespace arrow {
namespace internal {
/// \brief A parsed URI
class ARROW_EXPORT Uri {
public:
Uri();
~Uri();
// XXX Should we use util::string_view instead? These functions are
// not performance-critical.
/// The URI scheme, such as "http", or the empty string if the URI has no
/// explicit scheme.
std::string scheme() const;
/// Whether the URI has an explicit host name. This may return true if
/// the URI has an empty host (e.g. "file:///tmp/foo"), while it returns
/// false is the URI has not host component at all (e.g. "file:/tmp/foo").
bool has_host() const;
/// The URI host name, such as "localhost", "127.0.0.1" or "::1", or the empty
/// string is the URI does not have a host component.
std::string host() const;
/// The URI port number, as a string such as "80", or the empty string is the URI
/// does not have a port number component.
std::string port_text() const;
/// The URI port parsed as an integer, or -1 if the URI does not have a port
/// number component.
int32_t port() const;
/// The URI path component.
std::string path() const;
/// Get the string representation of this URI.
const std::string& ToString() const;
/// Factory function to parse a URI from its string representation.
Status Parse(const std::string& uri_string);
private:
struct Impl;
std::unique_ptr<Impl> impl_;
};
} // namespace internal
} // namespace arrow