org.rococoa.cocoa.foundation.categories
Interface NSStringExtensionMethods

All Superinterfaces:
ObjCObject

public interface NSStringExtensionMethods
extends ObjCObject

This file was autogenerated by JNAerator,
a tool written by Olivier Chafik that uses a few opensource projects..
For help, please visit NativeLibs4Java, Rococoa, or JNA.


Nested Class Summary
static interface NSStringExtensionMethods._static_
           
 
Method Summary
 boolean boolValue()
          Skips initial space characters (whitespaceSet), or optional -/+ sign followed by zeroes.
 boolean canBeConvertedToEncoding(int encoding)
          Original signature : -(BOOL)canBeConvertedToEncoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:208
 NSString capitalizedString()
          Original signature : -(NSString*)capitalizedString
from NSStringExtensionMethods native declaration : NSString.h:162
 NSObject caseInsensitiveCompare(NSString string)
          Original signature : -(id)caseInsensitiveCompare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:106
 NSString commonPrefixWithString_options(NSString aString, int mask)
          Original signature : -(NSString*)commonPrefixWithString:(NSString*) options:(NSStringCompareOptions)
from NSStringExtensionMethods native declaration : NSString.h:158
 NSObject compare_options(NSString string, int mask)
          Original signature : -(id)compare:(NSString*) options:(NSStringCompareOptions)
from NSStringExtensionMethods native declaration : NSString.h:103
 NSObject compare(NSString string)
          Original signature : -(id)compare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:102
 NSArray componentsSeparatedByCharactersInSet(NSCharacterSet separator)
          Original signature : -(NSArray*)componentsSeparatedByCharactersInSet:(NSCharacterSet*)
from NSStringExtensionMethods native declaration : NSString.h:155
 NSArray componentsSeparatedByString(NSString separator)
          Original signature : -(NSArray*)componentsSeparatedByString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:153
 String cStringUsingEncoding(int encoding)
          Methods to convert NSString to a NULL-terminated cString using the specified encoding.
 NSData dataUsingEncoding_allowLossyConversion(int encoding, boolean lossy)
          External representation
Original signature : -(NSData*)dataUsingEncoding:(NSStringEncoding) allowLossyConversion:(BOOL)
from NSStringExtensionMethods native declaration : NSString.h:205
 NSData dataUsingEncoding(int encoding)
          External representation
Original signature : -(NSData*)dataUsingEncoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:206
 NSString decomposedStringWithCanonicalMapping()
          Original signature : -(NSString*)decomposedStringWithCanonicalMapping
from NSStringExtensionMethods native declaration : NSString.h:236
 NSString decomposedStringWithCompatibilityMapping()
          Original signature : -(NSString*)decomposedStringWithCompatibilityMapping
from NSStringExtensionMethods native declaration : NSString.h:238
 double doubleValue()
          The following convenience methods all skip initial space characters (whitespaceSet) and ignore trailing characters.
 int fastestEncoding()
           
 float floatValue()
          Original signature : -(float)floatValue
from NSStringExtensionMethods native declaration : NSString.h:145
 boolean getCString_maxLength_encoding(ByteBuffer buffer, NSUInteger maxBufferCount, int encoding)
          NO return if conversion not possible due to encoding errors or too small of a buffer.
 boolean getCString_maxLength_encoding(Pointer buffer, NSUInteger maxBufferCount, int encoding)
          Deprecated. use the safer methods getCString_maxLength_encoding(java.nio.ByteBuffer, org.rococoa.cocoa.foundation.NSUInteger, int) and getCString_maxLength_encoding(com.sun.jna.Pointer, org.rococoa.cocoa.foundation.NSUInteger, int) instead
 NSUInteger hash()
          Original signature : -(NSUInteger)hash
from NSStringExtensionMethods native declaration : NSString.h:198
 boolean hasPrefix(NSString aString)
          Original signature : -(BOOL)hasPrefix:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:116
 boolean hasSuffix(NSString aString)
          Original signature : -(BOOL)hasSuffix:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:117
 NSString init()
          In general creation methods in NSString do not apply to subclassers, as subclassers are assumed to provide their own init methods which create the string in the way the subclass wishes.
 NSString initWithBytes_length_encoding(Pointer bytes, NSUInteger len, int encoding)
          Original signature : -(id)initWithBytes:(const void*) length:(NSUInteger) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:283
 NSString initWithBytesNoCopy_length_encoding_freeWhenDone(Pointer bytes, NSUInteger len, int encoding, boolean freeBuffer)
          "NoCopy" is a hint
