goldendict-ng/winlibs/include/zim/item.h
xiaoyifang 3858932ec4
feat!: add libzim dependency (#725)
* feat!: add libzim dependency

* 🎨 apply clang-format changes

* action: add libzim dependency to action

* feat!: change dependency folder

* action: add zim support

* feat!: add libzim support

* action: fix sonarcloud check

* doc: add libzim readme

* action: cmake build

* action: cmake check

* fix: code smell

* action: cmake check

* action: cmake on Macos

* action: cmake on Macos

* feat: use libzim to read title and description

* 🎨 apply clang-format changes

* feat: split zim file support

* feat: loadArticle refactor

* 🎨 apply clang-format changes

* 🎨 apply clang-format changes

* feat: update library and goldendict.pro

* 🎨 apply clang-format changes

* fix:word count

* 🎨 apply clang-format changes

* fix: video src url subsititue

* 🎨 apply clang-format changes

* zim: headword is not usually a valid

it is from title and url.

* fix: remove nested try catch

* zim: fix resource loading issue.

* 🎨 apply clang-format changes

* action: remove libao

* zim: process url

some old zim dictionary url does not contain namespace such as
/C/url

make the old and new zim dictionary's url consistent without the leading
../C/  etc.

* 🎨 apply clang-format changes

* zim: process url

remove leading dot and slash
such as ../-/assets  ,remove ../

* 🎨 apply clang-format changes

* zim: remove resourceIndex creation

use libzim to read the resource directly.

* zim: only iterate all the articles

* 🎨 apply clang-format changes

* fix: code smell

* 🎨 apply clang-format changes

* zim: refactor method to convert url to wstring

* 🎨 apply clang-format changes

* fix:code smell

* 🎨 apply clang-format changes

* zim: update windows dependencies

* zim: add mutex lock

* 🎨 apply clang-format changes

* fix: code smell

* 🎨 apply clang-format changes

---------

Co-authored-by: xiaoyifang <xiaoyifang@users.noreply.github.com>
Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
2023-05-27 12:12:16 +08:00

107 lines
3.1 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 <string>
namespace zim {
class Dirent;
class FileImpl;
/**
* An `Item` in an `Archive`
*
* All `Item`'s methods are threadsafe.
*/
class LIBZIM_API Item
{
public: // types
typedef std::pair< std::string, offset_type > DirectAccessInfo;
public: // functions
explicit Item( std::shared_ptr< FileImpl > file_, entry_index_type idx_ );
std::string getTitle() const;
std::string getPath() const;
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 m_idx;
}
#ifdef ZIM_PRIVATE
cluster_index_type getClusterIndex() const;
#endif
private: // data
std::shared_ptr< FileImpl > m_file;
entry_index_type m_idx;
std::shared_ptr< const Dirent > m_dirent;
};
} // namespace zim
#endif // ZIM_ITEM_H