"

 COPYRIGHT (c) 1989 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libbasic' }"

"{ NameSpace: Smalltalk }"

OrderedCollection subclass:#StringCollection

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	category:'Collections-Text'

!

!StringCollection class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1989 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    StringCollection is a variable sized array of lines which are strings.

    WARNING:

        This class is temporary (a historic leftover) - it may change or

        even vanish in the future. Use OrderedCollections or other standard

        classes to represent collections of strings.

    StringCollection used to be called Text, but this is a very bad name

     - there is something totally different also named Text in ST-80 ...

    [author:]

        Claus Gittinger

"

! !

!StringCollection class methodsFor:'instance creation'!

from:aString

    <resource: #obsolete>

    "return a new text object with lines taken from the argument, aString"

    self obsoleteMethodWarning:'use #fromString:'.

    ^ self fromString:aString.

!

fromArray:anArray

    "return a new text object with lines taken from the argument, an array

     of strings"

    |newStringCollection

     size "{ Class: SmallInteger }" |

    size := anArray size.

    newStringCollection := self new:size.

    1 to:size do:[:line |

	newStringCollection at:line put:(anArray at:line)

    ].

    ^ newStringCollection

!

fromString:aString

    "return a new text object with lines taken from the argument, aString"

    ^ (self new:1) fromString:aString

    "Modified: / 25-07-2012 / 18:52:47 / cg"

!

new:size

    "return a new string collection with size empty lines"

    ^ (super new:size) grow:size

    "   

     StringCollection new:10

    "

!

newWithCapacity:size

    "return a new empty string collection with size capacity"

    ^ super new:size.

    "   

     StringCollection newWithCapacity:10

    "

    "Created: / 21-09-2017 / 15:37:49 / stefan"

!

newWithSize:size

    "return a new string collection with size empty lines"

    ^ self new:size "/ already does what we want

! !

!StringCollection methodsFor:'converting'!

asString

    "return myself as a string with embedded cr's"

    ^ [

        self 

            asStringWith:Character cr

            from:1 to:(self size) 

            compressTabs:false 

            final:Character cr

    ] on:ConversionError do:[:ex|

        "non-string elements trigger a ComversionError. Fall back..."

        super printString.

    ].

    "

        #('This' 'is' 'some' 'text') asStringCollection asString

        #('This' 22 'some' 'text') asStringCollection asString

    "

    "Modified (format): / 21-09-2017 / 12:52:00 / stefan"

!

asStringCollection

    "return the receiver as a stringCollection - that's easy"

    ^ self

    "Modified (comment): / 25-07-2012 / 18:11:14 / cg"

!

asStringWithoutEmphasis

    "return myself as a string with embedded cr's, but drop any emphasis"

    ^ self 

        asStringWith:Character cr

        from:1 to:(self size) 

        compressTabs:false 

        final:Character cr

        withEmphasis:false

    "Created: / 17.6.1998 / 12:32:48 / cg"

!

asStringWithoutFinalCR

    "return myself as a string with embedded cr's

     but do not add a final CR"

    ^ self 

        asStringWith:Character cr

        from:1 to:(self size) 

        compressTabs:false 

        final:nil

!

encodeFrom:oldEncoding into:newEncoding

    "encode each line"

    |enc|

    enc := CharacterEncoder encoderToEncodeFrom:oldEncoding into:newEncoding.

    ^ self 

        collect:[:line |

            line isNil 

                ifTrue:[ nil ]

                ifFalse:[ enc encodeString:line]

        ]

    "Modified (comment): / 25-07-2012 / 18:09:40 / cg"

!

from:aString

    "setup my contents from the argument, aString"

    <resource: #obsolete>

    self obsoleteMethodWarning:'use #fromString:'.

    ^ self fromString:aString

    "Modified (format): / 25-07-2012 / 18:02:34 / cg"

!