Original signature : -(id)initWithBytesNoCopy:(void*) length:(NSUInteger) encoding:(NSStringEncoding) freeWhenDone:(BOOL)
from NSStringExtensionMethods native declaration : NSString.h:285
 NSString initWithCharacters_length(char[] characters, NSUInteger length)
          Original signature : -(id)initWithCharacters:(const unichar*) length:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:275
 NSString initWithCharacters_length(CharByReference characters, NSUInteger length)
          Deprecated. use the safer methods initWithCharacters_length(char[], org.rococoa.cocoa.foundation.NSUInteger) and initWithCharacters_length(com.ochafik.lang.jnaerator.runtime.CharByReference, org.rococoa.cocoa.foundation.NSUInteger) instead
 NSString initWithCharactersNoCopy_length_freeWhenDone(CharBuffer characters, NSUInteger length, boolean freeBuffer)
          "NoCopy" is a hint
Original signature : -(id)initWithCharactersNoCopy:(unichar*) length:(NSUInteger) freeWhenDone:(BOOL)
from NSStringExtensionMethods native declaration : NSString.h:274
 NSString initWithCharactersNoCopy_length_freeWhenDone(CharByReference characters, NSUInteger length, boolean freeBuffer)
          Deprecated. use the safer methods initWithCharactersNoCopy_length_freeWhenDone(java.nio.CharBuffer, org.rococoa.cocoa.foundation.NSUInteger, boolean) and initWithCharactersNoCopy_length_freeWhenDone(com.ochafik.lang.jnaerator.runtime.CharByReference, org.rococoa.cocoa.foundation.NSUInteger, boolean) instead
 NSString initWithContentsOfFile_encoding_error(NSString path, int enc, PointerByReference error)
          Original signature : -(id)initWithContentsOfFile:(NSString*) encoding:(NSStringEncoding) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:302
 NSString initWithContentsOfFile_usedEncoding_error(NSString path, IntBuffer enc, PointerByReference error)
          Original signature : -(id)initWithContentsOfFile:(NSString*) usedEncoding:(NSStringEncoding*) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:309
 NSString initWithContentsOfFile_usedEncoding_error(NSString path, IntByReference enc, PointerByReference error)
          Deprecated. use the safer methods initWithContentsOfFile_usedEncoding_error(org.rococoa.cocoa.foundation.NSString, java.nio.IntBuffer, com.sun.jna.ptr.PointerByReference) and initWithContentsOfFile_usedEncoding_error(org.rococoa.cocoa.foundation.NSString, com.sun.jna.ptr.IntByReference, com.sun.jna.ptr.PointerByReference) instead
 NSString initWithContentsOfURL_encoding_error(NSURL url, int enc, PointerByReference error)
          These use the specified encoding.
 NSString initWithContentsOfURL_usedEncoding_error(NSURL url, IntBuffer enc, PointerByReference error)
          These try to determine the encoding, and return the encoding which was used.
 NSString initWithContentsOfURL_usedEncoding_error(NSURL url, IntByReference enc, PointerByReference error)
          Deprecated. use the safer methods initWithContentsOfURL_usedEncoding_error(org.rococoa.cocoa.foundation.NSURL, java.nio.IntBuffer, com.sun.jna.ptr.PointerByReference) and initWithContentsOfURL_usedEncoding_error(org.rococoa.cocoa.foundation.NSURL, com.sun.jna.ptr.IntByReference, com.sun.jna.ptr.PointerByReference) instead
 NSString initWithCString_encoding(Pointer nullTerminatedCString, int encoding)
          Deprecated. use the safer methods initWithCString_encoding(java.lang.String, int) and initWithCString_encoding(com.sun.jna.Pointer, int) instead
 NSString initWithCString_encoding(String nullTerminatedCString, int encoding)
          Original signature : -(id)initWithCString:(const char*) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:296
 NSString initWithData_encoding(NSData data, int encoding)
          Original signature : -(id)initWithData:(NSData*) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:282
 NSString initWithFormat_locale(NSString format, ObjCObject locale, NSObject... varargs)
          Original signature : -(id)initWithFormat:(NSString*) locale:(id), ...
 NSString initWithFormat(NSString format, NSObject... varargs)
          Original signature : -(id)initWithFormat:(NSString*), ...
 NSString initWithString(NSString aString)
          Original signature : -(id)initWithString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:277
 NSString initWithUTF8String(Pointer nullTerminatedCString)
          Deprecated. use the safer methods initWithUTF8String(java.lang.String) and initWithUTF8String(com.sun.jna.Pointer) instead
 NSString initWithUTF8String(String nullTerminatedCString)
          Original signature : -(id)initWithUTF8String:(const char*)
