mme_explore_size_get()

Get the number of entries to be explored

Synopsis:

#include <mme/explore.h>

ssize_t mme_explore_size_get( mme_explore_hdl_t *x_hdl,
                              uint32_t flags );

Arguments:

x_hdl
An explorer handle returned by mme_explore_start().
flags
For future use.

Library:

mme

Description:

The function mme_explore_size_get() returns the number of entries of interest found in the folder that is currently being explored.


Caution:
  • 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.

Events

None delivered.

Blocking and validation

This function performs no validations. It doesn't block.

Returns:

0
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

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()