getString

Retrieves a string value from the vault.

Retrieves a string stored under the specified name in the vault. An exception is thrown if the vault is locked when this method is called.

Syntax

- (NSString*)getString:(NSString*)name;

Parameters

name – The name associated with the string object to be retrieved.

Returns

getString returns a string data value, associated with the specified name, from the vault. An exception is thrown if the vault is locked when this method is called.

Examples

Get a String Value – Unlocks the vault and retrieves a string value associated with the name "testString" in the vault. The finally clause in the try/catch block ensure that the vault ends in a secure state even if an exception occurs.

NSString *retrievedstring = nil;
    
@try {
   [oVault unlock:@"goodPassword" withSalt:@"goodSalt"];
   retrievedstring = [oVault getString:@"testString"];
}
@catch (NSException *e) {
   NSLog(@"Exception: %@",[e description]);
}
@finally {
   [oVault lock];
}