public interface ISqlJetVdbeMem extends ISqlJetReleasable
Modifier and Type | Method and Description |
---|---|
void |
applyAffinity(SqlJetTypeAffinity affinity,
SqlJetEncoding enc) |
void |
changeEncoding(SqlJetEncoding desiredEnc)
If pMem is an object with a valid string representation, this routine
ensures the internal encoding for the string representation is
'desiredEnc', one of SQLITE_UTF8, SQLITE_UTF16LE or SQLITE_UTF16BE.
|
ISqlJetVdbeMem |
copy()
Make a full copy of pFrom into pTo.
|
void |
expandBlob()
If the given Mem* has a zero-filled tail, turn it into an ordinary blob
stored in dynamically allocated space.
|
void |
fromBtree(ISqlJetBtreeCursor pCur,
int offset,
int amt,
boolean key)
Move data out of a btree key or data field and into a Mem structure.
|
java.util.Set<SqlJetVdbeMemFlags> |
getFlags() |
SqlJetValueType |
getType() |
void |
grow(int n,
boolean preserve)
Make sure pMem->z points to a writable allocation of at least n bytes.
|
void |
handleBom()
This routine checks for a byte-order mark at the beginning of the UTF-16
string stored in *pMem.
|
void |
integerAffinity()
The MEM structure is already a MEM_Real.
|
void |
integerify()
Convert pMem to type integer.
|
long |
intValue()
Return some kind of integer value which is the best we can do at
representing the value that *pMem describes as an integer.
|
boolean |
isNull() |
boolean |
isTooBig()
Return true if the Mem object contains a TEXT or BLOB that is too large -
whose size exceeds SQLITE_MAX_LENGTH.
|
void |
makeWriteable()
Make the given Mem object MEM_Dyn.
|
ISqlJetVdbeMem |
move()
Transfer the contents of pFrom to pTo.
|
void |
nulTerminate()
Make sure the given Mem is nul terminated.
|
void |
numerify()
Convert pMem so that it has types MEM_Real or MEM_Int or both.
|
void |
realify()
Convert pMem so that it is of type MEM_Real.
|
double |
realValue()
Return the best representation of pMem that we can get into a double.
|
void |
reset()
Release any memory held by the Mem.
|
void |
sanity()
Perform various checks on the memory cell pMem.
|
void |
setDouble(double val)
Delete any previous value and set the value stored in *pMem to val,
manifest type REAL.
|
void |
setInt64(long val)
Delete any previous value and set the value stored in *pMem to val,
manifest type INTEGER.
|
void |
setNull()
Delete any previous value and set the value stored in *pMem to NULL.
|
void |
setRowSet()
Delete any previous value and set the value of pMem to be an empty
boolean index.
|
void |
setStr(ISqlJetMemoryPointer z,
SqlJetEncoding enc)
Change the value of a Mem to be a string or a BLOB.
|
void |
setTypeFlag(SqlJetVdbeMemFlags f)
Clear any existing type flags from a Mem and replace them with f
|
void |
setZeroBlob(int n)
Delete any previous value and set the value to be a BLOB of length n
containing all zeros.
|
ISqlJetVdbeMem |
shallowCopy(SqlJetVdbeMemFlags srcType)
Make an shallow copy.
|
void |
stringify(SqlJetEncoding enc)
Add MEM_Str to the set of representations for the given Mem.
|
void |
translate(SqlJetEncoding desiredEnc)
This routine transforms the internal text encoding used by pMem to
desiredEnc.
|
ISqlJetMemoryPointer |
valueBlob()
Converts the object V into a BLOB and then returns a pointer to the
converted value.
|
int |
valueBytes(SqlJetEncoding enc)
Return the number of bytes in the sqlite3_value object assuming that it
uses the encoding "enc"
|
ISqlJetMemoryPointer |
valueText(SqlJetEncoding enc)
This function is only available internally, it is not part of the
external API.
|
release
void reset()
void changeEncoding(SqlJetEncoding desiredEnc) throws SqlJetException
enc
- SqlJetException
void translate(SqlJetEncoding desiredEnc) throws SqlJetException
desiredEnc
- SqlJetException
void handleBom()
void expandBlob()
ISqlJetMemoryPointer valueText(SqlJetEncoding enc) throws SqlJetException
enc
- SqlJetException
void grow(int n, boolean preserve)
n
- preserve
- void fromBtree(ISqlJetBtreeCursor pCur, int offset, int amt, boolean key) throws SqlJetException
pCur
- offset
- Offset from the start of data to return bytes from.amt
- Number of bytes to return.key
- If true, retrieve from the btree key, not data.SqlJetException
void makeWriteable()
long intValue()
void setNull()
void setStr(ISqlJetMemoryPointer z, SqlJetEncoding enc) throws SqlJetException
SqlJetException
void setInt64(long val)
void nulTerminate()
void stringify(SqlJetEncoding enc) throws SqlJetException
enc
- SqlJetException
double realValue()
void integerAffinity()
void integerify()
void realify()
void numerify()
void setZeroBlob(int n)
void setDouble(double val)
void setRowSet()
boolean isTooBig()
ISqlJetVdbeMem shallowCopy(SqlJetVdbeMemFlags srcType) throws SqlJetException
srcType
- SqlJetException
ISqlJetVdbeMem copy() throws SqlJetException
SqlJetException
ISqlJetVdbeMem move() throws SqlJetException
SqlJetException
void sanity()
int valueBytes(SqlJetEncoding enc) throws SqlJetException
SqlJetException
void setTypeFlag(SqlJetVdbeMemFlags f)
real
- java.util.Set<SqlJetVdbeMemFlags> getFlags()
boolean isNull()
SqlJetValueType getType()
ISqlJetMemoryPointer valueBlob() throws SqlJetException
SqlJetException
void applyAffinity(SqlJetTypeAffinity affinity, SqlJetEncoding enc) throws SqlJetException
affinity
- enc
- SqlJetException
Copyright © 2009-2010 TMate Software Ltd. All Rights Reserved.