saveImmediate

 

 

Description

The saveImmediate function reads a value stored at the specified key, {key}, from the specified ObjectRepository {aGor} and stores the new value {value} in the Repository Index.

The Repository Index is simply a Directory, which is saved on the disk with the Object Repository. The keys in the Repository Index normally map to a value which is a pointer to the location in the disk file. Retrieving or Saving a value to the Object Repository is key driven and requires two disk access:

1) Load the Repository Index into the Virtual Memory of the Analytic Information Server Server.

2) Use the key and then the disk pointer associated with the key, read the value from the disk.

The saveImmediate function replaces the pointer value with the immediate value from retrieved from the disk. Thus, if the Object Repository file is closed, the Repository Index is saved in its modified state. If another Object Repository references causes the Object Repository to be opened and the Repository Index to be loaded into virtual memory, the result of the saveImmediate from the last reference is persists in the Repository Index.

When to use

The saveImmediate function should be used on values that are referenced many times during an execution of an Lambda or function as it eliminates a disk access and will result in optimized access times. The Repository Index will be dynamically resized to accommodate immediate values and can grow to any size limited only by available virtual memory.

 

Syntax

(saveImmediate aGor key value )



Name Description AIS Types
aGorThe ObjectRepository which will be tested.ObjectRepository
key The key value associated with the object.String
value The value associated with the object.String


Returns:

The Object Id of the Object Repository.

 

Examples

Here are a number of links to Lambda coding examples which contain this instruction in various use cases.

Example_ObjectRepository_saveImmediate_001

This example show the an Immediate value save in a REpository using the saveImmediateFunction. Then the isImmediate function is used to check the data type of the value saved.

 

Argument Types

Here are the links to the data types of the function arguments.

ObjectRepository Directory String

Here are also a number of links to functions having arguments with any of these data types.