fromString:aString

    "setup my contents from the argument, aString.

     AString should be delimited by newline characters"

    |numberOfLines "{ Class:SmallInteger }"

     start         "{ Class:SmallInteger }"

     stop          "{ Class:SmallInteger }"

     delimiter

    |

    aString isEmpty ifTrue:[self grow:0. ^ self ].

    delimiter := Character cr.

    numberOfLines := aString occurrencesOf:delimiter.

    numberOfLines == 0 ifTrue:[

        "/ check if it's a return-delimited string

        numberOfLines := aString occurrencesOf:(Character return).

        numberOfLines > 0 ifTrue:[

            delimiter := Character return.

        ].

    ].

    aString last == delimiter ifFalse:[

        numberOfLines := numberOfLines + 1.

    ].

    self grow:numberOfLines.

    start := 1.

    1 to:numberOfLines do:[:lineNr |

        stop := aString indexOf:delimiter startingAt:start.

        stop == 0 ifTrue:[

            self at:lineNr put:(aString copyFrom:start).

            self from:lineNr+1 to:numberOfLines put:''.

            ^ self

        ].

        self at:lineNr put:(aString copyFrom:start to:stop-1).

        start := stop + 1

    ]

    "Modified: / 25-07-2012 / 18:52:58 / cg"

    "Modified (format): / 13-02-2017 / 20:31:40 / cg"

    "Modified (format): / 14-11-2017 / 16:26:27 / mawalch"

! !

!StringCollection methodsFor:'copying'!

