【たのしいCocoa】07_文字列

// C文字列
char* cString = "This is C string";
// NSString インスタンス
NSString* string = @"This is NSString";

+ (id) stringWithCString:(const cha*)cString
　encoding:(NSStringEncoding)encoding
- initWithCString:(const char*)cString
　encoding:(NSStringEncoding)encoding
C言語の文字列 cString と、そのテキストエンコーディング encoding を指定して、インスタンスを作る。

NSString* jpString;
jpString = [NSString stringWithCString:"日本語文字列"
	encoding:NSShiftJISStringEncoding];

+ (id) stringWithFormat:(NSString*)format...
- (id) initWithFormat:(NSString*)format...
フォーマット format を指定して、インスタンスを作る

NSString* stringA;
string = @"Mac";
 
// NSString のインスタンスを指定して、文字列を作る
NSString* stringB;
stringB = [NSString stringWithFormat:@"%@ Pro", stringA];
NSLog(stringB);
// stringB は、"Mac Pro"になる
// 整数を指定して文字列を作る
int i = 80;
NSString* stringC;
stringC = [NSStringWithFormat:@"%d%%", i];
NSLog(stringD);
// stringD は"0x50"になる

type struct _NSRange {
　unsigned int location;
　unsigned int length;
} NSRange;

NSMakeRange(unsigned int location, unsigned int length);
範囲のスタート位置 location と、長さ length を指定して、NSRange を作る

// NSRange を作る
NSRange range = NSMakeRange(0,5);
NSLog(@"location is %d, length is %d", range.location, range.length);

NSString* string;
string = @"Mac OS X";
 
unsigned int length;
length = [string length];
NSLog(@"length is %d", length);
// length は8になる

- (NSString*)stringByAppendingString:(NSString*)string
自分自身に、文字列 string を連結した新しい文字列を作成して返す
- (NSString)stringByAppendingFormat:(NSString*)format,...
自分自身に、format で指定された文字列を連結した新しい文字列を作成して、返す。

NSString* stringA = @"Mac OS X";
NSString* stringB = @"Leopard";
 
// stringA と stringB をつなげる
NSString* stringC = [stringA stringByAppendingString:stringB];
NSLog(stringC);
// stringC は、"Mac OS X Leopard"となる
 