from NSStringExtensionMethods native declaration : NSString.h:276
 NSInteger integerValue()
          Original signature : -(NSInteger)integerValue
from NSStringExtensionMethods native declaration : NSString.h:148
 int intValue()
          Original signature : -(int)intValue
from NSStringExtensionMethods native declaration : NSString.h:146
 boolean isEqualToString(NSString aString)
          Original signature : -(BOOL)isEqualToString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:114
 NSUInteger lengthOfBytesUsingEncoding(int enc)
          Result in O(n) time; the result is exact.
 NSObject localizedCaseInsensitiveCompare(NSString string)
          Original signature : -(id)localizedCaseInsensitiveCompare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:108
 NSObject localizedCompare(NSString string)
          Original signature : -(id)localizedCompare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:107
 NSObject localizedStandardCompare(NSString string)
          localizedStandardCompare:, added in 10.6, should be used whenever file names or other strings are presented in lists and tables where Finder-like sorting is appropriate.
 long longLongValue()
          Original signature : -(long long)longLongValue
from NSStringExtensionMethods native declaration : NSString.h:149
 NSString lowercaseString()
          Original signature : -(NSString*)lowercaseString
from NSStringExtensionMethods native declaration : NSString.h:161
 NSUInteger maximumLengthOfBytesUsingEncoding(int enc)
          These return the maximum and exact number of bytes needed to store the receiver in the specified encoding in non-external representation.
 NSString precomposedStringWithCanonicalMapping()
          Original signature : -(NSString*)precomposedStringWithCanonicalMapping
from NSStringExtensionMethods native declaration : NSString.h:237
 NSString precomposedStringWithCompatibilityMapping()
          Original signature : -(NSString*)precomposedStringWithCompatibilityMapping
from NSStringExtensionMethods native declaration : NSString.h:239
 NSObject rangeOfCharacterFromSet_options(NSCharacterSet aSet, int mask)
          Original signature : -(id)rangeOfCharacterFromSet:(NSCharacterSet*) options:(NSStringCompareOptions)
from NSStringExtensionMethods native declaration : NSString.h:131
 NSObject rangeOfCharacterFromSet(NSCharacterSet aSet)
          These return the range of the first character from the set in the string, not the range of a sequence of characters.
 NSObject rangeOfComposedCharacterSequenceAtIndex(NSUInteger index)
          Original signature : -(id)rangeOfComposedCharacterSequenceAtIndex:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:134
 NSObject rangeOfString_options(NSString aString, int mask)
          Original signature : -(id)rangeOfString:(NSString*) options:(NSStringCompareOptions)
from NSStringExtensionMethods native declaration : NSString.h:122
 NSObject rangeOfString(NSString aString)
          These methods return length==0 if the target string is not found.
 int smallestEncoding()
           
 NSString stringByAppendingFormat(NSString format, NSObject... varargs)
          Original signature : -(NSString*)stringByAppendingFormat:(NSString*), ...
 NSString stringByAppendingString(NSString aString)
          Original signature : -(NSString*)stringByAppendingString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:139
 NSString stringByFoldingWithOptions_locale(int options, NSLocale locale)
          Returns a string with the character folding options applied. theOptions is a mask of compare flags with *InsensitiveSearch suffix.
 NSString stringByPaddingToLength_withString_startingAtIndex(NSUInteger newLength, NSString padString, NSUInteger padIndex)
          Original signature : -(NSString*)stringByPaddingToLength:(NSUInteger) withString:(NSString*) startingAtIndex:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:166
 NSString stringByReplacingOccurrencesOfString_withString(NSString target, NSString replacement)
          Replace all occurrences of the target string with replacement.
 NSString stringByTrimmingCharactersInSet(NSCharacterSet set)
          Original signature : -(NSString*)stringByTrimmingCharactersInSet:(NSCharacterSet*)
from NSStringExtensionMethods native declaration : NSString.h:165
 NSString substringFromIndex(NSUInteger from)
          Original signature : -(NSString*)substringFromIndex:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:98
 NSString substringToIndex(NSUInteger to)
          Original signature : -(NSString*)substringToIndex:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:99
 NSString uppercaseString()
          Original signature : -(NSString*)uppercaseString
from NSStringExtensionMethods native declaration : NSString.h:160
 String UTF8String()
          Convenience to return null-terminated UTF8 representation
