//
// Copyright (c) 2023 Alan de Freitas (alandefreitas@gmail.com)
//
// Distributed under the Boost Software License, Version 1.0. (See accompanying
// file LICENSE_1_0.txt or copy at https://www.boost.org/LICENSE_1_0.txt)
//
// Official repository: https://github.com/boostorg/url
//

= Magnet Link

`magnet` is a URL scheme for identifying files by their content.
These files are usually identified by cryptographic hash value.

Magnet links are useful in peer-to-peer file sharing networks because they allow resources to be referred to without the need for a continuously available host..

This example parses a magnet link into a new view type and prints its components to standard output.

// example_magnet
[source,cpp]
----
include::example$example/magnet.cpp[tag=example_magnet,indent=0]
----