mirror of
https://github.com/xiaoyifang/goldendict-ng.git
synced 2024-12-01 01:44:09 +00:00
96 lines
3 KiB
C++
96 lines
3 KiB
C++
/*
|
|
* Copyright (C) 2020 Matthieu Gautier <mgautier@kymeria.fr>
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License as
|
|
* published by the Free Software Foundation; either version 2 of the
|
|
* License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* is provided AS IS, WITHOUT ANY WARRANTY; without even the implied
|
|
* warranty of MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, and
|
|
* NON-INFRINGEMENT. See the GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*
|
|
*/
|
|
|
|
#ifndef ZIM_ENTRY_H
|
|
#define ZIM_ENTRY_H
|
|
|
|
#include "zim.h"
|
|
|
|
#include <string>
|
|
#include <memory>
|
|
|
|
namespace zim
|
|
{
|
|
class Item;
|
|
class Dirent;
|
|
class FileImpl;
|
|
|
|
/**
|
|
* An entry in an `Archive`.
|
|
*
|
|
* All `Entry`'s methods are threadsafe.
|
|
*/
|
|
class LIBZIM_API Entry
|
|
{
|
|
public:
|
|
explicit Entry(std::shared_ptr<FileImpl> file_, entry_index_type idx_);
|
|
|
|
bool isRedirect() const;
|
|
std::string getTitle() const;
|
|
std::string getPath() const;
|
|
|
|
/** Get the item associated to the entry.
|
|
*
|
|
* An item is associated only if the entry is not a redirect.
|
|
* For convenience, if follow is true, return the item associated to the targeted entry.
|
|
*
|
|
* @param follow True if the redirection is resolved before getting the item. (false by default)
|
|
* @return The Item associated to the entry.
|
|
* @exception InvalidType if the entry is a redirection and follow is false.
|
|
*/
|
|
Item getItem(bool follow=false) const;
|
|
|
|
/** Get the item associated to the target entry.
|
|
*
|
|
* If there is a chain of redirection, the whole chain is resolved
|
|
* and the item associted to the last entry is returned.
|
|
*
|
|
* @return the Item associated with the targeted entry.
|
|
* @exception InvalidType if the entry is not a redirection.
|
|
*/
|
|
Item getRedirect() const;
|
|
|
|
/** Get the Entry targeted by the entry.
|
|
*
|
|
* @return The entry directly targeted by this redirect entry.
|
|
* @exception InvalidEntry if the entry is not a redirection.
|
|
*/
|
|
Entry getRedirectEntry() const;
|
|
|
|
/** Get the index of the Entry targeted by the entry.
|
|
*
|
|
* @return The index of the entry directly targeted by this redirect
|
|
* entry.
|
|
* @exception InvalidEntry if the entry is not a redirection.
|
|
*/
|
|
entry_index_type getRedirectEntryIndex() const;
|
|
|
|
entry_index_type getIndex() const { return m_idx; }
|
|
|
|
protected: // so that Item can be implemented as a wrapper over Entry
|
|
std::shared_ptr<FileImpl> m_file;
|
|
entry_index_type m_idx;
|
|
std::shared_ptr<const Dirent> m_dirent;
|
|
};
|
|
|
|
}
|
|
|
|
#endif // ZIM_ENTRY_H
|
|
|