SCStrings.h

Go to the documentation of this file.

//
//  SCStrings.h
//  scl
//
//  Created by Viacheslav Smolensky on 05.02.13.
//  Copyright (c) 2007 - 2017 by Samond Development Corporation. All rights reserved.
//

#import <scl/SCObject.h>
#import <scl/SCArray.h>
#import <scl/SCTextDelegateProtocol.h>

#pragma mark -
#pragma mark Константы класса

#define SCStringsClass  @"SCStrings"    


@interface SCStrings : SCObject {
    SCArray             *fStrings;          // Внутреннее представление списка строк
    BOOL                 fModified;         // Флаг наличия несохраненных изменений
    BOOL                 fCaseInsensitive;  // Флаг учета регистра букв
    id<SCTextDelegate>   fDelegate;         // Обработчик событий
}

#pragma mark -
#pragma mark Свойства экземпляра класса

@property (nonatomic, retain, getter=name, setter=setName:) NSString *name;

@property (nonatomic, assign, getter=readOnly, setter=setReadOnly:) BOOL readOnly;

@property (nonatomic, assign, getter=caseInsensitive, setter=setCaseInsensitive:) BOOL caseInsensitive;

@property (nonatomic, retain, getter=delegate, setter=setDelegate:) id<SCTextDelegate> delegate;

@property (nonatomic, assign, readonly, getter=count) SCULong count;

@property (nonatomic, assign, readonly, getter=empty) BOOL empty;

@property (nonatomic, retain, readonly, getter=description) NSString *description;

@property (nonatomic, assign, readonly, getter=modified) BOOL modified;

@property (nonatomic, retain, readonly, getter=stringEnumerator) NSEnumerator *stringEnumerator;

@property (nonatomic, retain, readonly, getter=reverseStringEnumerator) NSEnumerator *reverseStringEnumerator;

@property (nonatomic, retain, readonly, getter=array) SCArray *array;

@property (nonatomic, retain, readonly, getter=foundationArray) NSArray *foundationArray;

@property (nonatomic, retain, readonly, getter=sortedStrings) SCStrings *sortedStrings;

@property (nonatomic, retain, readonly, getter=reversedStrings) SCStrings *reversedStrings;

@property (nonatomic, retain, readonly, getter=firstString) NSString *firstString;

@property (nonatomic, retain, readonly, getter=lastString) NSString *lastString;

@property (nonatomic, assign, readonly, getter=indexOfLastString) SCIndex indexOfLastString;

#pragma mark -
#pragma mark Свойства экземпляра класса
- (NSString *)name;
- (BOOL)readOnly;
- (BOOL)caseInsensitive;
- (id<SCTextDelegate>)delegate;
- (SCULong)count;
- (BOOL)empty;
- (NSString *)description;
- (BOOL)modified;

- (void)setName:(NSString *)name;
- (void)setReadOnly:(BOOL)readOnly;
- (void)setCaseInsensitive:(BOOL)caseInsensitive;
- (void)setDelegate:(id<SCTextDelegate>)delegate;

#pragma mark -
#pragma mark Создание списков строк
+ (SCStrings *)stringsWithCoder:(NSCoder *)coder;
+ (SCStrings *)stringsWithContentsOfSerializedFile:(NSString *)path;
+ (SCStrings *)stringsWithDataDictionary:(NSDictionary *)dictionary;
+ (SCStrings *)stringsWithDataDictionaryFromFile:(NSString *)path;
+ (SCStrings *)stringsWithStream:(SCStream *)stream;
+ (SCStrings *)stringsWithFileStream:(NSString *)path;

+ (SCStrings *)stringsWithName:(NSString *)name;
+ (SCStrings *)stringsWithString:(NSString *)string;
+ (SCStrings *)stringsWithCollection:(id)collection;
+ (SCStrings *)stringsWithStrings:(SCStrings *)strings;
+ (SCStrings *)strings;

#pragma mark -
#pragma mark Инициализация списков строк
- (id)initWithName:(NSString *)name;
- (id)initWithString:(NSString *)string;
- (id)initWithCollection:(id)collection;
- (id)initWithStrings:(SCStrings *)strings;
- (id)init;

#pragma mark -
#pragma mark Копирование списков строк
- (void)setStrings:(SCStrings *)strings;
- (void)setCollection:(id)collection;
- (void)setString:(NSString *)string;

#pragma mark -
#pragma mark Сравнение списков строк
- (BOOL)isEqualToStrings:(SCStrings *)strings;
- (BOOL)isEqualToCollection:(id)collection;
- (BOOL)isEqualTo:(id)object;
- (BOOL)isEqual:(id)object;

#pragma mark -
#pragma mark Счетчики строк
- (NSEnumerator *)stringEnumerator;
- (NSEnumerator *)reverseStringEnumerator;
- (void)enumerateWithDelegate:(id<SCTextDelegate>)delegate;
- (void)enumerate;
- (void)reverseEnumerateWithDelegate:(id<SCTextDelegate>)delegate;
- (void)reverseEnumerate;

#pragma mark -
#pragma mark Преобразование списков строк
- (SCArray *)array;
- (NSArray *)foundationArray;

