Get the number of entries to be explored
#include <mme/explore.h>
ssize_t mme_explore_size_get( mme_explore_hdl_t *x_hdl,
uint32_t flags );
- x_hdl
- An explorer handle returned by mme_explore_start().
- flags
- For future use.
mme
The function mme_explore_size_get() returns the number of entries of interest found in the folder that is currently being explored.
 |
- mme_explore_size_get() may require considerable time to complete execution: with some mediastore types, it requires a readdir() of the entire item being explored.
- If mme_explore_size_get() is called before the filter is set, its result may not be accurate when the filter is applied.
- The use of filters with mme_explore_position_set() makes using mme_explore_size_get() an expensive operation (for mediastores for which it is normally inexpensive), because the mme_explore_size_get() operation must now traverse the entire session to determine the actual number of items of interest.
|
None delivered.
This function performs no validations. It doesn't block.
- ≥0
- Success.
- -1
- An error occurred (errno is set).
QNX Neutrino
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
Yes |
mme_explore_end(),
mme_explore_hdl_t,
mme_explore_info_free(),
mme_explore_info_get(),
mme_explore_info_t,
mme_explore_playlist_find_file(),
mme_explore_position_set(),
mme_explore_start()