Difference between revisions of "NSMutableString"

From GNUstepWiki
Jump to navigation Jump to search
 
 
(One intermediate revision by one other user not shown)
Line 11: Line 11:
 
The simplest way to edit a string is by appending to the end of the string, as shown here:
 
The simplest way to edit a string is by appending to the end of the string, as shown here:
  
   NSMutableString *str = @"short string";
+
   NSMutableString *str = [NSMutableString stringWithString: @"short string"];
 
   [str appendString: @" made longer"];
 
   [str appendString: @" made longer"];
 
   // str is now = @"short string made longer"
 
   // str is now = @"short string made longer"
Line 17: Line 17:
 
C style formating flags can also be used as follows:
 
C style formating flags can also be used as follows:
  
   NSMutableString *str = @"short string";
+
   NSMutableString *str = [NSMutableString stringWithString: @"short string"];
 
   [str appendFormat: @" made longer %@.", @"with formating"];
 
   [str appendFormat: @" made longer %@.", @"with formating"];
 
   // str is now = @"short string made longer with formating."
 
   // str is now = @"short string made longer with formating."
Line 25: Line 25:
 
The more advanced method of adding to strings in by insertion, as demonstrated here:
 
The more advanced method of adding to strings in by insertion, as demonstrated here:
  
   NSMutableString *str = @"a string";
+
   NSMutableString *str = [NSMutableString stringWithString: @"a string"];
 
   [str insertString: @"new " atIndex: 2];
 
   [str insertString: @"new " atIndex: 2];
 
   // str is now = @"a new string"
 
   // str is now = @"a new string"
Line 33: Line 33:
 
A certain substring can be replaced with a new one as follows:
 
A certain substring can be replaced with a new one as follows:
  
   NSMutableString *str = @"a old string";
+
   NSMutableString *str = [NSMutableString stringWithString: @"a old string"];
 
   [str replaceString: @"old" withString: @"new];
 
   [str replaceString: @"old" withString: @"new];
 
   // str is now = @"a new string"
 
   // str is now = @"a new string"
Line 39: Line 39:
 
This can also be done with ranges:
 
This can also be done with ranges:
  
   NSMutableString *str = @"a old string";
+
   NSMutableString *str = [NSMutableString stringWithString: @"a old string"];
  NSRange range = {2, 3};
 
 
   // start at index 2 and include the next 3 characters
 
   // start at index 2 and include the next 3 characters
   [str replaceCharactersInRange: range withString: @"new];
+
   [str replaceCharactersInRange: NSMakeRange(2, 3) withString: @"new];
 
   // str is now = @"a new string"
 
   // str is now = @"a new string"
 +
 +
 +
[[Category:Foundation]]
 +
[[Category:Snippets]]

Latest revision as of 04:50, 12 May 2009

NSMutableString inherits from NSString, but includes methods for changing the string.

Editing Strings

Adding To Strings

Strings can be added on to by appending the new substring to the end, or by inserting it any where in the middle.

Appending Strings

The simplest way to edit a string is by appending to the end of the string, as shown here:

 NSMutableString *str = [NSMutableString stringWithString: @"short string"];
 [str appendString: @" made longer"];
 // str is now = @"short string made longer"

C style formating flags can also be used as follows:

 NSMutableString *str = [NSMutableString stringWithString: @"short string"];
 [str appendFormat: @" made longer %@.", @"with formating"];
 // str is now = @"short string made longer with formating."

Inserting Substrings

The more advanced method of adding to strings in by insertion, as demonstrated here:

 NSMutableString *str = [NSMutableString stringWithString: @"a string"];
 [str insertString: @"new " atIndex: 2];
 // str is now = @"a new string"

Replacing Substrings

A certain substring can be replaced with a new one as follows:

 NSMutableString *str = [NSMutableString stringWithString: @"a old string"];
 [str replaceString: @"old" withString: @"new];
 // str is now = @"a new string"

This can also be done with ranges:

 NSMutableString *str = [NSMutableString stringWithString: @"a old string"];
 // start at index 2 and include the next 3 characters
 [str replaceCharactersInRange: NSMakeRange(2, 3) withString: @"new];
 // str is now = @"a new string"