Original signature : -(const char*)UTF8String
from NSStringExtensionMethods native declaration : NSString.h:260
 boolean writeToFile_atomically_encoding_error(NSString path, boolean useAuxiliaryFile, int enc, PointerByReference error)
          Original signature : -(BOOL)writeToFile:(NSString*) atomically:(BOOL) encoding:(NSStringEncoding) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:316
 boolean writeToURL_atomically_encoding_error(NSURL url, boolean useAuxiliaryFile, int enc, PointerByReference error)
          Write to specified url or path using the specified encoding.
 
Methods inherited from interface org.rococoa.ObjCObject
id
 

Method Detail

substringFromIndex

NSString substringFromIndex(NSUInteger from)
Original signature : -(NSString*)substringFromIndex:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:98


substringToIndex

NSString substringToIndex(NSUInteger to)
Original signature : -(NSString*)substringToIndex:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:99


compare

NSObject compare(NSString string)
Original signature : -(id)compare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:102


compare_options

NSObject compare_options(NSString string,
                         int mask)
Original signature : -(id)compare:(NSString*) options:(NSStringCompareOptions)
from NSStringExtensionMethods native declaration : NSString.h:103

Parameters:
mask - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringCompareOptions

caseInsensitiveCompare

NSObject caseInsensitiveCompare(NSString string)
Original signature : -(id)caseInsensitiveCompare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:106


localizedCompare

NSObject localizedCompare(NSString string)
Original signature : -(id)localizedCompare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:107


localizedCaseInsensitiveCompare

NSObject localizedCaseInsensitiveCompare(NSString string)
Original signature : -(id)localizedCaseInsensitiveCompare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:108


localizedStandardCompare

NSObject localizedStandardCompare(NSString string)
localizedStandardCompare:, added in 10.6, should be used whenever file names or other strings are presented in lists and tables where Finder-like sorting is appropriate. The exact behavior of this method may be tweaked in future releases, and will be different under different localizations, so clients should not depend on the exact sorting order of the strings.
Original signature : -(id)localizedStandardCompare:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:112


isEqualToString

boolean isEqualToString(NSString aString)
Original signature : -(BOOL)isEqualToString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:114


hasPrefix

boolean hasPrefix(NSString aString)
Original signature : -(BOOL)hasPrefix:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:116


hasSuffix

boolean hasSuffix(NSString aString)
Original signature : -(BOOL)hasSuffix:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:117


rangeOfString

NSObject rangeOfString(NSString aString)
These methods return length==0 if the target string is not found. So, to check for containment: ([str rangeOfString:@"target"].length > 0). Note that the length of the range returned by these methods might be different than the length of the target string, due composed characters and such.
Original signature : -(id)rangeOfString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:121


rangeOfString_options

NSObject rangeOfString_options(NSString aString,
                               int mask)
Original signature : -(id)rangeOfString:(NSString*) options:(NSStringCompareOptions)
from NSStringExtensionMethods native declaration : NSString.h:122

Parameters:
mask - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringCompareOptions

rangeOfCharacterFromSet

NSObject rangeOfCharacterFromSet(NSCharacterSet aSet)
These return the range of the first character from the set in the string, not the range of a sequence of characters.
Original signature : -(id)rangeOfCharacterFromSet:(NSCharacterSet*)
from NSStringExtensionMethods native declaration : NSString.h:130


rangeOfCharacterFromSet_options

NSObject rangeOfCharacterFromSet_options(NSCharacterSet aSet,
                                         int mask)
Original signature : -(id)rangeOfCharacterFromSet:(NSCharacterSet*) options:(NSStringCompareOptions)
from NSStringExtensionMethods native declaration : NSString.h:131

Parameters:
mask - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringCompareOptions

rangeOfComposedCharacterSequenceAtIndex

NSObject rangeOfComposedCharacterSequenceAtIndex(NSUInteger index)
Original signature : -(id)rangeOfComposedCharacterSequenceAtIndex:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:134


stringByAppendingString

NSString stringByAppendingString(NSString aString)
Original signature : -(NSString*)stringByAppendingString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:139


stringByAppendingFormat

NSString stringByAppendingFormat(NSString format,
                                 NSObject... varargs)
Original signature : -(NSString*)stringByAppendingFormat:(NSString*), ...
from NSStringExtensionMethods native declaration : NSString.h:140


doubleValue

