home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / NeXTanswers / OpenStepSpec_rtf / FoundationKit / Classes / NSArchiver.rtf next >
Encoding:
Text File  |  1994-07-01  |  4.8 KB  |  100 lines
  1. {\rtf0\ansi\paperw16228 \paperh18648 \margl-907 \margr0 \margt0 \margb0 {\fonttbl\f0\fswiss Helvetica;\f1\froman Times;\f2\fmodern Courier;\f3\ftech Symbol;\f4\froman Palatino;}
  2. {\stylesheet{\s0 \li100 \fi0 \ri1007 \ql   1Head;}
  3. {\s1 \li100 \fi0 \ri0 \ql   ChapterNum;}
  4. {\s2 \li0 \fi0 \ri1007 \ql   ChapterTitle;}
  5. {\s3 \li100 \fi0 \ri1007 \ql   ClassName;}
  6. {\s4 \li2872 \fi-2771 \ri1007 \ql \tx2872   ConformsTo;}
  7. {\s5 \li2872 \fi-2771 \ri1007 \ql   DeclaredIn;}
  8. {\s6 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030   Description;}
  9. {\s7 \li7030 \fi-5796 \ri1007 \ql   DescriptionPart;}
  10. {\s8 \li0 \fi0 \ri0 \ql \tx-25 \tx8290 \tx9172   Footer;}
  11. {\s9 \li2872 \fi-2771 \ri1007 \ql \tx2872   InheritsFrom;}
  12. {\s10 \li100 \fi0 \ri1007 \ql   Summary;}
  13. }
  14. \li0 \fi0 \ri0 \ql \sb0 \f1 \fs24 
  15. (Preliminary Documentation) Copyright \f3 \'e3\f1 1994 by NeXT Computer, Inc.  All Rights Reserved.\
  16. \
  17. \s0 \li100 \fi0 \ri0 \ql \f0 \b \fs84 \fs16 \
  18. \fs84 2\
  19. \fs16 \
  20. \
  21. \
  22. \fs84 \s2 \li0 \fi756 \fi0 \ri1007 \f1 \b0 \i \fs88 \fs16 \fs88 Foundation Kit\
  23. \fs16 \
  24. \
  25. \
  26. \
  27. \
  28. \
  29. \
  30. \
  31. \fs88 \s0 \li100 \fi-756 \fi0 \f0 \b \i0 \fs52 \fs16 \fs52 Classes\
  32. \fs16 \
  33. \
  34. \fs52 \s3 \fs36 \fs16 \
  35. \
  36. \
  37. \
  38. \
  39. \fs36 NSArchiver \
  40. \pard \s9 \li2872 \fi-2771 \ri1007 \ql \tx2872 \f1 \b0 \fs28 \fs16 \
  41. \
  42. \
  43. \fs28 \f0 \b \fs28 Inherits From:    \b0 \fs28 \f1 NSCoder : NSObject\
  44. \fs16 \
  45. \fs28 \s4 \fs16 \fs28 \f0 \b \fs28 Conforms To:    \b0 \fs28 \f1 NSCoding\
  46. \fi0 NSObject \
  47. \fs16 \
  48. \fs28 \s5 \fi-2771 \fs16 \fs28 \f0 \b \fs28 Declared In:    \b0 \fs28 \f1 foundation/NSArchiver.h \
  49. \fs16 \
  50. \fs28 \pard \s10 \li100 \fi0 \ri1007 \ql \f0 \b \fs28 \fs16 \
  51. \
  52. \fs28 Initializing an NSArchiver\
  53. \fs16 \
  54. \fs28 \pard \s6 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (id)\b initForWritingWithMutableData:\b0 (NSMutableData *)\i mdata\i0     \
  55. \fi-6552 \s7 \li7030 \fi-6553 \fi-5796     Initializes an archiver, encoding stream and version information into mutable data \i mdata\i0 .\
  56. \pard \s10 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  57. \
  58. \
  59. \fs28 Archiving data \
  60. \fs16 \
  61. \fs28 \pard \s6 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 + (NSData *)\b archivedDataWithRootObject:\b0 (id)\i rootObject\i0     \
  62. \fi-6552 \s7 \li7030 \fi-6553 \fi-5796     Creates and returns a data object after initializing an archiver with that object and encoding the archiver with \i rootObject\i0 .\
  63. \s6 \li7029 \fi-5794 \fi-6552 \fi-6552 + (BOOL)\b archiveRootObject:\b0 (id)\i rootObject\i0     Archives\i  rootObject\i0  by encoding it as a data object in\
  64. \fi-6552 \s7 \li7030 \fi-6553 \fi-5796 \b toFile:\b0 (NSString *)\i path\i0         an archiver and writing that data object to file \i path\i0 .  Returns YES upon success.\
  65. \s6 \li7029 \fi-5794 \fi-6552 \fi-6552 {\f3 -} (void)\b encodeArrayOfObjCType:\b0 (const char *)\i type\i0      Encodes an \i array\i0  of \i count\i0  data elements of the same   \
  66. \fi-6552 \s7 \li7030 \fi-6553 \fi-5796 \b count:\b0 (unsigned int)\i count\i0         Objective C data \i type\i0 .\i   \
  67. \i0 \b at:\b0 (const void *)\i array\
  68. \s6 \li7029 \fi-5794 \fi-6552 \i0 \fi-6552 {\f3 -} (void)\b encodeConditionalObject:\b0 (id)\i object\i0     Encodes into the linearized data a conditional  \i object\i0  that points back toward a root object.  If \b nil\b0  is specified for \i object\i0 , it encodes it as \b nil\b0  unconditionally.  Raises an exception if no root object has been encoded.    \
  69. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b encodeRootObject:\b0 (id)\i rootObject\i0     Encodes the \i rootObject\i0  at the start of the linearized data representing the object graph.  Raises an exception if the root object has already been encoded.\
  70. \fi-6552 \pard \s10 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  71. \
  72. \
  73. \fs28 Getting data from the archiver\
  74. \fs16 \
  75. \fs28 \pard \s6 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSMutableData *)\b archiverData\b0     Returns the data object,  in mutable form, that is associated with the receiving NSArchiver.\
  76. \fi-6552 \pard \s10 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  77. \
  78. \
  79. \fs28 Substituting One Class for Another \
  80. \fs16 \
  81. \fs28 \pard \s6 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 + (NSString *)\b classNameEncodedForTrueClassName:\b0 (NSString *)\i trueName\
  82. \fi-6552 \s7 \li7030 \fi-6553 \fi-5796 \i0     Returns the string object representing the class name used to archive instances of the class.  This class name might not be the original name (\i trueName\i0 ):  see \b encodeClassName:intoClassName\b0 .\
  83. \s6 \li7029 \fi-5794 \fi-6552 \fi-6552 {\f3 -} (void)\b encodeClassName:\b0 (NSString *)\i trueName\i0     Encodes in the archived data a substitute class name \
  84. \fi-6552 \s7 \li7030 \fi-6553 \fi-5796 \b intoClassName:\b0 (NSString *)\i inArchiveName\i0         (\i inArchiveName\i0 ) for the real class name (\i trueName\i0 ).  \
  85. \pard \s0 \li100 \fi0 \ri1007 \tx478 \tx856 \tx1234 \fs28 \fs16 \
  86. \
  87. \fs28 \
  88. \fs16 \
  89. \
  90. \fs28 \fs16 \fs28 \
  91. \fs16 \
  92. \
  93. \fs28 \fs16 \fs28 \
  94. \fs16 \
  95. \
  96. \fs28 \fs16 \fs28 \
  97. \fs16 \
  98. \
  99. \fs28 }
  100.