{\rtf1\ansi{\fonttbl\f0\fnil Times-Roman;\f1\fswiss Helvetica;\f2\fmodern Courier;}\paperw12000\paperh8000\margl40\margr40
\pard\f0\fs24\cf0 Portable Object Compiler (c) 1997,98,99,03.  All Rights Reserved.\fs16\
\
\
\
\
\
\
\f1\b\fs56\li2200 RunArray\f0\b0\fs16\
\
\
\
\
\
\f0\fs28\li2200 {\b {\f1 Inherits from:}} Cltn\fs16\
\
\f0\fs28\li2200 {\b {\f1 Maturity Index:}} Experimental\fs16\
\
\fs16\
\
\f1\b\fs36\li1400 Class Description\b0\f0\fs16\
\
\f0\fs28\li2200 This class is used by the {\b Text} class, to associate lists of {\b TextAttribute} instances, to segments of characters in a string (slices of text with the same formatting properties, called {\i runs}).\fs16\
\
\fs16\
\
\f1\b\fs36\li1400 Accessing\b0\f0\fs16\
\
\f0\fs28\li2200 A {\b RunArray} is {\i not} indexed by segment number.\fs16\
\
\f0\fs28\li2200 Rather, it is indexed by character offsets : the message {\f2 at:} or {\f2 runLengthAt:} takes a character offset as argument, and translates this offset to a segment offset (the segment to which the character belongs) and returns the attributes or segment length, for that segment.\fs16\
\
\f0\fs28\li2200 The {\f2 size} of a {\b RunArray} is the largest character offset plus one;it is not the number of segments.\fs16\
\
\fs16\
\
\f1\b\fs36\li1400 Method types\b0\f0\fs16\
\
\pard\tx2600\fs28\li2600\cf0
{\b Creation}
\pard\tx6000\fs28\fi-3800\li6000\cf0
	- new\
	- free\
\pard\fs16\
\
\pard\tx2600\fs28\li2600\cf0
{\b Accessing}
\pard\tx6000\fs28\fi-3800\li6000\cf0
	- values\
	- runs\
	- at:\
	- runLengthAt:\
	- size\
	- addAttribute:from:size:\
	- at:insert:count:\
	- deleteFrom:to:\
	- concat:\
	- coalesce\
\pard\fs16\
\
\pard\tx2600\fs28\li2600\cf0
{\b Printing}
\pard\tx6000\fs28\fi-3800\li6000\cf0
	- printOn:\
\pard\fs16\
\
\fs16\
\
\f1\b\fs36\li1400 Methods\b0\f0\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 new\f0\b0\
\f0\fs28\li2500 +{\b new}\fs16\
\
\f0\fs28\li2200 Creates an empty RunArray collection.\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 free\f0\b0\
\f0\fs28\li2500 -{\b free}\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 values\f0\b0\
\f0\fs28\li2500 -{\b values}\fs16\
\
\f0\fs28\li2200 Returns a collection of OrdCltn instances (each element being a list of {\b TextAttribute} instances).\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 runs\f0\b0\
\f0\fs28\li2500 -{\b runs}\fs16\
\
\f0\fs28\li2200 Returns the run array (array of {\i int}).\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 at:\f0\b0\
\f0\fs28\li2500 -{\b at}:(unsigned){\i i}\fs16\
\
\f0\fs28\li2200 Returns a collection of TextAttributes for the {\i i}-th character.\fs16\
\
\f0\fs28\li2200 This method translates a character offset into a segment number.  The segment number is cached so that a subsequent call to {\f2 at:} or {\f2 runLengthAt:} doesn't have to recompute it.\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 runLengthAt:\f0\b0\
\f0\fs28\li2500 - (unsigned){\b runLengthAt}:(unsigned){\i i}\fs16\
\
\f0\fs28\li2200 Returns the number of remaining characters in the string segment to which the character at position {\i i} belongs.  If {\i i} is the first character of a run, this method returns the size of the run.  Otherwise it returns the size minus the index of character in the run.\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 size\f0\b0\
\f0\fs28\li2500 - (unsigned){\b size}\fs16\
\
\f0\fs28\li2200 Returns the size of the RunArray, which is the same as the size of the String instance for this RunArray object.\fs16\
\
\f0\fs28\li2200 The number of runs can be obtained by sending a {\f2 size} message to the object returned by {\f2 values}.\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 addAttribute:from:size:\f0\b0\
\f0\fs28\li2500 -{\b addAttribute}:{\i attrib}{\b from}:(unsigned){\i p}{\b size}:(unsigned){\i s}\fs16\
\
\f0\fs28\li2200 Adds {\i attrib} to the attribute lists for the {\i s} characters from position {\i p}.\fs16\
\
\f0\fs28\li2200 {\b {\f1 Note:}} This method is optimized for adding at the end of the RunArray.\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 at:insert:count:\f0\b0\
\f0\fs28\li2500 -{\b at}:(unsigned){\i anOffset}{\b insert}:(char*){\i aString}{\b count}:(int){\i n}\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 deleteFrom:to:\f0\b0\
\f0\fs28\li2500 -{\b deleteFrom}:(unsigned){\i p}{\b to}:(unsigned){\i q}\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 concat:\f0\b0\
\f0\fs28\li2500 -{\b concat}:{\i b}\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 coalesce\f0\b0\
\f0\fs28\li2500 -{\b coalesce}\fs16\
\
\f0\fs28\li2200 Merges adjacent lists of TextAttribute instances, by testing whether they are equal (in the sense of {\b TextAttribute}'s {\f2 isEqual} method).\fs16\
\
\fs16\
\
\f1\b\fs28\li2200 printOn:\f0\b0\
\f0\fs28\li2500 -{\b printOn}:(IOD){\i aFile}\fs16\
\
\f0\fs28\li2200 Prints the RunArray values.\fs16\
\
\fs16\
\
\
}