90 lines
3.6 KiB
C++
90 lines
3.6 KiB
C++
/*
|
|
|
|
Copyright (c) 2007-2018, Arvid Norberg
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions
|
|
are met:
|
|
|
|
* Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
* Redistributions in binary form must reproduce the above copyright
|
|
notice, this list of conditions and the following disclaimer in
|
|
the documentation and/or other materials provided with the distribution.
|
|
* Neither the name of the author nor the names of its
|
|
contributors may be used to endorse or promote products derived
|
|
from this software without specific prior written permission.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
|
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*/
|
|
|
|
#ifndef TORRENT_MAGNET_URI_HPP_INCLUDED
|
|
#define TORRENT_MAGNET_URI_HPP_INCLUDED
|
|
|
|
#include <string>
|
|
#include "libtorrent/config.hpp"
|
|
#include "libtorrent/torrent_handle.hpp"
|
|
#include "libtorrent/add_torrent_params.hpp"
|
|
#include "libtorrent/string_view.hpp"
|
|
|
|
namespace libtorrent {
|
|
|
|
struct torrent_handle;
|
|
class session;
|
|
|
|
// Generates a magnet URI from the specified torrent. If the torrent
|
|
// handle is invalid, an empty string is returned.
|
|
//
|
|
// For more information about magnet links, see magnet-links_.
|
|
//
|
|
TORRENT_EXPORT std::string make_magnet_uri(torrent_handle const& handle);
|
|
TORRENT_EXPORT std::string make_magnet_uri(torrent_info const& info);
|
|
|
|
#if TORRENT_ABI_VERSION == 1
|
|
#ifndef BOOST_NO_EXCEPTIONS
|
|
// deprecated in 0.14
|
|
TORRENT_DEPRECATED_EXPORT
|
|
torrent_handle add_magnet_uri(session& ses, std::string const& uri
|
|
, std::string const& save_path
|
|
, storage_mode_t storage_mode = storage_mode_sparse
|
|
, bool paused = false
|
|
, storage_constructor_type sc = default_storage_constructor
|
|
, void* userdata = nullptr);
|
|
|
|
// deprecated in 0.16. Instead, pass in the magnet link as add_torrent_params::url
|
|
TORRENT_DEPRECATED_EXPORT
|
|
torrent_handle add_magnet_uri(session& ses, std::string const& uri
|
|
, add_torrent_params const& p);
|
|
#endif
|
|
|
|
// deprecated in 0.16. Instead, pass in the magnet link as add_torrent_params::url
|
|
TORRENT_DEPRECATED_EXPORT
|
|
torrent_handle add_magnet_uri(session& ses, std::string const& uri
|
|
, add_torrent_params const& p, error_code& ec);
|
|
#endif // TORRENT_ABI_VERSION
|
|
|
|
|
|
// This function parses out information from the magnet link and populates the
|
|
// add_torrent_params object. The overload that does not take an
|
|
// ``error_code`` reference will throw a system_error on error
|
|
// The overload taking an ``add_torrent_params`` reference will fill in the
|
|
// fields specified in the magnet URI.
|
|
TORRENT_EXPORT add_torrent_params parse_magnet_uri(string_view uri, error_code& ec);
|
|
TORRENT_EXPORT add_torrent_params parse_magnet_uri(string_view uri);
|
|
TORRENT_EXPORT void parse_magnet_uri(string_view uri, add_torrent_params& p, error_code& ec);
|
|
}
|
|
|
|
#endif
|