UnicodeConverter.pas 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731
  1. {
  2. File: CarbonCore/UnicodeConverter.h
  3. Contains: Types, constants, and prototypes for Unicode Converter
  4. Copyright: © 1994-2011 Apple Inc. All rights reserved.
  5. Bugs?: For bug reports, consult the following page on
  6. the World Wide Web:
  7. http://bugs.freepascal.org
  8. }
  9. {
  10. Modified for use with Free Pascal
  11. Version 308
  12. Please report any bugs to <[email protected]>
  13. }
  14. {$ifc not defined MACOSALLINCLUDE or not MACOSALLINCLUDE}
  15. {$mode macpas}
  16. {$packenum 1}
  17. {$macro on}
  18. {$inline on}
  19. {$calling mwpascal}
  20. unit UnicodeConverter;
  21. interface
  22. {$setc UNIVERSAL_INTERFACES_VERSION := $0400}
  23. {$setc GAP_INTERFACES_VERSION := $0308}
  24. {$ifc not defined USE_CFSTR_CONSTANT_MACROS}
  25. {$setc USE_CFSTR_CONSTANT_MACROS := TRUE}
  26. {$endc}
  27. {$ifc defined CPUPOWERPC and defined CPUI386}
  28. {$error Conflicting initial definitions for CPUPOWERPC and CPUI386}
  29. {$endc}
  30. {$ifc defined FPC_BIG_ENDIAN and defined FPC_LITTLE_ENDIAN}
  31. {$error Conflicting initial definitions for FPC_BIG_ENDIAN and FPC_LITTLE_ENDIAN}
  32. {$endc}
  33. {$ifc not defined __ppc__ and defined CPUPOWERPC32}
  34. {$setc __ppc__ := 1}
  35. {$elsec}
  36. {$setc __ppc__ := 0}
  37. {$endc}
  38. {$ifc not defined __ppc64__ and defined CPUPOWERPC64}
  39. {$setc __ppc64__ := 1}
  40. {$elsec}
  41. {$setc __ppc64__ := 0}
  42. {$endc}
  43. {$ifc not defined __i386__ and defined CPUI386}
  44. {$setc __i386__ := 1}
  45. {$elsec}
  46. {$setc __i386__ := 0}
  47. {$endc}
  48. {$ifc not defined __x86_64__ and defined CPUX86_64}
  49. {$setc __x86_64__ := 1}
  50. {$elsec}
  51. {$setc __x86_64__ := 0}
  52. {$endc}
  53. {$ifc not defined __arm__ and defined CPUARM}
  54. {$setc __arm__ := 1}
  55. {$elsec}
  56. {$setc __arm__ := 0}
  57. {$endc}
  58. {$ifc not defined __arm64__ and defined CPUAARCH64}
  59. {$setc __arm64__ := 1}
  60. {$elsec}
  61. {$setc __arm64__ := 0}
  62. {$endc}
  63. {$ifc defined cpu64}
  64. {$setc __LP64__ := 1}
  65. {$elsec}
  66. {$setc __LP64__ := 0}
  67. {$endc}
  68. {$ifc defined __ppc__ and __ppc__ and defined __i386__ and __i386__}
  69. {$error Conflicting definitions for __ppc__ and __i386__}
  70. {$endc}
  71. {$ifc defined __ppc__ and __ppc__}
  72. {$setc TARGET_CPU_PPC := TRUE}
  73. {$setc TARGET_CPU_PPC64 := FALSE}
  74. {$setc TARGET_CPU_X86 := FALSE}
  75. {$setc TARGET_CPU_X86_64 := FALSE}
  76. {$setc TARGET_CPU_ARM := FALSE}
  77. {$setc TARGET_CPU_ARM64 := FALSE}
  78. {$setc TARGET_OS_MAC := TRUE}
  79. {$setc TARGET_OS_IPHONE := FALSE}
  80. {$setc TARGET_IPHONE_SIMULATOR := FALSE}
  81. {$setc TARGET_OS_EMBEDDED := FALSE}
  82. {$elifc defined __ppc64__ and __ppc64__}
  83. {$setc TARGET_CPU_PPC := FALSE}
  84. {$setc TARGET_CPU_PPC64 := TRUE}
  85. {$setc TARGET_CPU_X86 := FALSE}
  86. {$setc TARGET_CPU_X86_64 := FALSE}
  87. {$setc TARGET_CPU_ARM := FALSE}
  88. {$setc TARGET_CPU_ARM64 := FALSE}
  89. {$setc TARGET_OS_MAC := TRUE}
  90. {$setc TARGET_OS_IPHONE := FALSE}
  91. {$setc TARGET_IPHONE_SIMULATOR := FALSE}
  92. {$setc TARGET_OS_EMBEDDED := FALSE}
  93. {$elifc defined __i386__ and __i386__}
  94. {$setc TARGET_CPU_PPC := FALSE}
  95. {$setc TARGET_CPU_PPC64 := FALSE}
  96. {$setc TARGET_CPU_X86 := TRUE}
  97. {$setc TARGET_CPU_X86_64 := FALSE}
  98. {$setc TARGET_CPU_ARM := FALSE}
  99. {$setc TARGET_CPU_ARM64 := FALSE}
  100. {$ifc defined(iphonesim)}
  101. {$setc TARGET_OS_MAC := FALSE}
  102. {$setc TARGET_OS_IPHONE := TRUE}
  103. {$setc TARGET_IPHONE_SIMULATOR := TRUE}
  104. {$elsec}
  105. {$setc TARGET_OS_MAC := TRUE}
  106. {$setc TARGET_OS_IPHONE := FALSE}
  107. {$setc TARGET_IPHONE_SIMULATOR := FALSE}
  108. {$endc}
  109. {$setc TARGET_OS_EMBEDDED := FALSE}
  110. {$elifc defined __x86_64__ and __x86_64__}
  111. {$setc TARGET_CPU_PPC := FALSE}
  112. {$setc TARGET_CPU_PPC64 := FALSE}
  113. {$setc TARGET_CPU_X86 := FALSE}
  114. {$setc TARGET_CPU_X86_64 := TRUE}
  115. {$setc TARGET_CPU_ARM := FALSE}
  116. {$setc TARGET_CPU_ARM64 := FALSE}
  117. {$ifc defined(iphonesim)}
  118. {$setc TARGET_OS_MAC := FALSE}
  119. {$setc TARGET_OS_IPHONE := TRUE}
  120. {$setc TARGET_IPHONE_SIMULATOR := TRUE}
  121. {$elsec}
  122. {$setc TARGET_OS_MAC := TRUE}
  123. {$setc TARGET_OS_IPHONE := FALSE}
  124. {$setc TARGET_IPHONE_SIMULATOR := FALSE}
  125. {$endc}
  126. {$setc TARGET_OS_EMBEDDED := FALSE}
  127. {$elifc defined __arm__ and __arm__}
  128. {$setc TARGET_CPU_PPC := FALSE}
  129. {$setc TARGET_CPU_PPC64 := FALSE}
  130. {$setc TARGET_CPU_X86 := FALSE}
  131. {$setc TARGET_CPU_X86_64 := FALSE}
  132. {$setc TARGET_CPU_ARM := TRUE}
  133. {$setc TARGET_CPU_ARM64 := FALSE}
  134. { will require compiler define when/if other Apple devices with ARM cpus ship }
  135. {$setc TARGET_OS_MAC := FALSE}
  136. {$setc TARGET_OS_IPHONE := TRUE}
  137. {$setc TARGET_IPHONE_SIMULATOR := FALSE}
  138. {$setc TARGET_OS_EMBEDDED := TRUE}
  139. {$elifc defined __arm64__ and __arm64__}
  140. {$setc TARGET_CPU_PPC := FALSE}
  141. {$setc TARGET_CPU_PPC64 := FALSE}
  142. {$setc TARGET_CPU_X86 := FALSE}
  143. {$setc TARGET_CPU_X86_64 := FALSE}
  144. {$setc TARGET_CPU_ARM := FALSE}
  145. {$setc TARGET_CPU_ARM64 := TRUE}
  146. { will require compiler define when/if other Apple devices with ARM cpus ship }
  147. {$setc TARGET_OS_MAC := FALSE}
  148. {$setc TARGET_OS_IPHONE := TRUE}
  149. {$setc TARGET_IPHONE_SIMULATOR := FALSE}
  150. {$setc TARGET_OS_EMBEDDED := TRUE}
  151. {$elsec}
  152. {$error __ppc__ nor __ppc64__ nor __i386__ nor __x86_64__ nor __arm__ nor __arm64__ is defined.}
  153. {$endc}
  154. {$ifc defined __LP64__ and __LP64__ }
  155. {$setc TARGET_CPU_64 := TRUE}
  156. {$elsec}
  157. {$setc TARGET_CPU_64 := FALSE}
  158. {$endc}
  159. {$ifc defined FPC_BIG_ENDIAN}
  160. {$setc TARGET_RT_BIG_ENDIAN := TRUE}
  161. {$setc TARGET_RT_LITTLE_ENDIAN := FALSE}
  162. {$elifc defined FPC_LITTLE_ENDIAN}
  163. {$setc TARGET_RT_BIG_ENDIAN := FALSE}
  164. {$setc TARGET_RT_LITTLE_ENDIAN := TRUE}
  165. {$elsec}
  166. {$error Neither FPC_BIG_ENDIAN nor FPC_LITTLE_ENDIAN are defined.}
  167. {$endc}
  168. {$setc ACCESSOR_CALLS_ARE_FUNCTIONS := TRUE}
  169. {$setc CALL_NOT_IN_CARBON := FALSE}
  170. {$setc OLDROUTINENAMES := FALSE}
  171. {$setc OPAQUE_TOOLBOX_STRUCTS := TRUE}
  172. {$setc OPAQUE_UPP_TYPES := TRUE}
  173. {$setc OTCARBONAPPLICATION := TRUE}
  174. {$setc OTKERNEL := FALSE}
  175. {$setc PM_USE_SESSION_APIS := TRUE}
  176. {$setc TARGET_API_MAC_CARBON := TRUE}
  177. {$setc TARGET_API_MAC_OS8 := FALSE}
  178. {$setc TARGET_API_MAC_OSX := TRUE}
  179. {$setc TARGET_CARBON := TRUE}
  180. {$setc TARGET_CPU_68K := FALSE}
  181. {$setc TARGET_CPU_MIPS := FALSE}
  182. {$setc TARGET_CPU_SPARC := FALSE}
  183. {$setc TARGET_OS_UNIX := FALSE}
  184. {$setc TARGET_OS_WIN32 := FALSE}
  185. {$setc TARGET_RT_MAC_68881 := FALSE}
  186. {$setc TARGET_RT_MAC_CFM := FALSE}
  187. {$setc TARGET_RT_MAC_MACHO := TRUE}
  188. {$setc TYPED_FUNCTION_POINTERS := TRUE}
  189. {$setc TYPE_BOOL := FALSE}
  190. {$setc TYPE_EXTENDED := FALSE}
  191. {$setc TYPE_LONGLONG := TRUE}
  192. uses MacTypes,TextCommon;
  193. {$endc} {not MACOSALLINCLUDE}
  194. {$ifc TARGET_OS_MAC}
  195. {$ALIGN MAC68K}
  196. { Unicode conversion contexts: }
  197. type
  198. TextToUnicodeInfo = ^SInt32; { an opaque type }
  199. TextToUnicodeInfoPtr = ^TextToUnicodeInfo; { when a var xx:TextToUnicodeInfo parameter can be nil, it is changed to xx: TextToUnicodeInfoPtr }
  200. UnicodeToTextInfo = ^SInt32; { an opaque type }
  201. UnicodeToTextInfoPtr = ^UnicodeToTextInfo; { when a var xx:UnicodeToTextInfo parameter can be nil, it is changed to xx: UnicodeToTextInfoPtr }
  202. UnicodeToTextRunInfo = ^SInt32; { an opaque type }
  203. UnicodeToTextRunInfoPtr = ^UnicodeToTextRunInfo; { when a var xx:UnicodeToTextRunInfo parameter can be nil, it is changed to xx: UnicodeToTextRunInfoPtr }
  204. ConstTextToUnicodeInfo = TextToUnicodeInfo;
  205. ConstUnicodeToTextInfo = UnicodeToTextInfo;
  206. { UnicodeMapVersion type & values }
  207. type
  208. UnicodeMapVersion = SInt32;
  209. const
  210. kUnicodeUseLatestMapping = -1;
  211. kUnicodeUseHFSPlusMapping = 4;
  212. { Types used in conversion }
  213. type
  214. UnicodeMapping = record
  215. unicodeEncoding: TextEncoding;
  216. otherEncoding: TextEncoding;
  217. mappingVersion: UnicodeMapVersion;
  218. end;
  219. UnicodeMappingPtr = ^UnicodeMapping;
  220. type
  221. ConstUnicodeMappingPtr = ^UnicodeMapping;
  222. { Control flags for ConvertFromUnicodeToText and ConvertFromTextToUnicode }
  223. const
  224. kUnicodeUseFallbacksBit = 0;
  225. kUnicodeKeepInfoBit = 1;
  226. kUnicodeDirectionalityBits = 2;
  227. kUnicodeVerticalFormBit = 4;
  228. kUnicodeLooseMappingsBit = 5;
  229. kUnicodeStringUnterminatedBit = 6;
  230. kUnicodeTextRunBit = 7;
  231. kUnicodeKeepSameEncodingBit = 8;
  232. kUnicodeForceASCIIRangeBit = 9;
  233. kUnicodeNoHalfwidthCharsBit = 10;
  234. kUnicodeTextRunHeuristicsBit = 11;
  235. kUnicodeMapLineFeedToReturnBit = 12; { if kUnicodeUseExternalEncodingFormBit is not set, }
  236. { input/output UTF-16 (and UTF-32) is assumed to be in native endian. }
  237. { if kUnicodeUseExternalEncodingFormBit is set, }
  238. { input UTF-16 (and UTF-32) is assumed to be in big endian }
  239. { unless it begins with a byte-order-mark, }
  240. { and output UTF-16 (and UTF-32) will be in big endian. }
  241. kUnicodeUseExternalEncodingFormBit = 13; { Bits 16-17 are defined in TextEncodingConverter.h for TECSetBasicOptions }
  242. const
  243. kUnicodeUseFallbacksMask = 1 shl kUnicodeUseFallbacksBit;
  244. kUnicodeKeepInfoMask = 1 shl kUnicodeKeepInfoBit;
  245. kUnicodeDirectionalityMask = 3 shl kUnicodeDirectionalityBits;
  246. kUnicodeVerticalFormMask = 1 shl kUnicodeVerticalFormBit;
  247. kUnicodeLooseMappingsMask = 1 shl kUnicodeLooseMappingsBit;
  248. kUnicodeStringUnterminatedMask = 1 shl kUnicodeStringUnterminatedBit;
  249. kUnicodeTextRunMask = 1 shl kUnicodeTextRunBit;
  250. kUnicodeKeepSameEncodingMask = 1 shl kUnicodeKeepSameEncodingBit;
  251. kUnicodeForceASCIIRangeMask = 1 shl kUnicodeForceASCIIRangeBit;
  252. kUnicodeNoHalfwidthCharsMask = 1 shl kUnicodeNoHalfwidthCharsBit;
  253. kUnicodeTextRunHeuristicsMask = 1 shl kUnicodeTextRunHeuristicsBit;
  254. kUnicodeMapLineFeedToReturnMask = 1 shl kUnicodeMapLineFeedToReturnBit; { if kUnicodeUseExternalEncodingFormBit is not set, }
  255. { input/output UTF-16 (and UTF-32) is assumed to be in native endian. }
  256. { if kUnicodeUseExternalEncodingFormBit is set, }
  257. { input UTF-16 (and UTF-32) is assumed to be in big endian }
  258. { unless it begins with a byte-order-mark, }
  259. { and output UTF-16 (and UTF-32) will be in big endian. }
  260. kUnicodeUseExternalEncodingFormMask = 1 shl kUnicodeUseExternalEncodingFormBit;
  261. { Values for kUnicodeDirectionality field }
  262. const
  263. kUnicodeDefaultDirection = 0;
  264. kUnicodeLeftToRight = 1;
  265. kUnicodeRightToLeft = 2;
  266. { Directionality masks for control flags }
  267. const
  268. kUnicodeDefaultDirectionMask = kUnicodeDefaultDirection shl kUnicodeDirectionalityBits;
  269. kUnicodeLeftToRightMask = kUnicodeLeftToRight shl kUnicodeDirectionalityBits;
  270. kUnicodeRightToLeftMask = kUnicodeRightToLeft shl kUnicodeDirectionalityBits;
  271. { Control flags for TruncateForUnicodeToText: }
  272. {
  273. Now TruncateForUnicodeToText uses control flags from the same set as used by
  274. ConvertFromTextToUnicode, ConvertFromUnicodeToText, etc., but only
  275. kUnicodeStringUnterminatedMask is meaningful for TruncateForUnicodeToText.
  276. Previously two special control flags were defined for TruncateForUnicodeToText:
  277. kUnicodeTextElementSafeBit = 0
  278. kUnicodeRestartSafeBit = 1
  279. However, neither of these was implemented.
  280. Instead of implementing kUnicodeTextElementSafeBit, we now use
  281. kUnicodeStringUnterminatedMask since it accomplishes the same thing and avoids
  282. having special flags just for TruncateForUnicodeToText
  283. Also, kUnicodeRestartSafeBit is unnecessary, since restart-safeness is handled by
  284. setting kUnicodeKeepInfoBit with ConvertFromUnicodeToText.
  285. If TruncateForUnicodeToText is called with one or both of the old special control
  286. flags set (bits 0 or 1), it will not generate a paramErr, but the old bits have no
  287. effect on its operation.
  288. }
  289. { Filter bits for filter field in QueryUnicodeMappings and CountUnicodeMappings: }
  290. const
  291. kUnicodeMatchUnicodeBaseBit = 0;
  292. kUnicodeMatchUnicodeVariantBit = 1;
  293. kUnicodeMatchUnicodeFormatBit = 2;
  294. kUnicodeMatchOtherBaseBit = 3;
  295. kUnicodeMatchOtherVariantBit = 4;
  296. kUnicodeMatchOtherFormatBit = 5;
  297. const
  298. kUnicodeMatchUnicodeBaseMask = 1 shl kUnicodeMatchUnicodeBaseBit;
  299. kUnicodeMatchUnicodeVariantMask = 1 shl kUnicodeMatchUnicodeVariantBit;
  300. kUnicodeMatchUnicodeFormatMask = 1 shl kUnicodeMatchUnicodeFormatBit;
  301. kUnicodeMatchOtherBaseMask = 1 shl kUnicodeMatchOtherBaseBit;
  302. kUnicodeMatchOtherVariantMask = 1 shl kUnicodeMatchOtherVariantBit;
  303. kUnicodeMatchOtherFormatMask = 1 shl kUnicodeMatchOtherFormatBit;
  304. { Control flags for SetFallbackUnicodeToText }
  305. const
  306. kUnicodeFallbackSequencingBits = 0;
  307. const
  308. kUnicodeFallbackSequencingMask = 3 shl kUnicodeFallbackSequencingBits;
  309. kUnicodeFallbackInterruptSafeMask = 1 shl 2; { To indicate that caller fallback routine doesnÕt move memory}
  310. { values for kUnicodeFallbackSequencing field }
  311. const
  312. kUnicodeFallbackDefaultOnly = 0;
  313. kUnicodeFallbackCustomOnly = 1;
  314. kUnicodeFallbackDefaultFirst = 2;
  315. kUnicodeFallbackCustomFirst = 3;
  316. { Caller-supplied entry point to a fallback handler }
  317. type
  318. UnicodeToTextFallbackProcPtr = function( iSrcUniStr: UniCharPtr; iSrcUniStrLen: ByteCount; var oSrcConvLen: ByteCount; oDestStr: TextPtr; iDestStrLen: ByteCount; var oDestConvLen: ByteCount; iInfoPtr: LogicalAddress; iUnicodeMappingPtr: ConstUnicodeMappingPtr ): OSStatus;
  319. UnicodeToTextFallbackUPP = UnicodeToTextFallbackProcPtr;
  320. {
  321. * NewUnicodeToTextFallbackUPP()
  322. *
  323. * Availability:
  324. * Mac OS X: in version 10.0 and later in CoreServices.framework
  325. * CarbonLib: in CarbonLib 1.0 and later
  326. * Non-Carbon CFM: available as macro/inline
  327. }
  328. function NewUnicodeToTextFallbackUPP( userRoutine: UnicodeToTextFallbackProcPtr ): UnicodeToTextFallbackUPP; external name '_NewUnicodeToTextFallbackUPP';
  329. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  330. {
  331. * DisposeUnicodeToTextFallbackUPP()
  332. *
  333. * Availability:
  334. * Mac OS X: in version 10.0 and later in CoreServices.framework
  335. * CarbonLib: in CarbonLib 1.0 and later
  336. * Non-Carbon CFM: available as macro/inline
  337. }
  338. procedure DisposeUnicodeToTextFallbackUPP( userUPP: UnicodeToTextFallbackUPP ); external name '_DisposeUnicodeToTextFallbackUPP';
  339. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  340. {
  341. * InvokeUnicodeToTextFallbackUPP()
  342. *
  343. * Availability:
  344. * Mac OS X: in version 10.0 and later in CoreServices.framework
  345. * CarbonLib: in CarbonLib 1.0 and later
  346. * Non-Carbon CFM: available as macro/inline
  347. }
  348. function InvokeUnicodeToTextFallbackUPP( iSrcUniStr: UniCharPtr; iSrcUniStrLen: ByteCount; var oSrcConvLen: ByteCount; oDestStr: TextPtr; iDestStrLen: ByteCount; var oDestConvLen: ByteCount; iInfoPtr: LogicalAddress; iUnicodeMappingPtr: ConstUnicodeMappingPtr; userUPP: UnicodeToTextFallbackUPP ): OSStatus; external name '_InvokeUnicodeToTextFallbackUPP';
  349. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  350. { Function prototypes }
  351. {
  352. * CreateTextToUnicodeInfo()
  353. *
  354. * Availability:
  355. * Mac OS X: in version 10.0 and later in CoreServices.framework
  356. * CarbonLib: in CarbonLib 1.0 and later
  357. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  358. }
  359. function CreateTextToUnicodeInfo( iUnicodeMapping: ConstUnicodeMappingPtr; var oTextToUnicodeInfo: TextToUnicodeInfo ): OSStatus; external name '_CreateTextToUnicodeInfo';
  360. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  361. {
  362. * CreateTextToUnicodeInfoByEncoding()
  363. *
  364. * Availability:
  365. * Mac OS X: in version 10.0 and later in CoreServices.framework
  366. * CarbonLib: in CarbonLib 1.0 and later
  367. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  368. }
  369. function CreateTextToUnicodeInfoByEncoding( iEncoding: TextEncoding; var oTextToUnicodeInfo: TextToUnicodeInfo ): OSStatus; external name '_CreateTextToUnicodeInfoByEncoding';
  370. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  371. {
  372. * CreateUnicodeToTextInfo()
  373. *
  374. * Availability:
  375. * Mac OS X: in version 10.0 and later in CoreServices.framework
  376. * CarbonLib: in CarbonLib 1.0 and later
  377. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  378. }
  379. function CreateUnicodeToTextInfo( iUnicodeMapping: ConstUnicodeMappingPtr; var oUnicodeToTextInfo: UnicodeToTextInfo ): OSStatus; external name '_CreateUnicodeToTextInfo';
  380. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  381. {
  382. * CreateUnicodeToTextInfoByEncoding()
  383. *
  384. * Availability:
  385. * Mac OS X: in version 10.0 and later in CoreServices.framework
  386. * CarbonLib: in CarbonLib 1.0 and later
  387. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  388. }
  389. function CreateUnicodeToTextInfoByEncoding( iEncoding: TextEncoding; var oUnicodeToTextInfo: UnicodeToTextInfo ): OSStatus; external name '_CreateUnicodeToTextInfoByEncoding';
  390. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  391. {
  392. * CreateUnicodeToTextRunInfo()
  393. *
  394. * Availability:
  395. * Mac OS X: in version 10.0 and later in CoreServices.framework
  396. * CarbonLib: in CarbonLib 1.0 and later
  397. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  398. }
  399. function CreateUnicodeToTextRunInfo( iNumberOfMappings: ItemCount; {const} iUnicodeMappings: {variable-size-array} UnicodeMappingPtr; var oUnicodeToTextInfo: UnicodeToTextRunInfo ): OSStatus; external name '_CreateUnicodeToTextRunInfo';
  400. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  401. {
  402. * CreateUnicodeToTextRunInfoByEncoding()
  403. *
  404. * Availability:
  405. * Mac OS X: in version 10.0 and later in CoreServices.framework
  406. * CarbonLib: in CarbonLib 1.0 and later
  407. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  408. }
  409. function CreateUnicodeToTextRunInfoByEncoding( iNumberOfEncodings: ItemCount; {const} iEncodings: {variable-size-array} TextEncodingPtr; var oUnicodeToTextInfo: UnicodeToTextRunInfo ): OSStatus; external name '_CreateUnicodeToTextRunInfoByEncoding';
  410. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  411. {
  412. * CreateUnicodeToTextRunInfoByScriptCode()
  413. *
  414. * Availability:
  415. * Mac OS X: in version 10.0 and later in CoreServices.framework
  416. * CarbonLib: in CarbonLib 1.0 and later
  417. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  418. }
  419. function CreateUnicodeToTextRunInfoByScriptCode( iNumberOfScriptCodes: ItemCount; {const} iScripts: {variable-size-array} ScriptCodePtr; var oUnicodeToTextInfo: UnicodeToTextRunInfo ): OSStatus; external name '_CreateUnicodeToTextRunInfoByScriptCode';
  420. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  421. { Change the TextToUnicodeInfo to another mapping. }
  422. {
  423. * ChangeTextToUnicodeInfo()
  424. *
  425. * Availability:
  426. * Mac OS X: in version 10.0 and later in CoreServices.framework
  427. * CarbonLib: in CarbonLib 1.0 and later
  428. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  429. }
  430. function ChangeTextToUnicodeInfo( ioTextToUnicodeInfo: TextToUnicodeInfo; iUnicodeMapping: ConstUnicodeMappingPtr ): OSStatus; external name '_ChangeTextToUnicodeInfo';
  431. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  432. { Change the UnicodeToTextInfo to another mapping. }
  433. {
  434. * ChangeUnicodeToTextInfo()
  435. *
  436. * Availability:
  437. * Mac OS X: in version 10.0 and later in CoreServices.framework
  438. * CarbonLib: in CarbonLib 1.0 and later
  439. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  440. }
  441. function ChangeUnicodeToTextInfo( ioUnicodeToTextInfo: UnicodeToTextInfo; iUnicodeMapping: ConstUnicodeMappingPtr ): OSStatus; external name '_ChangeUnicodeToTextInfo';
  442. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  443. {
  444. * DisposeTextToUnicodeInfo()
  445. *
  446. * Availability:
  447. * Mac OS X: in version 10.0 and later in CoreServices.framework
  448. * CarbonLib: in CarbonLib 1.0 and later
  449. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  450. }
  451. function DisposeTextToUnicodeInfo( var ioTextToUnicodeInfo: TextToUnicodeInfo ): OSStatus; external name '_DisposeTextToUnicodeInfo';
  452. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  453. {
  454. * DisposeUnicodeToTextInfo()
  455. *
  456. * Availability:
  457. * Mac OS X: in version 10.0 and later in CoreServices.framework
  458. * CarbonLib: in CarbonLib 1.0 and later
  459. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  460. }
  461. function DisposeUnicodeToTextInfo( var ioUnicodeToTextInfo: UnicodeToTextInfo ): OSStatus; external name '_DisposeUnicodeToTextInfo';
  462. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  463. {
  464. * DisposeUnicodeToTextRunInfo()
  465. *
  466. * Availability:
  467. * Mac OS X: in version 10.0 and later in CoreServices.framework
  468. * CarbonLib: in CarbonLib 1.0 and later
  469. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  470. }
  471. function DisposeUnicodeToTextRunInfo( var ioUnicodeToTextRunInfo: UnicodeToTextRunInfo ): OSStatus; external name '_DisposeUnicodeToTextRunInfo';
  472. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  473. {
  474. * ConvertFromTextToUnicode()
  475. *
  476. * Availability:
  477. * Mac OS X: in version 10.0 and later in CoreServices.framework
  478. * CarbonLib: in CarbonLib 1.0 and later
  479. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  480. }
  481. function ConvertFromTextToUnicode( iTextToUnicodeInfo: TextToUnicodeInfo; iSourceLen: ByteCount; iSourceStr: ConstLogicalAddress; iControlFlags: OptionBits; iOffsetCount: ItemCount; {const} iOffsetArray: {variable-size-array} ByteOffsetPtr { can be NULL }; oOffsetCount: ItemCountPtr { can be NULL }; oOffsetArray: {variable-size-array} ByteOffsetPtr { can be NULL }; iOutputBufLen: ByteCount; var oSourceRead: ByteCount; var oUnicodeLen: ByteCount; oUnicodeStr: {variable-size-array} UniCharPtr ): OSStatus; external name '_ConvertFromTextToUnicode';
  482. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  483. {
  484. * ConvertFromUnicodeToText()
  485. *
  486. * Availability:
  487. * Mac OS X: in version 10.0 and later in CoreServices.framework
  488. * CarbonLib: in CarbonLib 1.0 and later
  489. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  490. }
  491. function ConvertFromUnicodeToText( iUnicodeToTextInfo: UnicodeToTextInfo; iUnicodeLen: ByteCount; {const} iUnicodeStr: {variable-size-array} UniCharPtr; iControlFlags: OptionBits; iOffsetCount: ItemCount; {const} iOffsetArray: {variable-size-array} ByteOffsetPtr { can be NULL }; oOffsetCount: ItemCountPtr { can be NULL }; oOffsetArray: {variable-size-array} ByteOffsetPtr { can be NULL }; iOutputBufLen: ByteCount; var oInputRead: ByteCount; var oOutputLen: ByteCount; oOutputStr: LogicalAddress ): OSStatus; external name '_ConvertFromUnicodeToText';
  492. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  493. {
  494. * ConvertFromUnicodeToTextRun()
  495. *
  496. * Availability:
  497. * Mac OS X: in version 10.0 and later in CoreServices.framework
  498. * CarbonLib: in CarbonLib 1.0 and later
  499. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  500. }
  501. function ConvertFromUnicodeToTextRun( iUnicodeToTextInfo: UnicodeToTextRunInfo; iUnicodeLen: ByteCount; {const} iUnicodeStr: {variable-size-array} UniCharPtr; iControlFlags: OptionBits; iOffsetCount: ItemCount; {const} iOffsetArray: {variable-size-array} ByteOffsetPtr { can be NULL }; oOffsetCount: ItemCountPtr { can be NULL }; oOffsetArray: {variable-size-array} ByteOffsetPtr { can be NULL }; iOutputBufLen: ByteCount; var oInputRead: ByteCount; var oOutputLen: ByteCount; oOutputStr: LogicalAddress; iEncodingRunBufLen: ItemCount; var oEncodingRunOutLen: ItemCount; oEncodingRuns: {variable-size-array} TextEncodingRunPtr ): OSStatus; external name '_ConvertFromUnicodeToTextRun';
  502. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  503. {
  504. * ConvertFromUnicodeToScriptCodeRun()
  505. *
  506. * Availability:
  507. * Mac OS X: in version 10.0 and later in CoreServices.framework
  508. * CarbonLib: in CarbonLib 1.0 and later
  509. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  510. }
  511. function ConvertFromUnicodeToScriptCodeRun( iUnicodeToTextInfo: UnicodeToTextRunInfo; iUnicodeLen: ByteCount; {const} iUnicodeStr: {variable-size-array} UniCharPtr; iControlFlags: OptionBits; iOffsetCount: ItemCount; {const} iOffsetArray: {variable-size-array} ByteOffsetPtr { can be NULL }; oOffsetCount: ItemCountPtr { can be NULL }; oOffsetArray: {variable-size-array} ByteOffsetPtr { can be NULL }; iOutputBufLen: ByteCount; var oInputRead: ByteCount; var oOutputLen: ByteCount; oOutputStr: LogicalAddress; iScriptRunBufLen: ItemCount; var oScriptRunOutLen: ItemCount; oScriptCodeRuns: {variable-size-array} ScriptCodeRunPtr ): OSStatus; external name '_ConvertFromUnicodeToScriptCodeRun';
  512. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  513. { Truncate a multibyte string at a safe place. }
  514. {
  515. * TruncateForTextToUnicode()
  516. *
  517. * Availability:
  518. * Mac OS X: in version 10.0 and later in CoreServices.framework
  519. * CarbonLib: in CarbonLib 1.0 and later
  520. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  521. }
  522. function TruncateForTextToUnicode( iTextToUnicodeInfo: ConstTextToUnicodeInfo; iSourceLen: ByteCount; iSourceStr: ConstLogicalAddress; iMaxLen: ByteCount; var oTruncatedLen: ByteCount ): OSStatus; external name '_TruncateForTextToUnicode';
  523. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  524. { Truncate a Unicode string at a safe place. }
  525. {
  526. * TruncateForUnicodeToText()
  527. *
  528. * Availability:
  529. * Mac OS X: in version 10.0 and later in CoreServices.framework
  530. * CarbonLib: in CarbonLib 1.0 and later
  531. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  532. }
  533. function TruncateForUnicodeToText( iUnicodeToTextInfo: ConstUnicodeToTextInfo; iSourceLen: ByteCount; iSourceStr: ConstUniCharPtr; iControlFlags: OptionBits; iMaxLen: ByteCount; var oTruncatedLen: ByteCount ): OSStatus; external name '_TruncateForUnicodeToText';
  534. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  535. { Convert a Pascal string to Unicode string. }
  536. {
  537. * ConvertFromPStringToUnicode()
  538. *
  539. * Availability:
  540. * Mac OS X: in version 10.0 and later in CoreServices.framework
  541. * CarbonLib: in CarbonLib 1.0 and later
  542. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  543. }
  544. function ConvertFromPStringToUnicode( iTextToUnicodeInfo: TextToUnicodeInfo; const (*var*) iPascalStr: Str255; iOutputBufLen: ByteCount; var oUnicodeLen: ByteCount; oUnicodeStr: UniCharPtr ): OSStatus; external name '_ConvertFromPStringToUnicode';
  545. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  546. { Convert a Unicode string to Pascal string. }
  547. {
  548. * ConvertFromUnicodeToPString()
  549. *
  550. * Availability:
  551. * Mac OS X: in version 10.0 and later in CoreServices.framework
  552. * CarbonLib: in CarbonLib 1.0 and later
  553. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  554. }
  555. function ConvertFromUnicodeToPString( iUnicodeToTextInfo: UnicodeToTextInfo; iUnicodeLen: ByteCount; {const} iUnicodeStr: {variable-size-array} UniCharPtr; var oPascalStr: Str255 ): OSStatus; external name '_ConvertFromUnicodeToPString';
  556. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  557. { Count the available conversion mappings. }
  558. {
  559. * CountUnicodeMappings()
  560. *
  561. * Availability:
  562. * Mac OS X: in version 10.0 and later in CoreServices.framework
  563. * CarbonLib: in CarbonLib 1.0 and later
  564. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  565. }
  566. function CountUnicodeMappings( iFilter: OptionBits; iFindMapping: ConstUnicodeMappingPtr; var oActualCount: ItemCount ): OSStatus; external name '_CountUnicodeMappings';
  567. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  568. { Get a list of the available conversion mappings. }
  569. {
  570. * QueryUnicodeMappings()
  571. *
  572. * Availability:
  573. * Mac OS X: in version 10.0 and later in CoreServices.framework
  574. * CarbonLib: in CarbonLib 1.0 and later
  575. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  576. }
  577. function QueryUnicodeMappings( iFilter: OptionBits; iFindMapping: ConstUnicodeMappingPtr; iMaxCount: ItemCount; var oActualCount: ItemCount; oReturnedMappings: {variable-size-array} UnicodeMappingPtr ): OSStatus; external name '_QueryUnicodeMappings';
  578. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  579. { Setup the fallback handler for converting Unicode To Text. }
  580. {
  581. * SetFallbackUnicodeToText()
  582. *
  583. * Availability:
  584. * Mac OS X: in version 10.0 and later in CoreServices.framework
  585. * CarbonLib: in CarbonLib 1.0 and later
  586. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  587. }
  588. function SetFallbackUnicodeToText( iUnicodeToTextInfo: UnicodeToTextInfo; iFallback: UnicodeToTextFallbackUPP; iControlFlags: OptionBits; iInfoPtr: LogicalAddress ): OSStatus; external name '_SetFallbackUnicodeToText';
  589. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  590. { Setup the fallback handler for converting Unicode To TextRuns. }
  591. {
  592. * SetFallbackUnicodeToTextRun()
  593. *
  594. * Availability:
  595. * Mac OS X: in version 10.0 and later in CoreServices.framework
  596. * CarbonLib: in CarbonLib 1.0 and later
  597. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  598. }
  599. function SetFallbackUnicodeToTextRun( iUnicodeToTextRunInfo: UnicodeToTextRunInfo; iFallback: UnicodeToTextFallbackUPP; iControlFlags: OptionBits; iInfoPtr: LogicalAddress ): OSStatus; external name '_SetFallbackUnicodeToTextRun';
  600. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  601. { Re-initialize all state information kept by the context objects. }
  602. {
  603. * ResetTextToUnicodeInfo()
  604. *
  605. * Availability:
  606. * Mac OS X: in version 10.0 and later in CoreServices.framework
  607. * CarbonLib: in CarbonLib 1.0 and later
  608. * Non-Carbon CFM: in UnicodeConverter 1.3 and later
  609. }
  610. function ResetTextToUnicodeInfo( ioTextToUnicodeInfo: TextToUnicodeInfo ): OSStatus; external name '_ResetTextToUnicodeInfo';
  611. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  612. { Re-initialize all state information kept by the context objects. }
  613. {
  614. * ResetUnicodeToTextInfo()
  615. *
  616. * Availability:
  617. * Mac OS X: in version 10.0 and later in CoreServices.framework
  618. * CarbonLib: in CarbonLib 1.0 and later
  619. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  620. }
  621. function ResetUnicodeToTextInfo( ioUnicodeToTextInfo: UnicodeToTextInfo ): OSStatus; external name '_ResetUnicodeToTextInfo';
  622. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  623. { Re-initialize all state information kept by the context objects in TextRun conversions. }
  624. {
  625. * ResetUnicodeToTextRunInfo()
  626. *
  627. * Availability:
  628. * Mac OS X: in version 10.0 and later in CoreServices.framework
  629. * CarbonLib: in CarbonLib 1.0 and later
  630. * Non-Carbon CFM: in UnicodeConverter 1.1 and later
  631. }
  632. function ResetUnicodeToTextRunInfo( ioUnicodeToTextRunInfo: UnicodeToTextRunInfo ): OSStatus; external name '_ResetUnicodeToTextRunInfo';
  633. (* __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
  634. {$endc} {TARGET_OS_MAC}
  635. {$ifc not defined MACOSALLINCLUDE or not MACOSALLINCLUDE}
  636. end.
  637. {$endc} {not MACOSALLINCLUDE}