NSString.h

Go to the documentation of this file.

//
//  NSString.h
//  FoundationExtension
//
//  Created by Jeong YunWon on 10. 10. 17..
//  Copyright 2010 youknowone.org All rights reserved.
//

#import <Foundation/Foundation.h>

#import <FoundationExtension/NSMacro.h>

NS_ASSUME_NONNULL_BEGIN

@interface NSString (Creations)

- (instancetype)initWithInteger:(NSInteger)value;

- (instancetype)initWithConcatnatingStrings:(NSString *)first, ... NS_REQUIRES_NIL_TERMINATION;

+ (instancetype)stringWithInteger:(NSInteger)value;

+ (instancetype)stringWithFormat:(NSString *)format arguments:(va_list)argList NS_FORMAT_FUNCTION(1,0);

+ (nullable instancetype)stringWithData:(NSData *)data encoding:(NSStringEncoding)encoding;

+ (instancetype)stringWithConcatnatingStrings:(NSString *)first, ... NS_REQUIRES_NIL_TERMINATION;

@end


@interface NSString (Shortcuts)

- (NSString *)format:(id)first, ...;
- (NSString *)format0:(nullable id)dummyLikeNil, ...;

- (NSRange)range;

- (NSString *)substringFromIndex:(NSUInteger)from length:(NSUInteger)length;
- (NSString *)substringFromIndex:(NSUInteger)from toIndex:(NSUInteger)to;

- (NSString *)stringByTrimmingWhitespaceCharacters;
- (NSString *)stringByTrimmingWhitespaceAndNewlineCharacters;
- (NSString *)stringByTrimmingNewlineCharacters;

@end


@interface NSString (NSUTF8StringEncoding)

+ (instancetype)stringWithUTF8Data:(NSData *)data;

- (nullable NSData *)dataUsingUTF8Encoding;

@end


@interface NSString (Evaluation)

- (NSInteger)integerValueBase:(NSInteger)radix;
- (NSInteger)hexadecimalValue;

@end


@interface NSString (RegularExpression)

#define _Nullable

- (nullable NSString *)stringByReplacingRegularExpressionWithPattern:pattern withTemplate:(nonnull NSString *)templ error:(NSError * _Nullable __autoreleasing * _Nullable)error;

@end


@interface NSData (NSStringUTF8)

@property(nonatomic, readonly) NSString *stringUsingUTF8Encoding;

@end


@interface NSString (Deprecation)

- (BOOL)hasSubstring:(NSString *)aString __deprecated;

@end

NS_ASSUME_NONNULL_END