sf::Utf< 8 > Class Template Reference

Specialization of the Utf template for UTF-8. More...

#include <Utf.hpp>

List of all members.

Static Public Member Functions

template<typename In >
static In Decode (In begin, In end, Uint32 &output, Uint32 replacement=0)
 Decode a single UTF-8 character.
template<typename Out >
static Out Encode (Uint32 input, Out output, Uint8 replacement=0)
 Encode a single UTF-8 character.
template<typename In >
static In Next (In begin, In end)
 Advance to the next UTF-8 character.
template<typename In >
static std::size_t Count (In begin, In end)
 Count the number of characters of a UTF-8 sequence.
template<typename In , typename Out >
static Out FromAnsi (In begin, In end, Out output, const std::locale &locale=GetDefaultLocale())
 Convert an ANSI characters range to UTF-8.
template<typename In , typename Out >
static Out FromWide (In begin, In end, Out output)
 Convert a wide characters range to UTF-8.
template<typename In , typename Out >
static Out ToAnsi (In begin, In end, Out output, char replacement=0, const std::locale &locale=GetDefaultLocale())
 Convert an UTF-8 characters range to ANSI characters.
template<typename In , typename Out >
static Out ToWide (In begin, In end, Out output, wchar_t replacement=0)
 Convert an UTF-8 characters range to wide characters.
template<typename In , typename Out >
static Out ToUtf8 (In begin, In end, Out output)
 Convert a UTF-8 characters range to UTF-8.
template<typename In , typename Out >
static Out ToUtf16 (In begin, In end, Out output)
 Convert a UTF-8 characters range to UTF-16.
template<typename In , typename Out >
static Out ToUtf32 (In begin, In end, Out output)
 Convert a UTF-8 characters range to UTF-32.

Detailed Description

template<>
class sf::Utf< 8 >

Specialization of the Utf template for UTF-8.

Definition at line 56 of file Utf.hpp.

Member Function Documentation

template<typename In >
static std::size_t sf::Utf< 8 >::Count ( In  begin,
In  end 
) [inline, static]

Count the number of characters of a UTF-8 sequence.

This function is necessary for multi-elements encodings, as a single character may use more than 1 storage element, thus the total size can be different from (begin - end).

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
Returns:
Iterator pointing to one past the last read element of the input sequence
template<typename In >
static In sf::Utf< 8 >::Decode ( In  begin,
In  end,
Uint32 &  output,
Uint32  replacement = 0 
) [inline, static]

Decode a single UTF-8 character.

Decoding a character means finding its unique 32-bits code (called the codepoint) in the Unicode standard.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
output Codepoint of the decoded UTF-8 character
replacement Replacement character to use in case the UTF-8 sequence is invalid
Returns:
Iterator pointing to one past the last read element of the input sequence
template<typename Out >
static Out sf::Utf< 8 >::Encode ( Uint32  input,
Out  output,
Uint8  replacement = 0 
) [inline, static]

Encode a single UTF-8 character.

Encoding a character means converting a unique 32-bits code (called the codepoint) in the target encoding, UTF-8.

Parameters:
input Codepoint to encode as UTF-8
output Iterator pointing to the beginning of the output sequence
replacement Replacement for characters not convertible to UTF-8 (use 0 to skip them)
Returns:
Iterator to the end of the output sequence which has been written
template<typename In , typename Out >
static Out sf::Utf< 8 >::FromAnsi ( In  begin,
In  end,
Out  output,
const std::locale &  locale = GetDefaultLocale() 
) [inline, static]

Convert an ANSI characters range to UTF-8.

The current global locale will be used by default, unless you pass a custom one in the locale parameter.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
output Iterator pointing to the beginning of the output sequence
locale Locale to use for conversion
Returns:
Iterator to the end of the output sequence which has been written
template<typename In , typename Out >
static Out sf::Utf< 8 >::FromWide ( In  begin,
In  end,
Out  output 
) [inline, static]

Convert a wide characters range to UTF-8.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
output Iterator pointing to the beginning of the output sequence
Returns:
Iterator to the end of the output sequence which has been written
template<typename In >
static In sf::Utf< 8 >::Next ( In  begin,
In  end 
) [inline, static]

Advance to the next UTF-8 character.

This function is necessary for multi-elements encodings, as a single character may use more than 1 storage element.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
Returns:
Iterator pointing to one past the last read element of the input sequence
template<typename In , typename Out >
static Out sf::Utf< 8 >::ToAnsi ( In  begin,
In  end,
Out  output,
char  replacement = 0,
const std::locale &  locale = GetDefaultLocale() 
) [inline, static]

Convert an UTF-8 characters range to ANSI characters.

The current global locale will be used by default, unless you pass a custom one in the locale parameter.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
output Iterator pointing to the beginning of the output sequence
replacement Replacement for characters not convertible to ANSI (use 0 to skip them)
locale Locale to use for conversion
Returns:
Iterator to the end of the output sequence which has been written
template<typename In , typename Out >
static Out sf::Utf< 8 >::ToUtf16 ( In  begin,
In  end,
Out  output 
) [inline, static]

Convert a UTF-8 characters range to UTF-16.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
output Iterator pointing to the beginning of the output sequence
Returns:
Iterator to the end of the output sequence which has been written
template<typename In , typename Out >
static Out sf::Utf< 8 >::ToUtf32 ( In  begin,
In  end,
Out  output 
) [inline, static]

Convert a UTF-8 characters range to UTF-32.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
output Iterator pointing to the beginning of the output sequence
Returns:
Iterator to the end of the output sequence which has been written
template<typename In , typename Out >
static Out sf::Utf< 8 >::ToUtf8 ( In  begin,
In  end,
Out  output 
) [inline, static]

Convert a UTF-8 characters range to UTF-8.

This functions does nothing more than a direct copy; it is defined only to provide the same interface as other specializations of the sf::Utf<> template, and allow generic code to be written on top of it.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
output Iterator pointing to the beginning of the output sequence
Returns:
Iterator to the end of the output sequence which has been written
template<typename In , typename Out >
static Out sf::Utf< 8 >::ToWide ( In  begin,
In  end,
Out  output,
wchar_t  replacement = 0 
) [inline, static]

Convert an UTF-8 characters range to wide characters.

Parameters:
begin Iterator pointing to the beginning of the input sequence
end Iterator pointing to the end of the input sequence
output Iterator pointing to the beginning of the output sequence
replacement Replacement for characters not convertible to wide (use 0 to skip them)
Returns:
Iterator to the end of the output sequence which has been written
The documentation for this class was generated from the following file: