ENCSetExternalEncoding

Syntax

#include <revolution/enc.h>

ENCResult ENCSetExternalEncoding(ENCContext* context, const u8* encoding);

Arguments

context	Character code conversion context.
encoding	The character-string representation of the external character encoding name. A termination character must be attached.

Return Values

ENC_OK: Normal exit.
ENC_ERR_INVALID_PARAM: Invalid argument.
ENC_ERR_UNKNOWN_ENCODING: Unidentifiable character encoding.
ENC_ERR_UNSUPPORTED: Unsupported character code conversion.

Description

This function specifies a character-string representation of the external character encoding name for the character code conversion context.
A termination character must be attached to the name of the external character encoding.
Refer to the ENC API Introduction for details on supported character encodings.

ENC_ERR_NOT_LOADED was eliminated in RevolutionSDK 3.2.
If you specify a character encoding whose conversion table has been stripped, this function will return ENC_ERR_UNSUPPORTED.

Revision History

2008/07/08 Added an explanation and link related to supported character encodings.
2008/03/31 Eliminated ENC_ERR_NOT_LOADED.
2007/02/05 Added ENC_ERR_NOT_LOADED.
2006/10/19 Initial version.