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
|
/*
* Copyright (C) 2020 Linux Studio Plugins Project <https://lsp-plug.in/>
* (C) 2020 Vladimir Sadovnikov <sadko4u@gmail.com>
*
* This file is part of lsp-runtime-lib
* Created on: 8 мар. 2019 г.
*
* lsp-runtime-lib is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* any later version.
*
* lsp-runtime-lib 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with lsp-runtime-lib. If not, see <https://www.gnu.org/licenses/>.
*/
#ifndef LSP_PLUG_IN_IO_CHARSETDECODER_H_
#define LSP_PLUG_IN_IO_CHARSETDECODER_H_
#include <lsp-plug.in/runtime/version.h>
#include <lsp-plug.in/runtime/LSPString.h>
#include <lsp-plug.in/common/status.h>
#include <lsp-plug.in/io/charset.h>
#include <lsp-plug.in/io/File.h>
#include <lsp-plug.in/io/IInStream.h>
#include <lsp-plug.in/io/IOutSequence.h>
namespace lsp
{
namespace io
{
/**
* Character set decoder, from any character set to UTF-32
* For most methods utilizes internal buffer.
* Very suitable for streaming processing.
*/
class CharsetDecoder
{
protected:
uint8_t *bBuffer; // Temporary buffer for storing input byte sequence
uint8_t *bBufHead; // Buffer head
uint8_t *bBufTail; // Buffer tail
lsp_wchar_t *cBuffer; // Temporary buffer for storing UTF-16 code points
lsp_wchar_t *cBufHead; // Character buffer head
lsp_wchar_t *cBufTail; // Character buffer tail
#if defined(PLATFORM_WINDOWS)
lsp_utf16_t *xBuffer; // Additional translation buffer
UINT nCodePage; // Code page
#else
iconv_t hIconv; // iconv handle
#endif /* PLATFORM_WINDOWS */
private:
CharsetDecoder & operator = (const CharsetDecoder &); // Deny copying
inline size_t prepare_buffer();
ssize_t decode_buffer();
public:
explicit CharsetDecoder();
~CharsetDecoder();
public:
/**
* Initialize character-set decoder
* @param charset character set name, NULL for default native character set
* @return status of operation
*/
status_t init(const char *charset = NULL);
/**
* Close decoder and free all resources
*/
void close();
/**
* Fetch a single character
* @return single character to fetch
*/
lsp_swchar_t fetch();
/**
* Fetch decoded characters into output buffer
* @param outbuf output buffer to perform fetch
* @param count the size of output buffer
* @return number of characters fetched or negative error code
*/
ssize_t fetch(lsp_wchar_t *outbuf, size_t count);
/**
* Fetch decoded characters directly into string
* @param out output string to perform fetch
* @param count the maximum possible amount of characters to fetch, 0 means maximum possible value
* @return number of characters fetched or negative error code
*/
ssize_t fetch(LSPString *out, size_t count = 0);
/**
* Fetch decoded characters directly into output sequence
* @param out output sequence
* @param count maximum number of characters to fetch, 0 means maximum possible value
* @return number of characters fetched or negative status of operation
*/
ssize_t fetch(IOutSequence *out, size_t count = 0);
/**
* Fill the internal byte buffer with additional data for decoding
* @param buf source buffer with data
* @param count size of the buffer
* @return number of bytes added to internal buffer
*/
ssize_t fill(const void *buf, size_t count);
/**
* Fill the internal byte buffer with additional data directly from file
* @param fd file to read data
* @param count maximum number of bytes to read, 0 means maximum possible value
* @return number of bytes read into internal buffer
*/
ssize_t fill(File *fd, size_t count = 0);
/**
* Fill the internal byte buffer with additional data directly from input stream
* @param fd file to read data
* @param count maximum number of bytes to read, 0 means maximum possible value
* @return number of bytes read into internal buffer
*/
ssize_t fill(IInStream *is, size_t count = 0);
};
} /* namespace io */
} /* namespace lsp */
#endif /* LSP_PLUG_IN_IO_CHARSETDECODER_H_ */
|