1<!DOCTYPE HTML PUBLIC "-//W3C//Dtd HTML 4.01 Transitional//EN">
2<html>
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252" />
5<meta http-equiv="Content-Style-Type" content="text/css" />
6<link rel="stylesheet" type="text/css" href="../../CSS/revolution.css" />
7<title>ENCSetAlternativeCharacter</title>
8</head>
9
10<body>
11
12<h1>ENCSetAlternativeCharacter</h1>
13
14
15<h2>Syntax</h2>
16<dl><dd><pre class="construction">
17#include &lt;revolution/enc.h&gt;
18
19ENCResult ENCSetAlternativeCharacter(ENCContext* context, u16 nomap, u16 invalid);
20</pre></dd></dl>
21
22<h2>Arguments</h2>
23<TABLE class="arguments" border="1" >
24    <tr>
25<th>context</th>
26<td>Character code conversion context.</td>
27    </tr>
28    <tr>
29<th>nomap</th>
30<td>Substitute characters for inconvertible characters corresponding to <code>ENC_ERR_NO_MAP_RULE</code>.<br>Specified in the character code of the internal character encoding.<br>Specify <code>ENC_ALT_STOP</code> if stopping without replacing characters with their substitutes, and <code>ENC_ALT_SKIP</code> if skipping to next character without replacing.</td>
31    </tr>
32    <tr>
33<th>invalid</th>
34<td>Substitute character for unsupported input character code corresponding to <code>ENC_ERR_INVALID_FORMAT</code>.<br>Specified in the character code of the internal character encoding.<br>Specify <code>ENC_ALT_STOP</code> if stopping without replacing characters with their substitutes, and <code>ENC_ALT_SKIP</code> if skipping to next character without replacing.</td>
35    </tr>
36</table>
37
38<h2>Return Values</h2>
39<p>
40<code>ENC_OK</code>: Normal exit. <br><code>ENC_ERR_INVALID_PARAM</code>: Invalid argument.<br>
41</p>
42
43<h2>Description</h2>
44<p>Specifies how non-convertible characters are handled.</p>
45<p>
46When replacing with a substitute character, it is specified with a character code of the internal character encoding.<br>Also, the substitute character needs to be convertible to an external character encoding.
47</p>
48<p>Specify <code>ENC_ALT_STOP</code> if stopping without replacing characters with their substitutes, and <code>ENC_ALT_SKIP</code> if skipping to next character without replacing.</p>
49<p>The default setting is <code>ENC_ALT_STOP</code>.</p>
50
51<h2>See Also</h2>
52<p>
53None.
54</p>
55
56<h2>Revision History</h2>
57<p>
582006/10/26 Initial version.<br>
59</p>
60
61<hr><p>CONFIDENTIAL</p></body>
62</html>