double doubleValue()
The following convenience methods all skip initial space characters (whitespaceSet) and ignore trailing characters. NSScanner can be used for more "exact" parsing of numbers.
Original signature : -(double)doubleValue
from NSStringExtensionMethods native declaration : NSString.h:144


floatValue

float floatValue()
Original signature : -(float)floatValue
from NSStringExtensionMethods native declaration : NSString.h:145


intValue

int intValue()
Original signature : -(int)intValue
from NSStringExtensionMethods native declaration : NSString.h:146


integerValue

NSInteger integerValue()
Original signature : -(NSInteger)integerValue
from NSStringExtensionMethods native declaration : NSString.h:148


longLongValue

long longLongValue()
Original signature : -(long long)longLongValue
from NSStringExtensionMethods native declaration : NSString.h:149


boolValue

boolean boolValue()
Skips initial space characters (whitespaceSet), or optional -/+ sign followed by zeroes. Returns YES on encountering one of "Y", "y", "T", "t", or a digit 1-9. It ignores any trailing characters.
Original signature : -(BOOL)boolValue
from NSStringExtensionMethods native declaration : NSString.h:150


componentsSeparatedByString

NSArray componentsSeparatedByString(NSString separator)
Original signature : -(NSArray*)componentsSeparatedByString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:153


componentsSeparatedByCharactersInSet

NSArray componentsSeparatedByCharactersInSet(NSCharacterSet separator)
Original signature : -(NSArray*)componentsSeparatedByCharactersInSet:(NSCharacterSet*)
from NSStringExtensionMethods native declaration : NSString.h:155


commonPrefixWithString_options

NSString commonPrefixWithString_options(NSString aString,
                                        int mask)
Original signature : -(NSString*)commonPrefixWithString:(NSString*) options:(NSStringCompareOptions)
from NSStringExtensionMethods native declaration : NSString.h:158

Parameters:
mask - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringCompareOptions

uppercaseString

NSString uppercaseString()
Original signature : -(NSString*)uppercaseString
from NSStringExtensionMethods native declaration : NSString.h:160


lowercaseString

NSString lowercaseString()
Original signature : -(NSString*)lowercaseString
from NSStringExtensionMethods native declaration : NSString.h:161


capitalizedString

NSString capitalizedString()
Original signature : -(NSString*)capitalizedString
from NSStringExtensionMethods native declaration : NSString.h:162


stringByTrimmingCharactersInSet

NSString stringByTrimmingCharactersInSet(NSCharacterSet set)
Original signature : -(NSString*)stringByTrimmingCharactersInSet:(NSCharacterSet*)
from NSStringExtensionMethods native declaration : NSString.h:165


stringByPaddingToLength_withString_startingAtIndex

NSString stringByPaddingToLength_withString_startingAtIndex(NSUInteger newLength,
                                                            NSString padString,
                                                            NSUInteger padIndex)
Original signature : -(NSString*)stringByPaddingToLength:(NSUInteger) withString:(NSString*) startingAtIndex:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:166


hash

NSUInteger hash()
Original signature : -(NSUInteger)hash
from NSStringExtensionMethods native declaration : NSString.h:198


fastestEncoding

int fastestEncoding()
See Also:
org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

smallestEncoding

int smallestEncoding()
See Also:
org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

dataUsingEncoding_allowLossyConversion

NSData dataUsingEncoding_allowLossyConversion(int encoding,
                                              boolean lossy)
External representation
Original signature : -(NSData*)dataUsingEncoding:(NSStringEncoding) allowLossyConversion:(BOOL)
from NSStringExtensionMethods native declaration : NSString.h:205

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

dataUsingEncoding

NSData dataUsingEncoding(int encoding)
External representation
Original signature : -(NSData*)dataUsingEncoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:206

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

canBeConvertedToEncoding

boolean canBeConvertedToEncoding(int encoding)
Original signature : -(BOOL)canBeConvertedToEncoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:208

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

cStringUsingEncoding

String cStringUsingEncoding(int encoding)
Methods to convert NSString to a NULL-terminated cString using the specified encoding. Note, these are the "new" cString methods, and are not deprecated like the older cString methods which do not take encoding arguments.
"Autoreleased"; NULL return if encoding conversion not possible; for performance reasons, lifetime of this should not be considered longer than the lifetime of the receiving string (if the receiver string is freed, this might go invalid then, before the end of the autorelease scope)
Original signature : -(const char*)cStringUsingEncoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:213

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

getCString_maxLength_encoding

@Deprecated
boolean getCString_maxLength_encoding(Pointer buffer,
                                                 NSUInteger maxBufferCount,
                                                 int encoding)
