struct Poco::UTF8

Overview

This class provides static methods that are UTF-8 capable variants of the same functions in Poco/String.h. More…

#include <UTF8String.h>

struct UTF8
{
    // methods

    static
    int
    icompare(
        const std::string& str,
        std::string::size_type pos,
        std::string::size_type n,
        std::string::const_iterator it2,
        std::string::const_iterator end2
        );

    static
    int
    icompare(
        const std::string& str1,
        const std::string& str2
        );

    static
    int
    icompare(
        const std::string& str1,
        std::string::size_type n1,
        const std::string& str2,
        std::string::size_type n2
        );

    static
    int
    icompare(
        const std::string& str1,
        std::string::size_type n,
        const std::string& str2
        );

    static
    int
    icompare(
        const std::string& str1,
        std::string::size_type pos,
        std::string::size_type n,
        const std::string& str2
        );

    static
    int
    icompare(
        const std::string& str1,
        std::string::size_type pos1,
        std::string::size_type n1,
        const std::string& str2,
        std::string::size_type pos2,
        std::string::size_type n2
        );

    static
    int
    icompare(
        const std::string& str1,
        std::string::size_type pos1,
        std::string::size_type n,
        const std::string& str2,
        std::string::size_type pos2
        );

    static
    int
    icompare(
        const std::string& str,
        std::string::size_type pos,
        std::string::size_type n,
        const std::string::value_type* ptr
        );

    static
    int
    icompare(
        const std::string& str,
        std::string::size_type pos,
        const std::string::value_type* ptr
        );

    static
    int
    icompare(
        const std::string& str,
        const std::string::value_type* ptr
        );

    static
    std::string
    toUpper(const std::string& str);

    static
    std::string&
    toUpperInPlace(std::string& str);

    static
    std::string
    toLower(const std::string& str);

    static
    std::string&
    toLowerInPlace(std::string& str);

    static
    void
    removeBOM(std::string& str);
};

Detailed Documentation

This class provides static methods that are UTF-8 capable variants of the same functions in Poco/String.h.

The various variants of icompare() provide case insensitive comparison for UTF-8 encoded strings.

toUpper(), toUpperInPlace(), toLower() and toLowerInPlace() provide Unicode-based character case transformation for UTF-8 encoded strings.

removeBOM() removes the UTF-8 Byte Order Mark sequence (0xEF, 0xBB, 0xBF) from the beginning of the given string, if it’s there.

Methods

static
void
removeBOM(std::string& str)

Remove the UTF-8 Byte Order Mark sequence (0xEF, 0xBB, 0xBF) from the beginning of the string, if it’s there.