home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / NeXTanswers / OpenStepSpec_rtf / FoundationKit / Protocols / NSObject.rtf < prev   
Encoding:
Text File  |  1994-07-01  |  7.0 KB  |  123 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 \li2872 \fi-2771 \ri1007 \ql \tx2872   AdoptedBy;}
  4. {\s2 \li100 \fi0 \ri1007 \ql \tx478 \tx856 \tx1234   Body;}
  5. {\s3 \li2872 \fi-2771 \ri1007 \ql \tx2872   CategoryOf;}
  6. {\s4 \li100 \fi0 \ri1007 \ql   ClassName;}
  7. {\s5 \li2872 \fi-2771 \ri1007 \ql \tx2872   ConformsTo;}
  8. {\s6 \li2872 \fi-2771 \ri1007 \ql   DeclaredIn;}
  9. {\s7 \li7029 \fi-6928 \ri1007 \ql \tx6652 \tx7030   DescNoInd;}
  10. {\s8 \li7029 \fi-6172 \ri1007 \ql   DescPartNoInd;}
  11. {\s9 \li7029 \fi-6552 \ri1007 \ql   Description;}
  12. {\s10 \li7029 \fi-5796 \ri1007 \ql   DescriptionPart;}
  13. {\s11 \li0 \fi0 \ri0 \ql \tx-25 \tx8290 \tx9172   Footer;}
  14. {\s12 \li2872 \fi-2771 \ri1007 \ql \tx2872   Incorporates;}
  15. {\s13 \li100 \fi0 \ri1007 \ql   informalprotocol;}
  16. {\s14 \li2872 \fi-2771 \ri1007 \ql \tx2872   InheritsFrom;}
  17. {\s15 \li100 \fi0 \ri1007 \ql   NoSummary(space);}
  18. {\s16 \li100 \fi0 \ri1007 \ql   Summary;}
  19. }
  20. \li0 \fi0 \ri0 \ql \sb0 \f1 \fs24 
  21. (Preliminary Documentation) Copyright \f3 \'e3\f1 1994 by NeXT Computer, Inc.  All Rights Reserved.\
  22. \
  23. \s0 \li100 \fi0 \ri1007 \ql \f0 \b \fs36 \fs16 \
  24. \
  25. \
  26. \
  27. \
  28. \
  29. \
  30. \fs36 NSObject \
  31. \pard \s1 \li2872 \fi-2771 \ri1007 \ql \tx2872 \f1 \b0 \fs28 \fs16 \
  32. \
  33. \
  34. \fs28 \f0 \b \fs28 Adopted By:    \b0 \fs28 \f1 NSObject\
  35. \fi0 NSProxy\
  36. \fs16 \
  37. \fs28 \s6 \fi-2771 \fs16 \fs28 \f0 \b \fs28 Declared In:    \b0 \fs28 \f1 foundation/NSObject.h \
  38. \fs16 \
  39. \fs28 \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs28 \fs16 \
  40. \
  41. \fs28 Identifying and Comparing Instances\
  42. \fs16 \
  43. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (unsigned)\b hash\b0     Returns an unsigned integer that can be used as a table address in a hash table structure. Two objects that are equal must hash to the same value.\
  44. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (BOOL)\b isEqual:\b0 (id)\i anObject\i0     Returns YES if the receiver and \i anObject\i0  have equal values; otherwise returns NO.\
  45. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (id)\b self\b0     Returns the receiver.\
  46. \fi-6552 \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  47. \
  48. \
  49. \fs28 Identifying Class and Superclass\
  50. \fs16 \
  51. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (Class)\b class\b0     Returns the class object for the receiver\'27s class.\
  52. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (Class)\b superclass\b0     Returns the class object for the receiver\'27s superclass.\
  53. \fi-6552 \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  54. \
  55. \
  56. \fs28 Determining Allocation Zones\
  57. \fs16 \
  58. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSZone *)\b zone\b0     Returns a pointer to the zone from which the receiver was allocated.\
  59. \fi-6552 \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  60. \
  61. \
  62. \fs28 Sending Messages Determined at Run Time\
  63. \fs16 \
  64. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (id)\b perform:\b0 (SEL)\i aSelector\i0     Sends an \i aSelector\i0  message to the receiver and returns the result of the message. If \i aSelector\i0  is null, an NSInvalidArgumentException is raised.\
  65. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (id)\b perform:\b0 (SEL)\i aSelector\i0     Sends an \i aSelector\i0  message to the receiver with \i anObject\
  66. \fi-6552 \s10 \fi-5796 \i0 \b withObject:\b0 (id)\i anObject\i0         as an argument. If \i aSelector\i0  is null, an NSInvalidArgumentException is raised.\
  67. \s9 \fi-6552 \fi-6552 {\f3 -} (id)\b perform:\b0 (SEL)\i aSelector\i0     Sends the receiver an \i aSelector\i0  message with \i anObject\i0  and\
  68. \fi-6552 \s10 \fi-5796 \b withObject:\b0 (id)\i anObject\i0     \i     anotherObject\i0  as arguments. If \i aSelector\i0  is null, an\
  69. \b withObject:\b0 (id)\i anotherObject\i0          NSInvalidArgumentException is raised.\
  70. \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  71. \
  72. \
  73. \fs28 Identifying Proxies\
  74. \fs16 \
  75. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (BOOL)\b isProxy\b0     Returns YES to indicate that the receiver is an NSProxy, rather than an object that descends from NSObject. Otherwise, it returns NO.\
  76. \fi-6552 \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  77. \
  78. \
  79. \fs28 Testing Inheritance Relationships\
  80. \fs16 \
  81. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (BOOL)\b isKindOfClass:\b0 (Class)\i aClass\i0     Returns YES if the receiver is an instance of \i aClass\i0  or an instance of any class that inherits from \i aClass\i0 . Otherwise, it returns NO.\
  82. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (BOOL)\b isMemberOfClass:\b0 (Class)\i aClass\i0     Returns YES if the receiver is an instance of \i aClass\i0 . Otherwise, it returns NO.\
  83. \fi-6552 \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  84. \
  85. \
  86. \fs28 Testing for Protocol Conformance\
  87. \fs16 \
  88. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (BOOL)\b conformsToProtocol:\b0 (Protocol *)\i aProtocol\i0     \
  89. \fi-6552 \s10 \fi-5796     Returns YES if the class of the receiver conforms to \i aProtocol\i0 , and NO if it doesn\'27t.\
  90. \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  91. \
  92. \
  93. \fs28 Testing Class Functionality\
  94. \fs16 \
  95. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (BOOL)\b respondsToSelector:\b0 (SEL)\i aSelector\i0     Returns YES if the receiver implements or inherits a method that can respond to \i aSelector\i0  messages, and NO if it doesn\'27t.\
  96. \fi-6552 \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  97. \
  98. \
  99. \fs28 Managing Reference Counts\
  100. \fs16 \
  101. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (id)\b autorelease\b0     As defined in the NSObject class, decrements the receiver\'27s reference count. When the count reaches 0, adds the object to  the current autorelease pool. Returns \b self\b0 . Objects in the pool are released later, typically at the top of the event loop.\
  102. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (oneway void)\b release\b0     As defined in the NSObject class, decrements the receiver\'27s reference count. When the count reaches 0, the object is automatically deallocated immediately. \
  103. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (id)\b retain\b0     As defined in the NSObject class, \b retain\b0  increments the receiver\'27s reference count. You send an object a \b retain\b0  message when you want to prevent it from being deallocated without your express permission. Returns self.\
  104. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (unsigned)\b retainCount\b0     Returns the receiver\'27s reference count for debugging purposes.\
  105. \fi-6552 \pard \s16 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  106. \
  107. \
  108. \fs28 Describing the Object\
  109. \fs16 \
  110. \fs28 \pard \s9 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSString *)\b description\b0     Returns a human readable description of the receiver.\
  111. \fi-6552 \pard \s2 \li100 \fi0 \ri1007 \ql \tx478 \tx856 \tx1234 \fs28 \fs16 \
  112. \
  113. \fs28 \
  114. \fs16 \
  115. \
  116. \fs28 \fs16 \fs28 \
  117. \fs16 \
  118. \
  119. \fs28 \fs16 \fs28 \
  120. \fs16 \
  121. \
  122. \fs28 }
  123.