Deprecated. use the safer methods getCString_maxLength_encoding(java.nio.ByteBuffer, org.rococoa.cocoa.foundation.NSUInteger, int) and getCString_maxLength_encoding(com.sun.jna.Pointer, org.rococoa.cocoa.foundation.NSUInteger, int) instead

NO return if conversion not possible due to encoding errors or too small of a buffer. The buffer should include room for maxBufferCount bytes; this number should accomodate the expected size of the return value plus the NULL termination character, which this method adds. (So note that the maxLength passed to this method is one more than the one you would have passed to the deprecated getCString:maxLength:.)
Original signature : -(BOOL)getCString:(char*) maxLength:(NSUInteger) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:214

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

getCString_maxLength_encoding

boolean getCString_maxLength_encoding(ByteBuffer buffer,
                                      NSUInteger maxBufferCount,
                                      int encoding)
NO return if conversion not possible due to encoding errors or too small of a buffer. The buffer should include room for maxBufferCount bytes; this number should accomodate the expected size of the return value plus the NULL termination character, which this method adds. (So note that the maxLength passed to this method is one more than the one you would have passed to the deprecated getCString:maxLength:.)
Original signature : -(BOOL)getCString:(char*) maxLength:(NSUInteger) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:214

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

maximumLengthOfBytesUsingEncoding

NSUInteger maximumLengthOfBytesUsingEncoding(int enc)
These return the maximum and exact number of bytes needed to store the receiver in the specified encoding in non-external representation. The first one is O(1), while the second one is O(n). These do not include space for a terminating null.
Result in O(1) time; the estimate may be way over what's needed. Returns 0 on error (overflow)
Original signature : -(NSUInteger)maximumLengthOfBytesUsingEncoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:231

Parameters:
enc - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

lengthOfBytesUsingEncoding

NSUInteger lengthOfBytesUsingEncoding(int enc)
Result in O(n) time; the result is exact. Returns 0 on error (cannot convert to specified encoding, or overflow)
Original signature : -(NSUInteger)lengthOfBytesUsingEncoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:232

Parameters:
enc - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

decomposedStringWithCanonicalMapping

NSString decomposedStringWithCanonicalMapping()
Original signature : -(NSString*)decomposedStringWithCanonicalMapping
from NSStringExtensionMethods native declaration : NSString.h:236


precomposedStringWithCanonicalMapping

NSString precomposedStringWithCanonicalMapping()
Original signature : -(NSString*)precomposedStringWithCanonicalMapping
from NSStringExtensionMethods native declaration : NSString.h:237


decomposedStringWithCompatibilityMapping

NSString decomposedStringWithCompatibilityMapping()
Original signature : -(NSString*)decomposedStringWithCompatibilityMapping
from NSStringExtensionMethods native declaration : NSString.h:238


precomposedStringWithCompatibilityMapping

NSString precomposedStringWithCompatibilityMapping()
Original signature : -(NSString*)precomposedStringWithCompatibilityMapping
from NSStringExtensionMethods native declaration : NSString.h:239


stringByFoldingWithOptions_locale

NSString stringByFoldingWithOptions_locale(int options,
                                           NSLocale locale)
Returns a string with the character folding options applied. theOptions is a mask of compare flags with *InsensitiveSearch suffix.
Original signature : -(NSString*)stringByFoldingWithOptions:(NSStringCompareOptions) locale:(NSLocale*)
from NSStringExtensionMethods native declaration : NSString.h:245

Parameters:
options - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringCompareOptions

stringByReplacingOccurrencesOfString_withString

NSString stringByReplacingOccurrencesOfString_withString(NSString target,
                                                         NSString replacement)
Replace all occurrences of the target string with replacement. Invokes the above method with 0 options and range of the whole string.
Original signature : -(NSString*)stringByReplacingOccurrencesOfString:(NSString*) withString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:253


UTF8String

String UTF8String()
Convenience to return null-terminated UTF8 representation
Original signature : -(const char*)UTF8String
from NSStringExtensionMethods native declaration : NSString.h:260


init

NSString init()
In general creation methods in NSString do not apply to subclassers, as subclassers are assumed to provide their own init methods which create the string in the way the subclass wishes. Designated initializers of NSString are thus init and initWithCoder:.
Original signature : -(id)init
from NSStringExtensionMethods native declaration : NSString.h:273


initWithCharactersNoCopy_length_freeWhenDone

@Deprecated
NSString initWithCharactersNoCopy_length_freeWhenDone(CharByReference characters,
                                                                 NSUInteger length,
                                                                 boolean freeBuffer)
