开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 多媒体编程 > 查看源码
TextUtils.h
资源名称：fullMPCcode.rar　[点击查看]
上传用户：xjjlds
上传日期：2015-12-05
资源大小：22823k
文件大小：18k
源码类别：

多媒体编程

开发平台：

Visual C++

TextUtils.h：源码内容
  1. /*
  2.      File:       TextUtils.h
  3.  
  4.      Contains:   Text Utilities Interfaces.
  5.  
  6.      Version:    Technology: Mac OS 8
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1985-2001 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef __TEXTUTILS__
  18. #define __TEXTUTILS__
  20. #ifndef __MACTYPES__
  21. #include "MacTypes.h"
  22. #endif
  24. #ifndef __NUMBERFORMATTING__
  25. #include "NumberFormatting.h"
  26. #endif
  28. #ifndef __STRINGCOMPARE__
  29. #include "StringCompare.h"
  30. #endif
  32. #ifndef __DATETIMEUTILS__
  33. #include "DateTimeUtils.h"
  34. #endif
  39. #if PRAGMA_ONCE
  40. #pragma once
  41. #endif
  43. #ifdef __cplusplus
  44. extern "C" {
  45. #endif
  47. #if PRAGMA_IMPORT
  48. #pragma import on
  49. #endif
  51. #if PRAGMA_STRUCT_ALIGN
  52.     #pragma options align=mac68k
  53. #elif PRAGMA_STRUCT_PACKPUSH
  54.     #pragma pack(push, 2)
  55. #elif PRAGMA_STRUCT_PACK
  56.     #pragma pack(2)
  57. #endif
  59. /*
  61.     Here are the current System 7 routine names and the translations to the older forms.
  62.     Please use the newer forms in all new code and migrate the older names out of existing
  63.     code as maintainance permits.
  64.     
  65.     NEW NAME                    OLD NAMEs                   OBSOLETE FORM (no script code)
  67.     FindScriptRun
  68.     FindWordBreaks                                          NFindWord, FindWord
  69.     GetIndString            
  70.     GetString
  71.     Munger
  72.     NewString               
  73.     SetString               
  74.     StyledLineBreak
  75.     TruncString
  76.     TruncText
  78.     UpperString ($A054)         UprString, UprText
  79.     UppercaseText               SCUpperText (a only)        UpperText ($A456)
  80.     LowercaseText                                           LwrString, LowerText, LwrText ($A056)
  81.     StripDiacritics                                         StripText ($A256)
  82.     UppercaseStripDiacritics                                StripUpperText ($A656)
  85. */
  87. /* Type for truncWhere parameter in TruncString, TruncText */
  88. typedef short                           TruncCode;
  89. enum {
  90.                                                                 /* Constants for truncWhere argument in TruncString and TruncText */
  91.     truncEnd                    = 0,                            /* Truncate at end */
  92.     truncMiddle                 = 0x4000,                       /* Truncate in middle */
  93.     smTruncEnd                  = 0,                            /* Truncate at end - obsolete */
  94.     smTruncMiddle               = 0x4000                        /* Truncate in middle - obsolete */
  95. };
  97. enum {
  98.                                                                 /* Constants for TruncString and TruncText results */
  99.     notTruncated                = 0,                            /* No truncation was necessary */
  100.     truncated                   = 1,                            /* Truncation performed */
  101.     truncErr                    = -1,                           /* General error */
  102.     smNotTruncated              = 0,                            /* No truncation was necessary - obsolete */
  103.     smTruncated                 = 1,                            /* Truncation performed   - obsolete */
  104.     smTruncErr                  = -1                            /* General error - obsolete */
  105. };
  107. typedef SInt8                           StyledLineBreakCode;
  108. enum {
  109.     smBreakWord                 = 0,
  110.     smBreakChar                 = 1,
  111.     smBreakOverflow             = 2
  112. };
  115. struct ScriptRunStatus {
  116.     SInt8                           script;
  117.     SInt8                           runVariant;
  118. };
  119. typedef struct ScriptRunStatus          ScriptRunStatus;
  121. struct BreakTable {
  122.     char                            charTypes[256];
  123.     short                           tripleLength;
  124.     short                           triples[1];
  125. };
  126. typedef struct BreakTable               BreakTable;
  127. typedef BreakTable *                    BreakTablePtr;
  129. struct NBreakTable {
  130.     SInt8                           flags1;
  131.     SInt8                           flags2;
  132.     short                           version;
  133.     short                           classTableOff;
  134.     short                           auxCTableOff;
  135.     short                           backwdTableOff;
  136.     short                           forwdTableOff;
  137.     short                           doBackup;
  138.     short                           length;                     /* length of NBreakTable */
  139.     char                            charTypes[256];
  140.     short                           tables[1];
  141. };
  142. typedef struct NBreakTable              NBreakTable;
  143. typedef NBreakTable *                   NBreakTablePtr;
  144. /* The following functions are new names that work on 68k and PowerPC*/
  145. EXTERN_API( long )
  146. Munger                          (Handle                 h,
  147.                                  long                   offset,
  148.                                  const void *           ptr1,
  149.                                  long                   len1,
  150.                                  const void *           ptr2,
  151.                                  long                   len2)                               ONEWORDINLINE(0xA9E0);
  153. EXTERN_API( StringHandle )
  154. NewString                       (ConstStr255Param       theString)                          ONEWORDINLINE(0xA906);
  156. EXTERN_API( void )
  157. SetString                       (StringHandle           theString,
  158.                                  ConstStr255Param       strNew)                             ONEWORDINLINE(0xA907);
  160. EXTERN_API( StringHandle )
  161. GetString                       (short                  stringID)                           ONEWORDINLINE(0xA9BA);
  163. EXTERN_API( void )
  164. GetIndString                    (Str255                 theString,
  165.                                  short                  strListID,
  166.                                  short                  index);
  168. #if CALL_NOT_IN_CARBON
  169. EXTERN_API_C( void )
  170. setstring                       (StringHandle           theString,
  171.                                  const char *           strNew);
  173. EXTERN_API_C( StringHandle )
  174. newstring                       (const char *           theString);
  176. EXTERN_API_C( void )
  177. getindstring                    (char *                 theString,
  178.                                  short                  strListID,
  179.                                  short                  index);
  181. #endif  /* CALL_NOT_IN_CARBON */
  183. EXTERN_API( StyledLineBreakCode )
  184. StyledLineBreak                 (Ptr                    textPtr,
  185.                                  long                   textLen,
  186.                                  long                   textStart,
  187.                                  long                   textEnd,
  188.                                  long                   flags,
  189.                                  Fixed *                textWidth,
  190.                                  long *                 textOffset)                         FOURWORDINLINE(0x2F3C, 0x821C, 0xFFFE, 0xA8B5);
  192. EXTERN_API( short )
  193. TruncString                     (short                  width,
  194.                                  Str255                 theString,
  195.                                  TruncCode              truncWhere)                         FOURWORDINLINE(0x2F3C, 0x8208, 0xFFE0, 0xA8B5);
  197. EXTERN_API( short )
  198. TruncText                       (short                  width,
  199.                                  Ptr                    textPtr,
  200.                                  short *                length,
  201.                                  TruncCode              truncWhere)                         FOURWORDINLINE(0x2F3C, 0x820C, 0xFFDE, 0xA8B5);
  203. EXTERN_API( void )
  204. FindWordBreaks                  (Ptr                    textPtr,
  205.                                  short                  textLength,
  206.                                  short                  offset,
  207.                                  Boolean                leadingEdge,
  208.                                  BreakTablePtr          breaks,
  209.                                  OffsetTable            offsets,
  210.                                  ScriptCode             script)                             FOURWORDINLINE(0x2F3C, 0xC012, 0x001A, 0xA8B5);
  212. EXTERN_API( void )
  213. LowercaseText                   (Ptr                    textPtr,
  214.                                  short                  len,
  215.                                  ScriptCode             script)                             SIXWORDINLINE(0x3F3C, 0x0000, 0x2F3C, 0x800A, 0xFFB6, 0xA8B5);
  217. EXTERN_API( void )
  218. UppercaseText                   (Ptr                    textPtr,
  219.                                  short                  len,
  220.                                  ScriptCode             script)                             SIXWORDINLINE(0x3F3C, 0x0400, 0x2F3C, 0x800A, 0xFFB6, 0xA8B5);
  222. EXTERN_API( void )
  223. StripDiacritics                 (Ptr                    textPtr,
  224.                                  short                  len,
  225.                                  ScriptCode             script)                             SIXWORDINLINE(0x3F3C, 0x0200, 0x2F3C, 0x800A, 0xFFB6, 0xA8B5);
  227. EXTERN_API( void )
  228. UppercaseStripDiacritics        (Ptr                    textPtr,
  229.                                  short                  len,
  230.                                  ScriptCode             script)                             SIXWORDINLINE(0x3F3C, 0x0600, 0x2F3C, 0x800A, 0xFFB6, 0xA8B5);
  232. EXTERN_API( ScriptRunStatus )
  233. FindScriptRun                   (Ptr                    textPtr,
  234.                                  long                   textLen,
  235.                                  long *                 lenUsed)                            FOURWORDINLINE(0x2F3C, 0x820C, 0x0026, 0xA8B5);
  237. #if CALL_NOT_IN_CARBON
  238. /*
  239.     The following functions are old names, but are required for PowerPC builds
  240.     because InterfaceLib exports these names, instead of the new ones.
  241. */
  242. #if CALL_NOT_IN_CARBON
  243. EXTERN_API( void )
  244. FindWord                        (Ptr                    textPtr,
  245.                                  short                  textLength,
  246.                                  short                  offset,
  247.                                  Boolean                leadingEdge,
  248.                                  BreakTablePtr          breaks,
  249.                                  OffsetTable            offsets)                            FOURWORDINLINE(0x2F3C, 0x8012, 0x001A, 0xA8B5);
  251. EXTERN_API( void )
  252. NFindWord                       (Ptr                    textPtr,
  253.                                  short                  textLength,
  254.                                  short                  offset,
  255.                                  Boolean                leadingEdge,
  256.                                  NBreakTablePtr         nbreaks,
  257.                                  OffsetTable            offsets)                            FOURWORDINLINE(0x2F3C, 0x8012, 0xFFE2, 0xA8B5);
  259. /*
  260.    On 68K machines, LwrText, LowerText, StripText, UpperText and StripUpperText
  261.    return an error code in register D0, but System 7 PowerMacs do not emulate
  262.    this properly, so checking D0 is unreliable.
  263. */
  265.                                                                                             #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
  266.                                                                                             #pragma parameter LwrText(__A0, __D0)
  267.                                                                                             #endif
  268. EXTERN_API( void )
  269. LwrText                         (Ptr                    textPtr,
  270.                                  short                  len)                                ONEWORDINLINE(0xA056);
  272.                                                                                             #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
  273.                                                                                             #pragma parameter LowerText(__A0, __D0)
  274.                                                                                             #endif
  275. EXTERN_API( void )
  276. LowerText                       (Ptr                    textPtr,
  277.                                  short                  len)                                ONEWORDINLINE(0xA056);
  279.                                                                                             #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
  280.                                                                                             #pragma parameter StripText(__A0, __D0)
  281.                                                                                             #endif
  282. EXTERN_API( void )
  283. StripText                       (Ptr                    textPtr,
  284.                                  short                  len)                                ONEWORDINLINE(0xA256);
  286.                                                                                             #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
  287.                                                                                             #pragma parameter UpperText(__A0, __D0)
  288.                                                                                             #endif
  289. EXTERN_API( void )
  290. UpperText                       (Ptr                    textPtr,
  291.                                  short                  len)                                ONEWORDINLINE(0xA456);
  293.                                                                                             #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
  294.                                                                                             #pragma parameter StripUpperText(__A0, __D0)
  295.                                                                                             #endif
  296. EXTERN_API( void )
  297. StripUpperText                  (Ptr                    textPtr,
  298.                                  short                  len)                                ONEWORDINLINE(0xA656);
  300. #endif  /* CALL_NOT_IN_CARBON */
  302. #endif  /* CALL_NOT_IN_CARBON */
  304. /* The following are new names which are exported by InterfaceLib*/
  305. EXTERN_API( void )
  306. UpperString                     (Str255                 theString,
  307.                                  Boolean                diacSensitive);
  309. EXTERN_API_C( void )
  310. upperstring                     (char *                 theString,
  311.                                  Boolean                diacSensitive);
  313. /* The following are macros which map old names to the names exported by InterfaceLib*/
  314. #if OLDROUTINENAMES
  315. #define UprString(theString, diacSensitive)  
  316.          UpperString(theString, diacSensitive)
  317. #endif  /* OLDROUTINENAMES */
  319. /* Old routine name but no new names are mapped to it:*/
  320. #if CALL_NOT_IN_CARBON
  321. #if CALL_NOT_IN_CARBON
  322.                                                                                             #if TARGET_OS_MAC && TARGET_CPU_68K && !TARGET_RT_MAC_CFM
  323.                                                                                             #pragma parameter UprText(__A0, __D0)
  324.                                                                                             #endif
  325. EXTERN_API( void )
  326. UprText                         (Ptr                    textPtr,
  327.                                  short                  len)                                ONEWORDINLINE(0xA054);
  329. #endif  /* CALL_NOT_IN_CARBON */
  331. #endif  /* CALL_NOT_IN_CARBON */
  333. /*
  334.     Functions for converting between C and Pascal Strings
  335.     (Previously in Strings.h)
  336.     
  337.     Note: CopyPascalStringToC, CopyCStringToPascal, c2pstrcpy, and p2cstrcpy
  338.           are written to allow inplace conversion.  That is, the src and dst
  339.           parameters can point to the memory location.  
  340.           
  341.     Note: c2pstr, C2PStr, p2cstr, and P2CStr are all deprecated.  These functions
  342.           only do inplace conversion and often require casts to call them.  This can
  343.           cause bugs because you can easily cast away a const and change the 
  344.           contents of a read-only buffer.  Do you know what c2pstr("Hello") will do?
  345.     
  346. */
  347. EXTERN_API_C( void )
  348. c2pstrcpy                       (Str255                 dst,
  349.                                  const char *           src);
  351. EXTERN_API_C( void )
  352. p2cstrcpy                       (char *                 dst,
  353.                                  ConstStr255Param       src);
  355. EXTERN_API_C( void )
  356. CopyPascalStringToC             (ConstStr255Param       src,
  357.                                  char *                 dst);
  359. EXTERN_API_C( void )
  360. CopyCStringToPascal             (const char *           src,
  361.                                  Str255                 dst);
  363. #if CALL_NOT_IN_CARBON
  364. #if CALL_NOT_IN_CARBON
  365. EXTERN_API_C( StringPtr )
  366. c2pstr                          (char *                 aStr);
  368. EXTERN_API( StringPtr )
  369. C2PStr                          (Ptr                    cString);
  371. EXTERN_API_C( char *)
  372. p2cstr                          (StringPtr              aStr);
  374. EXTERN_API( Ptr )
  375. P2CStr                          (StringPtr              pString);
  377. #endif  /* CALL_NOT_IN_CARBON */
  379. #endif  /* CALL_NOT_IN_CARBON */
  381. #if !TARGET_OS_MAC
  382.     /* Added for QuickTime 3.0 */
  383.     #define C2PStr(a)  (StringPtr)c2pstr((Ptr)(a))
  384.     #define P2CStr(a)  (Ptr)p2cstr(a)
  386.     #define CopyPascalStringToC(src,dst) p2cstrcpy(dst,src)
  387.     #define CopyCStringToPascal(src,dst) c2pstrcpy(dst,src)
  388. #endif
  389. /*
  390.    Added macros to convert p2cstr and c2pstr calls into p2cstrcpy and c2pstrcpy calls,
  391.    and map C2PStr and P2CStr to c2pstr and p2cstr for Carbon.
  392.    The use of the often unappreciated comma operator to coerce the proper return values,
  393.    since the p2cstrcpy and c2pstrcpy routines have no return value.
  394. */
  396. #if TARGET_OS_MAC && TARGET_API_MAC_CARBON && OLDP2C
  397.     #define p2cstr(aStr) (p2cstrcpy((char *) aStr, aStr) , (char *) aStr)
  398.     #define c2pstr(aStr) (c2pstrcpy(aStr, (char *) aStr) , (StringPtr) aStr)
  400.     #define C2PStr(a)  (StringPtr)c2pstr((Ptr)(a))
  401.     #define P2CStr(a)  (Ptr)p2cstr(a)
  402. #endif
  406. #if PRAGMA_STRUCT_ALIGN
  407.     #pragma options align=reset
  408. #elif PRAGMA_STRUCT_PACKPUSH
  409.     #pragma pack(pop)
  410. #elif PRAGMA_STRUCT_PACK
  411.     #pragma pack()
  412. #endif
  414. #ifdef PRAGMA_IMPORT_OFF
  415. #pragma import off
  416. #elif PRAGMA_IMPORT
  417. #pragma import reset
  418. #endif
  420. #ifdef __cplusplus
  421. }
  422. #endif
  424. #endif /* __TEXTUTILS__ */