//　stringBに、文字列をつなげる
NSString* stringD = [stringB stringByAppendingFormat:@" %d.%d, 10, 5];
NSLog(stringD);
// stringD は、"Leopard 10.5"となる

// stringA と stringB から、文字列を作成する
NSString* stringE = [NSString stringWithFormat:@"%@%@", stringA, stringB];
NSLog(stringE);
// stringE は、"Mac OS X Leopard"となる

+ (id) string
空文字列のインスタンスを作る
+ (id) stringWithString:(NSString*)string
- (id) initWithString:(NSString*)string
文字列 string と同じ内容のインスタンスを作る

// 文字列を指定して、NSMutableString を作る。
NSMutableString* string = [NSMutableString stringWithString:@"Mac OS X"];

- (void) appendString:(NSString*)string
文字列 string を追加する
- (void) appendFormat:(NSString*)format, ...
format で指定された文字列を追加する

// 空文字列を作成する
NSMutableString* string = [NSMutableString string];
 
// 文字列を追加する
[string appendString:@"Mac "];
[string appendString:@"OS "];
[string appendString:@"X"];
NSLog(string);
// 最終的に文字列は、"Mac OS X"になる

- (void) insertString:(NSString*)string atIndex:(insigned)index
文字列 string をインデックス index に挿入する

// 文字列を作成する
NSMutableString* string = [NSMutableString stringWithString:@"Mac X"];
 
// 文字列を挿入する
[string insertString:@"OS " atIndex:4];
NSLog(string);
// 文字列は、"Mac OS X"になる

- (void) deleteCharacterInRange:(NSRange)range
範囲 range で指定した文字列を削除する

// 文字列を作成する
NSMutableString* string = [NSMutableString stringWithString:@"Mac"];
// 範囲を指定して、文字列を削除する
[string deleteCharacterInRange:NSMakeRange(0,1)];
NSLog(string);
// 文字列は、"ac"になる

- (BOOL) isEqualToString:(NSString*)string
文字列 string が、こも文字列と等しかったら YES 、違っていたら NO を返す

NSString* stringA = @"Mac OS X";
NSString* stringB = @"Mac OS X";
NSString* stringC = @"Windows";
BOOL result;
 
// 文字列を比較する
result = [stringA isEqualToString:stringB];
// この結果は YES になる
 
result = [stringA isEqualToString:stringC];
// この結果は NO になる

- (BOOL)hasPrefix:(NSString*)string
この文字列が、文字列 string で始まっているなら YES、そうでないなら NO を返します。
- (BOOL) hasSuffix:(NSString*)string
この文字列が、文字列 string で終わっているなら YES、そうでないなら NO を返す。

NSString* stringA = @"Mac Pro";
NSString* stringB = @"MacBook";
BOOL result;
 
// 前置子を調べる
result = [stringA hasPrefix:@"Mac"];
result = [stringB hasPrefix:@"Mac"];
// 両方とも結果は YES になる
 
// 後置子を調べる
result = [stringA hasPrefix:@"Pro"];
result = [stringB hasPrefix:@"Pro"];
// 前者は YES 、後者は NO になる。

- (NSRange) rangeOfString:(NSString)subString
- (NSRange) rangeOfString:(NSString)subString options:(insigned)mask
- (NSRange) rangeOfString:(NSString)subString options:(unsigned)mask range:(NSRange)range
この文字列の検索をして、文字列 subString がある範囲を返す。検索のためのオプションを mask として指定することや、検索の範囲を range で指定することができる。

NSString* string = @"This is Mac OS X";
 
// 文字列を検索する
NSRange range;
range = [string rangeOfString:"Mac OS X"];
 
// 見つかった場合
if (range.location != NSNotFound) {
　NSLog(@"Found at Location=%d, length=%d", range.location, range.length);
}
// 見つからなかった場合
else {
　NSLog(@"Not found");
}

- (NSString*) substringToIndex:(unsigned)index
この文字列の、先頭からインデックス index までの文字列を返す。
- (NSString*) substringFromIndex:(unsigned)index
この文字列の、インデックスか index から最後までの文字列を返す。
- (NSString*) substringWithIndex:(unsigned)index
この文字列の、範囲 range に含まれる文字列を返す。

NSString* string = @"Happy Cocoa Programing";
 
// 先頭から文字列を取り出す
NSString* stringA;
stringA = [string substringToIndex:5];
NSLog(stringA);
// stringA は、"Happy"となる
 
// 最後までの文字列を取り出す
NSString* stringB;
stringB = [string substringFromIndex:12];
NSLog(stringB);
// stringB は、"Prigraming"となる
 
// 範囲を指定して文字列を取り出す
NSString* stringC;
stringC = [string substringWithRange:NSMakeRange(6,5)];
NSLog(stringC);
// stringC は、"Cocoa"となる

+ (id) stringWithContentsOfFile:(NSString*)path
　encoding:(NSStringEncoding)encoding
　error:(NSError**)error
- (id) initWithContentsOfFile:(NSString*)path
　encoding:(NSStringEncoding)encoding
　error:(NSError**)error
テキストファイルのパス path とエンコーディング encoding を指定して、ファイルを読み込む。読み込みに失敗した場合、エラー error が返る。

// テキストファイルを読み込む
// path には適切なパスを指定する
NSString* text;
NSString* path = @"/Users/local/test.txt";
NSError* error;
text = [NSString stringWithContentsOfFile:path
　encoding:NSUTF8StringEncoding error:&error];
if (text) {
　// 読み込みが成功した場合
}
else {
　// 読み込みが失敗した場合
　NSLog([error localizedDescription]);
}

- (BOOL) writeToFile:(NSString*)path
　atomically:(BOOL)useAuxiliaryFile
　encoding:(NSStringEncoding)encoding
　error:(NSError**)error;
パス path とエンコーディング encoding を指定して、テキストをファイルに書き出す。補助ファイルを使うかどうか、useAuxiliaryFile で指定する。書き出しに失敗した場合、エラー error が返る。

// テキストファイルへ書き出す
// path には適切なパスを指定する
NSString* text = @"Cocoa programming";
NSString* path = @"/Users/local/test.txt";
NSError* error;
 
BOOL result;
result = [text writeToFile:path atomically:YES encoding:NSUTF8StringEncodng error:&error];
if (result) {
　// 書き出しが成功した場合
}
else {
　// 書き出しが失敗した場合
NSLog([error localizedDescription]);
}