Skip to content

Instantly share code, notes, and snippets.

@bibhas

bibhas/Foundation+CoreCode.h

Created October 12, 2020 06:00
Show Gist options
  • Save bibhas/4faaa9fb6146756141011790f46aa33a to your computer and use it in GitHub Desktop.
Save bibhas/4faaa9fb6146756141011790f46aa33a to your computer and use it in GitHub Desktop.
Download ZIP
Raw
Foundation+CoreCode.h
//
// Foundation+CoreCode.h
// CoreLib
//
// Created by CoreCode on 15.03.12.
/* Copyright © 2020 CoreCode Limited
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitationthe rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
#include "CoreLib.h"
@interface NSArray <ObjectType> (CoreCode)
@property (readonly, nonatomic) NSArray *flattenedArray;
@property (readonly, nonatomic) NSArray <ObjectType> *reverseArray;
@property (readonly, nonatomic) NSMutableArray <ObjectType> *mutableObject;
@property (readonly, nonatomic) BOOL empty;
@property (readonly, nonatomic) NSData *XMLData;
@property (readonly, nonatomic) NSData *JSONData;
@property (readonly, nonatomic) NSString *string;
@property (readonly, nonatomic) NSString *path;
@property (readonly, nonatomic) NSArray <ObjectType> *sorted;
@property (readonly, nonatomic) NSString *literalString;
@property (readonly, nonatomic) NSDictionary *dictionary; // will yield a dictionary that has the array contents as keys and @(1) as objects
- (NSArray <ObjectType>*)arrayByAddingObjectSafely:(ObjectType)anObject; // add nil aint a prob
- (NSArray <ObjectType>*)arrayByAddingNewObject:(ObjectType)anObject; // adds the object only if it is not identical (contentwise) to existing entry
- (NSArray <ObjectType>*)arrayByDeletingObjectIdenticalTo:(ObjectType)anObject;
- (NSArray <ObjectType>*)arrayByDeletingObjectsIdenticalTo:(NSArray <ObjectType>*)objects;
- (NSArray <ObjectType>*)arrayByDeletingObjectAtIndex:(NSUInteger)index;
- (NSArray <ObjectType>*)arrayByDeletingObjectsAtIndexes:(NSIndexSet *)indexSet;
- (NSArray *)arrayByInsertingObject:(id)anObject atIndex:(NSUInteger)index;
- (NSArray <ObjectType>*)arrayByReplacingObject:(ObjectType)anObject withObject:(ObjectType)newObject;
- (ObjectType)slicingObjectAtIndex:(NSInteger)index;
- (ObjectType)safeObjectAtIndex:(NSUInteger)index;
- (BOOL)containsDictionaryWithKey:(NSString *)key equalTo:(NSString *)value;
- (NSArray <ObjectType>*)sortedArrayByKey:(NSString *)key;
- (NSArray <ObjectType>*)sortedArrayByKey:(NSString *)key insensitive:(BOOL)insensitive;
- (NSArray <ObjectType>*)sortedArrayByKey:(NSString *)key ascending:(BOOL)ascending;
- (BOOL)contains:(ObjectType)object; // shortcut = containsObject
- (BOOL)containsObjectIdenticalTo:(ObjectType)object; // similar: indexOfObjectIdenticalTo != NSNotFound
- (CCIntRange2D)calculateExtentsOfPoints:(CCIntPoint (^)(ObjectType input))block;
- (CCIntRange1D)calculateExtentsOfValues:(int (^)(ObjectType input))block;
- (NSArray <ObjectType>*)subarrayFromIndex:(NSUInteger)index; // containing the characters of the receiver from the one at anIndex to the end (DOES include index) similar to -[NSString subarrayFromIndex:]
- (NSArray <ObjectType>*)subarrayToIndex:(NSUInteger)index; // containing the characters of the receiver up to, but not including, the one at anIndex. (does NOT include index) similar to -[NSString substringToIndex:]
- (NSArray <ObjectType>*)slicingSubarrayToIndex:(NSInteger)index; // index should be negative and tell how many objects to remove from the end ... -1 removes one char from the end
- (NSArray <ObjectType>*)slicingSubarrayFromIndex:(NSInteger)index; // index should be negative and tell how many chars to include from the end .... -2 is just the last two items
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
- (NSString *)runAsTask;
- (NSString *)runAsTaskWithTerminationStatus:(NSInteger *)terminationStatus usePolling:(BOOL)usePollingToAvoidRunloop;
- (NSString *)runAsTaskWithProgressBlock:(StringInBlock)progressBlock;
- (NSString *)runAsTaskWithProgressBlock:(StringInBlock)progressBlock terminationStatus:(NSInteger *)terminationStatus;
#endif
- (NSArray *)mapped:(id (^)(ObjectType input))block;
- (NSArray <ObjectType>*)filtered:(BOOL (^)(ObjectType input))block;
- (NSArray <ObjectType>*)filteredUsingPredicateString:(NSString *)format, ... NS_FORMAT_FUNCTION(1,2);
- (NSInteger)reduce:(int (^)(ObjectType input))block;
// versions similar to cocoa methods
- (void)apply:(void (^)(ObjectType input))block; // similar = enumerateObjectsUsingBlock:
// forwards for less typing
- (NSString *)joined:(NSString *)sep; // shortcut = componentsJoinedByString:
@property (readonly, nonatomic) NSString *joinedWithSpaces;
@property (readonly, nonatomic) NSString *joinedWithNewlines;
@property (readonly, nonatomic) NSString *joinedWithDots;
@property (readonly, nonatomic) NSString *joinedWithCommas;
@property (readonly, nonatomic) NSSet <ObjectType> *set;
@property (readonly, nonatomic) NSOrderedSet <ObjectType> *orderedSet;
@property (readonly, nonatomic) ObjectType mostFrequentObject;
@property (readonly, nonatomic) ObjectType randomObject;
@property (readonly, nonatomic) NSRange fullRange;
@end
@interface NSMutableArray <ObjectType>(CoreCode)
@property (readonly, nonatomic) NSArray <ObjectType> *immutableObject;
- (void)addNewObject:(ObjectType)anObject;
- (void)addObjectSafely:(ObjectType)anObject;
- (void)map:(ObjectType (^)(ObjectType input))block;
- (void)filter:(int (^)(ObjectType input))block;
- (void)filterUsingPredicateString:(NSString *)format, ... NS_FORMAT_FUNCTION(1,2);
- (void)removeFirstObject;
- (void)moveObjectAtIndex:(NSUInteger)fromIndex toIndex:(NSUInteger)toIndex;
- (void)removeObjectPassingTest:(int (^)(ObjectType input))block;
@end
@interface NSPointerArray (CoreCode)
- (BOOL)containsPointer:(void *)aPointer;
- (NSInteger)getIndexOfPointer:(void *)aPointer;
- (void)forEach:(void (^)(void *))aCallback;
@end
@interface NSString (CoreCode)
// filesystem support
@property (readonly, nonatomic) NSArray <NSString *> *directoryContents;
@property (readonly, nonatomic) NSArray <NSString *> *directoryContentsRecursive;
@property (readonly, nonatomic) NSArray <NSString *> *directoryContentsAbsolute;
@property (readonly, nonatomic) NSArray <NSString *> *directoryContentsRecursiveAbsolute;
@property (readonly, nonatomic) NSString *uniqueFile;
@property (readonly, nonatomic) BOOL fileExists;
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
@property (readonly, nonatomic) BOOL fileIsRestricted;
@property (readonly, nonatomic) BOOL fileIsAlias;
@property (readonly, nonatomic) BOOL fileIsSymlink;
@property (readonly, nonatomic) NSString *fileAliasTarget;
#endif
@property (readonly, nonatomic) unsigned long long fileSize;
@property (readonly, nonatomic) unsigned long long directorySize;
@property (readonly, nonatomic) BOOL isWriteablePath;
@property (readonly, nonatomic) NSString *stringByResolvingSymlinksInPathFixed;
@property (readonly, nonatomic) NSRange fullRange;
@property (readonly, nonatomic) NSString *literalString;
// path string to url
@property (readonly, nonatomic) NSURL *fileURL;
@property (readonly, nonatomic) NSURL *URL;
// url string download
@property (readonly, nonatomic) NSData *download;
@property (readonly, nonatomic) NSString *downloadWithCurl;
// path string filedata
@property (unsafe_unretained, nonatomic) NSData *contents;
// NSUserDefaults support
@property (copy, nonatomic) id defaultObject;
@property (copy, nonatomic) NSString *defaultString;
@property (copy, nonatomic) NSArray *defaultArray;
@property (copy, nonatomic) NSDictionary *defaultDict;
@property (copy, nonatomic) NSURL *defaultURL;
@property (assign, nonatomic) NSInteger defaultInt;
@property (assign, nonatomic) float defaultFloat;
@property (readonly, nonatomic) NSString *localized;
// bundle contents to path
@property (readonly, nonatomic) NSString *resourcePath;
@property (readonly, nonatomic) NSURL *resourceURL;
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
@property (readonly, nonatomic) NSImage *namedImage;
#else
@property (readonly, nonatomic) UIImage *namedImage;
#endif
// string things
@property (readonly, nonatomic) NSArray <NSString *> *lines;
@property (readonly, nonatomic) NSArray <NSString *> *words;
@property (readonly, nonatomic) unichar firstCharacter;
@property (readonly, nonatomic) unichar lastCharacter;
@property (readonly, nonatomic) NSUInteger lengthFixed; // string length that doesn't fuck up for emoji
@property (readonly, nonatomic) NSString *expanded; // shortcut = stringByExpandingTildeInPath
@property (readonly, nonatomic) NSString *strippedOfNewlines; // deletes from interior of string too, in contrast to TRIMMING which deletes only from front and back ... shortcut for stringByDeletingCharactersInSet:newlineCharacterSet
@property (readonly, nonatomic) NSString *strippedOfWhitespace; // deletes from interior of string too, in contrast to TRIMMING which deletes only from front and back ... shortcut for stringByDeletingCharactersInSet:whitespaceCharacterSet
@property (readonly, nonatomic) NSString *strippedOfWhitespaceAndNewlines;
@property (readonly, nonatomic) NSString *trimmedOfWhitespace;
@property (readonly, nonatomic) NSString *trimmedOfWhitespaceAndNewlines;
@property (readonly, nonatomic) NSString *unescaped;
@property (readonly, nonatomic) NSString *escaped; // URL escaping
@property (readonly, nonatomic) NSString *encoded; // total encoding, wont work with OPEN anymore as it encodes everything except numbers and letters, useful for single CGI params
@property (readonly, nonatomic) NSString *escapedForXML; // just escapes <>'"& for HTML/XML contents
@property (readonly, nonatomic) NSMutableString *mutableObject;
@property (readonly, nonatomic) NSString *rot13;
#ifdef USE_SECURITY
@property (readonly, nonatomic) NSString *SHA1;
#endif
@property (readonly, nonatomic) NSString *language;
@property (readonly, nonatomic) NSString *titlecaseString;
@property (readonly, nonatomic) NSString *propercaseString;
@property (readonly, nonatomic) BOOL isIntegerNumber;
@property (readonly, nonatomic) BOOL isIntegerNumberOnly;
@property (readonly, nonatomic) BOOL isFloatNumber;
@property (readonly, nonatomic) BOOL isValidEmail;
@property (readonly, nonatomic) BOOL isValidEmails;
@property (readonly, nonatomic) BOOL isNumber;
@property (readonly, nonatomic) NSData *data; // data of string contents
@property (readonly, nonatomic) NSData *dataFromHexString;
@property (readonly, nonatomic) NSData *dataFromBase64String;
@property (readonly, nonatomic) NSCharacterSet *characterSet;
- (NSArray <NSArray <NSString *> *> *)parsedDSVWithDelimiter:(NSString *)delimiter;
- (NSString *)stringValue;
- (NSUInteger)count:(NSString *)str; // peviously called countOccurencesOfString
- (BOOL)contains:(NSString *)otherString insensitive:(BOOL)insensitive; // similar: rangeOfString options != NSNotFound
- (BOOL)contains:(NSString *)otherString; // similar: rangeOfString != NSNotFound
- (BOOL)hasAnyPrefix:(NSArray <NSString *>*)possiblePrefixes;
- (BOOL)hasAnySuffix:(NSArray <NSString *>*)possibleSuffixes;
- (BOOL)containsAny:(NSArray <NSString *>*)otherStrings;
- (BOOL)containsAny:(NSArray <NSString *>*)otherStrings insensitive:(BOOL)insensitive;
- (BOOL)containsAll:(NSArray <NSString *>*)otherStrings;
- (BOOL)equalsAny:(NSArray <NSString *>*)otherStrings;
- (NSString *)stringByReplacingMultipleStrings:(NSDictionary <NSString *, NSString *>*)replacements;
- (NSString *)clamp:(NSUInteger)maximumLength;
- (NSString *)clampByteLength:(NSUInteger)maximumLength; // normal clamp clamps to number of chars. however with multi-byte chars, the upper bound for the number of bytes in UTF8 is (maximumLength * 4)
- (NSString *)tail:(NSUInteger)maximumLength;
// split a string at a splitter - return part before or after splitter - two variants, return either full string or null in case the seperator doesn't occur
- (NSString *)splitBeforeFull:(NSString *)sep;
- (NSString *)splitAfterFull:(NSString *)sep;
- (NSString *)splitBeforeNull:(NSString *)sep;
- (NSString *)splitAfterNull:(NSString *)sep;
- (NSString *)between:(NSString *)sep1 and:(NSString *)sep2; // returns string part between 1 and 2, nil if not possible
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
- (NSAttributedString *)attributedStringWithColor:(NSColor *)color;
#endif
- (NSAttributedString *)attributedStringWithHyperlink:(NSURL *)url;
- (NSAttributedString *)attributedStringWithFont:(NSFont *)font;
- (NSString *)capitalizedStringWithUppercaseWords:(NSArray <NSString *> *)uppercaseWords;
- (NSString *)titlecaseStringWithLowercaseWords:(NSArray <NSString *> *)lowercaseWords andUppercaseWords:(NSArray <NSString *> *)uppercaseWords;
- (NSString *)stringByTrimmingLeadingCharactersInSet:(NSCharacterSet *)characterSet;
- (NSString *)stringByTrimmingTrailingCharactersInSet:(NSCharacterSet *)characterSet;
- (NSString *)stringByDeletingCharactersInSet:(NSCharacterSet *)characterSet;
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
- (CGSize)sizeUsingFont:(NSFont *)font maxWidth:(CGFloat)maxWidth;
// FSEvents directory observing
- (NSValue *)startObserving:(ObjectInBlock)block withFileLevelEvents:(BOOL)fileLevelEvents;
- (void)stopObserving:(NSValue *)token;
#endif
- (NSString *)removed:(NSString *)stringToRemove;
- (NSString *)slicingSubstringToIndex:(NSInteger)index; // index should be negative and tell how many chars to remove -1 removes one char from the end
// forwards for less typing
- (NSString *)replaced:(NSString *)str1 with:(NSString *)str2; // shortcut = stringByReplacingOccurencesOfString:withString:
- (NSArray <NSString *> *)split:(NSString *)sep; // shortcut = componentsSeparatedByString:
- (NSString *)appended:(NSString *)str; // shortcut = stringByAppendingString
@end
@interface NSMutableString (CoreCode)
@property (readonly, nonatomic) NSString *immutableObject;
@end
@interface NSURL (CoreCode)
+ (NSURL *)URLWithHost:(NSString *)host path:(NSString *)path query:(NSString *)query;
+ (NSURL *)URLWithHost:(NSString *)host path:(NSString *)path query:(NSString *)query user:(NSString *)user password:(NSString *)password fragment:(NSString *)fragment scheme:(NSString *)scheme port:(NSNumber *)port;
- (NSData *)performBlockingPOST:(double)timeoutSeconds;
- (NSData *)performBlockingGET:(double)timeoutSeconds;
- (void)performGET:(void (^)(NSData *data))completion;
- (void)performPOST:(void (^)(NSData *data))completion;
- (NSData *)readFileHeader:(NSUInteger)maximumByteCount;
- (NSURL *)add:(NSString *)component;
- (void)open;
@property (readonly, nonatomic) BOOL fileIsBundle;
@property (readonly, nonatomic) BOOL fileIsDirectory;
//@property (readonly, nonatomic) NSString *path;
@property (readonly, nonatomic) NSArray <NSURL *> *directoryContents;
@property (readonly, nonatomic) NSArray <NSURL *> *directoryContentsRecursive;
@property (readonly, nonatomic) NSURL *uniqueFile;
@property (readonly, nonatomic) BOOL fileExists;
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
@property (readonly, nonatomic) BOOL fileIsRestricted;
@property (readonly, nonatomic) BOOL fileIsAlias;
@property (readonly, nonatomic) BOOL fileIsRegularFile;
@property (readonly, nonatomic) BOOL fileIsSymlink;
@property (readonly, nonatomic) NSURL *fileAliasTarget;
#endif
@property (readonly, nonatomic) NSDate *fileCreationDate;
@property (readonly, nonatomic) NSDate *fileModificationDate;
@property (readonly, nonatomic) unsigned long long fileSize;
@property (readonly, nonatomic) unsigned long long fileOrDirectorySize;
@property (readonly, nonatomic) unsigned long long directorySize;
@property (readonly, nonatomic) NSString *fileChecksumSHA;
@property (readonly, nonatomic) NSURLRequest *request;
@property (readonly, nonatomic) NSMutableURLRequest *mutableRequest;
@property (readonly, nonatomic) BOOL isWriteablePath;
// url string download
@property (readonly, nonatomic) NSData *download;
@property (readonly, nonatomic) NSString *downloadWithCurl;
// path string filedata
@property (unsafe_unretained, nonatomic) NSData *contents;
@end
@interface NSData (CoreCode)
@property (readonly, nonatomic) NSMutableData *mutableObject;
@property (readonly, nonatomic) NSString *string;
@property (readonly, nonatomic) NSString *stringUTF8;
@property (readonly, nonatomic) NSString *hexString;
@property (readonly, nonatomic) NSString *base64String;
@property (readonly, nonatomic) NSDictionary *JSONDictionary;
@property (readonly, nonatomic) NSArray *JSONArray;
#ifdef USE_SNAPPY
@property (readonly, nonatomic) NSData *snappyCompressed;
@property (readonly, nonatomic) NSData *snappyDecompressed;
#endif
#ifdef USE_SECURITY
@property (readonly, nonatomic) NSString *SHA1;
#ifdef PROVIDE_DEPRECATED_MD5
@property (readonly, nonatomic) NSString *MD5;
#endif
@property (readonly, nonatomic) NSString *SHA256;
#endif
@property (readonly, nonatomic) NSRange fullRange;
@end
@interface NSDate (CoreCode)
+ (NSDate *)tomorrow;
+ (NSDate *)yesterday;
// date format strings: dd.MM.yyyy HH:mm:ss
+ (NSDate *)dateWithString:(NSString *)dateString format:(NSString *)dateFormat localeIdentifier:(NSString *)localeIdentifier;
+ (NSDate *)dateWithString:(NSString *)dateString format:(NSString *)dateFormat;
+ (NSDate *)dateWithPreprocessorDate:(const char *)preprocessorDateString;
+ (NSDate *)dateWithRFC822Date:(NSString *)rfcDateString; // e.g. Wed, 02 Oct 2002 15:00:00 +0200
+ (NSDate *)dateWithISO8601Date:(NSString *)iso8601DateString; // e.g. 2019-03-15T05:18:44Z
- (NSString *)stringUsingFormat:(NSString *)dateFormat;
- (NSString *)stringUsingFormat:(NSString *)dateFormat timeZone:(NSTimeZone *)timeZone;
- (NSString *)stringUsingDateStyle:(NSDateFormatterStyle)dateStyle timeStyle:(NSDateFormatterStyle)timeStyle;
- (NSDate *)nextDay;
- (NSDate *)previousDay;
@property (readonly, nonatomic) NSString *shortDateString;
@property (readonly, nonatomic) NSString *shortTimeString;
@property (readonly, nonatomic) NSString *shortDateAndTimeString;
@end
@interface NSDateFormatter (CoreCode)
+ (NSString *)formattedTimeFromTimeInterval:(NSTimeInterval)timeInterval;
@end
@interface NSDictionary <KeyType, ObjectType>(CoreCode)
@property (readonly, nonatomic) NSString *literalString;
@property (readonly, nonatomic) NSData *JSONData;
@property (readonly, nonatomic) NSData *XMLData;
@property (readonly, nonatomic) NSMutableDictionary <KeyType, ObjectType> *mutableObject;
- (NSDictionary *)dictionaryBySettingValue:(ObjectType)value forKey:(KeyType)key; // does replace too
- (NSDictionary *)dictionaryByDeletingKey:(KeyType)key;
- (NSDictionary *)dictionaryByDeletingKeys:(NSArray <KeyType> *)keys;
- (NSDictionary *)dictionaryByReplacingNSNullWithEmptyStrings;
- (BOOL)containsAny:(NSArray <NSString *>*)keys;
- (BOOL)containsAll:(NSArray <NSString *>*)keys;
@end
@interface NSMutableDictionary <KeyType, ObjectType>(CoreCode)
@property (readonly, nonatomic) NSDictionary <KeyType, ObjectType> *immutableObject;
// 'default dict'
- (void)addObject:(id)object toMutableArrayAtKey:(KeyType)key; // the point here is that it will add a mutablearray with the single object if the key doesn't exist - a poor mans 'defaultdict'
@end
@interface NSMutableURLRequest (CoreCode)
- (void)addBasicAuthentication:(NSString *)username password:(NSString *)password;
@end
@interface NSURLRequest (CoreCode)
- (NSData *)downloadWithTimeout:(double)timeoutSeconds disableCache:(BOOL)disableCache;
@property (readonly, nonatomic) NSData *download;
@end
@interface NSFileHandle (CoreCode)
- (float)readFloat;
- (int)readInt;
@end
@interface NSLocale (CoreCode)
+ (NSArray <NSString *> *)preferredLanguages2Letter;
+ (NSArray <NSString *> *)preferredLanguages3Letter;
@end
@interface NSObject (CoreCode)
@property (readonly, nonatomic) id id;
@property (retain, nonatomic) id associatedValue;
- (id)associatedValueForKey:(const NSString *)key;
- (void)setAssociatedValue:(id)value forKey:(const NSString *)key;
+ (instancetype)newWith:(NSDictionary *)dict;
@property (readonly, nonatomic) NSString *literalString;
@end
@interface NSCharacterSet (CoreCode)
@property (readonly, nonatomic) NSMutableCharacterSet *mutableObject;
@property (readonly, nonatomic) NSString *stringRepresentation;
@property (readonly, nonatomic) NSString *stringRepresentationLong;
@end
@interface NSMutableCharacterSet (CoreCode)
@property (readonly, nonatomic) NSCharacterSet *immutableObject;
@end
@interface NSNumber (CoreCode)
@property (readonly, nonatomic) NSString *literalString;
@end
@interface NSMutableOrderedSet <ObjectType> (CoreCode)
@property (readonly, nonatomic) NSOrderedSet <ObjectType> *immutableObject;
@end
@interface NSOrderedSet <ObjectType> (CoreCode)
@property (readonly, nonatomic) NSMutableOrderedSet <ObjectType> *mutableObject;
@end
@interface NSMutableSet <ObjectType> (CoreCode)
@property (readonly, nonatomic) NSSet <ObjectType> *immutableObject;
@end
@interface NSSet <ObjectType> (CoreCode)
@property (readonly, nonatomic) NSMutableSet <ObjectType> *mutableObject;
@end
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
@interface NSTask (CoreCode)
- (BOOL)waitUntilExitWithTimeout:(NSTimeInterval)timeout;
@end
#ifndef SANDBOX
@interface NSUserDefaults (CoreCode)
- (NSString *)stringForKey:(NSString *)defaultName ofForeignApp:(NSString *)bundleID;
- (NSObject *)objectForKey:(NSString *)defaultName ofForeignApp:(NSString *)bundleID;
@end
#endif
#endif
Raw
Foundation+CoreCode.m
//
// Foundation+CoreCode.m
// CoreLib
//
// Created by CoreCode on 15.03.12.
/* Copyright © 2020 CoreCode Limited
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitationthe rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
#import "Foundation+CoreCode.h"
#if __has_feature(modules)
#ifdef USE_SECURITY
@import CommonCrypto.CommonDigest;
#endif
@import ObjectiveC.runtime;
#else
#ifdef USE_SECURITY
#include <CommonCrypto/CommonDigest.h>
#endif
#import <objc/runtime.h>
#endif
#ifdef USE_SNAPPY
#import <snappy/snappy-c.h>
#endif
#if __has_feature(modules)
@import Darwin.POSIX.sys.stat;
#else
#include <sys/stat.h>
#endif
CONST_KEY(CoreCodeAssociatedValue)
@implementation NSArray (CoreCode)
@dynamic mutableObject, empty, set, reverseArray, string, path, sorted, XMLData, flattenedArray, literalString, orderedSet, JSONData, mostFrequentObject, dictionary, randomObject, joinedWithSpaces, joinedWithNewlines, joinedWithDots, joinedWithCommas, fullRange;
- (NSRange)fullRange
{
return NSMakeRange(0, self.count);
}
- (NSDictionary *)dictionary
{
NSNumber *oneObject = @(1);
NSMutableDictionary *result = makeMutableDictionary();
for (id object in self)
result[object] = oneObject;
return result.immutableObject;
}
- (NSString *)literalString
{
NSMutableString *tmp = [NSMutableString stringWithString:@"@["];
for (NSObject *obj in self)
[tmp appendFormat:@"%@, ", obj.literalString];
[tmp replaceCharactersInRange:NSMakeRange(tmp.length-2, 2) // replace trailing ', '
withString:@"]"]; // with terminating ']'
return tmp;
}
- (id)randomObject
{
if (!self.count) return nil;
else
return self[(NSUInteger)generateRandomIntBetween(0,(int)self.count-1)];
}
- (id)mostFrequentObject
{
NSCountedSet *set = [[NSCountedSet alloc] initWithArray:self];
id mostFrequentObject = nil;
NSUInteger highestCount = 0;
for (id obj in set)
{
NSUInteger count = [set countForObject:obj];
if (count > highestCount)
{
highestCount = count;
mostFrequentObject = obj;
}
}
return mostFrequentObject;
}
- (NSArray *)sorted
{
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wselector"
return [self sortedArrayUsingSelector:@selector(compare:)];
#pragma clang diagnostic pop
}
- (NSData *)JSONData
{
NSError *err;
NSData *data = [NSJSONSerialization dataWithJSONObject:self options:(NSJSONWritingOptions)0 error:&err];
if (!data || err)
{
cc_log_error(@"Error: JSON write fails! input %@ data %@ err %@", self, data, err);
return nil;
}
return data;
}
- (NSData *)XMLData
{
NSError *err;
NSData *data = [NSPropertyListSerialization dataWithPropertyList:self
format:NSPropertyListXMLFormat_v1_0
options:(NSPropertyListWriteOptions)0
error:&err];
if (!data || err)
{
cc_log_error(@"Error: XML write fails! input %@ data %@ err %@", self, data, err);
return nil;
}
return data;
}
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wgnu-statement-expression"
- (CCIntRange2D)calculateExtentsOfPoints:(ObjectInPointOutBlock)block
{
CCIntRange2D range = {{INT_MAX, INT_MAX}, {INT_MIN, INT_MIN}, {-1, -1}};
if (self.count)
{
for (NSObject *o in self)
{
CCIntPoint p = block(o);
range.max.x = MAX(range.max.x, p.x);
range.max.y = MAX(range.max.y, p.y);
range.min.x = MIN(range.min.x, p.x);
range.min.y = MIN(range.min.y, p.y);
}
range.length.x = range.max.x - range.min.x;
range.length.y = range.max.y - range.min.y;
}
return range;
}
- (CCIntRange1D)calculateExtentsOfValues:(ObjectInIntOutBlock)block
{
CCIntRange1D range = {INT_MAX, INT_MIN, -1};
if (self.count)
{
for (NSObject *o in self)
{
int p = block(o);
range.min = MIN(range.min, p);
range.max = MAX(range.max, p);
}
range.length = range.max - range.min;
}
return range;
}
#pragma clang diagnostic pop
+ (void)_addArrayContents:(NSArray *)array toArray:(NSMutableArray *)newArray
{
for (NSObject *object in array)
{
if ([object isKindOfClass:[NSArray class]])
[NSArray _addArrayContents:object.id toArray:newArray];
else
[newArray addObject:object];
}
}
- (NSArray *)flattenedArray
{
NSMutableArray *tmp = [NSMutableArray array];
[NSArray _addArrayContents:self toArray:tmp];
return tmp.immutableObject;
}
- (NSString *)string
{
NSString *ret = @"";
for (NSString *str in self)
ret = [ret stringByAppendingString:VALID_STR(str)];
return ret;
}
- (NSString *)path
{
NSString *ret = @"";
for (NSString *str in self)
ret = [ret stringByAppendingPathComponent:str];
return ret;
}
- (BOOL)contains:(id)object
{
return [self containsObject:object];
}
- (BOOL)containsObjectIdenticalTo:(id)object
{
return [self indexOfObjectIdenticalTo:object] != NSNotFound;
}
- (NSArray *)reverseArray
{
return [self reverseObjectEnumerator].allObjects;
}
- (NSOrderedSet *)orderedSet
{
return [NSOrderedSet orderedSetWithArray:self];
}
- (NSSet *)set
{
return [NSSet setWithArray:self];
}
- (NSArray *)arrayByInsertingObject:(id)anObject atIndex:(NSUInteger)index
{
NSMutableArray *array = [NSMutableArray arrayWithArray:self];
[array insertObject:anObject atIndex:index];
return [NSArray arrayWithArray:array];
}
- (NSArray *)arrayByAddingObjectSafely:(id)anObject
{
if (!anObject)
return self;
else
return [self arrayByAddingObject:anObject];
}
- (NSArray *)arrayByAddingNewObject:(id)anObject
{
if ([self indexOfObject:anObject] == NSNotFound)
return [self arrayByAddingObject:anObject];
else
return self;
}
- (NSArray *)arrayByDeletingObjectIdenticalTo:(id)anObject
{
NSMutableArray *array = [NSMutableArray arrayWithArray:self];
[array removeObjectIdenticalTo:anObject];
return [NSArray arrayWithArray:array];
}
- (NSArray *)arrayByDeletingObjectsIdenticalTo:(NSArray *)objects
{
NSMutableArray *array = [NSMutableArray arrayWithArray:self];
for (id obj in objects)
[array removeObjectIdenticalTo:obj];
return [NSArray arrayWithArray:array];
}
- (NSArray *)arrayByDeletingObjectsAtIndexes:(NSIndexSet *)indexSet
{
NSMutableArray *array = [NSMutableArray arrayWithArray:self];
[array removeObjectsAtIndexes:indexSet];
return [NSArray arrayWithArray:array];
}
- (NSArray *)arrayByDeletingObjectAtIndex:(NSUInteger)index
{
NSMutableArray *array = [NSMutableArray arrayWithArray:self];
[array removeObjectAtIndex:index];
return [NSArray arrayWithArray:array];
}
- (NSArray *)arrayByReplacingObject:(id)anObject withObject:(id)newObject
{
NSMutableArray *mut = self.mutableObject;
mut[[mut indexOfObject:anObject]] = newObject;
return mut.immutableObject;
}
- (id)slicingObjectAtIndex:(NSInteger)index
{
if (index < 0)
return self[(NSUInteger)((NSInteger)self.count + index)];
else
return self[(NSUInteger)index];
}
- (id)safeObjectAtIndex:(NSUInteger)index
{
if (self.count > index)
return self[index];
else
return nil;
}
- (BOOL)containsDictionaryWithKey:(NSString *)key equalTo:(NSString *)value
{
for (NSDictionary *dict in self)
{
NSObject *object = [dict valueForKey:key];
if ([object isEqual:value])
return TRUE;
}
return FALSE;
}
- (NSArray *)sortedArrayByKey:(NSString *)key
{
return [self sortedArrayByKey:key ascending:YES];
}
- (NSArray *)sortedArrayByKey:(NSString *)key insensitive:(BOOL)insensitive
{
if (!insensitive)
return [self sortedArrayByKey:key ascending:YES];
NSSortDescriptor *sd = [[NSSortDescriptor alloc] initWithKey:key ascending:YES selector:@selector(caseInsensitiveCompare:)];
return [self sortedArrayUsingDescriptors:@[sd]];
}
- (NSArray *)sortedArrayByKey:(NSString *)key ascending:(BOOL)ascending
{
NSSortDescriptor *sd = [[NSSortDescriptor alloc] initWithKey:key ascending:ascending];
return [self sortedArrayUsingDescriptors:@[sd]];
}
- (NSArray *)subarrayFromIndex:(NSUInteger)location
{
return [self subarrayWithRange:NSMakeRange(location, self.count-location)];
}
- (NSArray *)subarrayToIndex:(NSUInteger)location
{
return [self subarrayWithRange:NSMakeRange(0, location)];
}
- (NSArray *)slicingSubarrayToIndex:(NSInteger)location
{
if (location < 0)
{
NSInteger max = (NSInteger)self.count + location;
return [self subarrayToIndex:(NSUInteger)max];
}
else
return [self subarrayToIndex:(NSUInteger)location];
}
- (NSArray *)slicingSubarrayFromIndex:(NSInteger)location
{
if (location < 0)
{
NSInteger max = (NSInteger)self.count + location;
return [self subarrayFromIndex:(NSUInteger)max];
}
else
return [self subarrayFromIndex:(NSUInteger)location];
}
- (NSMutableArray *)mutableObject
{
return [NSMutableArray arrayWithArray:self];
}
- (BOOL)empty
{
return self.count == 0;
}
- (NSArray *)mapped:(ObjectInOutBlock)block
{
NSMutableArray *resultArray = [NSMutableArray new];
for (id object in self)
{
id result = block(object);
if (result)
[resultArray addObject:result];
}
return [NSArray arrayWithArray:resultArray];
}
- (NSInteger)reduce:(ObjectInIntOutBlock)block
{
NSInteger value = 0;
for (id object in self)
value += block(object);
return value;
}
- (NSArray *)filtered:(BOOL (^)(id input))block
{
NSMutableArray *resultArray = [NSMutableArray new];
for (id object in self)
if (block(object))
[resultArray addObject:object];
return [NSArray arrayWithArray:resultArray];
}
- (void)apply:(ObjectInBlock)block // similar = enumerateObjectsUsingBlock:
{
for (id object in self)
block(object);
}
- (NSString *)joined:(NSString *)sep // shortcut = componentsJoinedByString:
{
return [self componentsJoinedByString:sep];
}
- (NSString *)joinedWithSpaces
{
return [self componentsJoinedByString:@" "];
}
- (NSString *)joinedWithNewlines
{
return [self componentsJoinedByString:@"\n"];
}
- (NSString *)joinedWithDots
{
return [self componentsJoinedByString:@"."];
}
- (NSString *)joinedWithCommas
{
return [self componentsJoinedByString:@","];
}
- (NSArray *)filteredUsingPredicateString:(NSString *)format, ...
{
va_list args;
va_start(args, format);
NSPredicate *pred = [NSPredicate predicateWithFormat:format arguments:args];
va_end(args);
return [self filteredArrayUsingPredicate:pred];
}
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
- (NSString *)runAsTask
{
return [self runAsTaskWithTerminationStatus:NULL usePolling:NO];
}
- (NSString *)runAsTaskWithTerminationStatus:(NSInteger *)terminationStatus usePolling:(BOOL)usePollingToAvoidRunloop
{
NSTask *task = [NSTask new];
NSPipe *taskPipe = [NSPipe pipe];
NSFileHandle *file = taskPipe.fileHandleForReading;
task.launchPath = self[0];
task.standardOutput = taskPipe;
task.standardError = taskPipe;
task.arguments = [self subarrayWithRange:NSMakeRange(1, self.count-1)];
if ([task.arguments reduce:^int(NSString *input) { return (int)input.length; }] > 200000)
cc_log_error(@"Error: task argument size approaching or above limit, spawn will fail");
@try
{
[task launch];
}
@catch (NSException *e)
{
cc_log_error(@"Error: got exception %@ while trying to perform task %@", e.description, [self joined:@" "]);
return nil;
}
NSData *data = [file readDataToEndOfFile];
if (!usePollingToAvoidRunloop)
{
[task waitUntilExit];
#if defined(DEBUG) && !defined(CLI) && !defined(SKIP_MAINTHREADWAITUNTILEXIT_WARNING)
if ([NSThread currentThread] == [NSThread mainThread])
cc_log(@"Warning: -[NSTask waitUntilExit] on main thread considered harmful");
#endif
}
else
{
while (task.isRunning)
{
[NSThread sleepForTimeInterval:0.05];
}
}
NSString *string = data.string;
if (terminationStatus)
(*terminationStatus) = task.terminationStatus;
return string;
}
- (NSString *)runAsTaskWithProgressBlock:(StringInBlock)progressBlock
{
return [self runAsTaskWithProgressBlock:progressBlock terminationStatus:NULL];
}
- (NSString *)runAsTaskWithProgressBlock:(StringInBlock)progressBlock terminationStatus:(NSInteger *)terminationStatus
{
__block dispatch_semaphore_t sema = dispatch_semaphore_create(0);
NSMutableString *jobOutput = makeMutableString();
NSTask *task = [[NSTask alloc] init];
NSPipe *taskPipe = [NSPipe pipe];
task.launchPath = self[0];
task.standardOutput = taskPipe;
task.standardError = taskPipe;
task.arguments = [self subarrayWithRange:NSMakeRange(1, self.count-1)];
NSFileHandle *fileHandle = taskPipe.fileHandleForReading;
[fileHandle setReadabilityHandler:^(NSFileHandle *file)
{
NSData *data = file.availableData;
NSString *string = data.string;
if (string)
[jobOutput appendString:string];
progressBlock(string);
}];
[task setTerminationHandler:^(NSTask *t)
{
fileHandle.readabilityHandler = nil;
assert(sema);
dispatch_semaphore_signal(sema);
}];
[task launch];
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
sema = NULL;
if (terminationStatus)
(*terminationStatus) = task.terminationStatus;
return jobOutput;
}
#endif
@end
@implementation NSMutableArray (CoreCode)
@dynamic immutableObject;
- (void)moveObjectAtIndex:(NSUInteger)fromIndex toIndex:(NSUInteger)toIndex
{
id object = self[fromIndex];
[self removeObjectAtIndex:fromIndex];
if (toIndex < self.count)
[self insertObject:object atIndex:toIndex];
else
[self addObject:object];
}
- (void)removeObjectPassingTest:(ObjectInIntOutBlock)block
{
NSUInteger idx = [self indexOfObjectPassingTest:^BOOL(id obj, NSUInteger i, BOOL *s)
{
int res = block(obj);
return (BOOL)res;
}];
if (idx != NSNotFound)
[self removeObjectAtIndex:idx];
}
- (NSArray *)immutableObject
{
return [NSArray arrayWithArray:self];
}
- (void)addNewObject:(id)anObject
{
if (anObject && [self indexOfObject:anObject] == NSNotFound)
[self addObject:anObject];
}
- (void)addObjectSafely:(id)anObject
{
if (anObject)
[self addObject:anObject];
}
- (void)map:(ObjectInOutBlock)block
{
for (NSUInteger i = 0; i < self.count; i++)
{
id result = block(self[i]);
self[i] = result;
}
}
- (void)filter:(ObjectInIntOutBlock)block
{
NSMutableIndexSet *indices = [NSMutableIndexSet new];
for (NSUInteger i = 0; i < self.count; i++)
{
int result = block(self[i]);
if (!result)
[indices addIndex:i];
}
[self removeObjectsAtIndexes:indices];
}
- (void)filterUsingPredicateString:(NSString *)format, ...
{
va_list args;
va_start(args, format);
NSPredicate *pred = [NSPredicate predicateWithFormat:format arguments:args];
va_end(args);
[self filterUsingPredicate:pred];
}
- (void)removeFirstObject
{
[self removeObjectAtIndex:0];
}
@end
@implementation NSPointerArray (CoreCode)
- (NSInteger)getIndexOfPointer:(void *)aPointer
{
for (NSUInteger i = 0; i < self.count; i++)
{
if ([self pointerAtIndex:i] == aPointer)
{
return (NSInteger)i;
}
}
return -1;
}
- (void)forEach:(void (^)(void *))aCallback
{
for (NSUInteger i = 0; i < self.count; i++)
{
aCallback([self pointerAtIndex:i]);
}
}
- (BOOL)containsPointer:(void *)aPointer
{
return [self getIndexOfPointer:aPointer] != -1;
}
@end
@implementation NSString (CoreCode)
@dynamic words, lines, strippedOfWhitespace, strippedOfNewlines, trimmedOfWhitespace, trimmedOfWhitespaceAndNewlines, URL, fileURL, download, downloadWithCurl, resourceURL, resourcePath, localized, defaultObject, defaultString, defaultInt, defaultFloat, defaultURL, directoryContents, directoryContentsRecursive, directoryContentsAbsolute, directoryContentsRecursiveAbsolute, fileExists, uniqueFile, expanded, defaultArray, defaultDict, isWriteablePath, fileSize, directorySize, contents, dataFromHexString, dataFromBase64String, unescaped, escaped, namedImage, isIntegerNumber, isIntegerNumberOnly, isFloatNumber, data, firstCharacter, lastCharacter, fullRange, stringByResolvingSymlinksInPathFixed, literalString, isNumber, rot13, characterSet, lengthFixed;
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
@dynamic fileIsAlias, fileAliasTarget, fileIsSymlink, fileIsRestricted;
#endif
#ifdef USE_SECURITY
@dynamic SHA1;
#endif
- (NSUInteger)lengthFixed
{
NSUInteger realLength = [self lengthOfBytesUsingEncoding:NSUTF32StringEncoding] / 4;
return realLength;
}
- (NSCharacterSet *)characterSet
{
NSCharacterSet *cs = [NSCharacterSet characterSetWithCharactersInString:self];
assert(cs);
return cs;
}
- (NSString *)rot13
{
const char *cstring = [self cStringUsingEncoding:NSASCIIStringEncoding];
if (!cstring) return nil;
char *newcstring = malloc(self.length+1);
NSUInteger x;
for(x = 0; x < self.length; x++)
{
unsigned int aCharacter = (unsigned int)cstring[x];
if (0x40 < aCharacter && aCharacter < 0x5B) // A - Z
newcstring[x] = (((aCharacter - 0x41) + 0x0D) % 0x1A) + 0x41;
else if (0x60 < aCharacter && aCharacter < 0x7B) // a-z
newcstring[x] = (((aCharacter - 0x61) + 0x0D) % 0x1A) + 0x61;
else // Not an alpha character
newcstring[x] = (char)aCharacter;
}
newcstring[x] = '\0';
NSString *rotString = @(newcstring);
free(newcstring);
return rotString;
}
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
- (NSImage *)namedImage
{
NSImage *image = [NSImage imageNamed:self];
if (!image)
cc_log_error(@"Error: there is no named image with name: %@", self);
return image;
}
#else
- (UIImage *)namedImage
{
UIImage *image = [UIImage imageNamed:self];
if (!image)
cc_log_error(@"Error: there is no named image with name: %@", self);
return image;
}
#endif
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
- (BOOL)fileIsRestricted
{
struct stat info;
lstat(self.UTF8String, &info);
return (info.st_flags & SF_RESTRICTED) > 0;
}
- (BOOL)fileIsAlias
{
NSURL *url = [NSURL fileURLWithPath:self];
CFURLRef cfurl = (__bridge CFURLRef) url;
CFBooleanRef aliasBool = kCFBooleanFalse;
Boolean success = CFURLCopyResourcePropertyForKey(cfurl, kCFURLIsAliasFileKey, &aliasBool, NULL);
Boolean alias = CFBooleanGetValue(aliasBool);
return alias && success;
}
- (BOOL)fileIsSymlink
{
NSURL *url = [NSURL fileURLWithPath:self];
CFURLRef cfurl = (__bridge CFURLRef) url;
CFBooleanRef aliasBool = kCFBooleanFalse;
Boolean success = CFURLCopyResourcePropertyForKey(cfurl, kCFURLIsSymbolicLinkKey, &aliasBool, NULL);
Boolean alias = CFBooleanGetValue(aliasBool);
return alias && success;
}
- (NSString *)stringByResolvingSymlinksInPathFixed
{
NSString *ret = self.stringByResolvingSymlinksInPath;
for (NSString *exception in @[@"/etc/", @"/tmp/", @"/var/"])
{
if ([ret hasPrefix:exception])
{
NSString *fixed = [@"/private" stringByAppendingPathComponent:ret];
return fixed;
}
}
return ret;
}
- (NSString *)fileAliasTarget
{
CFErrorRef *err = NULL;
CFDataRef bookmark = CFURLCreateBookmarkDataFromFile(NULL, (__bridge CFURLRef)self.fileURL, err);
if (bookmark == nil)
return nil;
CFURLRef url = CFURLCreateByResolvingBookmarkData (NULL, bookmark, kCFBookmarkResolutionWithoutUIMask, NULL, NULL, NULL, err);
__autoreleasing NSURL *nurl = [(__bridge NSURL *)url copy];
CFRelease(bookmark);
CFRelease(url);
return nurl.path;
}
- (CGSize)sizeUsingFont:(NSFont *)font maxWidth:(CGFloat)maxWidth
{
NSTextStorage *textStorage = [[NSTextStorage alloc] initWithString:self];
NSTextContainer *textContainer = [[NSTextContainer alloc] initWithContainerSize:NSMakeSize(maxWidth, DBL_MAX)];
NSLayoutManager *layoutManager = [[NSLayoutManager alloc] init];
[layoutManager addTextContainer:textContainer];
[textStorage addLayoutManager:layoutManager];
[textStorage beginEditing];
[textStorage setAttributes:@{NSFontAttributeName: font} range:NSMakeRange(0, self.length)];
[textStorage endEditing];
(void) [layoutManager glyphRangeForTextContainer:textContainer];
NSRect r = [layoutManager usedRectForTextContainer:textContainer];
return r.size;
}
#endif
- (NSString *)literalString
{
return makeString(@"@\"%@\"", self);
}
- (NSRange)fullRange
{
return NSMakeRange(0, self.length);
}
- (unichar)firstCharacter
{
if (self.length)
return [self characterAtIndex:0];
return 0;
}
- (unichar)lastCharacter
{
NSUInteger len = self.length;
if (len)
return [self characterAtIndex:len-1];
return 0;
}
- (unsigned long long)fileSize
{
assert(fileManager);
NSDictionary *attr = [fileManager attributesOfItemAtPath:self error:NULL];
if (!attr) return 0;
NSNumber *fs = attr[NSFileSize];
return fs.unsignedLongLongValue;
}
- (unsigned long long)directorySize
{
return self.fileURL.directorySize;
}
- (BOOL)isIntegerNumber
{
return [self rangeOfCharacterFromSet:NSCharacterSet.decimalDigitCharacterSet].location != NSNotFound;
}
- (BOOL)isNumber
{
if (!self.length)
return NO;
if (self.isIntegerNumberOnly)
return YES;
return self.isFloatNumber;
}
- (BOOL)isIntegerNumberOnly
{
return [self rangeOfCharacterFromSet:NSCharacterSet.decimalDigitCharacterSet.invertedSet].location == NSNotFound;
}
- (BOOL)isFloatNumber
{
static NSCharacterSet *cs = nil;
ONCE_PER_FUNCTION(^
{
NSMutableCharacterSet *tmp = [NSMutableCharacterSet characterSetWithCharactersInString:@",."];
NSString *groupingSeparators = [[NSLocale currentLocale] objectForKey:NSLocaleGroupingSeparator];
NSString *decimalSeparators = [[NSLocale currentLocale] objectForKey:NSLocaleDecimalSeparator];
[tmp addCharactersInString:groupingSeparators];
[tmp addCharactersInString:decimalSeparators];
cs = tmp.immutableObject;
assert(cs);
})
return ([self rangeOfCharacterFromSet:NSCharacterSet.decimalDigitCharacterSet].location != NSNotFound) && ([self rangeOfCharacterFromSet:cs].location != NSNotFound);
}
- (BOOL)isWriteablePath
{
if (self.fileExists)
return NO;
if (![@"TEST" writeToFile:self atomically:YES encoding:NSUTF8StringEncoding error:NULL])
return NO;
assert(fileManager);
[fileManager removeItemAtPath:self error:NULL];
return YES;
}
- (BOOL)isValidEmails
{
for (NSString *line in self.lines)
if (!line.isValidEmail)
return NO;
return YES;
}
- (BOOL)isValidEmail
{
if (self.length > 254)
return NO;
NSArray <NSString *> *portions = [self split:@"@"];
if (portions.count != 2)
return FALSE;
NSString *local = portions[0];
NSString *domain = portions[1];
if (![domain contains:@"."])
return FALSE;
static NSCharacterSet *localValid = nil, *domainValid = nil;
ONCE_PER_FUNCTION(^
{
localValid = [NSCharacterSet characterSetWithCharactersInString:@"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%&'*+-/=?^_`{|}~."];
domainValid = [NSCharacterSet characterSetWithCharactersInString:@"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-."];
assert(localValid);
assert(domainValid);
})
if ([local rangeOfCharacterFromSet:localValid.invertedSet options:(NSStringCompareOptions)0].location != NSNotFound)
return NO;
if ([domain rangeOfCharacterFromSet:domainValid.invertedSet options:(NSStringCompareOptions)0].location != NSNotFound)
return NO;
return YES;
}
- (NSArray <NSString *> *)directoryContents
{
assert(fileManager);
return [fileManager contentsOfDirectoryAtPath:self error:NULL];
}
- (NSArray <NSString *> *)directoryContentsRecursive
{
assert(fileManager);
return [fileManager subpathsOfDirectoryAtPath:self error:NULL];
}
- (NSArray <NSString *> *)directoryContentsAbsolute
{
NSArray <NSString *> *c = self.directoryContents;
return [c mapped:^NSString *(NSString *input) { return [self stringByAppendingPathComponent:input]; }];
}
- (NSArray <NSString *> *)directoryContentsRecursiveAbsolute
{
NSArray <NSString *> *c = self.directoryContentsRecursive;
return [c mapped:^NSString *(NSString *input) { return [self stringByAppendingPathComponent:input]; }];
}
- (NSString *)uniqueFile
{
assert(fileManager);
if (![fileManager fileExistsAtPath:self])
return self;
else
{
NSString *ext = self.pathExtension;
NSString *namewithoutext = self.stringByDeletingPathExtension;
int i = 0;
while ([fileManager fileExistsAtPath:[NSString stringWithFormat:@"%@-%i.%@", namewithoutext, i,ext]])
i++;
return [NSString stringWithFormat:@"%@-%i.%@", namewithoutext, i,ext];
}
}
- (void)setContents:(NSData *)data
{
NSError *err;
if (!data)
cc_log(@"Error: can not write null data to file %@", self);
else if (![data writeToFile:self options:NSDataWritingAtomic error:&err])
cc_log(@"Error: writing data to file has failed (file: %@ data: %lu error: %@)", self, (unsigned long)data.length, err.description);
}
- (NSData *)contents
{
return [[NSData alloc] initWithContentsOfFile:self];
}
- (BOOL)fileExists
{
assert(fileManager);
return [fileManager fileExistsAtPath:self];
}
- (NSUInteger)count:(NSString *)str
{
return [self componentsSeparatedByString:str].count - 1;
}
- (BOOL)hasAnyPrefix:(NSArray <NSString *>*)possiblePrefixes
{
for (NSString *possiblePrefix in possiblePrefixes)
if ([self hasPrefix:possiblePrefix])
return YES;
return NO;
}
- (BOOL)hasAnySuffix:(NSArray <NSString *>*)possibleSuffixes
{
for (NSString *possibleSuffix in possibleSuffixes)
if ([self hasSuffix:possibleSuffix])
return YES;
return NO;
}
- (BOOL)contains:(NSString *)otherString
{
return ([self rangeOfString:otherString].location != NSNotFound);
}
- (BOOL)contains:(NSString *)otherString insensitive:(BOOL)insensitive
{
return ([self rangeOfString:otherString options:insensitive ? NSCaseInsensitiveSearch : 0].location != NSNotFound);
}
- (BOOL)containsAny:(NSArray <NSString *>*)otherStrings
{
for (NSString *otherString in otherStrings)
if ([self rangeOfString:otherString].location != NSNotFound)
return YES;
return NO;
}
- (BOOL)containsAny:(NSArray <NSString *>*)otherStrings insensitive:(BOOL)insensitive
{
for (NSString *otherString in otherStrings)
if ([self rangeOfString:otherString options:insensitive ? NSCaseInsensitiveSearch : 0].location != NSNotFound)
return YES;
return NO;
}
- (BOOL)containsAll:(NSArray <NSString *>*)otherStrings
{
for (NSString *otherString in otherStrings)
if ([self rangeOfString:otherString].location == NSNotFound)
return NO;
return YES;
}
- (BOOL)equalsAny:(NSArray <NSString *>*)otherStrings
{
for (NSString *otherString in otherStrings)
if ([self isEqualToString:otherString])
return YES;
return NO;
}
- (NSString *)localized
{
NSString *localizedString = NSLocalizedString(self, nil);
#ifdef CUSTOM_LOCALIZED_STRING_REPLACEMENT
#define STRINGIZE(x) #x
#define STRINGIZE2(x) STRINGIZE(x)
#define LITERAL1 @ STRINGIZE2(CUSTOM_LOCALIZED_STRING_REPLACEMENT_FROM)
#define LITERAL2 @ STRINGIZE2(CUSTOM_LOCALIZED_STRING_REPLACEMENT_TO)
localizedString = [localizedString replaced:LITERAL1
with:LITERAL2];
#endif
return localizedString;
}
- (NSString *)resourcePath
{
assert(bundle);
return [bundle pathForResource:self ofType:nil];
}
- (NSURL *)resourceURL
{
assert(bundle);
return [bundle URLForResource:self withExtension:nil];
}
- (NSURL *)URL
{
return [NSURL URLWithString:self];
}
- (NSURL *)fileURL
{
return [NSURL fileURLWithPath:self];
}
- (NSString *)expanded
{
return self.stringByExpandingTildeInPath;
}
- (NSArray <NSString *> *)words
{
return [self componentsSeparatedByCharactersInSet:[NSCharacterSet whitespaceCharacterSet]];
}
- (NSArray <NSString *> *)lines
{
return [self componentsSeparatedByCharactersInSet:[NSCharacterSet newlineCharacterSet]];
}
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
- (NSAttributedString *)attributedStringWithColor:(NSColor *)color
{
NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:self];
[attributedString beginEditing];
[attributedString addAttribute:NSForegroundColorAttributeName value:color range:self.fullRange];
[attributedString endEditing];
return attributedString;
}
#endif
- (NSAttributedString *)attributedStringWithHyperlink:(NSURL *)url
{
NSString *urlstring = url.absoluteString;
NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:self];
[attributedString beginEditing];
[attributedString addAttribute:NSLinkAttributeName value:urlstring range:self.fullRange];
[attributedString addAttribute:NSForegroundColorAttributeName value:makeColor(0, 0, 1, 1) range:self.fullRange];
[attributedString addAttribute:NSUnderlineStyleAttributeName value:@(NSUnderlineStyleSingle) range:self.fullRange];
[attributedString endEditing];
return attributedString;
}
- (NSAttributedString *)attributedStringWithFont:(NSFont *)font
{
NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:self];
[attributedString beginEditing];
[attributedString addAttribute:NSFontAttributeName value:font range:self.fullRange];
[attributedString endEditing];
return attributedString;
}
- (NSString *)strippedOfNewlines
{
return [self stringByDeletingCharactersInSet:[NSCharacterSet newlineCharacterSet]];
}
- (NSString *)strippedOfWhitespace
{
return [self stringByDeletingCharactersInSet:[NSCharacterSet whitespaceCharacterSet]];
}
- (NSString *)strippedOfWhitespaceAndNewlines
{
return [self stringByDeletingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
}
- (NSString *)trimmedOfWhitespace
{
return [self stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceCharacterSet]];
}
- (NSString *)trimmedOfWhitespaceAndNewlines
{
return [self stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
}
- (NSString *)clamp:(NSUInteger)maximumLength
{
return ((self.length <= maximumLength) ? self : [self substringToIndex:maximumLength]);
}
- (NSString *)clampByteLength:(NSUInteger)maximumLength
{
NSString *clampedString = [self clamp:maximumLength];
while ([clampedString lengthOfBytesUsingEncoding:NSUTF8StringEncoding] > maximumLength)
clampedString = [clampedString slicingSubstringToIndex:-1];
return clampedString;
}
- (NSString *)tail:(NSUInteger)maximumLength
{
return ((self.length <= maximumLength) ? self : [self substringFromIndex:self.length - maximumLength]);
}
- (NSString *)stringByReplacingMultipleStrings:(NSDictionary <NSString *, NSString *>*)replacements
{
NSString *ret = self;
assert(![self contains:@"k9BBV15zFYi44YyB"]);
for (NSString *key in replacements)
{
if ([[NSNull null] isEqual:key] || [[NSNull null] isEqual:replacements[key]])
continue;
ret = [ret stringByReplacingOccurrencesOfString:key
withString:[key stringByAppendingString:@"k9BBV15zFYi44YyB"]];
}
BOOL replaced;
do
{
replaced = FALSE;
for (NSString *key in replacements)
{
id value = replacements[key];
if ([[NSNull null] isEqual:key] || [[NSNull null] isEqual:value])
continue;
NSString *tmp = [ret stringByReplacingOccurrencesOfString:[key stringByAppendingString:@"k9BBV15zFYi44YyB"]
withString:value];
if (![tmp isEqualToString:ret])
{
ret = tmp;
replaced = YES;
}
}
} while (replaced);
return ret;
}
- (NSString *)capitalizedStringWithUppercaseWords:(NSArray <NSString *> *)uppercaseWords
{
NSString *res = self.capitalizedString;
for (NSString *word in uppercaseWords)
{
res = [res stringByReplacingOccurrencesOfString:makeString(@"(\\W)%@(\\W)", word.capitalizedString)
withString:makeString(@"$1%@$2", word.uppercaseString)
options:NSRegularExpressionSearch range: res.fullRange];
}
for (NSString *word in uppercaseWords)
{
res = [res stringByReplacingOccurrencesOfString:makeString(@"(\\W)%@(\\Z)", word.capitalizedString)
withString:makeString(@"$1%@", word.uppercaseString)
options:NSRegularExpressionSearch range:res.fullRange];
}
return res;
}
- (NSString *)titlecaseStringWithLowercaseWords:(NSArray <NSString *> *)lowercaseWords andUppercaseWords:(NSArray <NSString *> *)uppercaseWords
{
NSString *res = [self capitalizedStringWithUppercaseWords:uppercaseWords];
for (NSString *word in lowercaseWords)
{
res = [res stringByReplacingOccurrencesOfString:makeString(@"([^:,;,-]\\s)%@(\\s)", word.capitalizedString)
withString:makeString(@"$1%@$2", word.lowercaseString)
options:NSRegularExpressionSearch range: res.fullRange];
}
// for (NSString *word in lowercaseWords)
// {
// res = [res stringByReplacingOccurrencesOfString:makeString(@"(\\s)%@(\\Z)", word.capitalizedString)
// withString:makeString(@"$1%@", word.lowercaseString)
// options:NSRegularExpressionSearch range: res.fullRange];
//
// }
return res;
}
- (NSString *)titlecaseString
{
NSArray *words = @[@"a", @"an", @"the", @"and", @"but", @"for", @"nor", @"or", @"so", @"yet", @"at", @"by", @"for", @"in", @"of", @"off", @"on", @"out", @"to", @"up", @"via", @"to", @"c", @"ca", @"etc", @"e.g.", @"i.e.", @"vs.", @"vs", @"v", @"down", @"from", @"into", @"like", @"near", @"onto", @"over", @"than", @"with", @"upon"];
return [self titlecaseStringWithLowercaseWords:words.id andUppercaseWords:nil];
}
- (NSString *)propercaseString
{
if (self.length == 0)
return @"";
else if (self.length == 1)
return self.uppercaseString;
return makeString(@"%@%@",
[self substringToIndex:1].uppercaseString,
[self substringFromIndex:1].lowercaseString);
}
- (NSData *)download
{
#if defined(DEBUG) && !defined(SKIP_MAINTHREADDOWNLOAD_WARNING) && !defined(CLI)
if ([NSThread currentThread] == [NSThread mainThread])
LOG(@"Warning: performing blocking download on main thread")
#endif
NSData *d = [[NSData alloc] initWithContentsOfURL:self.URL];
return d;
}
- (NSString *)downloadWithCurl
{
return self.URL.downloadWithCurl;
}
#ifdef USE_SECURITY
- (NSString *)SHA1
{
const char *cStr = self.UTF8String;
if (!cStr) return nil;
unsigned char result[CC_SHA1_DIGEST_LENGTH];
CC_SHA1(cStr, (CC_LONG)strlen(cStr), result);
NSString *s = [NSString stringWithFormat:
@"%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x",
result[0], result[1], result[2], result[3], result[4],
result[5], result[6], result[7],
result[8], result[9], result[10], result[11], result[12],
result[13], result[14], result[15],
result[16], result[17], result[18], result[19]
];
return s;
}
#endif
- (NSMutableString *)mutableObject
{
return [NSMutableString stringWithString:self];
}
- (NSString *)language
{
CFStringRef resultLanguage;
resultLanguage = CFStringTokenizerCopyBestStringLanguage((CFStringRef)self, CFRangeMake(0, self.length > 500 ? 500 : (long)self.length));
return CFBridgingRelease(resultLanguage);
// NSLinguisticTagger *tagger = [[NSLinguisticTagger alloc] initWithTagSchemes:@[NSLinguisticTagSchemeLanguage] options:0];
// tagger.string = self;
//
// NSString *resultLanguage = [tagger tagAtIndex:0 scheme:NSLinguisticTagSchemeLanguage tokenRange:NULL sentenceRange:NULL];
// return resultLanguage;
// __block NSString *resultLanguage;
// dispatch_queue_t queue;
// dispatch_semaphore_t sema = dispatch_semaphore_create(0);
// NSSpellChecker *spellChecker = NSSpellChecker.sharedSpellChecker;
// spellChecker.automaticallyIdentifiesLanguages = YES;
// [spellChecker requestCheckingOfString:self
// range:(NSRange){0, self}
// types:NSTextCheckingTypeOrthography
// options:nil
// inSpellDocumentWithTag:0
// completionHandler:^(NSInteger sequenceNumber, NSArray *results, NSOrthography *orthography, NSInteger wordCount)
// {
// resultLanguage = orthography.dominantLanguage;
// dispatch_semaphore_signal(sema);
// }];
//
//
// dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
// sema = NULL;
//
// return resultLanguage;
}
- (NSString *)removed:(NSString *)stringToRemove
{
return [self stringByReplacingOccurrencesOfString:stringToRemove withString:@""];
}
- (NSString *)appended:(NSString *)str // = stringByAppendingString
{
return [self stringByAppendingString:str];
}
- (NSString *)replaced:(NSString *)str1 with:(NSString *)str2 // stringByReplacingOccurencesOfString:withString:
{
assert(str2);
return [self stringByReplacingOccurrencesOfString:str1 withString:str2];
}
- (NSArray <NSString *> *)split:(NSString *)sep // componentsSeparatedByString:
{
return [self componentsSeparatedByString:sep];
}
- (NSString *)between:(NSString *)sep1 and:(NSString *)sep2
{
return [[self splitAfterNull:sep1] splitBeforeNull:sep2]; // iif the first call yields nil, we still return nil
}
- (NSString *)splitBeforeFull:(NSString *)sep
{
NSRange r = [self rangeOfString:sep];
if (r.location == NSNotFound)
return self;
else
return [self substringToIndex:r.location];
}
- (NSString *)splitAfterFull:(NSString *)sep
{
NSRange r = [self rangeOfString:sep];
if (r.location == NSNotFound)
return self;
else
return [self substringFromIndex:r.location + r.length];
}
- (NSString *)splitBeforeNull:(NSString *)sep
{
NSRange r = [self rangeOfString:sep];
if (r.location == NSNotFound)
return nil;
else
return [self substringToIndex:r.location];
}
- (NSString *)splitAfterNull:(NSString *)sep
{
NSRange r = [self rangeOfString:sep];
if (r.location == NSNotFound)
return nil;
else
return [self substringFromIndex:r.location + r.length];
}
- (NSArray *)defaultArray
{
assert(userDefaults);
return [userDefaults arrayForKey:self];
}
- (void)setDefaultArray:(NSArray *)newDefault
{
assert(userDefaults);
[NSUserDefaults.standardUserDefaults setObject:newDefault forKey:self];
}
- (NSDictionary *)defaultDict
{
assert(userDefaults);
return [NSUserDefaults.standardUserDefaults dictionaryForKey:self];
}
- (void)setDefaultDict:(NSDictionary *)newDefault
{
assert(userDefaults);
[NSUserDefaults.standardUserDefaults setObject:newDefault forKey:self];
}
- (id)defaultObject
{
assert(userDefaults);
return [userDefaults objectForKey:self];
}
- (void)setDefaultObject:(id)newDefault
{
assert(userDefaults);
[userDefaults setObject:newDefault forKey:self];
}
- (NSString *)defaultString
{
assert(userDefaults);
return [userDefaults stringForKey:self];
}
- (void)setDefaultString:(NSString *)newDefault
{
[userDefaults setObject:newDefault forKey:self];
}
- (NSURL *)defaultURL
{
assert(userDefaults);
return [userDefaults URLForKey:self];
}
- (void)setDefaultURL:(NSURL *)newDefault
{
assert(userDefaults);
[userDefaults setURL:newDefault forKey:self];
}
- (NSInteger)defaultInt
{
assert(userDefaults);
return [userDefaults integerForKey:self];
}
- (void)setDefaultInt:(NSInteger)newDefault
{
assert(userDefaults);
[userDefaults setInteger:newDefault forKey:self];
}
- (float)defaultFloat
{
assert(userDefaults);
return [userDefaults floatForKey:self];
}
- (void)setDefaultFloat:(float)newDefault
{
assert(userDefaults);
[userDefaults setFloat:newDefault forKey:self];
}
- (NSString *)stringValue
{
return self;
}
//- (NSNumber *)numberValue
//{
// return @(self.doubleValue);
//}
- (NSArray <NSArray <NSString *> *> *)parsedDSVWithDelimiter:(NSString *)delimiter
{ // credits to Drew McCormack
NSMutableArray *rows = [NSMutableArray array];
NSMutableCharacterSet *whitespaceCharacterSet = [NSMutableCharacterSet whitespaceCharacterSet];
NSMutableCharacterSet *newlineCharacterSetMutable = [NSMutableCharacterSet whitespaceAndNewlineCharacterSet];
[newlineCharacterSetMutable formIntersectionWithCharacterSet:whitespaceCharacterSet.invertedSet];
[whitespaceCharacterSet removeCharactersInString:delimiter];
NSCharacterSet *newlineCharacterSet = [NSCharacterSet characterSetWithBitmapRepresentation:newlineCharacterSetMutable.bitmapRepresentation];
NSMutableCharacterSet *importantCharactersSetMutable = [NSMutableCharacterSet characterSetWithCharactersInString:[delimiter stringByAppendingString:@"\""]];
[importantCharactersSetMutable formUnionWithCharacterSet:newlineCharacterSet];
NSCharacterSet *importantCharactersSet = [NSCharacterSet characterSetWithBitmapRepresentation:importantCharactersSetMutable.bitmapRepresentation];
NSScanner *scanner = [NSScanner scannerWithString:self];
[scanner setCharactersToBeSkipped:nil];
while (!scanner.atEnd)
{
BOOL insideQuotes = NO;
BOOL finishedRow = NO;
NSMutableArray *columns = [NSMutableArray arrayWithCapacity:30];
NSMutableString *currentColumn = [NSMutableString string];
while (!finishedRow)
{
NSString *tempString;
if ([scanner scanUpToCharactersFromSet:importantCharactersSet intoString:&tempString])
{
[currentColumn appendString:tempString];
}
if (scanner.atEnd)
{
if (![currentColumn isEqualToString:@""])
[columns addObject:currentColumn];
finishedRow = YES;
}
else if ([scanner scanCharactersFromSet:newlineCharacterSet intoString:&tempString])
{
if (insideQuotes)
{
[currentColumn appendString:tempString];
}
else
{
if (![currentColumn isEqualToString:@""])
[columns addObject:currentColumn];
finishedRow = YES;
}
}
else if ([scanner scanString:@"\"" intoString:NULL])
{
if (insideQuotes && [scanner scanString:@"\"" intoString:NULL])
{
[currentColumn appendString:@"\""];
}
else
{
insideQuotes = !insideQuotes;
}
}
else if ([scanner scanString:delimiter intoString:NULL])
{
if (insideQuotes)
{
[currentColumn appendString:delimiter];
}
else
{
[columns addObject:currentColumn];
currentColumn = [NSMutableString string];
[scanner scanCharactersFromSet:whitespaceCharacterSet intoString:NULL];
}
}
}
if (columns.count > 0)
[rows addObject:columns];
}
return rows;
}
- (NSData *)data
{
static const NSStringEncoding encodingsToTry[] = {NSUTF8StringEncoding, NSISOLatin1StringEncoding, NSASCIIStringEncoding, NSUnicodeStringEncoding};
int encodingCount = (sizeof(encodingsToTry) / sizeof(NSStringEncoding));
NSData *d;
for (unsigned char i = 0; i < encodingCount; i++)
{
d = [self dataUsingEncoding:encodingsToTry[i] allowLossyConversion:YES];
if (d)
break;
}
if (!d)
cc_log_error(@"Error: can not convert string to data!");
return d;
}
- (NSData *)dataFromBase64String
{
return [[NSData alloc] initWithBase64EncodedString:self options:NSDataBase64DecodingIgnoreUnknownCharacters];
}
- (NSData *)dataFromHexString
{
const char *bytes = [self cStringUsingEncoding:NSUTF8StringEncoding];
if (!bytes) return nil;
NSUInteger length = strlen(bytes);
unsigned char *r = (unsigned char *)malloc(length / 2 + 1);
unsigned char *index = r;
while ((*bytes) && (*(bytes +1)))
{
char encoder[3] = {'\0','\0','\0'};
encoder[0] = *bytes;
encoder[1] = *(bytes+1);
*index = (unsigned char)strtol(encoder, NULL, 16);
index++;
bytes+=2;
}
*index = '\0';
NSData *result = [NSData dataWithBytes:r length:length / 2];
free(r);
return result;
}
- (NSString *)unescaped
{
return self.stringByRemovingPercentEncoding;
}
- (NSString *)escaped
{
return [self stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
}
- (NSString *)escapedForXML
{
NSString *str = self;
str = [str stringByReplacingMultipleStrings:@{@"&" : @"&amp;",
@"\"" : @"&quot;",
@"'" : @"&#39;",
@">" : @"&gt;",
@"<" : @"&lt;"}];
return str;
}
- (NSString *)slicingSubstringToIndex:(NSInteger)location
{
if (location < 0)
{
NSInteger max = (NSInteger)self.length + location;
return [self substringToIndex:(NSUInteger)max];
}
else
return [self substringToIndex:(NSUInteger)location];
}
- (NSString *)encoded
{
return [self stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet alphanumericCharacterSet]];
}
- (NSString *)stringByTrimmingLeadingCharactersInSet:(NSCharacterSet *)characterSet
{
NSRange rangeOfFirstWantedCharacter = [self rangeOfCharacterFromSet:characterSet.invertedSet];
if (rangeOfFirstWantedCharacter.location == NSNotFound)
return @"";
return [self substringFromIndex:rangeOfFirstWantedCharacter.location];
}
- (NSString *)stringByTrimmingTrailingCharactersInSet:(NSCharacterSet *)characterSet
{
NSRange rangeOfLastWantedCharacter = [self rangeOfCharacterFromSet:characterSet.invertedSet
options:NSBackwardsSearch];
if (rangeOfLastWantedCharacter.location == NSNotFound)
return @"";
return [self substringToIndex:rangeOfLastWantedCharacter.location+1];
}
- (NSString *)stringByDeletingCharactersInSet:(NSCharacterSet *)characterSet
{
NSRange r = [self rangeOfCharacterFromSet:characterSet];
NSString *new = self.copy;
while (r.location != NSNotFound)
{
new = [new stringByReplacingCharactersInRange:r withString:@""];
r = [new rangeOfCharacterFromSet:characterSet];
}
return new;
}
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
void directoryObservingReleaseCallback(const void *info)
{
CFBridgingRelease(info);
}
void directoryObservingEventCallback(ConstFSEventStreamRef streamRef, void *clientCallBackInfo, size_t numEvents, void *eventPaths, const FSEventStreamEventFlags eventFlags[], const FSEventStreamEventId eventIds[])
{
NSMutableArray <NSDictionary *> *tmp = makeMutableArray();
char **paths = eventPaths;
for (NSUInteger i = 0; i < numEvents; i++)
{
char *eventPath = paths[i];
if (eventPath)
{
NSString *eventPathString = @(eventPath);
if (eventPathString)
[tmp addObject:@{@"path" : eventPathString, @"flags" : @(eventFlags[i])}];
}
}
void (^block)(id input) = (__bridge void (^)(id))(clientCallBackInfo);
block(tmp);
//
// void (^block)(void) = (__bridge void (^)(void))(clientCallBackInfo);
// block();
}
CONST_KEY(CCDirectoryObserving)
- (NSValue *)startObserving:(ObjectInBlock)block withFileLevelEvents:(BOOL)fileLevelEvents
{
void *ptr = (__bridge_retained void *)block;
FSEventStreamContext context = {0, ptr, NULL, directoryObservingReleaseCallback, NULL};
CFStringRef mypath = (__bridge CFStringRef)self.stringByExpandingTildeInPath;
CFArrayRef pathsToWatch = CFArrayCreate(NULL, (const void **)&mypath, 1, NULL);
FSEventStreamRef stream;
CFAbsoluteTime latency = 2.0;
assert(self.fileURL.fileIsDirectory);
stream = FSEventStreamCreate(NULL, &directoryObservingEventCallback, &context, pathsToWatch, kFSEventStreamEventIdSinceNow, latency, fileLevelEvents ? kFSEventStreamCreateFlagFileEvents : 0);
CFRelease(pathsToWatch);
FSEventStreamScheduleWithRunLoop(stream, CFRunLoopGetCurrent(), kCFRunLoopDefaultMode);
FSEventStreamStart(stream);
NSValue *token = [NSValue valueWithPointer:stream];
[self setAssociatedValue:token forKey:kCCDirectoryObservingKey];
return token;
}
- (void)stopObserving:(NSValue *)token
{
NSValue *v = [self associatedValueForKey:kCCDirectoryObservingKey];
if (!v)
v = token;
if (v)
{
FSEventStreamRef stream = v.pointerValue;
FSEventStreamStop(stream);
FSEventStreamInvalidate(stream);
FSEventStreamRelease(stream);
}
else
cc_log_debug(@"Warning: stopped observing on location which was never observed %@", self);
}
#endif
@end
@implementation NSMutableString (CoreCode)
@dynamic immutableObject;
- (NSString *)immutableObject
{
return [NSString stringWithString:self];
}
@end
@implementation NSURL (CoreCode)
@dynamic directoryContents, directoryContentsRecursive, fileExists, uniqueFile, request, mutableRequest, fileSize, directorySize, isWriteablePath, download, downloadWithCurl, contents, fileIsDirectory, fileOrDirectorySize, fileChecksumSHA, fileCreationDate, fileModificationDate; // , path
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
@dynamic fileIsAlias, fileAliasTarget, fileIsRestricted, fileIsRegularFile, fileIsSymlink;
- (NSString *)fileChecksumSHA
{
#ifdef USE_SECURITY
if (self.fileExists)
{
NSData *d = [NSData dataWithContentsOfURL:self];
unsigned char result[CC_SHA1_DIGEST_LENGTH];
CC_SHA1(d.bytes, (CC_LONG)d.length, result);
NSMutableString *ms = [NSMutableString string];
for (int i = 0; i < CC_SHA1_DIGEST_LENGTH; i++)
{
[ms appendFormat: @"%02x", (int)(result [i])];
}
return [ms copy];
}
else
return @"NoFile";
#else
return @"Unvailable";
#endif
}
- (BOOL)fileIsRestricted
{
struct stat info;
lstat(self.path.UTF8String, &info);
return (info.st_flags & SF_RESTRICTED) > 0;
}
- (BOOL)fileIsAlias
{
CFURLRef cfurl = (__bridge CFURLRef) self;
CFBooleanRef aliasBool = kCFBooleanFalse;
Boolean success = CFURLCopyResourcePropertyForKey(cfurl, kCFURLIsAliasFileKey, &aliasBool, NULL);
Boolean alias = CFBooleanGetValue(aliasBool);
return alias && success;
}
- (BOOL)fileIsRegularFile
{
NSNumber *value;
[self getResourceValue:&value forKey:NSURLIsRegularFileKey error:NULL];
return value.boolValue;
}
- (BOOL)fileIsSymlink
{
CFURLRef cfurl = (__bridge CFURLRef) self;
CFBooleanRef aliasBool = kCFBooleanFalse;
Boolean success = CFURLCopyResourcePropertyForKey(cfurl, kCFURLIsSymbolicLinkKey, &aliasBool, NULL);
Boolean alias = CFBooleanGetValue(aliasBool);
return alias && success;
}
- (BOOL)fileIsDirectory
{
NSNumber *value;
[self getResourceValue:&value forKey:NSURLIsDirectoryKey error:NULL];
return value.boolValue;
}
- (BOOL)fileIsBundle
{
NSNumber *value;
[self getResourceValue:&value forKey:NSURLIsPackageKey error:NULL];
return value.boolValue;
}
- (NSURL *)fileAliasTarget
{
CFErrorRef *err = NULL;
CFDataRef bookmark = CFURLCreateBookmarkDataFromFile(NULL, (__bridge CFURLRef)self, err);
if (bookmark == nil)
return nil;
CFURLRef url = CFURLCreateByResolvingBookmarkData (NULL, bookmark, kCFBookmarkResolutionWithoutUIMask, NULL, NULL, NULL, err);
__autoreleasing NSURL *nurl = [(__bridge NSURL *)url copy];
CFRelease(bookmark);
CFRelease(url);
return nurl;
}
#endif
- (NSData *)readFileHeader:(NSUInteger)maximumByteCount
{
int fd = open(self.path.UTF8String, O_RDONLY);
if (fd == -1)
return nil;
NSUInteger length = maximumByteCount;
NSMutableData *data = [[NSMutableData alloc] initWithLength:length];
if (data)
{
void *buffer = [data mutableBytes];
long actualBytes = read(fd, buffer, length);
if (actualBytes <= 0)
data = nil;
else if ((NSUInteger)actualBytes < length)
[data setLength:(NSUInteger)actualBytes];
}
close(fd);
return data;
}
- (NSURLRequest *)request
{
return [NSURLRequest requestWithURL:self];
}
- (NSMutableURLRequest *)mutableRequest
{
return [NSMutableURLRequest requestWithURL:self];
}
- (NSURL *)add:(NSString *)component
{
return [self URLByAppendingPathComponent:component];
}
- (NSArray <NSURL *> *)directoryContents
{
assert(fileManager);
if (!self.fileURL) return nil;
NSString *path = self.path;
NSError *err;
NSArray *c = [fileManager contentsOfDirectoryAtPath:path error:&err];
return [c mapped:^id (NSString *input) { return [self URLByAppendingPathComponent:input]; }];
}
- (NSArray <NSURL *> *)directoryContentsRecursive
{
assert(fileManager);
NSDirectoryEnumerator *enumerator = [fileManager
enumeratorAtURL:self
includingPropertiesForKeys:nil
options:0
errorHandler:^(NSURL *url, NSError *error) { return YES; }];
return enumerator.allObjects;
}
- (NSURL *)uniqueFile
{
if (!self.fileURL) return nil;
return self.path.uniqueFile.fileURL;
}
- (BOOL)fileExists
{
assert(fileManager);
NSString *path = self.path;
return self.fileURL && [fileManager fileExistsAtPath:path];
}
- (unsigned long long)fileOrDirectorySize
{
return (self.fileIsDirectory ? self.directorySize : self.fileSize);
}
- (NSDate *)fileCreationDate
{
NSDate *date;
if ([self getResourceValue:&date forKey:NSURLCreationDateKey error:nil])
return date;
else
return nil;
}
- (NSDate *)fileModificationDate
{
NSDate *date;
if ([self getResourceValue:&date forKey:NSURLContentModificationDateKey error:nil])
return date;
else
return nil;
}
- (unsigned long long)fileSize
{
NSNumber *size;
if ([self getResourceValue:&size forKey:NSURLFileSizeKey error:nil])
return size.unsignedLongLongValue;
else
return 0;
}
- (unsigned long long)directorySize
{
assert(fileManager);
unsigned long long directorySize = 0;
NSDirectoryEnumerator *enumerator = [fileManager
enumeratorAtURL:self
includingPropertiesForKeys:@[NSURLIsDirectoryKey, NSURLFileSizeKey]
options:0
errorHandler:^(NSURL *url, NSError *error) { return YES; }];
for (NSURL *url in enumerator)
{
NSDictionary *values = [url resourceValuesForKeys:@[NSURLIsDirectoryKey, NSURLFileSizeKey] error:NULL];
if (values)
{
NSNumber *isDir = values[NSURLIsDirectoryKey];
if (!isDir.boolValue)
{
NSNumber *fileSize = values[NSURLFileSizeKey];
directorySize += fileSize.unsignedLongLongValue;
}
}
}
return directorySize;
}
- (void)open
{
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
[NSWorkspace.sharedWorkspace openURL:self];
#else
[UIApplication.sharedApplication openURL:self options:@{} completionHandler:NULL];
#endif
}
- (BOOL)isWriteablePath
{
assert(fileManager);
if (self.fileExists)
return NO;
if (![@"TEST" writeToURL:self atomically:YES encoding:NSUTF8StringEncoding error:NULL])
return NO;
[fileManager removeItemAtURL:self error:NULL];
return YES;
}
- (NSData *)download
{
#if defined(DEBUG) && !defined(SKIP_MAINTHREADDOWNLOAD_WARNING) && !defined(CLI)
if ([NSThread currentThread] == [NSThread mainThread] && !self.isFileURL)
LOG(@"Warning: performing blocking download on main thread")
#endif
NSData *d = [NSData dataWithContentsOfURL:self];
return d;
}
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
- (NSString *)downloadWithCurl
{
NSString *urlString = self.absoluteString;
NSString *res = [@[@"/usr/bin/curl", @"-s", urlString] runAsTask];
return res;
}
#endif
- (void)setContents:(NSData *)data
{
NSError *err;
if (!data)
cc_log(@"Error: can not write null data to file %@", self.path);
else if (![data writeToURL:self options:NSDataWritingAtomic error:&err])
cc_log(@"Error: writing data to file has failed (file: %@ data: %lu error: %@)", self.path, (unsigned long)data.length, err.description);
}
- (NSData *)contents
{
return self.download;
}
+ (NSURL *)URLWithHost:(NSString *)host path:(NSString *)path query:(NSString *)query
{
return [NSURL URLWithHost:host path:path query:query user:nil password:nil fragment:nil scheme:@"https" port:nil];
}
+ (NSURL *)URLWithHost:(NSString *)host path:(NSString *)path query:(NSString *)query user:(NSString *)user password:(NSString *)password fragment:(NSString *)fragment scheme:(NSString *)scheme port:(NSNumber *)port
{
assert([path hasPrefix:@"/"]);
assert(![query contains:@"k9BBV15zFYi44YyB"]);
query = [query replaced:@"+" with:@"k9BBV15zFYi44YyB"];
NSURLComponents *urlComponents = [NSURLComponents new];
urlComponents.scheme = scheme;
urlComponents.host = host;
urlComponents.path = path;
urlComponents.query = query;
urlComponents.user = user;
urlComponents.password = password;
urlComponents.fragment = fragment;
urlComponents.port = port;
urlComponents.percentEncodedQuery = [urlComponents.percentEncodedQuery replaced:@"k9BBV15zFYi44YyB" with:@"%2B"];
NSURL *url = urlComponents.URL;
assert(url);
return url;
}
- (NSData *)performBlockingPOST:(double)timeoutSeconds
{
__block NSData *data;
dispatch_semaphore_t sem = dispatch_semaphore_create(0);
[self performPOST:^(NSData *d)
{
data = d;
dispatch_semaphore_signal(sem);
}];
dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(timeoutSeconds * NSEC_PER_SEC));
long res = dispatch_semaphore_wait(sem, popTime);
if (res == 0)
return data;
else
return nil; // got timeout
}
- (NSData *)performBlockingGET:(double)timeoutSeconds
{
__block NSData *data;
dispatch_semaphore_t sem = dispatch_semaphore_create(0);
[self performGET:^(NSData *d)
{
data = d;
dispatch_semaphore_signal(sem);
}];
dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(timeoutSeconds * NSEC_PER_SEC));
long res = dispatch_semaphore_wait(sem, popTime);
if (res == 0)
return data;
else
return nil; // got timeout
}
- (void)performGET:(void (^)(NSData *data))completion
{
NSURLSessionDataTask *dataTask = [NSURLSession.sharedSession dataTaskWithURL:self completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error)
{
completion(data);
}];
[dataTask resume];
}
- (void)performPOST:(void (^)(NSData *data))completion
{
NSURL *newURL = [NSURL URLWithHost:self.host path:self.path query:nil user:self.user
password:self.password fragment:self.fragment scheme:self.scheme port:self.port]; // don't want the query in there
NSMutableURLRequest *request = newURL.request.mutableCopy;
request.HTTPBody = self.query.data;
request.HTTPMethod = @"POST";
[request addValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"];
NSURLSessionDataTask *dataTask = [NSURLSession.sharedSession dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error)
{
completion(data);
}];
[dataTask resume];
}
@end
@implementation NSData (CoreCode)
@dynamic string, stringUTF8, hexString, base64String, mutableObject, JSONArray, JSONDictionary, fullRange;
#ifdef USE_SECURITY
@dynamic SHA1, SHA256;
#ifdef PROVIDE_DEPRECATED_MD5
@dynamic MD5;
#endif
#endif
#ifdef USE_SECURITY
- (NSString *)SHA1
{
const char *cStr = self.bytes;
unsigned char result[CC_SHA1_DIGEST_LENGTH];
CC_SHA1(cStr, (CC_LONG)self.length, result);
NSString *s = [NSString stringWithFormat:
@"%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x",
result[0], result[1], result[2], result[3], result[4],
result[5], result[6], result[7],
result[8], result[9], result[10], result[11], result[12],
result[13], result[14], result[15],
result[16], result[17], result[18], result[19]
];
return s;
}
#ifdef PROVIDE_DEPRECATED_MD5
- (NSString *)MD5
{
const char *cStr = self.bytes;
unsigned char result[CC_MD5_DIGEST_LENGTH];
CC_MD5(cStr, (CC_LONG)self.length, result);
NSString *s = [NSString stringWithFormat:
@"%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x",
result[0], result[1], result[2], result[3], result[4],
result[5], result[6], result[7],
result[8], result[9], result[10], result[11], result[12],
result[13], result[14], result[15]
];
return s;
}
#endif
- (NSString *)SHA256
{
const char *cStr = self.bytes;
unsigned char result[CC_SHA256_DIGEST_LENGTH];
CC_SHA256(cStr, (CC_LONG)self.length, result);
NSString *s = [NSString stringWithFormat:
@"%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x%02x",
result[0], result[1], result[2], result[3], result[4],
result[5], result[6], result[7],
result[8], result[9], result[10], result[11], result[12],
result[13], result[14], result[15],
result[16], result[17], result[18], result[19],
result[20], result[21], result[22], result[23],
result[24], result[25], result[26], result[27],
result[28], result[29], result[30], result[31]
];
return s;
}
#endif
#ifdef USE_SNAPPY
@dynamic snappyCompressed, snappyDecompressed;
- (NSData *)snappyDecompressed
{
size_t uncompressedSize = 0;
if (snappy_uncompressed_length(self.bytes, self.length, &uncompressedSize) != SNAPPY_OK )
{
cc_log_error(@"Error: can't calculate the uncompressed length!\n");
return nil;
}
assert(uncompressedSize);
char *buf = (char *)malloc(uncompressedSize);
assert(buf);
int res = snappy_uncompress(self.bytes, self.length, buf, &uncompressedSize);
if (res != SNAPPY_OK)
{
cc_log_error(@"Error: can't uncompress the file!\n");
free(buf);
return nil;
}
NSData *d = [NSData dataWithBytesNoCopy:buf length:uncompressedSize];
return d;
}
- (NSData *)snappyCompressed
{
size_t output_length = snappy_max_compressed_length(self.length);
char *buf = (char*)malloc(output_length);
assert(buf);
int res = snappy_compress(self.bytes, self.length, buf, &output_length);
if (res != SNAPPY_OK )
{
cc_log_error(@"Error: problem compressing the file\n");
free(buf);
return nil;
}
NSData *d = [NSData dataWithBytesNoCopy:buf length:output_length];
return d;
}
#endif
- (NSString *)string
{
NSString *result;
// warning, stringEncodingForData can crash, rdar://45371868
[NSString stringEncodingForData:self encodingOptions:nil convertedString:&result usedLossyConversion:nil];
if (result)
return result;
static const NSStringEncoding encodingsToTry[] = {NSUTF8StringEncoding, NSISOLatin1StringEncoding, NSASCIIStringEncoding, NSUnicodeStringEncoding};
int encodingCount = (sizeof(encodingsToTry) / sizeof(NSStringEncoding));
for (unsigned char i = 0; i < encodingCount; i++)
{
NSString *s = [[NSString alloc] initWithData:self encoding:encodingsToTry[i]];
if (!s)
continue;
return s;
}
if (self.length < 200)
cc_log_error(@"Error: could not create string from data %@", self);
else
cc_log_error(@"Error: could not create string from data %@", [self subdataWithRange:NSMakeRange(0,150)]);
return nil;
}
- (NSString *)stringUTF8
{
NSString *s = [[NSString alloc] initWithData:self encoding:NSUTF8StringEncoding];
#ifndef CLI
if (!s)
{
let maximumStringOutput = 100;
if (self.length <= maximumStringOutput)
cc_log_error(@"Error: could not create UTF8 string from data %@", self);
else
cc_log_error(@"Error: could not create UTF8 string from data %@", [self subdataWithRange:NSMakeRange(0, maximumStringOutput)]);
}
#endif
return s;
}
- (NSString *)base64String
{
return [self base64EncodedStringWithOptions:(NSDataBase64EncodingOptions)0];
}
- (NSString *)hexString
{
const unsigned char *dataBuffer = (const unsigned char *)self.bytes;
if (!dataBuffer)
return [NSString string];
NSUInteger dataLength = self.length;
NSMutableString *hexString = [NSMutableString stringWithCapacity:(dataLength * 2)];
for (NSUInteger i = 0; i < dataLength; ++i)
[hexString appendString:[NSString stringWithFormat:@"%02lx", (unsigned long)dataBuffer[i]]];
return [NSString stringWithString:hexString];
}
- (NSMutableData *)mutableObject
{
return [NSMutableData dataWithData:self];
}
- (id)JSONObject
{
NSError *err;
NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:self options:(NSJSONReadingOptions)0 error:&err];
if (!dict || err)
{
cc_log_error(@"Error: JSON read fails! input %@ dict %@ err %@", self, dict, err);
return nil;
}
return dict;
}
- (NSArray *)JSONArray
{
NSObject *res = [self JSONObject];
if (![res isKindOfClass:[NSArray class]])
{
#ifndef SLIENCE_JSON_UNEXPECTEDCLASS_MESSAGES
cc_log_error(@"Error: JSON read fails! input is class %@ instead of array", [[res class] description]);
#endif
return nil;
}
return res.id;
}
- (NSDictionary *)JSONDictionary
{
NSObject *res = [self JSONObject];
if (![res isKindOfClass:[NSDictionary class]])
{
#ifndef SLIENCE_JSON_UNEXPECTEDCLASS_MESSAGES
cc_log_error(@"Error: JSON read fails! input is class %@ instead of dictionary", [[res class] description]);
#endif
return nil;
}
return res.id;
}
- (NSRange)fullRange
{
return NSMakeRange(0, self.length);
}
@end
@implementation NSDate (CoreCode)
+ (NSDate *)tomorrow
{
NSDateComponents *components = NSDateComponents.new;
components.day = 1;
NSCalendar *gregorian = [[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian];
NSDate *tomorrow = [gregorian dateByAddingComponents:components toDate:NSDate.date options:0];
return tomorrow;
}
+ (NSDate *)yesterday
{
NSDateComponents *components = NSDateComponents.new;
components.day = -1;
NSCalendar *gregorian = [[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian];
NSDate *yesterday = [gregorian dateByAddingComponents:components toDate:NSDate.date options:0];
return yesterday;
}
- (NSDate *)nextDay
{
NSDateComponents *components = NSDateComponents.new;
components.day = 1;
NSCalendar *gregorian = [[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian];
NSDate *tomorrow = [gregorian dateByAddingComponents:components toDate:self options:0];
return tomorrow;
}
- (NSDate *)previousDay
{
NSDateComponents *components = NSDateComponents.new;
components.day = -1;
NSCalendar *gregorian = [[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian];
NSDate *yesterday = [gregorian dateByAddingComponents:components toDate:self options:0];
return yesterday;
}
+ (NSDate *)dateWithString:(NSString *)dateString format:(NSString *)dateFormat localeIdentifier:(NSString *)localeIdentifier
{
NSDateFormatter *df = [NSDateFormatter new];
df.dateFormat = dateFormat;
NSLocale *l = [[NSLocale alloc] initWithLocaleIdentifier:localeIdentifier];
df.locale = l;
return [df dateFromString:dateString];
}
+ (NSDate *)dateWithString:(NSString *)dateString format:(NSString *)dateFormat
{
return [self dateWithString:dateString format:dateFormat localeIdentifier:@"en_US"];
}
+ (NSDate *)dateWithPreprocessorDate:(const char *)preprocessorDateString
{
return [self dateWithString:@(preprocessorDateString) format:@"MMM d yyyy"];
}
+ (NSDate *)dateWithRFC822Date:(NSString *)rfcDateString
{
NSDateFormatter *df = NSDateFormatter.new;
df.dateFormat = @"EEE, dd MMM yyyy HH:mm:ss ZZZ";
df.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US_POSIX"];
NSDate *result = [df dateFromString:rfcDateString];
return result;
}
+ (NSDate *)dateWithISO8601Date:(NSString *)iso8601DateString
{ // there is the NSISO8601DateFormatter but its 10.12+
NSDateFormatter *df = NSDateFormatter.new;
df.dateFormat = @"yyyy-MM-dd'T'HH:mm:ss'Z'";
df.locale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US_POSIX"];
NSDate *result = [df dateFromString:iso8601DateString];
return result;
}
- (NSString *)stringUsingFormat:(NSString *)dateFormat
{
return [self stringUsingFormat:dateFormat timeZone:nil];
}
- (NSString *)stringUsingFormat:(NSString *)dateFormat timeZone:(NSTimeZone *)timeZone
{
NSDateFormatter *df = [NSDateFormatter new];
NSLocale *l = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];
df.locale = l;
df.dateFormat = dateFormat;
if (timeZone)
df.timeZone = timeZone;
return [df stringFromDate:self];
}
- (NSString *)stringUsingDateStyle:(NSDateFormatterStyle)dateStyle timeStyle:(NSDateFormatterStyle)timeStyle
{
NSDateFormatter *df = [NSDateFormatter new];
df.locale = [NSLocale currentLocale];
df.dateStyle = dateStyle;
df.timeStyle = timeStyle;
return [df stringFromDate:self];
}
- (NSString *)shortDateString
{
return [self stringUsingDateStyle:NSDateFormatterShortStyle timeStyle:NSDateFormatterNoStyle];
}
- (NSString *)shortTimeString
{
return [self stringUsingDateStyle:NSDateFormatterNoStyle timeStyle:NSDateFormatterShortStyle];
}
- (NSString *)shortDateAndTimeString
{
return [self stringUsingDateStyle:NSDateFormatterShortStyle timeStyle:NSDateFormatterShortStyle];
}
@end
@implementation NSDateFormatter (CoreCode)
+ (NSString *)formattedTimeFromTimeInterval:(NSTimeInterval)timeInterval
{
int minutes = (int)(timeInterval / 60);
int seconds = (int)(timeInterval - (minutes * 60));
if (minutes)
return makeString(@"%im %is", minutes, seconds);
else
return makeString(@"%is", (int)timeInterval);
}
@end
@implementation NSDictionary (CoreCode)
@dynamic mutableObject, XMLData, literalString, JSONData;
- (NSString *)literalString
{
NSMutableString *tmp = [NSMutableString stringWithString:@"@{"];
for (NSObject *key in self)
{
NSObject *value = self[key];
[tmp appendFormat:@"%@ : %@, ", key.literalString, value.literalString];
}
[tmp replaceCharactersInRange:NSMakeRange(tmp.length-2, 2) // replace trailing ', '
withString:@"}"]; // with terminating '}'
return tmp;
}
- (NSData *)JSONData
{
NSError *err;
NSData *data = [NSJSONSerialization dataWithJSONObject:self options:(NSJSONWritingOptions)0 error:&err];
if (!data || err)
{
cc_log_error(@"Error: JSON write fails! input %@ data %@ err %@", self, data, err);
return nil;
}
return data;
}
- (NSData *)XMLData
{
NSError *err;
NSData *data = [NSPropertyListSerialization dataWithPropertyList:self
format:NSPropertyListXMLFormat_v1_0
options:(NSPropertyListWriteOptions)0
error:&err];
if (!data || err)
{
cc_log_error(@"Error: XML write fails! input %@ data %@ err %@", self, data, err);
return nil;
}
return data;
}
- (NSMutableDictionary *)mutableObject
{
return [NSMutableDictionary dictionaryWithDictionary:self];
}
- (NSMethodSignature *)methodSignatureForSelector:(SEL)selector
{
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wselector"
return [super methodSignatureForSelector:@selector(valueForKey:)];
#pragma clang diagnostic pop
}
- (void)forwardInvocation:(NSInvocation *)invocation
{
NSString *propertyName = NSStringFromSelector(invocation.selector);
invocation.selector = @selector(valueForKey:);
[invocation setArgument:&propertyName atIndex:2];
[invocation invokeWithTarget:self];
}
- (NSDictionary *)dictionaryByReplacingNSNullWithEmptyStrings
{
NSMutableDictionary *mutableCopy = self.mutableCopy;
NSArray *keys = mutableCopy.allKeys;
for (NSUInteger idx = 0, count = keys.count; idx < count; ++idx)
{
id const key = keys[idx];
id const obj = mutableCopy[key];
if (obj == NSNull.null)
mutableCopy[key] = @"";
}
return mutableCopy.copy;
}
- (NSDictionary *)dictionaryBySettingValue:(id)value forKey:(id)key
{
NSMutableDictionary *mutable = self.mutableObject;
mutable[key] = value;
return mutable.immutableObject;
}
- (NSDictionary *)dictionaryByDeletingKey:(id)key
{
NSMutableDictionary *mutable = self.mutableObject;
[mutable removeObjectForKey:key];
return mutable.immutableObject;
}
- (NSDictionary *)dictionaryByDeletingKeys:(NSArray <NSString *>*)keys
{
NSMutableDictionary *mutable = self.mutableObject;
for (NSString *key in keys)
[mutable removeObjectForKey:key];
return mutable.immutableObject;
}
- (BOOL)containsAny:(NSArray <NSString *>*)keys
{
for (NSString *key in keys)
if (self[key] != nil)
return YES;
return NO;
}
- (BOOL)containsAll:(NSArray <NSString *>*)keys
{
for (NSString *key in keys)
if (self[key] == nil)
return NO;
return YES;
}
@end
@implementation NSMutableDictionary (CoreCode)
@dynamic immutableObject;
- (NSDictionary *)immutableObject
{
return [NSDictionary dictionaryWithDictionary:self];
}
- (void)addObject:(id)object toMutableArrayAtKey:(id)key
{
NSMutableArray *existingEntry = self[key];
if (existingEntry)
[existingEntry addObject:object];
else
self[key] = [NSMutableArray arrayWithObject:object];
}
@end
@implementation NSMutableURLRequest (CoreCode)
- (void)addBasicAuthentication:(NSString *)username password:(NSString *)password
{
NSString *authStr = makeString(@"%@:%@", username, password);
NSString *authValue = makeString(@"Basic %@", authStr.data.base64String);
[self setValue:authValue forHTTPHeaderField:@"Authorization"];
}
@end
@implementation NSURLRequest (CoreCode)
@dynamic download;
- (NSData *)download
{
return [self downloadWithTimeout:5 disableCache:YES];
}
- (NSData *)downloadWithTimeout:(double)timeoutSeconds disableCache:(BOOL)disableCache
{
NSURLRequest *request = self;
__block NSData *data;
dispatch_semaphore_t sem = dispatch_semaphore_create(0);
NSURLSession *session = NSURLSession.sharedSession;
if (disableCache)
{
NSMutableURLRequest *mutableRequest = self.mutableCopy;
if (@available(macOS 10.15, *))
mutableRequest.cachePolicy = NSURLRequestReloadIgnoringLocalAndRemoteCacheData;
else
mutableRequest.cachePolicy = NSURLRequestReloadIgnoringLocalCacheData;
NSURLSessionConfiguration *config = NSURLSessionConfiguration.defaultSessionConfiguration;
if (@available(macOS 10.15, *))
config.requestCachePolicy = NSURLRequestReloadIgnoringLocalAndRemoteCacheData;
else
config.requestCachePolicy = NSURLRequestReloadIgnoringLocalCacheData;
config.URLCache = nil;
session = [NSURLSession sessionWithConfiguration:config];
request = mutableRequest;
}
NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable d, NSURLResponse * _Nullable response, NSError * _Nullable error)
{
data = d;
dispatch_semaphore_signal(sem);
}];
[dataTask resume];
dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(timeoutSeconds * NSEC_PER_SEC));
long res = dispatch_semaphore_wait(sem, popTime);
if (res == 0)
return data;
else
return nil; // got timeout
}
@end
@implementation NSFileHandle (CoreCode)
- (float)readFloat
{
float ret;
[[self readDataOfLength:sizeof(float)] getBytes:&ret length:sizeof(float)];
return ret;
}
- (int)readInt
{
int ret;
[[self readDataOfLength:sizeof(int)] getBytes:&ret length:sizeof(int)];
return ret;
}
@end
@implementation NSLocale (CoreCode)
+ (NSArray *)preferredLanguages2Letter
{
static NSMutableArray *languageCodes;
ONCE_PER_FUNCTION(^
{
languageCodes = makeMutableArray();
for (NSString *l in NSLocale.preferredLanguages)
{
NSDictionary *d = [NSLocale componentsFromLocaleIdentifier:l];
NSString *twoLetterCode = d[NSLocaleLanguageCode];
[languageCodes addObject:twoLetterCode];
}
})
return languageCodes;
}
+ (NSArray *)preferredLanguages3Letter
{
NSDictionary *iso2LetterTo3Letter = @{@"aa" : @"aar", @"ab" : @"abk", @"ae" : @"ave", @"af" : @"afr", @"ak" : @"aka", @"am" : @"amh", @"an" : @"arg", @"ar" : @"ara", @"as" : @"asm", @"av" : @"ava", @"ay" : @"aym", @"az" : @"aze", @"ba" : @"bak", @"be" : @"bel", @"bg" : @"bul", @"bh" : @"bih", @"bi" : @"bis", @"bm" : @"bam", @"bn" : @"ben", @"bo" : @"tib", @"bo" : @"tib", @"br" : @"bre", @"bs" : @"bos", @"ca" : @"cat", @"ce" : @"che", @"ch" : @"cha", @"co" : @"cos", @"cr" : @"cre", @"cs" : @"cze", @"cs" : @"cze", @"cu" : @"chu", @"cv" : @"chv", @"cy" : @"wel", @"cy" : @"wel", @"da" : @"dan", @"de" : @"ger", @"de" : @"ger", @"dv" : @"div", @"dz" : @"dzo", @"ee" : @"ewe", @"el" : @"gre", @"el" : @"gre", @"en" : @"eng", @"eo" : @"epo", @"es" : @"spa", @"et" : @"est", @"eu" : @"baq", @"eu" : @"baq", @"fa" : @"per", @"fa" : @"per", @"ff" : @"ful", @"fi" : @"fin", @"fj" : @"fij", @"fo" : @"fao", @"fr" : @"fre", @"fr" : @"fre", @"fy" : @"fry", @"ga" : @"gle", @"gd" : @"gla", @"gl" : @"glg", @"gn" : @"grn", @"gu" : @"guj", @"gv" : @"glv", @"ha" : @"hau", @"he" : @"heb", @"hi" : @"hin", @"ho" : @"hmo", @"hr" : @"hrv", @"ht" : @"hat", @"hu" : @"hun", @"hy" : @"arm", @"hy" : @"arm", @"hz" : @"her", @"ia" : @"ina", @"id" : @"ind", @"ie" : @"ile", @"ig" : @"ibo", @"ii" : @"iii", @"ik" : @"ipk", @"io" : @"ido", @"is" : @"ice", @"is" : @"ice", @"it" : @"ita", @"iu" : @"iku", @"ja" : @"jpn", @"jv" : @"jav", @"ka" : @"geo", @"ka" : @"geo", @"kg" : @"kon", @"ki" : @"kik", @"kj" : @"kua", @"kk" : @"kaz", @"kl" : @"kal", @"km" : @"khm", @"kn" : @"kan", @"ko" : @"kor", @"kr" : @"kau", @"ks" : @"kas", @"ku" : @"kur", @"kv" : @"kom", @"kw" : @"cor", @"ky" : @"kir", @"la" : @"lat", @"lb" : @"ltz", @"lg" : @"lug", @"li" : @"lim", @"ln" : @"lin", @"lo" : @"lao", @"lt" : @"lit", @"lu" : @"lub", @"lv" : @"lav", @"mg" : @"mlg", @"mh" : @"mah", @"mi" : @"mao", @"mi" : @"mao", @"mk" : @"mac", @"mk" : @"mac", @"ml" : @"mal", @"mn" : @"mon", @"mr" : @"mar", @"ms" : @"may", @"ms" : @"may", @"mt" : @"mlt", @"my" : @"bur", @"my" : @"bur", @"na" : @"nau", @"nb" : @"nob", @"nd" : @"nde", @"ne" : @"nep", @"ng" : @"ndo", @"nl" : @"dut", @"nl" : @"dut", @"nn" : @"nno", @"no" : @"nor", @"nr" : @"nbl", @"nv" : @"nav", @"ny" : @"nya", @"oc" : @"oci", @"oj" : @"oji", @"om" : @"orm", @"or" : @"ori", @"os" : @"oss", @"pa" : @"pan", @"pi" : @"pli", @"pl" : @"pol", @"ps" : @"pus", @"pt" : @"por", @"qu" : @"que", @"rm" : @"roh", @"rn" : @"run", @"ro" : @"rum", @"ro" : @"rum", @"ru" : @"rus", @"rw" : @"kin", @"sa" : @"san", @"sc" : @"srd", @"sd" : @"snd", @"se" : @"sme", @"sg" : @"sag", @"si" : @"sin", @"sk" : @"slo", @"sk" : @"slo", @"sl" : @"slv", @"sm" : @"smo", @"sn" : @"sna", @"so" : @"som", @"sq" : @"alb", @"sq" : @"alb", @"sr" : @"srp", @"ss" : @"ssw", @"st" : @"sot", @"su" : @"sun", @"sv" : @"swe", @"sw" : @"swa", @"ta" : @"tam", @"te" : @"tel", @"tg" : @"tgk", @"th" : @"tha", @"ti" : @"tir", @"tk" : @"tuk", @"tl" : @"tgl", @"tn" : @"tsn", @"to" : @"ton", @"tr" : @"tur", @"ts" : @"tso", @"tt" : @"tat", @"tw" : @"twi", @"ty" : @"tah", @"ug" : @"uig", @"uk" : @"ukr", @"ur" : @"urd", @"uz" : @"uzb", @"ve" : @"ven", @"vi" : @"vie", @"vo" : @"vol", @"wa" : @"wln", @"wo" : @"wol", @"xh" : @"xho", @"yi" : @"yid", @"yo" : @"yor", @"za" : @"zha", @"zh" : @"chi", @"zh" : @"chi", @"zu" : @"zul"};
NSMutableArray *tmp = [NSMutableArray new];
for (NSString *twoLetterCode in [NSLocale preferredLanguages])
{
NSString *threeLetterCode = iso2LetterTo3Letter[twoLetterCode];
if (threeLetterCode)
[tmp addObject:threeLetterCode];
else
{
NSDictionary *d = [NSLocale componentsFromLocaleIdentifier:twoLetterCode];
NSString *backupTwoLetterCode = d[NSLocaleLanguageCode];
NSString *backupThreeLetterCode = iso2LetterTo3Letter[backupTwoLetterCode];
[tmp addObject:(OBJECT_OR(backupThreeLetterCode, twoLetterCode))];
}
}
return [NSArray arrayWithArray:tmp];
}
@end
@implementation NSObject (CoreCode)
@dynamic associatedValue, id, literalString;
- (void)setAssociatedValue:(id)value forKey:(const NSString *)key
{
#if TARGET_OS_IPHONE
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wdeprecated-objc-pointer-introspection"
BOOL is64Bit = sizeof(void *) == 8;
BOOL isTagged = ((uintptr_t)self & 0x1);
assert(!(is64Bit && isTagged)); // associated values on tagged pointers broken on 64 bit iOS
#pragma clang diagnostic pop
#endif
objc_setAssociatedObject(self, (__bridge const void *)(key), value, OBJC_ASSOCIATION_RETAIN);
}
- (id)associatedValueForKey:(const NSString *)key
{
id value = objc_getAssociatedObject(self, (__bridge const void *)(key));
return value;
}
- (void)setAssociatedValue:(id)value
{
[self setAssociatedValue:value forKey:kCoreCodeAssociatedValueKey];
}
- (id)associatedValue
{
return [self associatedValueForKey:kCoreCodeAssociatedValueKey];
}
+ (instancetype)newWith:(NSDictionary *)dict
{
NSObject *obj = [self new];
for (NSString *key in dict)
{
[obj setValue:dict[key] forKey:key];
}
return obj;
}
- (id)id
{
return (id)self;
}
- (NSString *)literalString
{
return makeString(@"-unsupportedLiteralObject: %@-", self.description);
}
@end
@implementation NSCharacterSet (CoreCode)
@dynamic stringRepresentation, stringRepresentationLong, mutableObject;
- (NSString *)stringRepresentation
{
NSString *tmp = @"";
unichar unicharBuffer[20];
NSUInteger index = 0;
for (unichar uc = 0; uc < (0xFFFF); uc ++)
{
if ([self characterIsMember:uc])
{
unicharBuffer[index] = uc;
index ++;
if (index == 20)
{
tmp = [tmp stringByAppendingString:[NSString stringWithCharacters:unicharBuffer length:index]];
index = 0;
}
}
}
if (index != 0)
tmp = [tmp stringByAppendingString:[NSString stringWithCharacters:unicharBuffer length:index]];
return tmp;
}
- (NSString *)stringRepresentationLong
{
NSString *tmp = @"";
for (unichar uc = 0; uc < (0xFFFF); uc++)
{
if (uc && [self characterIsMember:uc])
{
tmp = [tmp stringByAppendingString:makeString(@"unichar %i: %@\n", uc, [NSString stringWithCharacters:&uc length:1])];
}
}
return tmp;
}
- (NSMutableCharacterSet *)mutableObject
{
return [NSMutableCharacterSet characterSetWithBitmapRepresentation:self.bitmapRepresentation];
}
@end
@implementation NSMutableCharacterSet (CoreCode)
@dynamic immutableObject;
- (NSCharacterSet *)immutableObject
{
return [NSCharacterSet characterSetWithBitmapRepresentation:self.bitmapRepresentation];
}
@end
@implementation NSNumber (CoreCode)
@dynamic literalString;
- (NSString *)literalString
{
return makeString(@"@(%@)", self.description);
}
@end
@implementation NSMutableOrderedSet (CoreCode)
@dynamic immutableObject;
- (NSOrderedSet *)immutableObject
{
return [NSOrderedSet orderedSetWithOrderedSet:self];
}
@end
@implementation NSOrderedSet (CoreCode)
@dynamic mutableObject;
- (NSMutableOrderedSet *)mutableObject
{
return [NSMutableOrderedSet orderedSetWithOrderedSet:self];
}
@end
@implementation NSMutableSet (CoreCode)
@dynamic immutableObject;
- (NSSet *)immutableObject
{
return [NSSet setWithSet:self];
}
@end
@implementation NSSet (CoreCode)
@dynamic mutableObject;
- (NSMutableSet *)mutableObject
{
return [NSMutableSet setWithSet:self];
}
@end
#if defined(TARGET_OS_MAC) && TARGET_OS_MAC && !TARGET_OS_IPHONE
@implementation NSTask (CoreCode)
- (BOOL)waitUntilExitWithTimeout:(NSTimeInterval)timeout
{
NSDate *killDate = [NSDate dateWithTimeIntervalSinceNow:timeout];
BOOL killed = NO;
while (self.running)
{
if ([[NSDate date] laterDate:killDate] != killDate)
{
[self terminate];
killed = YES;
}
[NSThread sleepForTimeInterval:0.05];
}
return killed;
}
@end
#ifndef SANDBOX
@implementation NSUserDefaults (CoreCode)
- (NSString *)stringForKey:(NSString *)defaultName ofForeignApp:(NSString *)bundleID
{
if (!bundleID)
{
cc_log_error(@"Error: stringForKey:ofForeignApp: called with nil bundleID");
return nil;
}
NSString *result;
CFPropertyListRef value = CFPreferencesCopyAppValue((CFStringRef)defaultName, (CFStringRef)bundleID);
if (value && CFGetTypeID(value) == CFStringGetTypeID())
{
result = [(__bridge NSString *)value copy];
CFRelease(value);
}
else if (value)
CFRelease(value);
return result;
}
- (NSObject *)objectForKey:(NSString *)defaultName ofForeignApp:(NSString *)bundleID
{
if (!bundleID)
{
cc_log_error(@"Error: objectForKey:ofForeignApp: called with nil bundleID");
return nil;
}
NSString *result;
CFPropertyListRef value = CFPreferencesCopyAppValue((CFStringRef)defaultName, (CFStringRef)bundleID);
if (value)
{
result = [(__bridge NSObject *)value copy];
CFRelease(value);
}
return result;
}
@end
#endif
#endif
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment