![]() System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /proc/self/root/usr/share/doc/gnustep-base-doc/Base/Reference/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>NSPointerArray class documentation</title> </head> <body> <font face="serif"> <a href="Base.html">Up</a> <br /> <h1><a name="title$NSPointerArray">NSPointerArray class documentation</a></h1> <h3>Authors</h3> <dl> <dt>Richard Frith-Macdonald (<a href="mailto:rfm@gnu.org"><code>rfm@gnu.org</code></a>)</dt> <dd> </dd> </dl> <p><b>Copyright:</b> (C) 2009 Free Software Foundation, Inc.</p> <div> <hr width="50%" align="left" /> <h3>Contents -</h3> <ol> <li> <a href="#001000000000">Software documentation for the NSPointerArray class</a> </li> <li> <a href="#002000000000">Software documentation for the NSPointerArray(NSArrayConveniences) category</a> </li> </ol> <hr width="50%" align="left" /> </div> <h1><a name="001000000000"> Software documentation for the NSPointerArray class </a></h1> <h2><a name="class$NSPointerArray">NSPointerArray</a> : <a rel="gsdoc" href="NSObject.html#class$NSObject">NSObject</a></h2> <blockquote class="declared"> <dl> <dt><b>Declared in:</b></dt> <dd>Foundation/NSPointerArray.h</dd> </dl> </blockquote> <blockquote> <dl> <dt><b>Conforms to:</b></dt> <dd><a rel="gsdoc" href="NSObject.html#protocol$(NSCopying)">NSCopying</a></dd> <dd><a rel="gsdoc" href="NSObject.html#protocol$(NSCoding)">NSCoding</a></dd> </dl> </blockquote> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> An NSPointerArray acts like a standard mutable array except that it can contain <code>nil</code> and even non-object values. <br /> The count can also be set causing the array to shrink (discarding items) or grow (adding nil/zero items). </div> <b>Method summary</b> <ul> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray(NSArrayConveniences)+pointerArrayWithStrongObjects">+pointerArrayWithStrongObjects</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray(NSArrayConveniences)+pointerArrayWithWeakObjects">+pointerArrayWithWeakObjects</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray(NSArrayConveniences)-allObjects">-allObjects</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray+pointerArrayWithOptions$">+pointerArrayWithOptions:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray+pointerArrayWithPointerFunctions$">+pointerArrayWithPointerFunctions:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray+strongObjectsPointerArray">+strongObjectsPointerArray</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray+weakObjectsPointerArray">+weakObjectsPointerArray</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-addPointer$">-addPointer:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-compact">-compact</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-count">-count</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-initWithOptions$">-initWithOptions:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-initWithPointerFunctions$">-initWithPointerFunctions:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-insertPointer$atIndex$">-insertPointer:atIndex:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-pointerAtIndex$">-pointerAtIndex:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-pointerFunctions">-pointerFunctions</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-removePointerAtIndex$">-removePointerAtIndex:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-replacePointerAtIndex$withPointer$">-replacePointerAtIndex:withPointer:</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray-setCount$">-setCount:</a></li> </ul> <hr width="50%" align="left" /> <div class="method"> <h3><a name="method$NSPointerArray+pointerArrayWithOptions$">pointerArrayWithOptions: </a></h3> + (id) <b>pointerArrayWithOptions:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSPointerFunctionsOptions">NSPointerFunctionsOptions</a>)options;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Allocate an instance, initialise using initWithOptions: and return it autoreleased. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray+pointerArrayWithPointerFunctions$">pointerArrayWithPointerFunctions: </a></h3> + (id) <b>pointerArrayWithPointerFunctions:</b> (<a rel="gsdoc" href="NSPointerFunctions.html#class$NSPointerFunctions">NSPointerFunctions</a>*)functions;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Allocate an instance, initialise using initWithPointerFunctions: and return it autoreleased. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray+strongObjectsPointerArray">strongObjectsPointerArray </a></h3> + (id) <b>strongObjectsPointerArray</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Returns a new pointer array for storing strong (retained) references to objects. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray+weakObjectsPointerArray">weakObjectsPointerArray </a></h3> + (id) <b>weakObjectsPointerArray</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Returns a new pointer array for storing zeroing weak references to objects. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-addPointer$">addPointer: </a></h3> - (void) <b>addPointer:</b> (void*)pointer;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Adds an item at the end of the array. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-compact">compact </a></h3> - (void) <b>compact</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Removes all nil/zero items from the array. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-count">count </a></h3> - (<a rel="gsdoc" href="TypesAndConstants.html#type$NSUInteger">NSUInteger</a>) <b>count</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Returns the number of items in the array. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-initWithOptions$">initWithOptions: </a></h3> - (id) <b>initWithOptions:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSPointerFunctionsOptions">NSPointerFunctionsOptions</a>)options;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Initialises the receiver with the specified <var>options</var>. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-initWithPointerFunctions$">initWithPointerFunctions: </a></h3> - (id) <b>initWithPointerFunctions:</b> (<a rel="gsdoc" href="NSPointerFunctions.html#class$NSPointerFunctions">NSPointerFunctions</a>*)functions;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Initialises the receiver using the supplied object. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-insertPointer$atIndex$">insertPointer: atIndex: </a></h3> - (void) <b>insertPointer:</b> (void*)pointer<b> atIndex:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSUInteger">NSUInteger</a>)index;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Inserts an item at the specified <var>index</var> causing all higher indexed items to be adjusted upwards. <br /> WARNING... the Apple documented (and implemented in MacOS-X 10.5) behavior is to raise an exception if <var>index</var> is the same as the count of items in the array. This is insane... for arrays, data and strings you can insert at the end of an object to append to it, so the behavior of this class in MacOS is inconsistent and must be considered buggy. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-pointerAtIndex$">pointerAtIndex: </a></h3> - (void*) <b>pointerAtIndex:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSUInteger">NSUInteger</a>)index;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Returns the item at the given <var>index</var> or raises an exception if <var>index</var> is out of range. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-pointerFunctions">pointerFunctions </a></h3> - (<a rel="gsdoc" href="NSPointerFunctions.html#class$NSPointerFunctions">NSPointerFunctions</a>*) <b>pointerFunctions</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Returns an autorelease NSPointerFunctions instance giving the functions in use by the receiver. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-removePointerAtIndex$">removePointerAtIndex: </a></h3> - (void) <b>removePointerAtIndex:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSUInteger">NSUInteger</a>)index;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Removes the item at the specified <var>index</var>, adjusting the positions of all higher indexed items. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-replacePointerAtIndex$withPointer$">replacePointerAtIndex: withPointer: </a></h3> - (void) <b>replacePointerAtIndex:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSUInteger">NSUInteger</a>)index<b> withPointer:</b> (void*)item;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> <em>Description forthcoming.</em> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray-setCount$">setCount: </a></h3> - (void) <b>setCount:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSUInteger">NSUInteger</a>)count;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Sets the number of items in the receiver. Adds nil/zero items to pad the end of the array, or removes extraneous items from the end. </div> <hr width="25%" align="left" /> </div> <h1><a name="002000000000"> Software documentation for the NSPointerArray(NSArrayConveniences) category </a></h1> <h2><a rel="gsdoc" href="#class$NSPointerArray">NSPointerArray</a>(<a name="category$NSPointerArray(NSArrayConveniences)">NSArrayConveniences</a>)</h2> <blockquote class="declared"> <dl> <dt><b>Declared in:</b></dt> <dd>Foundation/NSPointerArray.h</dd> </dl> </blockquote> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> <em>Description forthcoming.</em> </div> <b>Method summary</b> <ul> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray(NSArrayConveniences)+pointerArrayWithStrongObjects">+pointerArrayWithStrongObjects</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray(NSArrayConveniences)+pointerArrayWithWeakObjects">+pointerArrayWithWeakObjects</a></li> <li><a rel="gsdoc" href="NSPointerArray.html#method$NSPointerArray(NSArrayConveniences)-allObjects">-allObjects</a></li> </ul> <hr width="50%" align="left" /> <div class="method"> <h3><a name="method$NSPointerArray(NSArrayConveniences)+pointerArrayWithStrongObjects">pointerArrayWithStrongObjects </a></h3> + (id) <b>pointerArrayWithStrongObjects</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Creates an instance configured to hold objects and prevent them from being garbage collected. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray(NSArrayConveniences)+pointerArrayWithWeakObjects">pointerArrayWithWeakObjects </a></h3> + (id) <b>pointerArrayWithWeakObjects</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Creates an instance configured to hold objects, allowing them to be garbage collected and replaced by <code>nil</code> if/when they are collected. </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSPointerArray(NSArrayConveniences)-allObjects">allObjects </a></h3> - (<a rel="gsdoc" href="NSArray.html#class$NSArray">NSArray</a>*) <b>allObjects</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.5.0</div> <br /> <div class="desc"> Returns an array containing all the non-nil objects from the receiver. </div> <hr width="25%" align="left" /> </div> <br /> <a href="Base.html">Up</a> </font> </body> </html>