include/relpipe/common/text/TextCodec.h
author František Kučera <franta-hg@frantovo.cz>
Wed, 20 Nov 2019 14:56:41 +0100
branchv_0
changeset 18 9d566568d37c
child 20 a8ccd2b19faa
permissions -rw-r--r--
Iconv and TextCodec classes for converting text encodings
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
18
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     1
/**
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     2
 * Relational pipes (library)
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     3
 * Copyright © 2019 František Kučera (Frantovo.cz, GlobalCode.info)
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     4
 *
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     5
 * This program is free software: you can redistribute it and/or modify
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     6
 * it under the terms of the:
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     7
 *  - GNU Lesser General Public License as published by the Free Software Foundation;
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     8
 *    version 3 of the License or (at your option)
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
     9
 *  - GNU General Public License as published by the Free Software Foundation;
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    10
 *    version 2 of the License.
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    11
 *
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    12
 * This program is distributed in the hope that it will be useful,
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    13
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    15
 * GNU General Public License for more details.
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    16
 *
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    18
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    19
 */
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    20
#pragma once
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    21
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    22
#include <memory>
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    23
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    24
#include "Iconv.h"
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    25
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    26
namespace relpipe {
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    27
namespace common {
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    28
namespace text {
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    29
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    30
/**
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    31
 * TextCodec converts text from an encoding (usually the plarform default) 
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    32
 * to our internal string representations (which is octet string consisting of UTF-8 encoded text).
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    33
 * 
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    34
 * bytes = platform encoding
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    35
 * text = our encoding
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    36
 * 
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    37
 * n.b. if the default (platform) encoding "" is used, it is required to initialize locales: setlocale(LC_ALL, "");
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    38
 */
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    39
class TextCodec {
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    40
private:
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    41
	class TextCodecInternal;
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    42
	TextCodecInternal* internal;
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    43
public:
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    44
	TextCodec();
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    45
	TextCodec(const std::string& encoding);
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    46
	virtual ~TextCodec();
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    47
	std::string fromBytes(std::string bytes);
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    48
	std::string toBytes(std::string text);
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    49
};
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    50
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    51
}
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    52
}
9d566568d37c Iconv and TextCodec classes for converting text encodings
František Kučera <franta-hg@frantovo.cz>
parents:
diff changeset
    53
}