summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/ACE-guidelines.html67
1 files changed, 67 insertions, 0 deletions
diff --git a/docs/ACE-guidelines.html b/docs/ACE-guidelines.html
index 6f1a7adbd5a..7fc6ba5c9ff 100644
--- a/docs/ACE-guidelines.html
+++ b/docs/ACE-guidelines.html
@@ -654,6 +654,73 @@ bgcolor="#ffffff">
<strong><code>ASYS_ONLY_MULTIBYTE_STRING</code></strong>. See
the end of <a href="../ace/OS.h">OS.h</a> for more details.<p>
+ <li>Here is a brief breakdown:<p>
+ <table BORDER=2 CELLSPACING=2 CELLPADDING=0>
+ <tr>
+ <th Align=left>Macro Name</th>
+ <td>NONE </td>
+ <td>UNICODE</td>
+ <td>MOSTLY</td>
+ <td>Remark</td>
+ </tr>
+ <tr>
+ <th align=left><code>ACE_WIDE_STRING</code></th>
+ <td>NOP</td>
+ <td>C 2 W</td>
+ <td>C 2 W</td>
+ <td>&nbsp;</td>
+ </tr>
+ <tr>
+ <th align=left><code>ACE_MULTIBYTE_STRING</code></tr>
+ <td>NOP</td>
+ <td>W 2 C</td>
+ <td>W 2 C</td>
+ <td>&nbsp;</td>
+ </tr>
+ <tr>
+ <th align=left><code>ASYS_WIDE_STRING</code></th>
+ <td>NOP</td>
+ <td>NOP</td>
+ <td>C 2 W</td>
+ <td>Convert char strings to where ASYS_TCHAR strings are
+ expected.</td>
+ </tr>
+ <tr>
+ <th align=left><code>ASYS_MULTIBYTE_STRING</code></th>
+ <td>NOP</td>
+ <td>W 2 C</td>
+ <td>NOP</td>
+ <td>Convert LPTCSTR or LPTSTR strings to where ASYS_TCHAR
+ strings are expected.</td>
+ </tr>
+ <tr>
+ <th align=left><code>ASYS_ONLY_WIDE_STRING</code></th>
+ <td>NOP</td>
+ <td>C 2 W</td>
+ <td>NOP</td>
+ <td>Convert ASYS_TCHAR stirngs to where wchar strings are
+ expected.</td>
+ </tr>
+ <tr>
+ <th align=left><code>ASYS_ONLY_MULTIBYTE_STRING</code></th>
+ <td>NOP</td>
+ <td>NOP</td>
+ <td>W 2 C</td>
+ <td>Convert ASYS_TCHAR strings to where</td>
+ </tr>
+ </table><p>
+ Where:
+
+ <UL>
+ <LI>UNICODE: When <code>UNICODE</code> is defined.
+ <li>MOSTLY: When <code>ACE_HAS_MOSTLY_UNICODE_APIS</code> is
+ defined
+ <li>C: char *
+ <li>W: wchar *
+ <li>T: ASYS_TCHAR* (T == W) only when MOSTLY is defined,
+ otherwise, (T == C)
+ <li>NOP: No operation.
+ </ul><p>
</ul><p>
<li><strong>Exceptions</strong><p>