class Poco::TextConverter

Overview

A TextConverter converts strings from one encoding into another. More…

#include <TextConverter.h>

class TextConverter
{
public:
    // typedefs

    typedef int (*Transform)(int);

    // construction

    TextConverter(
        const TextEncoding& inEncoding,
        const TextEncoding& outEncoding,
        int defaultChar = '?'
        );

    // methods

    int
    convert(
        const std::string& source,
        std::string& destination,
        Transform trans
        );

    int
    convert(
        const void* source,
        int length,
        std::string& destination,
        Transform trans
        );

    int
    convert(
        const std::string& source,
        std::string& destination
        );

    int
    convert(
        const void* source,
        int length,
        std::string& destination
        );
};

Detailed Documentation

A TextConverter converts strings from one encoding into another.

Typedefs

typedef int (*Transform)(int)

Transform function for convert.

Construction

TextConverter(
    const TextEncoding& inEncoding,
    const TextEncoding& outEncoding,
    int defaultChar = '?'
    )

Creates the TextConverter.

The encoding objects must not be deleted while the TextConverter is in use.

Methods

int
convert(
    const std::string& source,
    std::string& destination,
    Transform trans
    )

Converts the source string from inEncoding to outEncoding and appends the result to destination.

Every character is passed to the transform function. If a character cannot be represented in outEncoding, defaultChar is used instead. Returns the number of encoding errors (invalid byte sequences in source).

int
convert(
    const void* source,
    int length,
    std::string& destination,
    Transform trans
    )

Converts the source buffer from inEncoding to outEncoding and appends the result to destination.

Every character is passed to the transform function. If a character cannot be represented in outEncoding, defaultChar is used instead. Returns the number of encoding errors (invalid byte sequences in source).

int
convert(
    const std::string& source,
    std::string& destination
    )

Converts the source string from inEncoding to outEncoding and appends the result to destination.

If a character cannot be represented in outEncoding, defaultChar is used instead. Returns the number of encoding errors (invalid byte sequences in source).

int
convert(
    const void* source,
    int length,
    std::string& destination
    )

Converts the source buffer from inEncoding to outEncoding and appends the result to destination.

If a character cannot be represented in outEncoding, defaultChar is used instead. Returns the number of encoding errors (invalid byte sequences in source).