*=(Symbol) abortTransaction(ObjectRepository) addMethod(BitVector) addMethod(Boolean)
addMethod(Brick) addMethod(Character) addMethod(CpxVector) addMethod(Date)
addMethod(Dictionary) addMethod(Directory) addMethod(FltVector) addMethod(Function)
addMethod(IntVector) addMethod(List) addMethod(Matrix) addMethod(NumMatrix)
addMethod(NumVector) addMethod(Number) addMethod(ObjVector) addMethod(ObjectRepository)
addMethod(Pair) addMethod(PcodeVector) addMethod(ShortVector) addMethod(String)
addMethod(Structure) addMethod(Symbol) addMethod(Vector) addMethod(Void)
appendWriteln(ByteVector) append(BitVector) append(Complex) append(CpxVector)
append(FltVector) append(IntVector) append(Matrix) append(NumMatrix)
append(NumVector) append(ObjVector) append(Pair) append(ShortVector)
append(String) append(Structure) append(Symbol) append(Vector)
attachLibrarian(ObjectRepository) balance(Lambda) beginTransaction(ObjectRepository) binaryInsert(CpxVector)
binaryInsert(FltVector) binaryInsert(IntVector) binaryInsert(Matrix) binaryInsert(NumMatrix)
binaryInsert(NumVector) binaryInsert(ShortVector) binaryInsert(Structure) binaryInsert(Vector)
binarySearch(CpxVector) binarySearch(Dictionary) binarySearch(FltVector) binarySearch(IntVector)
binarySearch(Matrix) binarySearch(NumMatrix) binarySearch(NumVector) binarySearch(ObjVector)
binarySearch(ShortVector) binarySearch(Structure) binarySearch(Vector) boolean(Boolean)
cdr(BitVector) cdr(Brick) cdr(CpxVector) cdr(Dictionary)
cdr(Directory) cdr(FltVector) cdr(IntVector) cdr(List)
cdr(Matrix) cdr(NumMatrix) cdr(NumVector) cdr(ObjVector)
cdr(ShortVector) cdr(Structure) cdr(Vector) character(Character)
checkPointTransaction(ObjectRepository) clean(String) closeLog(FileIO) code(String)
commitTransaction(ObjectRepository) compareEQ(BitVector) compareEQ(Boolean) compareEQ(Brick)
compareEQ(Character) compareEQ(Complex) compareEQ(CpxVector) compareEQ(Date)
compareEQ(Dictionary) compareEQ(Directory) compareEQ(FltVector) compareEQ(Function)
compareEQ(IntVector) compareEQ(Lambda) compareEQ(List) compareEQ(Matrix)
compareEQ(NumMatrix) compareEQ(NumVector) compareEQ(Number) compareEQ(ObjVector)
compareEQ(ObjectRepository) compareEQ(Pair) compareEQ(ShortVector) compareEQ(String)
compareEQ(Structure) compareEQ(Symbol) compareEQ(Vector) compareEQ(Void)
compareGE(BitVector) compareGE(Boolean) compareGE(Brick) compareGE(Character)
compareGE(Complex) compareGE(CpxVector) compareGE(Date) compareGE(Dictionary)
compareGE(Directory) compareGE(Function) compareGE(IntVector) compareGE(Lambda)
compareGE(List) compareGE(Matrix) compareGE(NumMatrix) compareGE(Number)
compareGE(ObjVector) compareGE(ObjectRepository) compareGE(Pair) compareGE(ShortVector)
compareGE(String) compareGE(Structure) compareGE(Symbol) compareGE(Vector)
compareGE(Void) compareGT(BitVector) compareGT(Boolean) compareGT(Brick)
compareGT(Character) compareGT(Complex) compareGT(CpxVector) compareGT(Date)
compareGT(Dictionary) compareGT(Directory) compareGT(Function) compareGT(IntVector)
compareGT(Lambda) compareGT(List) compareGT(Matrix) compareGT(NumMatrix)
compareGT(NumVector) compareGT(Number) compareGT(ObjVector) compareGT(ObjectRepository)
compareGT(Pair) compareGT(ShortVector) compareGT(String) compareGT(Structure)
compareGT(Symbol) compareGT(Vector) compareGT(Void) compareLE(BitVector)
compareLE(Boolean) compareLE(Brick) compareLE(Character) compareLE(Complex)
compareLE(CpxVector) compareLE(Date) compareLE(Dictionary) compareLE(Directory)
compareLE(FltVector) compareLE(Function) compareLE(IntVector) compareLE(Lambda)
compareLE(List) compareLE(Matrix) compareLE(NumMatrix) compareLE(NumVector)
compareLE(Number) compareLE(ObjVector) compareLE(ObjectRepository) compareLE(Pair)
compareLE(ShortVector) compareLE(String) compareLE(Structure) compareLE(Symbol)
compareLE(Vector) compareLE(Void) compareLT(BitVector) compareLT(Boolean)
compareLT(Brick) compareLT(Character) compareLT(Complex) compareLT(CpxVector)
compareLT(Date) compareLT(Dictionary) compareLT(Directory) compareLT(FltVector)
compareLT(Function) compareLT(IntVector) compareLT(Lambda) compareLT(List)
compareLT(Matrix) compareLT(NumMatrix) compareLT(NumVector) compareLT(Number)
compareLT(ObjVector) compareLT(ObjectRepository) compareLT(Pair) compareLT(ShortVector)
compareLT(String) compareLT(Structure) compareLT(Symbol) compareLT(Vector)
compareLT(Void) compareNE(BitVector) compareNE(Boolean) compareNE(Brick)
compareNE(Character) compareNE(Complex) compareNE(CpxVector) compareNE(Date)
compareNE(Dictionary) compareNE(Directory) compareNE(FltVector) compareNE(Function)
compareNE(IntVector) compareNE(Lambda) compareNE(List) compareNE(Matrix)
compareNE(NumMatrix) compareNE(NumVector) compareNE(Number) compareNE(ObjVector)
compareNE(ObjectRepository) compareNE(Pair) compareNE(ShortVector) compareNE(String)
compareNE(Structure) compareNE(Symbol) compareNE(Vector) compareNE(Void)
compare(BitVector) compare(Boolean) compare(Brick) compare(Character)
compare(Complex) compare(CpxVector) compare(Date) compare(Dictionary)
compare(Directory) compare(FltVector) compare(Function) compare(IntVector)
compare(Lambda) compare(List) compare(Matrix) compare(NumMatrix)
compare(NumVector) compare(Number) compare(ObjVector) compare(ObjectRepository)
compare(Pair) compare(ShortVector) compare(String) compare(Structure)
compare(Symbol) compare(Vector) compare(Void) comparison(BitVector)
comparison(Boolean) comparison(Brick) comparison(Character) comparison(Complex)
comparison(Date) comparison(Dictionary) comparison(Directory) comparison(FltVector)
comparison(Function) comparison(IntVector) comparison(List) comparison(Matrix)
comparison(NumMatrix) comparison(NumVector) comparison(Number) comparison(ObjVector)
comparison(ObjectRepository) comparison(Pair) comparison(ShortVector) comparison(String)
comparison(Structure) comparison(Symbol) comparison(Vector) comparison(Void)
compress(ByteVector) cons(Pair) copy(BitVector) copy(Brick)
copy(CpxVector) copy(Dictionary) copy(Directory) copy(FltVector)
copy(IntVector) copy(Lambda) copy(List) copy(Matrix)
copy(NumMatrix) copy(NumVector) copy(ObjVector) copy(Pair)
copy(PcodeVector) copy(ShortVector) copy(Structure) copy(Vector)
count(Dictionary) count(Directory) count(List) count(Matrix)
count(NumMatrix) count(Pair) count(Structure) count(Vector)
date(Date) day(Date) days360(Date) debugBrowsableProcs(Context)
debugBrowsableProcs(Lambda) debugDialog(String) delete(Dictionary) delete(Directory)
delete(FltVector) delete(IntVector) delete(List) delete(Matrix)
delete(NumMatrix) delete(NumVector) delete(ObjVector) delete(ObjectRepository)
delete(Pair) delete(ShortVector) delete(Structure) delete(Vector)
detachLibrarian(ObjectRepository) disassemble(Context) disassemble(Lambda) display(ByteVector)
display(FileIO) downcase(String) downcase(Symbol) encode(ByteVector)
evalInSyncLocalContext(Context) eval(Lambda) eval(List) exportTab(Lambda)
exportTab(ObjectRepository) fileReadRecord(ByteVector) fileReadRecord(String) fileReadRecord(Text)
find(String) getContextPtr(Context) getHttp(String) getHttp(Text)
hashString(String) hashString(Symbol) hour(Date) importTab(Lambda)
importTab(ObjectRepository) insert(Dictionary) insert(Directory) insert(FltVector)
insert(IntVector) insert(Matrix) insert(NumMatrix) insert(NumVector)
insert(ObjVector) insert(ShortVector) insert(Structure) insert(Vector)
inside(BitVector) inside(Dictionary) inside(Directory) inside(IntVector)
inside(List) inside(Matrix) inside(NumMatrix) inside(NumVector)
inside(ShortVector) inside(Structure) inside(Vector) inspect(Context)
inspect(Lambda) inspect(ObjectRepository) integer(Integer) isAtom(BitVector)
isAtom(Brick) isAtom(Dictionary) isAtom(Directory) isAtom(FltVector)
isAtom(IntVector) isAtom(List) isAtom(Matrix) isAtom(NumMatrix)
isAtom(NumVector) isAtom(ObjVector) isAtom(Pair) isAtom(PcodeVector)
isAtom(ShortVector) isAtom(Structure) isAtom(Vector) isBitVector(BitVector)
isBoolean(Boolean) isBound(Dictionary) isBound(Directory) isBound(Structure)
isByteVector(ByteVector) isCharAlphabetic(ByteVector) isCharAlphabetic(String) isCharAlphabetic(Symbol)
isCharAlphanumeric(ByteVector) isCharAlphanumeric(String) isCharAlphanumeric(Symbol) isCharLowercase(ByteVector)
isCharLowercase(String) isCharLowercase(Symbol) isCharName(ByteVector) isCharName(String)
isCharName(Symbol) isCharNumeric(ByteVector) isCharNumeric(String) isCharNumeric(Symbol)
isCharUppercase(ByteVector) isCharUppercase(String) isCharUppercase(Symbol) isCharWhitespace(ByteVector)
isCharWhitespace(String) isCharWhitespace(Symbol) isChar(String) isCharacter(Character)
isComplex(Complex) isDate(Date) isDictionary(Dictionary) isDirectory(Directory)
isEqual(BitVector) isEqual(Boolean) isEqual(Brick) isEqual(Character)
isEqual(Complex) isEqual(Date) isEqual(Dictionary) isEqual(Directory)
isEqual(FltVector) isEqual(Function) isEqual(IntVector) isEqual(List)
isEqual(Matrix) isEqual(NumMatrix) isEqual(NumVector) isEqual(Number)
isEqual(ObjVector) isEqual(Pair) isEqual(ShortVector) isEqual(String)
isEqual(Structure) isEqual(Vector) isEqual(Void) isError(Error)
isFloatVector(FltVector) isIdentical(BitVector) isIdentical(Boolean) isIdentical(Brick)
isIdentical(Character) isIdentical(Complex) isIdentical(Date) isIdentical(Dictionary)
isIdentical(Directory) isIdentical(Error) isIdentical(FltVector) isIdentical(Function)
isIdentical(IntVector) isIdentical(List) isIdentical(Matrix) isIdentical(NumMatrix)
isIdentical(NumVector) isIdentical(Number) isIdentical(ObjVector) isIdentical(ObjectRepository)
isIdentical(Pair) isIdentical(PcodeVector) isIdentical(ShortVector) isIdentical(Structure)
isIdentical(Vector) isIdentical(Void) isImmediate(ObjectRepository) isInside(BitVector)
isInside(Dictionary) isInside(Directory) isInside(IntVector) isInside(List)
isInside(Matrix) isInside(NumMatrix) isInside(NumVector) isInside(ObjVector)
isInside(Pair) isInside(ShortVector) isInside(Structure) isInside(Vector)
isIntegerVector(IntVector) isInteger(Integer) isMatrix(Matrix) isMember(BitVector)
isMember(Dictionary) isMember(Directory) isMember(IntVector) isMember(List)
isMember(Matrix) isMember(NumMatrix) isMember(NumVector) isMember(ObjVector)
isMember(Pair) isMember(ShortVector) isMember(Structure) isMember(Vector)
isMoney(Number) isNumberMatrix(NumMatrix) isNumberVector(NumVector) isNumber(Number)
isObjectVector(ObjVector) isObject(BitVector) isObject(Brick) isObject(ByteVector)
isObject(Dictionary) isObject(Directory) isObject(FltVector) isObject(IntVector)
isObject(List) isObject(Matrix) isObject(NumMatrix) isObject(NumVector)
isObject(ObjVector) isObject(Pair) isObject(PcodeVector) isObject(ShortVector)
isObject(String) isObject(Structure) isObject(Symbol) isObject(Vector)
isPair(List) isPair(Pair) isPcodeVector(PcodeVector) isString(String)
isStructure(Structure) isSymbol(Symbol) isText(String) isTransaction(ObjectRepository)
isType(BitVector) isType(Boolean) isType(Brick) isType(Character)
isType(Complex) isType(Date) isType(Dictionary) isType(Directory)
isType(FltVector) isType(Function) isType(IntVector) isType(Matrix)
isType(NumMatrix) isType(NumVector) isType(Number) isType(ObjVector)
isType(ObjectRepository) isType(Pair) isType(ShortVector) isType(String)
isType(Structure) isType(Symbol) isType(Vector) isType(Void)
isVector(Vector) julian(Date) left(String) length(BitVector)
length(Brick) length(Dictionary) length(Directory) length(FltVector)
length(IntVector) length(List) length(Matrix) length(NumMatrix)
length(NumVector) length(ObjVector) length(ObjectRepository) length(Pair)
length(PcodeVector) length(ShortVector) length(String) length(Structure)
length(Symbol) length(Vector) list(List) loadLib(String)
loadRepository(ObjectRepository) loadWorkspace(Context) macroReplace(String) makeQuotedList(List)
makeQuotedSymbol(Symbol) map(Dictionary) map(Directory) map(FltVector)
map(IntVector) map(List) map(Matrix) map(NumMatrix)
map(NumVector) map(Pair) map(ShortVector) map(Structure)
map(Vector) mapc(Dictionary) mapc(Directory) mapc(FltVector)
mapc(IntVector) mapc(List) mapc(Matrix) mapc(NumMatrix)
mapc(NumVector) mapc(Pair) mapc(ShortVector) mapc(Structure)
mapc(Vector) member(BitVector) member(Dictionary) member(Directory)
member(IntVector) member(List) member(Matrix) member(NumMatrix)
member(NumVector) member(ObjVector) member(ShortVector) member(Structure)
member(Vector) methodsOf(BitVector) methodsOf(Boolean) methodsOf(Brick)
methodsOf(Character) methodsOf(Complex) methodsOf(Date) methodsOf(Dictionary)
methodsOf(Directory) methodsOf(FltVector) methodsOf(Function) methodsOf(IntVector)
methodsOf(List) methodsOf(Matrix) methodsOf(NumMatrix) methodsOf(NumVector)
methodsOf(Number) methodsOf(ObjVector) methodsOf(ObjectRepository) methodsOf(Pair)
methodsOf(PcodeVector) methodsOf(ShortVector) methodsOf(String) methodsOf(Structure)
methodsOf(Symbol) methodsOf(Vector) methodsOf(Void) mid(String)
minute(Date) money(Number) month(Date) new(BitVector)
new(Brick) new(ByteVector) new(CpxVector) new(Dictionary)
new(Directory) new(FltVector) new(IntVector) new(Lambda)
new(Matrix) new(NumMatrix) new(NumVector) new(ObjVector)
new(ObjectRepository) new(PcodeVector) new(ShortVector) new(String)
new(Structure) new(Symbol) new(Vector) number(Number)
objectToDirectory(Directory) objectToMatrix(Matrix) objectToNumMatrix(NumMatrix) objectToNumVector(NumVector)
objectToVector(Vector) openLog(FileIO) openLog(String) pair(Pair)
parse(String) postHttp(String) postHttp(Text) readHtmlPage(String)
readHtmlPage(Text) refAttributes(Dictionary) refAttributes(Directory) refAttributes(Structure)
refAttributes(Vector) refLibrarian(ObjectRepository) refValues(Dictionary) refValues(Directory)
refValues(Structure) refValues(Vector) ref(BitVector) ref(Boolean)
ref(Brick) ref(Character) ref(Complex) ref(Date)
ref(Dictionary) ref(Directory) ref(FltVector) ref(Function)
ref(IntVector) ref(Lambda) ref(List) ref(Matrix)
ref(NumMatrix) ref(NumVector) ref(Number) ref(ObjVector)
ref(ObjectRepository) ref(PcodeVector) ref(ShortVector) ref(String)
ref(Structure) ref(Symbol) ref(Vector) ref(Void)
remove(BitVector) remove(Dictionary) remove(Directory) remove(IntVector)
remove(Matrix) remove(NumMatrix) remove(NumVector) remove(ObjVector)
remove(ShortVector) remove(Structure) remove(Vector) rename(ObjectRepository)
replace(String) rept(String) requestHttp(String) requestHttp(Text)
resize(BitVector) resize(Dictionary) resize(Directory) resize(FltVector)
resize(IntVector) resize(Matrix) resize(NumMatrix) resize(NumVector)
resize(ObjVector) resize(ShortVector) resize(Structure) resize(Vector)
right(String) run(ByteVector) run(Text) saveImmediate(ObjectRepository)
saveObject(ByteVector) saveObject(Integer) saveRepository(ObjectRepository) saveWorkspace(Context)
second(Date) send(BitVector) send(Boolean) send(Brick)
send(Character) send(CpxVector) send(Date) send(Dictionary)
send(Directory) send(FltVector) send(Function) send(IntVector)
send(Lambda) send(List) send(Matrix) send(NumMatrix)
send(NumVector) send(Number) send(ObjectRepository) send(Pair)
send(ShortVector) send(String) send(Structure) send(Symbol)
send(Vector) send(Void) setCar(List) setCar(Pair)
setCdr(BitVector) setCdr(Brick) setCdr(Dictionary) setCdr(Directory)
setCdr(FltVector) setCdr(IntVector) setCdr(List) setCdr(Matrix)
setCdr(NumMatrix) setCdr(NumVector) setCdr(ObjVector) setCdr(Pair)
setCdr(ShortVector) setCdr(Structure) setCdr(Vector) setLastCdr(BitVector)
setLastCdr(FltVector) setLastCdr(IntVector) setLastCdr(List) setLastCdr(Matrix)
setLastCdr(NumMatrix) setLastCdr(NumVector) setLastCdr(ObjVector) setLastCdr(Structure)
setLastCdr(Vector) set(ObjectRepository) setf(ObjectRepository) setq(BitVector)
setq(Boolean) setq(Brick) setq(Character) setq(Date)
setq(Dictionary) setq(Directory) setq(FltVector) setq(IntVector)
setq(Lambda) setq(List) setq(Matrix) setq(NumVector)
setq(Number) setq(ObjVector) setq(ObjectRepository) setq(PcodeVector)
setq(ShortVector) setq(String) setq(Structure) setq(Symbol)
setq(Vector) setq(Void) sizeof(BitVector) sizeof(Boolean)
sizeof(Brick) sizeof(ByteVector) sizeof(Character) sizeof(Complex)
sizeof(Date) sizeof(Dictionary) sizeof(Directory) sizeof(FltVector)
sizeof(Function) sizeof(IntVector) sizeof(List) sizeof(Matrix)
sizeof(NumMatrix) sizeof(NumVector) sizeof(Number) sizeof(ObjVector)
sizeof(ObjectRepository) sizeof(Pair) sizeof(PcodeVector) sizeof(ShortVector)
sizeof(String) sizeof(Structure) sizeof(Symbol) sizeof(Vector)
sizeof(Void) sort(BitVector) sort(Dictionary) sort(Directory)
sort(FltVector) sort(IntVector) sort(List) sort(Matrix)
sort(NumMatrix) sort(NumVector) sort(ObjVector) sort(ShortVector)
sort(Structure) sort(Vector) stringCiEQ(String) stringCiGE(String)
stringCiGT(String) stringCiLE(String) stringCiLT(String) stringCiNE(String)
stringFill(String) stringToBVector(String) stringToVector(String) string(Complex)
string(String) submit(Context) substitute(String) substringCiEQ(String)
substringCiGE(String) substringCiGT(String) substringCiLE(String) substringCiLT(String)
substringCiNE(String) substringEQ(String) substringFill(String) substringGE(String)
substringGT(String) substringLE(String) substringLT(String) substringNE(String)
substring(String) symbol(Symbol) system(ByteVector) system(Text)
testFunction(Structure) text(String) time(Date) trim(String)
type(BitVector) type(Boolean) type(Brick) type(ByteVector)
type(Character) type(Complex) type(Date) type(Dictionary)
type(Directory) type(FltVector) type(Function) type(IntVector)
type(Lambda) type(Matrix) type(NumMatrix) type(NumVector)
type(Number) type(ObjVector) type(ObjectRepository) type(Pair)
type(PcodeVector) type(ShortVector) type(String) type(Structure)
type(Symbol) type(Vector) type(Void) uniqueInsert(FltVector)
uniqueInsert(IntVector) uniqueInsert(Matrix) uniqueInsert(NumMatrix) uniqueInsert(NumVector)
uniqueInsert(ObjVector) uniqueInsert(ShortVector) uniqueInsert(Structure) uniqueInsert(Vector)
upcase(String) upcase(Symbol) vectorDelete(Directory) vectorFill(BitVector)
vectorFill(FltVector) vectorFill(IntVector) vectorFill(Matrix) vectorFill(NumMatrix)
vectorFill(NumVector) vectorFill(ObjVector) vectorFill(ShortVector) vectorFill(Vector)
writeln(ByteVector) writeln(String) writeln(Text) year(Date)

How do I contact the AIS team?

You can always talk with the AIS at aiserver.sourceforge.net.