Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://couchbase.github.io/couchbase-lite-core/C/html/group___blobs.html below:

LiteCore: Blobs

Derives the key of the given data, without storing it.

Stores a blob.

The associated key will be written to outKey, if non-NULL. If expectedKey is not NULL, then the operation will fail unless the contents actually have that key.

Deletes a blob from the store given its key.

Deletes the BlobStore's blobs and directory, and (if successful) frees the object.

Note

This function is thread-safe.

Warning

This should only be used for unit testing. Never delete a BlobStore belonging to a C4Database.

Closes/frees a BlobStore.

(A NULL parameter is allowed.)

Note

This function is thread-safe.

Warning

This should only be used for unit testing. Never free a BlobStore belonging to a C4Database.

Reads the entire contents of a blob into memory.

Caller is responsible for freeing it.

Returns the path of the file that stores the blob, if possible.

This call may fail with error kC4ErrorWrongFormat if the blob is encrypted (in which case the file would be unreadable by the caller) or with kC4ErrorUnsupported if for some implementation reason the blob isn't stored as a standalone file. Thus, the caller MUST use this function only as an optimization, and fall back to reading the contents via the API if it fails. Also, it goes without saying that the caller MUST not modify the file!

Gets the content size of a blob given its key.

Returns -1 if it doesn't exist. WARNING: If the blob is encrypted, the return value is a conservative estimate that may be up to 16 bytes larger than the actual size.

Decodes a string of the form "sha1-"+base64 into a raw key.

Note

This function is thread-safe.

Encodes a blob key to a string of the form "sha1-"+base64.

Note

This function is thread-safe.

Opens a blob for reading, as a random-access byte stream.

Note

This function is thread-safe.

Opens a BlobStore in a directory.

If the flags allow creating, the directory will be created if necessary. Call c4blob_freeStore() when finished using the BlobStore.

Note

This function is thread-safe.

Warning

This should only be used for unit testing. Naked BlobStores are not supported.

Parameters

dirPath The filesystem path of the directory holding the attachments. flags Specifies options like create, read-only encryptionKey Optional encryption algorithm & key outError Error is returned here

Returns

The BlobStore reference, or NULL on error

Opens a write stream for creating a new blob.

You should then call c4stream_write to write the data, ending with c4stream_install to compute the blob's key and add it to the store, and then c4stream_closeWriter.

Note

This function is thread-safe.

Returns the BlobStore associated with a bundled database.

Note

The caller must use a lock for Database when this function is called.

Fails if the database is not bundled. DO NOT call c4blob_freeStore on this! The C4Database will free it when it closes.

Returns the number of bytes written to the stream.

Note

The caller must use a lock for WriteStream when this function is called.

Computes the blob-key (digest) of the data written to the stream.

This should only be called after writing the entire data. No more data can be written after this call.

Note

The caller must use a lock for WriteStream when this function is called.

Returns the exact length in bytes of the stream.

Note

This function is thread-safe.

Adds the data written to the stream as a finished blob to the store.

If expectedKey is not NULL, then the operation will fail unless the contents actually have that key. (If you don't know ahead of time what the key should be, call c4stream_computeBlobKey beforehand to derive it, and pass NULL for expectedKey.) This function does not close the writer.

Note

The caller must use a lock for WriteStream when this function is called.

Reads from an open stream.

Note

The caller must use a lock for ReadStream when this function is called.

Parameters

stream The open stream to read from buffer Where to copy the read data to maxBytesToRead The maximum number of bytes to read to the buffer error Error is returned here

Returns

The actual number of bytes read, or 0 if an error occurred

Moves to a random location in the stream; the next c4stream_read call will read from that location.

Note

The caller must use a lock for ReadStram when this function is called.

Writes data to a stream.

Note

The caller must use a lock for WriteStream when this function is called.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4