Resource file reading functions. More...
#include <kanzi/core/cpp/cstddef.hpp>#include <kanzi/core/legacy/debug/kzs_error.hpp>#include <kanzi/core/legacy/kzs_types.hpp>Macros | |
| #define | KZS_RESOURCE_FILE_ERROR |
| Result value indicating that an error occurred in the function. More... | |
Functions | |
| kzsError | APKInit (void) |
| Initializes internal class and method pointers. More... | |
| kzsError | kzsResourceFileCreate (kzString resourceDirectory, kzString resourcePath, struct KzsResourceFile **out_resourceFile) |
| Opens a resource. More... | |
| kzsError | kzsResourceFileDelete (struct KzsResourceFile *resourceFile) |
| Closes a resource. More... | |
| kzInt | kzsResourceFileRead (struct KzsResourceFile *resourceFile, kzUint byteCount, kzByte *out_buffer) |
| Reads bytes from a resource. More... | |
| kzInt | kzsResourceFileSkip (struct KzsResourceFile *resourceFile, kzUint byteCount) |
| Skips bytes from a resource. More... | |
| int64_t | kzsResourceFileGetLength (const struct KzsResourceFile *resourceFile) |
| Gets the length of the resource. More... | |
| uint64_t | kzsResourceFileGetPosition (const struct KzsResourceFile *resourceFile) |
| Gets the current position in a resource. More... | |
| kzString | kzsResourceFileGetResourceDirectory (const struct KzsResourceFile *resourceFile) |
| Gets resource directory that was used when creating the resource file. More... | |
| kzString | kzsResourceFileGetResourcePath (const struct KzsResourceFile *resourceFile) |
| Gets resource path that was used when creating the resource file. More... | |
| kzsError | kzsResourceFileMemoryMap (struct KzsResourceFile *resourceFile, kanzi::byte **out_map) |
| Memory maps the resource file. More... | |
| kzBool | kzsResourceFileExists (kzString resourcePath) |
| Returns true if a resource exists. More... | |
Resource file reading functions.
Resource files provide simplified API for reading files (but not writing). This is the recommended API for reading resource files of the application, since full file-system API might not be available on all platforms.
Copyright 2008-2017 by Rightware. All rights reserved.
| #define KZS_RESOURCE_FILE_ERROR |
Result value indicating that an error occurred in the function.
| kzsError APKInit | ( | void | ) |
Initializes internal class and method pointers.
Must be called from main thread before any other function in this file.
| kzsError kzsResourceFileCreate | ( | kzString | resourceDirectory, |
| kzString | resourcePath, | ||
| struct KzsResourceFile ** | out_resourceFile | ||
| ) |
Opens a resource.
| kzsError kzsResourceFileDelete | ( | struct KzsResourceFile * | resourceFile | ) |
Closes a resource.
| kzInt kzsResourceFileRead | ( | struct KzsResourceFile * | resourceFile, |
| kzUint | byteCount, | ||
| kzByte * | out_buffer | ||
| ) |
Reads bytes from a resource.
Returns the number of bytes read. Returns 0 if no bytes could be read, because the resource has been completely finished. Returns KZS_RESOURCE_FILE_ERROR if an error occurred.
| kzInt kzsResourceFileSkip | ( | struct KzsResourceFile * | resourceFile, |
| kzUint | byteCount | ||
| ) |
Skips bytes from a resource.
Returns the number of bytes skipped. Returns 0 if no bytes could be skipped, because the resource has been completely finished. Returns KZS_RESOURCE_FILE_ERROR if an error occurred.
| int64_t kzsResourceFileGetLength | ( | const struct KzsResourceFile * | resourceFile | ) |
Gets the length of the resource.
Returns KZS_RESOURCE_FILE_ERROR if an error occurred.
| uint64_t kzsResourceFileGetPosition | ( | const struct KzsResourceFile * | resourceFile | ) |
Gets the current position in a resource.
| kzString kzsResourceFileGetResourceDirectory | ( | const struct KzsResourceFile * | resourceFile | ) |
Gets resource directory that was used when creating the resource file.
| kzString kzsResourceFileGetResourcePath | ( | const struct KzsResourceFile * | resourceFile | ) |
Gets resource path that was used when creating the resource file.
| kzsError kzsResourceFileMemoryMap | ( | struct KzsResourceFile * | resourceFile, |
| kanzi::byte ** | out_map | ||
| ) |
Memory maps the resource file.