getString

Retrieves a string value from 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

If an incorrect password or salt is used, a DataVaultException is thrown with the reason kDataVaultExceptionReasonInvalidPassword.

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 ensures that the vault ends in a secure state even if an exception occurs.

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