mirror of
https://github.com/xiaoyifang/goldendict-ng.git
synced 2024-11-27 23:34:06 +00:00
104 lines
3.2 KiB
C++
104 lines
3.2 KiB
C++
/*
|
|
* Copyright (C) 2021 Veloman Yunkan
|
|
* 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_ITEM_H
|
|
#define ZIM_ITEM_H
|
|
|
|
#include "zim.h"
|
|
#include "blob.h"
|
|
#include "entry.h"
|
|
#include <string>
|
|
|
|
namespace zim
|
|
{
|
|
/**
|
|
* An `Item` in an `Archive`
|
|
*
|
|
* There is no public constructor - the only way to obtain an `Item`
|
|
* is via `Entry::getItem()` or `Entry::getRedirect()`.
|
|
*
|
|
* All `Item`'s methods are threadsafe.
|
|
*/
|
|
class LIBZIM_API Item : private Entry
|
|
{
|
|
public: // types
|
|
typedef std::pair<std::string, offset_type> DirectAccessInfo;
|
|
|
|
public: // functions
|
|
std::string getTitle() const { return Entry::getTitle(); }
|
|
std::string getPath() const { return Entry::getPath(); }
|
|
std::string getMimetype() const;
|
|
|
|
/** Get the data associated to the item
|
|
*
|
|
* Get the data of the item, starting at offset.
|
|
*
|
|
* @param offset The number of byte to skip at begining of the data.
|
|
* @return A blob corresponding to the data.
|
|
*/
|
|
Blob getData(offset_type offset=0) const;
|
|
|
|
/** Get the data associated to the item
|
|
*
|
|
* Get the `size` bytes of data of the item, starting at offset.
|
|
*
|
|
* @param offset The number of byte to skip at begining of the data.
|
|
* @param size The number of byte to read.
|
|
* @return A blob corresponding to the data.
|
|
*/
|
|
Blob getData(offset_type offset, size_type size) const;
|
|
|
|
/** The size of the item.
|
|
*
|
|
* @return The size (in byte) of the item.
|
|
*/
|
|
size_type getSize() const;
|
|
|
|
/** Direct access information.
|
|
*
|
|
* Some item are stored raw in the zim file.
|
|
* If possible, this function give information about which file
|
|
* and at which to read to get the data.
|
|
*
|
|
* It can be usefull as an optimisation when interacting with other system
|
|
* by reopeing the file and reading the content bypassing the libzim.
|
|
*
|
|
* @return A pair of filename/offset specifying where read the content.
|
|
* If it is not possible to have direct access for this item,
|
|
* return a pair of `{"", 0}`
|
|
*/
|
|
DirectAccessInfo getDirectAccessInformation() const;
|
|
|
|
entry_index_type getIndex() const { return Entry::getIndex(); }
|
|
|
|
#ifdef ZIM_PRIVATE
|
|
cluster_index_type getClusterIndex() const;
|
|
#endif
|
|
|
|
private: // functions
|
|
explicit Item(const Entry& entry);
|
|
friend class Entry;
|
|
};
|
|
|
|
}
|
|
|
|
#endif // ZIM_ITEM_H
|
|
|