Kicking it Olde Sküül! Burgerlib on Github Follow Olde Sküül on Twitter Burgerbecky on LinkedIn Burgerbecky on LinkedIn
Loading...
Searching...
No Matches
Burger::MacRomanUS Class Reference

Conversion routines to support the MacRomanUS text encoding scheme. More...

Inheritance diagram for Burger::MacRomanUS:
Collaboration diagram for Burger::MacRomanUS:

Static Public Member Functions

static uint32_t translate_from_UTF8 (const char *pInput) noexcept
 Convert a single UTF8 stream character into a MacRomanUS 8 bit char.
 
static uintptr_t translate_from_UTF8 (char *pOutput, uintptr_t uOutputSize, const char *pInput) noexcept
 Convert a UTF8 stream into a MacRomanUS "C" string.
 
static uintptr_t translate_from_UTF8 (char *pOutput, uintptr_t uOutputSize, const char *pInput, uintptr_t uInputSize) noexcept
 Convert a UTF8 stream into a MacRomanUS byte array.
 

Static Public Attributes

static const uint8_t g_UpperCaseTable [256]
 Table to convert all characters to upper case.
 
static const uint8_t g_LowerCaseTable [256]
 Table to convert all characters to lower case.
 
static const uint8_t g_ToUTF8Table [128][4]
 Table to convert MacRomanUS to UTF8.
 
static const uint16_t g_ToUTF16Table [128]
 Table to convert MacRomanUS to UTF16.
 
- Static Public Attributes inherited from Burger::CodePage
static const uint32_t kInvalid = UINT32_MAX
 Value returned if a routine failed.
 

Detailed Description

Conversion routines to support the MacRomanUS text encoding scheme.


MacRomanUS is a high ASCII encoding that's used by the MacOS classic and Carbon environments. This class will allow the conversion of other character mappings to MacRomanUS for use in calling MacOS API functions.

The character map for MacRomanUS looks like this. Click here.

See also
Win437, ISOLatin1, or Win1252

Member Function Documentation

◆ translate_from_UTF8() [1/3]

uintptr_t BURGER_API Burger::MacRomanUS::translate_from_UTF8 ( char * pOutput,
uintptr_t uOutputSize,
const char * pInput )
staticnoexcept

Convert a UTF8 stream into a MacRomanUS "C" string.


Take a "C" string that is using UTF8 encoding and convert it into a MacRomanUS encoded "C" string. The function will return the size of the string after encoding. This size is valid, even if it exceeded the output buffer size. The output pointer and size can be nullptr to have this routine calculate the size of the possible output so the application can allocate a buffer large enough to hold it.

Note
This function will ensure that the string is always zero terminated, even if truncation is necessary to get it to fit in the output buffer. Under no circumstances will the output buffer be overrun.
Parameters
pOutputPointer to byte buffer to receive the MacRomanUS encoded string. nullptr is okay if uOutputSize is zero, otherwise it will page fault.
uOutputSizeSize of the output buffer in bytes.
pInputA UTF8 encoded "C" string. nullptr will page fault.
Returns
Burger::StringLength() of the potential output. It is valid, even if the output buffer wasn't large enough to contain everything.

◆ translate_from_UTF8() [2/3]

uintptr_t BURGER_API Burger::MacRomanUS::translate_from_UTF8 ( char * pOutput,
uintptr_t uOutputSize,
const char * pInput,
uintptr_t uInputSize )
staticnoexcept

Convert a UTF8 stream into a MacRomanUS byte array.


Take a byte array that is using UTF8 encoding and convert it to a MacRomanUS encoded "C" string. The function will return the size of the string after encoding. This size is valid, even if it exceeded the output buffer size. The output pointer and size can be nullptr to have this routine calculate the size of the possible output so the application can allocate a buffer large enough to hold it.

Note
This function will ensure that the string is always zero terminated, even if truncation is necessary to get it to fit in the output buffer. Under no circumstances will the output buffer be overrun.
Zeros can be encoded into the stream. This function will not early out if a zero was parsed. Zeros will be placed in the MacRomanUS stream as is.
Parameters
pOutputPointer to a byte buffer to receive the MacRomanUS string. nullptr is okay if uOutputSize is zero, otherwise a page fault will occur.
uOutputSizeSize of the output buffer in bytes.
pInputUTF8 encoded byte array. nullptr is okay if uInputSize is zero.
uInputSizeSize of the input byte array.
Returns
Burger::StringLength() of the potential output. It is valid, even if the output buffer wasn't large enough to contain everything.

◆ translate_from_UTF8() [3/3]

uint32_t BURGER_API Burger::MacRomanUS::translate_from_UTF8 ( const char * pInput)
staticnoexcept

Convert a single UTF8 stream character into a MacRomanUS 8 bit char.


Take up 3 bytes from a UTF8 stream and return the unsigned 8 bit value of the MacRomanUS character. Codes 0 through 0x7f are considered ASCII while codes 0x80 through 0xFF are mapped to MacRomanUS. If the UTF8 character cannot be mapped to MacRomanUS encoding, Burger::CodePage::kInvalid will be returned instead.

Note
This function will not return the number of bytes decoded. Use Burger::UTF8::NextToken(const char *) to get the pointer to the next UTF8 entry.
Parameters
pInputPointer to UTF8 buffer that contains the 1 to 3 byte buffer to convert. nullptr will page fault.
Returns
The unsigned 8 bit character code (0x00-0xFF) or Burger::CodePage::kInvalid if the UTF8 value wasn't low ASCII and couldn't be mapped to MacRomanUS.
See also
Burger::UTF8::NextToken(const char *) or Burger::UTF8::GetTokenSize(const char *)

Member Data Documentation

◆ g_LowerCaseTable

const uint8_t Burger::MacRomanUS::g_LowerCaseTable
static

Table to convert all characters to lower case.


Using MacRomanUS mapping, this table will convert all 256 codes into their lower case equivalents.

◆ g_ToUTF16Table

const uint16_t Burger::MacRomanUS::g_ToUTF16Table
static

Table to convert MacRomanUS to UTF16.


Since no Unicode token is larger than 16 bits, an array of uint16_t values holds the 128 high ascii codes for MacRomanUS converted to UTF16. All 128 codes are present in Unicode except for code 0xF0 which is the closed Apple symbol.

The character map for MacRomanUS looks like this. Click here.

◆ g_ToUTF8Table

const uint8_t Burger::MacRomanUS::g_ToUTF8Table
static

Table to convert MacRomanUS to UTF8.


This 128x4 array holds the 128 high ascii codes for MacRomanUS converted to UTF8. All 128 codes are present in Unicode except for code 0xF0 which is the closed Apple logo. The Apple logo is mapped to Unicode 0xF8FF which appears to be the Apple default for Unicode.

The character map for MacRomanUS looks like this. Click here.

◆ g_UpperCaseTable

const uint8_t Burger::MacRomanUS::g_UpperCaseTable
static

Table to convert all characters to upper case.


Using MacRomanUS mapping, this table will convert all 256 codes into their upper case equivalents.