Unicode 3.x and String- Related APIs in InDesign ... - Adobe Partners

Unicode 3.x and String-Related APIs inInDesign CS/InCopy CS # 10078 InDesign CS InCopy CS2003 9 12 Adobe Solutions Networkhttp://partners.adobe.com/asn/japan/developer/benefits.jsp

Copyright 2003 Adobe Systems Incorporated.All rights reserved.Adobe Systems IncorporatedAdobeAdobe After EffectsAdobe InDesignAdobe PhotoDeluxeAdobe PremiereAdobe PhotoshopAdobe IllustratorAdobe Type ManagerATM PostScript Macintosh Apple AppleComputer, Inc. Mac OS MicrosoftWindowsWindows 95Windows 98 Windows NT MicrosoftCorporation 0.1 2003 1 23 Ken Sadahiro 1.0 2003 1 27 Ken Sadahiro John Hake Lee Huang DocBook 1.0a 2003 1 30 Ken Sadahiro InDesignInDesign InCopyAlpha IComposeScanner::QueryData() 1.0b 2003 4 14 Ken Sadahiro Unicode TM SDK API 1.1 2003 7 14 Ken Sadahiro InDesign CSInCopy CSAPI 1.2 2003 9 3 Ken Sadahiro 1.3 2003 9 12 Ken Sadahiro ObsoleteLength()

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 InDesign InCopy Unicode . . . . . . . . . . . . . . . 6Unicode 3.x . . . . . . . . . . . . . . . . . . . . . . . . . . 7InDesign CS InCopy CS Unicode . . . . . . . . . . . . . . . . . . 8 Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Win32 API Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10UTF16TextChar UTF32TextChar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10UnicodeSavvyString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10WideStringConstUTF32Iter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11PMString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11WideString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16TextCharBuffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19TextIterator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20IComposeScanner::QueryDataAt(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21TextChar.h #defines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Win32 API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25iii

iv 2003 9 12 Unicode 3.x and String-Related APIs in InDesign CS/InCopy CS

1#10078 Unicode 3.x and StringrelatedAPIs in InDesign CS/InCopy CSInDesign CS InCopy CS API API InDesign InCopy Unicode InDesign CS InCopy CS InDesign InCopy 2.0 • API• Basic Multilingual PlaneBMP 16 U+0000 FFFFUnicode 1.0 • Unicode • CJK• 1 2 • • Input Method EditorIMEOSMicrosoft IME2000AppleErgoSoft EGBridge • JISISO-8859-1 • API InDesign CS InCopy CS API • 1 Unicode Unicode Tranformation Format UTF#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 5

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS• Unicodehttp://www.unicode.org • Unicode Scalar ValueUSVUnicode U+3000CJK 16 • Unicode Tranformation FormatUTF Unicode 3 1. UTF-81 4 http://www.unicode.org/faq/utf_bom.html#2 2. UTF-1616 http://www.unicode.org/faq/utf_bom.html#6 3. UTF-32 32 3 Unicode InDesign InCopy Unicode InDesign InCopy Unicode OpenType Unicode Unicode 2.0 InDesign InCopy Unicode • UTF-16 Unicode 3.0 16 1 InDesign InCopy 1.x 2.x textchar 16 • Unicode InDesign InCopy 1.x 2.x Unicode UnicodeUnicode Unicode InDesign InCopy Unicode • [ 1 ]• • Unicode SS 6

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CSInDesign CS InCopy CS Unicode Unicode InDesign CS InCopy CS API APIUnicode 3.x InDesign CS InCopy CS SDK API Unicode 3.x Unicode Unicode 3.2Unicode 3.x • Unicode 3.1 Unicode BMP U+10000 1FFFFU+20000 2FFFF U+E0000 EFFFF • Unicode 3.2 U+100000 10FFFF 40000 JIS X 0213• Unicode 3.x 3 Unicode Tranformation FormatUTF 1.1 UTF-88 1 4USV Unit1 Unit2 Unit3 Unit4U+0000 007FU+0080 07FF0xxxxxxx110xxxxx10xxxxxxU+0800 D7FFE000 FFFFU+10000 10FFFF1110xxxx 10xxxxxx 10xxxxxx11110xxx 10xxxxxx 10xxxxxx 10xxxxxx1 0 xUTF U+0080 07FF 11 x 11 U+10000 10FFFF 21 UTF-8 U+F03F 11101111 10000000 10111111 EF 80 BF 3 #10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 7

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CSInDesign CS InCopy CS Unicode 1.2 UTF-1616 1 2USV Unit1 Unit2U+0000 D7FFE000 FFFFU+10000 10FFFF10000 xxxxxxxxxxxxxxxx110110xxxxxxxxxx110111xxxxxxxxxx 3 UTF-16BEUTF-16LE UTF-16 1.3 UTF-3232 1Unicode 3.1 http://www.unicode.org/reports/tr19/ USVU+0000 D7FFE000 10FFFFUnit100000000000xxxxxxxxxxxxxxxxxxxxx 3 UTF-32BEUTF-32LE UTF-32 Unicode http://www.unicode.org/standard/standard.html InDesign CS InCopy CS Unicode Unicode Unicode 3.x 16 16 32 API API API • InDesign CS InCopy CS SDK API— UTF16TextChar UTF32TextChar— UnicodeSavvyString8

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CSInDesign CS InCopy CS Unicode — WideStringConstUTF32Iter• InDesign InCopy 2.0 SDK API API — PMString— WideStringUnicode — TextCharBuffertextchar — TextIterator IComposeScanner::QueryDataAt()Win32 API Unicode InDesign CS InCopy CS InDesign InCopy API Windows Unicode _Unicode precomp/msvc/VCSettings.h InDesign CS InCopy CS Unicode ANSI Unicode Win32 API Win32API IME Unicode • Unicode IME • Win32 API Unicode OS Unicode • Unicode • Visual C++ wchar_t Win32 Unicode API http://www.microsoft.com/msj/0499/multilangunicode/multilangunicode.htm InDesign CS InCopy CS Macintosh IME Unicode Windows #10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 9

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API APIInDesign CS InCopy CS SDK Unicode API API UTF16TextChar UTF32TextCharUnicodeSavvyString WideStringConstUTF32Iter UTF16TextChar UTF32TextCharAPI {SDK}/source/public/includes/BaseType.h Unicode UTF16TextChar uchar16 typedef textchar UTF32TextChar 32 Unicode UTF16TextChar UTF32TextChar Unicode textchar typedef UTF16TextChar UTF32TextChar BMP Unicode U+FFFF PMStringTextCharBufferTextIteratorWideStringWideStringConstUTF32IterUnicodeSavvyStringAPI {SDK}/source/public/includes/UnicodeSavvyString.hPMString WideString UnicodeSavvyString Unicode UTF16TextChar UTF16TextChar UTF32TextChar UTF-16 UTF-32 UTF16TextCharUTF32TextChar UnicodeSavvyString PMStringWideString10

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API WideStringConstUTF32IterAPI {SDK}/source/public/includes/WideString.hC++ STLWideString operator* UTF32TextChar WideStringConstUTF32Iter WideString WideString API PMStringAPI {SDK}/source/public/includes/PMString.hPMString InDesign CS InCopy CS API 1 • PMString • PMString Pascal • Unicode • Hash()AppendNumber()AsNumber()AppendFixed()SetHexChar()• Unicode 16 Unicode Unicode • PMString PMString PMString Unicode 3.x UTF-16 UTF-32 Unicode 3.x BMP #10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 11

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API textchar PMString PMString • PMString WideString • IsValidLineBreak() CJK • Unicode Unicode Unicode • InDesign InCopy 2.0 PMString API 3 Unicode • Unicode Unicode PMString • PMString UnicodeSavvyString UTF16TextChar UTF32TextChar UTF32TextChar UTF16TextChar* API uchar16 • Unicode • NULL U+0000• • PMString const 12

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API InDesign InCopy 2.x • Unicode textchar UTF32TextChar 1.4 textchar UTF32TextChar PMString InDesign 2.x InCopyTextchar GetWChar(int32 pos) const;void AppendW(textchar wc);InDesign CS InCopy CSUTF32TextChar GetWChar(int32 pos) const;void AppendW (UTF32TextChar wc);void InsertW(textchar wc, int32 pos = 0); void InsertW (UTF32TextChar wc, int32 pos = 0);int32 IndexOfWChar(textchar wc, int32 pos = 0) const;int32 LastIndexOfWChar(textchar wc) const;CharCounter IndexOfWChar (UTF32TextChar wc, int32pos = 0) const;CharCounter LastIndexOfWChar (UTF32TextChar wc)const;UTF32TextChar 16 16 somestring.AppendW(0x0020); // Insert a space• textchar*WString ConstWString UTF16TextChar* 1.5 textchar*/WString/ConstWString UTF16TextChar* PMString InDesign InCopy 2.xPMString(ConstWString string, int32 numChars, int16script = -1);void SetXString(const textchar* x, int32 nDblBytes);void AppendW(ConstWString ws, int32 nDblBytes =kMaxInt32);void InsertW(ConstWString ws, int32 nDblBytes =kMaxInt32, int32 pos = 0);InDesign CS InCopy CSPMString(const UTF16TextChar * string, int32nDblBytes, int16 script = -1);void SetXString (const UTF16TextChar* x, int32nDblBytes);void AppendW(const UTF16TextChar * ws, int32nDblBytes = kMaxInt32);void InsertW(const UTF16TextChar *ws, int32nDblBytes = kMaxInt32, int32 pos = 0);UTF16TextChar textchar 16 UTF16TextChar1 1 UTF16TextChar* 16 UTF16TextChar* #10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 13

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API • SetScript() SetEncoding() PMString.h SetEncoding() PMString Unicode SetEncoding() • PMString PMString Unicode PMString • PMString::Length() 1.6 PMString::Length() CharCounter Length(void) const; — CharCounter CharCount()GetCharSubstringTruncateContains CharCounter — int32 WCharLength() int32NumUTF16TextChars()GrabUTF16Buffer Unicode PMString 0 — int32 ByteLength()GrabCString() if (aPMString::Length() == 0) PMString bool16 IsEmpty() PMString IsEmpty() 14

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API 1.7 PMString InDesign InCopy 2.xInDesign InCopy 2.x InDesign InCopy 2.x void SetXString(const textchar* x, int32 nDblBytes);WString GrabPlatformEncodedWString(void);void ConvertToPlatformEncoding(void);CString GrabTString(void);ConstCString GrabTString(void) const;InDesign InCopy 2.x PlatformChar GetChar(CharCounter pos) const;textchar GetWChar(int32 pos) const;CharCounter Length(void) const;void AppendW(textchar wc);void InsertW(textchar wc, int32 pos = 0);int32 IndexOfWChar(textchar wc, int32 pos = 0) const;int32 LastIndexOfWChar(textchar wc) const;InDesign CS InCopy CSenum { kEncodingASCII,kEncodingShiftJIS,kEncodingChineseBig5,kEncodingKorean,kEncodingArabic,kEncodingHebrew,kEncodingGreek,kEncodingCyrillic,kEncodingThai = 21,kEncodingChineseGBK = 25,kEncodingEastEuropean = 29,kEncodingVietnamese };typedef int8 StringEncoding;PMString(const WideString& s);void SetXString(const UTF16TextChar* x, int32nDblBytes);ConstWString GrabPlatformEncodedWString(void)const;InDesign CS InCopy CS IEncodingUtils TCHAR* GrabTString(void);const TCHAR* GrabTString(void) const;void SetTString(const TCHAR* x);uint32 GetTLength() const;const PlatformChar GetChar(CharCounter pos) const;UTF32TextChar GetWChar(int32 pos) const;CharCounter ObsoleteLength(void) const;CharCounter Length(void) const PMString::Length() void AppendW(UTF32TextChar wc);void InsertW(UTF32TextChar wc, int32 pos = 0);CharCounter IndexOfWChar(UTF32TextChar wc, int32pos = 0) const;CharCounter LastIndexOfWChar(UTF32TextChar wc)const;#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 15

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API InDesign InCopy 2.xvoid Truncate(CharCounter count = 1, bool16handleTwoByte = kTrue);bool16 ValidLineBreakAfterIndex(CharCounter index);PlatformChar operator[](CharCounter index) const;uint8 GetScript() const;void SetScript(uint8 script);ConstWString GrabWString(void) const;InDesign InCopy 2.x InDesign CS InCopy CSvoid Truncate(CharCounter count = 1);void ObsoleteTruncate(CharCounter count = 1, bool16handleTwoByte = kTrue);InDesign CS InCopy CS PMString IEncodingUtils const PlatformChar operator[](CharCounter index)const;PMString::StringEncoding GetEncoding() const;void SetEncoding(PMString::StringEncoding encoding);const UTF16TextChar* GrabUTF16Buffer(int32*numUTF16s) const;int32 NumUTF16TextChars() const;UTF32TextChar GetUTF32TextChar(int32 pos) const;PMString* GetItem(const PMString& delimiter, constint32 nItem) const;WideStringAPI {SDK}/source/public/includes/WideString.hWideString Unicode API WideString PMString WideString • InDesign InCopy 2.x API uchar16 UTFTextChar32• uchar16 raw UTF32TextChar UTF32TextChar 16

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API • const UTF-16 InDesign InCopy 2.x WideString::iterator iter = ws.begin();WideString::iterator last = ws.end();while (iter != last) {uchar16 tc = *iter;++iter;}InDesign CS InCopy CS WideString::const_iterator iter = ws.begin();WideString::const_iterator last = ws.end();while (iter != last) {UTF32TextChar tc = *iter;++iter;}// NOTE:any place where a textchar or uchar16 was used// should be replaced with UTF32TextChar. 1.8 WideString InDesign InCopy 2.xtypedef uchar16& reference;typedef const uchar16& const_reference;typedef uchar16 value_type;typedef uchar16* pointer;typedef const uchar16* const_pointer;typedef uchar16* iterator;typedef const uchar16* const_iterator;typedef K2Reverse_iterator reverse_iterator;typedef K2Reverse_iteratorconst_reverse_iterator;InDesign InCopy 2.x InDesign CS InCopy CStypedef UTF32TextChar& reference;typedef const UTF32TextChar& const_reference;typedef UTF32TextChar value_type;typedef UTF32TextChar* pointer;typedef const UTF32TextChar* const_pointer;typedef WideStringConstUTF32Iter const_iterator;typedef K2Reverse_iterator reverse_iterator_raw;typedef K2Reverse_iterator const_reverse_iterator_raw;typedef UTF16TextChar& reference_raw;typedef const UTF16TextChar& const_reference_raw;typedef UTF16TextChar value_type_raw;typedef UTF16TextChar* pointer_raw;typedef const UTF16TextChar* const_pointer_raw;typedef UTF16TextChar* iterator_raw;typedef const UTF16TextChar* const_iterator_raw;#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 17

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API InDesign InCopy 2.xInDesign InCopy 2.x InDesign CS InCopy CSiterator_raw begin_raw();const_iterator_raw begin_raw() const;iterator_raw end_raw();const_iterator_raw end_raw() const;reverse_iterator_raw rbegin_raw();const_reverse_iterator_raw rbegin_raw() const;reverse_iterator_raw rend_raw();const_reverse_iterator_raw rend_raw() const;WideString(const uchar16* s, int32 len = LONG_MAX); explicit WideString(const UTF16TextChar* s, int32 len =LONG_MAX, int32 numChars = -1);InDesign InCopy 2.x void SetX16String(const uchar16* x, int32 len =LONG_MAX);iterator begin();reverse_iterator rbegin();const_reverse_iterator rbegin() const;reverse_iterator rend();const_reverse_iterator rend() const;uchar16* GrabX16String();const uchar16* GrabX16String() const;int32 size() const;InDesign InCopy 2.x uchar16 GetChar(int32 pos) const;uchar16 LastChar() const;uchar16 FirstChar() const;void push_back(uchar16 c);void Append(const uchar16* buf, int32 len);void Append(uchar16 c);void Append(uchar c);void Insert(const uchar16* buf, int32 len, int32 position= 0);void Insert(uchar16 c, int32 pos = 0);void Insert(uchar c, int32 pos = 0);int32 Strip(uchar16 c);WideString(const WideStringConstUTF32Iter& iter,int32 numChars);explicit WideString(ConstCString string);void SetX16String(const UTF16TextChar* x, int32 len =LONG_MAX, int32 numChars = -1);InDesign CS InCopy CS int32 CharCount() const;int32 UTF16IndexToCodePointIndex(int32 index) const;UTF32TextChar GetChar(int32 pos) const;UTF32TextChar LastChar() const;UTF32TextChar FirstChar() const;void push_back(UTF32TextChar c);void Append(const WideStringConstUTF32Iter& iter,int32 numChars);void Append(const UTF16TextChar* buf, int32 n, int32numChars = -1);void Append(UTF32TextChar c32);void Insert(const UTF16TextChar* buf, int32 len, int32pos = 0);void Insert(UTF32TextChar c, int32 pos = 0);int32 Strip(UTF32TextChar c);int32 IndexOf(uchar16 c, int32 position = 0) const; int32 IndexOf(UTF32TextChar c, int32 position = 0)const;18

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API InDesign InCopy 2.xInDesign InCopy 2.x uchar16 operator[](int32 index) const;uchar16& operator[](int32 index);InDesign InCopy 2.x InDesign CS InCopy CSWideString& operator = (const UTF16TextChar* copy);Const UTF32TextChar operator[](int32 index) const;void SetChar(int32 index, const UTF32TextChar& c32);bool16 operator == (const UTF16TextChar* b) const;bool16 operator != (const UTF16TextChar* b) const;TextCharBufferAPI {SDK}/source/public/includes/TextCharBuffer.hTextCharBuffer WideString Unicode textchar 32 Unicode TextCharBuffer textchar* WideStringConstUTF32Iter InDesign InCopy 2.x WideString ws = ". . .";TextCharBuffer tcb(ws);int32 len = tcb.Length();textchar* iter = tcb.begin();while (iter != tcb.end()) {textchar tc = *iter;++iter;}InDesign CS InCopy CS WideString ws = . . .;TextCharBuffer tcb(ws);int32 len = tcb.CharCount();WideStringConstUTF32Iter iter = tcb.begin();while (iter != tcb.end()) {UTF32TextChar tc = *iter;++iter;}#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 19

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API 1.9 TextCharBuffer InDesign InCopy 2.xTextCharBuffer(const textchar* b, int32 l);InDesign CS InCopy CSInDesign CS InCopy CS InDesign InCopy 2.x TextCharBuffer(WideStringConstUTF32Iter b,WideStringConstUTF32Iter e)TextCharBuffer();textchar First() const;textchar Last() const;textchar operator[] (int32 i) const;InDesign InCopy 2.x const textchar* begin() const;const textchar* end() const;int32 Length() const;void Remove(int32 position, int32 count);InDesign CS InCopy CS UTF32TextChar First() const;UTF32TextChar Last() const;UTF32TextChar operator[] (int32 i) const;const UTF16TextChar* begin_raw() const;const UTF16TextChar* end_raw() const;WideStringConstUTF32Iter begin() const;WideStringConstUTF32Iter end() const;int32 CharCount() const;int32 BufferLength() const;void remove_raw(int32 utf16Pos, int32 utf16Count);TextIteratorAPI {SDK}/source/public/includes/textiterator.hTextIterator textchar 32 Unicode TextCharBuffer TextIterator textchar* WideStringConstUTF32Iter InDesign InCopy 2.x ITextModel* textModel = . . .;TextIndex pos = . . .;TextIterator iter(textModel, pos);while(/*some terminating condition with TextIndex*/){20

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API }textchar tc = *iter;InDesign CS InCopy CS ITextModel* textModel = . . .;TextIndex pos = . . .;TextIterator iter(textModel, pos);if (!iter.IsNull()) {while ( iter.IterAt() != nil ) {UTF32TextChar tc = *iter;}} 1.10 TextIterator InDesign InCopy 2.xInDesign InCopy 2.x const textchar& operator* () const;const textchar* operator -> () const;const textchar& operator [] (int32 i) const;InDesign CS InCopy CSWideStringConstUTF32Iter IterAt() const;bool16 IsNull() const;UTF32TextChar operator* () const;WideStringConstUTF32Iter operator -> () const;UTF32TextChar operator [] (int32 i) const;IComposeScanner::QueryDataAt()API {SDK}/source/public/interfaces/text/IComposeScanner.hQueryDataAt() textchar BMP Unicode • QueryDataAt() textchar* TextIterator InDesign InCopy 2.x TextIndex position = . . .;IDrawingStyle* newStyle = nil;int32 length = 0;const textchar* ptc = composeScanner->QueryDataAt(#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 21

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS API position, &newStyle, &length);// length has the number of textchars// ptc points to the first textchar obtainedfor (int32 i = 0; i < length ; i++) {// get the characterconst textchar tc = *(ptc + i);}InDesign CS InCopy CS TextIndex position = . . .;IDrawingStyle* newStyle = nil;int32 numChars = 0;TextIterator iter = composeScanner->QueryDataAt(position, &newStyle, &numChars);// numChars has the number of textchars// iter points to the first UTF32TextChar obtainedint32 i = 0;while ((iter.IsNull() == kFalse) && (i < numChars)) {// get the characterconst UTF32TextChar tc = *iter;// goto the next character++iter;++i;} 1.11 IComposeScanner::QueryDataAt() InDesign InCopy 2.xvirtual const textchar* QueryDataAt(TextIndex position,IDrawingStyle **newstyle, int32 *length) = 0;InDesign CS InCopy CSvirtual TextIterator QueryDataAt(TextIndex position,IDrawingStyle **newstyle, int32 *numChars) = 0;TextChar.h #defines Unicode 1.12 TextChar.h #defines InDesign InCopy 2.xkTextChar_CancelkTextChar_EndOfMediumkTextChar_SubstituteInDesign CS InCopy CSInDesign CS InCopy CS 22

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CSUnicode InDesign InCopy 2.xInDesign InCopy 2.x namespace TextChar {bool16 IsSpecialChar(textchar n);bool16 IsControlChar(textchar n); }InDesign CS InCopy CSkTextChar_BreakRunInStylekTextChar_GreekOmegakTextChar_ThirdSpacekTextChar_QuarterSpacekTextChar_SixthSpacekTextChar_CJKIdeographExtensionAStartkTextChar_CJKIdeographExtensionAEndkTextChar_HighSurrogateStartkTextChar_HighSurrogateEndkTextChar_LowSurrogateStartkTextChar_LowSurrogateEndkTextChar_CJKCompatibilityIdeographsStartkTextChar_CJKCompatibilityIdeographsEndkTextChar_FullWidthCentSignnamespace TextChar {bool16 IsK2SpecificChar(UTF32TextChar c);bool16 IsLeadByte(uchar* buffer, int index);bool16 IsIllegalControlChar(UTF32TextChar n);bool16 IsIgnoredCharacter(UTF32TextChar n); }Unicode Win32 API ANSI UnicodeWide Win32 API Win32 API MSDN http://msdn.microsoft.com Windows Win32API OSCallNameA OSCallNameW 1 TCHAR* TCHAR* ANSI UnicodeWide WinAPI ANSI Unicode char* buf = "textstring";int result = ::DrawTextEx(gc->GetSysPort(), buf, strlen(buf), &textBounds,formatOptions, nil);#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 23

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS Unicode Unicode TCHAR* buf = TEXT("textstring");int result = ::DrawTextEx(gc->GetSysPort(), buf, _tcslen(buf), &textBounds,formatOptions, nil);// alternatively, using PMString:PMString buf("textstring");int result = ::DrawTextEx(gc->GetSysPort(), buf.GrabTString(), buf.GetTLength(),&textBounds, formatOptions, nil);Web • Unicode — http://www.unicode.org— Unicode Unicode© http://www.unicode.org/iuc/iuc17/papers.html— Unicodehttp://www.unicode.org/standard/standard.html— Unicode 3.2http://www.unicode.org/reports/tr28/— Unicode 3.1http://www.unicode.org/reports/tr19/• Apple Computer Inc.— Apple http://www.apple.com/developer— Unicode http://developer.apple.com/techpubs/macosx/Carbon/pdf/SupportingUnicodeInput.pdf— http://developer.apple.com/techpubs/macosx/Carbon/text/MultilingualTextEngine/multilingualtextengine.html— http://developer.apple.com/techpubs/macosx/Carbon/text/MultilingualTextEngine/HandlingUnicodeText_MLTE/index.html• Microsoft CorporationMSDN — Microsoft http://msdn.microsoft.com— International Programming Topicshttp://msdn.microsoft.com/library/enus/vccore98/HTML/_core_international_programming_topics.asp24

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS— Design a Single Unicode App that Runs on Both Windows 98 and Windows 2000Win32 Unicode API http://www.microsoft.com/msj/0499/multilangunicode/multilangunicode.htm• ErgoSoft http://www.ergo.co.jp• CJKV Information ProcessingKen Lunde O'Reilly & Associates, Inc.1999 ISBN 1-56592-224-7#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS 25

#10078 Unicode 3.x and String-related APIs in InDesign CS/InCopy CS26