Deprecated. use the safer methods initWithCharactersNoCopy_length_freeWhenDone(java.nio.CharBuffer, org.rococoa.cocoa.foundation.NSUInteger, boolean) and initWithCharactersNoCopy_length_freeWhenDone(com.ochafik.lang.jnaerator.runtime.CharByReference, org.rococoa.cocoa.foundation.NSUInteger, boolean) instead

"NoCopy" is a hint
Original signature : -(id)initWithCharactersNoCopy:(unichar*) length:(NSUInteger) freeWhenDone:(BOOL)
from NSStringExtensionMethods native declaration : NSString.h:274


initWithCharactersNoCopy_length_freeWhenDone

NSString initWithCharactersNoCopy_length_freeWhenDone(CharBuffer characters,
                                                      NSUInteger length,
                                                      boolean freeBuffer)
"NoCopy" is a hint
Original signature : -(id)initWithCharactersNoCopy:(unichar*) length:(NSUInteger) freeWhenDone:(BOOL)
from NSStringExtensionMethods native declaration : NSString.h:274


initWithCharacters_length

@Deprecated
NSString initWithCharacters_length(CharByReference characters,
                                              NSUInteger length)
Deprecated. use the safer methods initWithCharacters_length(char[], org.rococoa.cocoa.foundation.NSUInteger) and initWithCharacters_length(com.ochafik.lang.jnaerator.runtime.CharByReference, org.rococoa.cocoa.foundation.NSUInteger) instead

Original signature : -(id)initWithCharacters:(const unichar*) length:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:275


initWithCharacters_length

NSString initWithCharacters_length(char[] characters,
                                   NSUInteger length)
Original signature : -(id)initWithCharacters:(const unichar*) length:(NSUInteger)
from NSStringExtensionMethods native declaration : NSString.h:275


initWithUTF8String

@Deprecated
NSString initWithUTF8String(Pointer nullTerminatedCString)
Deprecated. use the safer methods initWithUTF8String(java.lang.String) and initWithUTF8String(com.sun.jna.Pointer) instead

Original signature : -(id)initWithUTF8String:(const char*)
from NSStringExtensionMethods native declaration : NSString.h:276


initWithUTF8String

NSString initWithUTF8String(String nullTerminatedCString)
Original signature : -(id)initWithUTF8String:(const char*)
from NSStringExtensionMethods native declaration : NSString.h:276


initWithString

NSString initWithString(NSString aString)
Original signature : -(id)initWithString:(NSString*)
from NSStringExtensionMethods native declaration : NSString.h:277


initWithFormat

NSString initWithFormat(NSString format,
                        NSObject... varargs)
Original signature : -(id)initWithFormat:(NSString*), ...
from NSStringExtensionMethods native declaration : NSString.h:278


initWithFormat_locale

NSString initWithFormat_locale(NSString format,
                               ObjCObject locale,
                               NSObject... varargs)
Original signature : -(id)initWithFormat:(NSString*) locale:(id), ...
from NSStringExtensionMethods native declaration : NSString.h:280


initWithData_encoding

NSString initWithData_encoding(NSData data,
                               int encoding)
Original signature : -(id)initWithData:(NSData*) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:282

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithBytes_length_encoding

NSString initWithBytes_length_encoding(Pointer bytes,
                                       NSUInteger len,
                                       int encoding)
Original signature : -(id)initWithBytes:(const void*) length:(NSUInteger) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:283

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithBytesNoCopy_length_encoding_freeWhenDone

NSString initWithBytesNoCopy_length_encoding_freeWhenDone(Pointer bytes,
                                                          NSUInteger len,
                                                          int encoding,
                                                          boolean freeBuffer)
"NoCopy" is a hint
Original signature : -(id)initWithBytesNoCopy:(void*) length:(NSUInteger) encoding:(NSStringEncoding) freeWhenDone:(BOOL)
from NSStringExtensionMethods native declaration : NSString.h:285

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithCString_encoding

@Deprecated
NSString initWithCString_encoding(Pointer nullTerminatedCString,
                                             int encoding)
Deprecated. use the safer methods initWithCString_encoding(java.lang.String, int) and initWithCString_encoding(com.sun.jna.Pointer, int) instead

Original signature : -(id)initWithCString:(const char*) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:296

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithCString_encoding

NSString initWithCString_encoding(String nullTerminatedCString,
                                  int encoding)
