setString

Stores a string object in the vault.

An exception is thrown if the vault is locked when this method is called.

Syntax

- (void)setString:(NSString*)name Value:(NSString*)value;

Parameters

name – the name associated with the string object to be stored.
value – the string object to store in the vault.

Returns

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

Examples

Set a string value – creates a test string, unlocks the vault, and sets 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 *teststring = @"ABCDEFabcdef";
@try {
   [oVault unlock:@"goodPassword" Salt:@"goodSalt"];
   [oVault setString:@"testString" Value:teststring];
}
@catch (NSException *e) {
   NSLog(@"Exception: %@",[e description]);
}
@finally {
   [oVault lock];
}