#pragma mark -
#pragma mark Сортировка списков строк
- (void)sortAscendingWithSorter:(id<SCSorter>)sorter;
- (void)sortDescendingWithSorter:(id<SCSorter>)sorter;
- (void)sortWithSorter:(id<SCSorter>)sorter;
- (void)sortAscending;
- (void)sortDescending;
- (void)sort;
- (SCStrings *)ascendingSortedStringsWithSorter:(id<SCSorter>)sorter;
- (SCStrings *)descendingSortedStringsWithSorter:(id<SCSorter>)sorter;
- (SCStrings *)sortedStringsWithSorter:(id<SCSorter>)sorter;
- (SCStrings *)ascendingSortedStrings;
- (SCStrings *)descendingSortedStrings;
- (SCStrings *)sortedStrings;

#pragma mark -
#pragma mark Добавление строк
- (void)addString:(NSString *)string;
- (void)addCollection:(id)collection;
- (void)addStrings:(SCStrings *)strings;
- (void)addLine;

- (void)insertString:(NSString *)string atIndex:(SCIndex)index;
- (void)insertStrings:(SCStrings *)strings atIndex:(SCIndex)index;
- (void)insertCollection:(id)collection atIndex:(SCIndex)index;
- (void)insertStrings:(SCStrings *)strings atIndexes:(NSIndexSet *)indexes;
- (void)insertCollection:(id)collection atIndexes:(NSIndexSet *)indexes;
- (void)insertLineAtIndex:(SCIndex)index;

#pragma mark -
#pragma mark Удаление строк
- (void)removeAllStrings;
- (void)removeFirstString;
- (void)removeLastString;
- (void)removeStringAtIndex:(SCIndex)index;
- (void)removeStringsAtIndexes:(NSIndexSet *)indexes;
- (void)removeString:(NSString *)string;
- (void)removeStrings:(SCStrings *)strings;
- (void)removeCollection:(id)collection;
- (void)removeStringsWithSubstring:(NSString *)substring;
- (void)removeStringsNotAtIndexes:(NSIndexSet *)indexes;
- (void)removeStringsNotEqualTo:(NSString *)string;
- (void)removeStringsNotInStrings:(SCStrings *)strings;
- (void)removeStringsNotInCollection:(id)collection;
- (void)removeStringsWithoutSubstring:(NSString *)substring;
- (void)removeDuplicatedStrings;

#pragma mark -
#pragma mark Замена строк
- (void)replaceStringAtIndex:(SCIndex)index withString:(NSString *)string;
- (void)replaceStringsAtIndexes:(NSIndexSet *)indexes withStrings:(SCStrings *)strings;
- (void)replaceStringsAtIndexes:(NSIndexSet *)indexes withCollection:(id)collection;
- (void)replaceString:(NSString *)string withString:(NSString *)newString;

#pragma mark -
#pragma mark Копирование и перемещение строк
- (void)exchangeStringAtIndex:(SCIndex)index withStringAtIndex:(SCIndex)destination;
- (void)duplicateStringAtIndex:(SCIndex)index;
- (void)duplicateAllStrings;
- (void)duplicate;
- (void)copyStringAtIndex:(SCIndex)index toIndex:(SCIndex)destination;
- (void)moveStringAtIndex:(SCIndex)index toIndex:(SCIndex)destination;
- (void)forwardMoveStringAtIndex:(SCIndex)index steps:(SCULong)steps;
- (void)forwardMoveStringAtIndex:(SCIndex)index;
- (void)backwardMoveStringAtIndex:(SCIndex)index steps:(SCULong)steps;
- (void)backwardMoveStringAtIndex:(SCIndex)index;
- (void)moveToFirstPositionStringAtIndex:(SCIndex)index;
- (void)moveToLastPositionStringAtIndex:(SCIndex)index;
- (void)reverse;
- (SCStrings *)reversedStrings;

#pragma mark -
#pragma mark Доступ к строкам
- (NSString *)firstString;
- (NSString *)lastString;
- (NSString *)stringAtIndex:(SCIndex)index;
- (SCStrings *)stringsAtIndexes:(NSIndexSet *)indexes;

#pragma mark -
#pragma mark Поиск строк
- (BOOL)containsString:(NSString *)string;
- (BOOL)containsStrings:(SCStrings *)strings;
- (BOOL)containsCollection:(id)collection;
- (BOOL)containsAnyString:(SCStrings *)strings;
- (BOOL)containsAnyStringFromCollection:(id)collection;
- (BOOL)containsSubstring:(NSString *)substring;
- (BOOL)containsSubstrings:(SCStrings *)substrings;
- (BOOL)containsSubstringsFromCollection:(id)collection;
- (BOOL)containsAnySubstring:(SCStrings *)substrings;
- (BOOL)containsAnySubstringFromCollection:(id)collection;
- (BOOL)containsDuplicatedStrings;

- (SCIndex)indexOfString:(NSString *)string;
- (SCIndex)indexOfLastString;
- (SCIndex)indexOfSubstring:(NSString *)substring;

- (SCStrings *)stringsWithSubstring:(NSString *)substring;
- (SCStrings *)stringsWithSubstrings:(SCStrings *)substrings;
- (SCStrings *)stringsWithSubstringsFromCollection:(id)collection;
- (SCStrings *)stringsWithAnySubstring:(SCStrings *)substrings;
- (SCStrings *)stringsWithAnySubstringFromCollection:(id)collection;
- (SCStrings *)stringsWithoutSubstring:(NSString *)substring;
- (SCStrings *)stringsWithoutSubstrings:(SCStrings *)substrings;
- (SCStrings *)stringsWithoutSubstringsFromCollection:(id)collection;

- (SCULong)countOfString:(NSString *)string;
- (SCULong)countOfSubstring:(NSString *)substring;
- (SCULong)countOfStringsWithSubstring:(NSString *)substring;

@end