Original signature : -(id)initWithCString:(const char*) encoding:(NSStringEncoding)
from NSStringExtensionMethods native declaration : NSString.h:296

Parameters:
encoding - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithContentsOfURL_encoding_error

NSString initWithContentsOfURL_encoding_error(NSURL url,
                                              int enc,
                                              PointerByReference error)
These use the specified encoding. If nil is returned, the optional error return indicates problem that was encountered (for instance, file system or encoding errors).
Original signature : -(id)initWithContentsOfURL:(NSURL*) encoding:(NSStringEncoding) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:301

Parameters:
enc - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithContentsOfFile_encoding_error

NSString initWithContentsOfFile_encoding_error(NSString path,
                                               int enc,
                                               PointerByReference error)
Original signature : -(id)initWithContentsOfFile:(NSString*) encoding:(NSStringEncoding) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:302

Parameters:
enc - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithContentsOfURL_usedEncoding_error

@Deprecated
NSString initWithContentsOfURL_usedEncoding_error(NSURL url,
                                                             IntByReference enc,
                                                             PointerByReference error)
Deprecated. use the safer methods initWithContentsOfURL_usedEncoding_error(org.rococoa.cocoa.foundation.NSURL, java.nio.IntBuffer, com.sun.jna.ptr.PointerByReference) and initWithContentsOfURL_usedEncoding_error(org.rococoa.cocoa.foundation.NSURL, com.sun.jna.ptr.IntByReference, com.sun.jna.ptr.PointerByReference) instead

These try to determine the encoding, and return the encoding which was used. Note that these methods might get "smarter" in subsequent releases of the system, and use additional techniques for recognizing encodings. If nil is returned, the optional error return indicates problem that was encountered (for instance, file system or encoding errors).
Original signature : -(id)initWithContentsOfURL:(NSURL*) usedEncoding:(NSStringEncoding*) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:308

Parameters:
enc - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithContentsOfURL_usedEncoding_error

NSString initWithContentsOfURL_usedEncoding_error(NSURL url,
                                                  IntBuffer enc,
                                                  PointerByReference error)
These try to determine the encoding, and return the encoding which was used. Note that these methods might get "smarter" in subsequent releases of the system, and use additional techniques for recognizing encodings. If nil is returned, the optional error return indicates problem that was encountered (for instance, file system or encoding errors).
Original signature : -(id)initWithContentsOfURL:(NSURL*) usedEncoding:(NSStringEncoding*) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:308


initWithContentsOfFile_usedEncoding_error

@Deprecated
NSString initWithContentsOfFile_usedEncoding_error(NSString path,
                                                              IntByReference enc,
                                                              PointerByReference error)
Deprecated. use the safer methods initWithContentsOfFile_usedEncoding_error(org.rococoa.cocoa.foundation.NSString, java.nio.IntBuffer, com.sun.jna.ptr.PointerByReference) and initWithContentsOfFile_usedEncoding_error(org.rococoa.cocoa.foundation.NSString, com.sun.jna.ptr.IntByReference, com.sun.jna.ptr.PointerByReference) instead

Original signature : -(id)initWithContentsOfFile:(NSString*) usedEncoding:(NSStringEncoding*) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:309

Parameters:
enc - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

initWithContentsOfFile_usedEncoding_error

NSString initWithContentsOfFile_usedEncoding_error(NSString path,
                                                   IntBuffer enc,
                                                   PointerByReference error)
Original signature : -(id)initWithContentsOfFile:(NSString*) usedEncoding:(NSStringEncoding*) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:309


writeToURL_atomically_encoding_error

boolean writeToURL_atomically_encoding_error(NSURL url,
                                             boolean useAuxiliaryFile,
                                             int enc,
                                             PointerByReference error)
Write to specified url or path using the specified encoding. The optional error return is to indicate file system or encoding errors.
Original signature : -(BOOL)writeToURL:(NSURL*) atomically:(BOOL) encoding:(NSStringEncoding) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:315

Parameters:
enc - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding

writeToFile_atomically_encoding_error

boolean writeToFile_atomically_encoding_error(NSString path,
                                              boolean useAuxiliaryFile,
                                              int enc,
                                              PointerByReference error)
Original signature : -(BOOL)writeToFile:(NSString*) atomically:(BOOL) encoding:(NSStringEncoding) error:(NSError**)
from NSStringExtensionMethods native declaration : NSString.h:316

Parameters:
enc - @see org.rococoa.cocoa.foundation.FoundationLibrary#NSStringEncoding


Copyright © 2009. All Rights Reserved.