/usr/include/syndication/atom/link.h is in kdepimlibs5-dev 4:4.14.10-7+b2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 | /*
* This file is part of the syndication library
*
* Copyright (C) 2006 Frank Osterfeld <osterfeld@kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*
*/
#ifndef SYNDICATION_ATOM_LINK_H
#define SYNDICATION_ATOM_LINK_H
#include <syndication/elementwrapper.h>
class QDomElement;
class QString;
namespace Syndication {
namespace Atom {
/**
* A link, pointing to webpages, media files on the web ("podcast"),
* related content, etc. See rel() for details.
*
* @author Frank Osterfeld
*/
class SYNDICATION_EXPORT Link : public Syndication::ElementWrapper
{
public:
/**
* creates a null link object.
*/
Link();
/**
* creates a Link object wrapping an atom:link element.
* @param element a DOM element, should be a atom:link element
* (although not enforced), otherwise this object will not parse
* anything useful
*/
explicit Link(const QDomElement& element);
/**
* URL of the referenced resource (required)
*/
QString href() const;
/**
* the relation between the feed/entry and the linked resource.
*
* The value of rel() is usually one of the following:
*
* @c "alternate": The URL points to an alternate version of the
* feed/entry. In practice, this is the article described in an entry,
* or the homepage of the feed.
*
* @c "enclosure": The link describes an Enclosure. See
* Syndication::Enclosure for more information.
*
* @c "related": links to web resources with related content. E.g., an
* article discussing KDE might link to the KDE homepage.
*
* @c "self": "identifies a resource equivalent to the containing
* element". This is usually the URL of the feed source itself.
*
* @c "via": The link points to the source of the information contained
* in the feed/entry
*
* @return the rel value specified in the feed. Default value is
* @c "alternate"
*/
QString rel() const;
/**
* MIME type of the linked resource. (optional)
*
* @return MIME type following (e.g., "text/html", "audio/mpeg"),
* or a null string if not set
*/
QString type() const;
/**
* the language of the linked resource. (optional)
* If used together with a rel() value of "alternate", it
* implies a translated version of the entry.
*
* @return a language tag as defined in RFC 3066,
* or a null string if not specified
*/
QString hrefLanguage() const;
/**
* human-readable information about the link. (optional)
*
* @return the link title as plain text ("<", "&" are text, not
* markup!), or a null string if not specified
*/
QString title() const;
/**
* size of the linked resource in bytes. (optional)
*
* @return file size in bytes, or 0 if not specified
*/
uint length() const;
/**
* description of the link object for debugging purposes
*
* @return debug string
*/
QString debugInfo() const;
};
} // namespace Atom
} // namespace Syndication
#endif // SYNDICATION_ATOM_LINK_H
|