/usr/include/syndication/atom/entry.h is in kdepimlibs5-dev 4:4.8.5-0ubuntu0.3.
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 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 | /*
* 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_ENTRY_H
#define SYNDICATION_ATOM_ENTRY_H
#include <syndication/elementwrapper.h>
#include <syndication/specificitem.h>
#include <ctime>
class QDomElement;
class QString;
template <class T> class QList;
namespace Syndication {
class SpecificItemVisitor;
namespace Atom {
class Category;
class Content;
class Link;
class Person;
class Source;
/**
* an Atom entry, equivalent to the "items" in the RSS world.
*
* @author Frank Osterfeld
*/
class SYNDICATION_EXPORT Entry : public ElementWrapper, public SpecificItem
{
public:
/**
* creates a null entry object
*/
Entry();
/**
* creates an Entry object wrapping an atom:entry element.
* @param element a DOM element, should be a atom:entry element
* (although not enforced), otherwise this object will not parse
* anything useful
*/
explicit Entry(const QDomElement& element);
/**
* Used by visitors for double dispatch. See SpecificVisitor
* for more information.
* @param visitor the visitor calling the method
*/
bool accept(SpecificItemVisitor* visitor);
/**
* list of persons who are authors of this entry.
*
* This is optional if the containing feed has an author description,
* and required if not.
*/
QList<Person> authors() const;
/**
* a list of categories this entry is filed to (optional)
*/
QList<Category> categories() const;
/**
* list of persons contributing to this entry (optional)
*/
QList<Person> contributors() const;
/**
* ID of the article. (required)
* The ID must be unique inside this feed. The atom spec defines it as a
* URI (which is not enforced by this parser)
*/
QString id() const;
/**
* links pointing to associated web sites and other resources.
*
* Links are optional if the entry provides Content.
* Otherwise, it must contain at least one link with
* a @c rel value of @c "alternate". (see Link).
*/
QList<Link> links() const;
/**
* copyright information (optional)
*
* @return copyright information for the entry (intended for human
* readers), or a null string if not specified
*/
QString rights() const;
/**
* source description of the content (optional)
*
* If the content was copied from another feed, this object contains
* information about the source feed.
*
* @return source description, or a null object if not
* specified
*/
Source source() const;
/**
* The datetime of the publication of this entry (optional).
*
* @return the publication date in seconds since epoch
*/
time_t published() const;
/**
* The datetime of the last modification of this entry (required).
*
* @return the modification date in seconds since epoch
*/
time_t updated() const;
/**
* a short summary, abstract or excerpt of an entry. (optional)
* This is usually more verbose than title() and but does not
* contain the whole content as content() does.
*
* @return the summary as HTML, or a null string if not specified
*/
QString summary() const;
/**
* title of the entry (required).
*
* @return the title as HTML
*/
QString title() const;
/**
* content of the entry (optional)
* See @ref Content for details
*
* @return entry content, or a null content object if not specified
*/
Content content() const;
/**
* returns all child elements of this entry not covered by this class.
* This can be used to access additional metadata from Atom extensions.
*/
QList<QDomElement> unhandledElements() const;
/**
* returns a description of this entry for debugging purposes
*
* @return debug string
*/
QString debugInfo() const;
};
} // namespace Atom
} // namespace Syndication
#endif // SYNDICATION_ATOM_ENTRY_H
|