copyEmpty:size

    "we have to redefine this, since 'self class new:size' 

     does allocate size nil lines (it does an implicit #grow: size).

     In order to get #collect: working, we should not perform this implicit grow"

    ^ self class newWithCapacity:size.

    "Created: / 14-02-1996 / 11:05:47 / stefan"

    "Modified: / 21-09-2017 / 15:43:49 / stefan"

!

copyEmptyAndGrow:size

    "performance optimization: 

     StringCollections are always grown to size after #new: (containing nil elements)"

    ^ self species new:size.

    "

        #('some' 'text' 'bla') asStringCollection copyEmptyAndGrow:20

    "

    "Modified: / 21-09-2017 / 15:46:18 / stefan"

!

withoutLeadingAndTrailingBlankLines

    "return a copy of the receiver with leading and trailing blank lines removed.

     If there are no trailing blank lines, the original receiver is returned.

     If all lines are blank, an empty string collection is returned."

    ^ self withoutLeadingBlankLines withoutTrailingBlankLines.

    "

'1

2

3' asStringCollection withoutLeadingAndTrailingBlankLines      

    "

    "

'

2

3

' asStringCollection withoutLeadingAndTrailingBlankLines       

    "

!

withoutLeadingBlankLines

    "return a copy of the receiver with leading blank lines removed.

     If there are no leading blank lines, the original receiver is returned.

     If all lines are blank, an empty string collection is returned."

    |indexOfFirstNonBlankLine|

    indexOfFirstNonBlankLine := self findFirst:[:line | line notEmptyOrNil and:[line isBlank not]].

    indexOfFirstNonBlankLine == 0 ifTrue:[ ^ self copyEmpty ].

    indexOfFirstNonBlankLine == 1 ifTrue:[ ^ self ].

    ^ self copyFrom:indexOfFirstNonBlankLine

    "

'1

2

3' asStringCollection withoutLeadingBlankLines     

    "

    "

'

2

3' asStringCollection withoutLeadingBlankLines       

    "

    "

'

' asStringCollection withoutLeadingBlankLines      

    "

!

withoutTrailingBlankLines

    "return a copy of the receiver with trailing blank lines removed.

     If there are no trailing blank lines, the original receiver is returned.

     If all lines are blank, an empty string collection is returned."

    |indexOfLastNonBlankLine|

    indexOfLastNonBlankLine := self findLast:[:line | line notEmptyOrNil and:[line isBlank not]].

    indexOfLastNonBlankLine == 0 ifTrue:[ ^ self copyEmpty ].

    indexOfLastNonBlankLine == self size ifTrue:[ ^ self ].

    ^ self copyTo:indexOfLastNonBlankLine

    "

'1

2

3' asStringCollection withoutTrailingBlankLines      

    "

    "

'

2

3

' asStringCollection withoutTrailingBlankLines       

    "

    "

'

2

3

' asStringCollection withoutTrailingBlankLines       

    "

    "

'

' asStringCollection withoutTrailingBlankLines      

    "

! !

!StringCollection methodsFor:'enumerating'!

collect:aBlock

    "evaluate the argument, aBlock for every element in the collection

     and return a collection of the results.

     Redefined, to change the result collection to an OrderedCollection if

     not all elements are valid for a StringCollection (must be string or nil)."

    |newCollection newElement onlyStrings

     start  "{ Class:SmallInteger }"

     stop   "{ Class:SmallInteger }" |

    onlyStrings := true.    "/ ... until proven otherwise         

    newCollection := self class newWithCapacity:(self size).

    stop := lastIndex.

    start := firstIndex.

    start to:stop do:[:index |

        newElement := aBlock value:(contentsArray at:index).

        (onlyStrings and:[newElement notNil and:[newElement isString not]]) ifTrue:[

            onlyStrings := false.

            newCollection := newCollection asOrderedCollection.

        ].

        newCollection add:newElement.

    ].

    ^ newCollection

    "

     #('this' 'is' 'some' nil 'text') asStringCollection collect:[:i | i]

     #('this' true 'some' nil 'text') asStringCollection collect:[:i | i ]

    "

    "Created: / 21-09-2017 / 14:31:31 / stefan"

    "Modified: / 21-09-2017 / 15:55:21 / stefan"

!

collect:collectBlock thenSelect:selectBlock

    "combination of collect followed by select;

     redefined to avoid the creation of an intermediate (garbage) collection.

     Redefined, to change the result collection to an OrderedCollection if

     not all elements are valid for a StringCollection (must be string or nil)."

    |newCollection newElement onlyStrings

     start  "{ Class:SmallInteger }"

     stop   "{ Class:SmallInteger }" |

    onlyStrings := true.    "/ ... until proven otherwise         

    newCollection := self class newWithCapacity:(self size).

    stop := lastIndex.

    start := firstIndex.

    start to:stop do:[:index |

        newElement := collectBlock value:(contentsArray at:index).

        (selectBlock value:newElement) ifTrue:[

            (onlyStrings and:[newElement notNil and:[newElement isString not]]) ifTrue:[

                onlyStrings := false.

                newCollection := newCollection asOrderedCollection.

            ].

            newCollection add:newElement.

        ]

    ].

    ^ newCollection

    "

     #('this' 'is' 'some' nil 'text') asStringCollection collect:[:i | i] thenSelect:[:e| e notNil]

     #('this' true 'some' nil 'text') asStringCollection collect:[:i | i ] thenSelect:[:e| e notNil]

    "

    "Created: / 21-09-2017 / 14:34:46 / stefan"

    "Modified: / 21-09-2017 / 15:55:05 / stefan"

!

select:selectBlock thenCollect:collectBlock

    "combination of select followed by collect;

     redefined to avoid the creation of an intermediate (garbage) collection.

     Redefined, to change the result collection to an OrderedCollection if

     not all elements are valid for a StringCollection (must be string or nil)."

    |newCollection element newElement onlyStrings

     start  "{ Class:SmallInteger }"

     stop   "{ Class:SmallInteger }" |

    onlyStrings := true.    "/ ... until proven otherwise         

    newCollection := self class newWithCapacity:(self size).

    stop := lastIndex.

    start := firstIndex.

    start to:stop do:[:index |

        element := contentsArray at:index.

        (selectBlock value:element) ifTrue:[

            newElement := collectBlock value:element.

            (onlyStrings and:[newElement notNil and:[newElement isString not]]) ifTrue:[

                onlyStrings := false.

                newCollection := newCollection asOrderedCollection.

            ].

            newCollection add:newElement.

        ]

    ].

    ^ newCollection

    "

     #('this' 'is' 'some' nil 'text') asStringCollection select:[:e| e notNil] thenCollect:[:i | i]

     #('this' true 'some' nil 'text') asStringCollection select:[:e| e notNil] thenCollect:[:i | i]

    "

    "Created: / 21-09-2017 / 14:42:20 / stefan"

    "Modified: / 21-09-2017 / 15:54:33 / stefan"

! !

!StringCollection methodsFor:'printing & storing'!

printOn:aStream

    "print myself on aStream with embedded cr's"

    self do:[:eachString|

        eachString printOn:aStream.

        aStream cr.

    ].

!

printString

    "return the receiver's printString"

    ^ self asString

! !