Comment 10 for bug 670358

I am really interested in this API since it would help a lot to the Music players like number of time a track is player. Music player is used by everyone, so it is a good use case which might reach out the maximum to the users. I just need some explanation

def find_events_and_data(*find_event_arguments, datatype_const):
    ...
    return result

result = [events, data]

datatype_const:
    DATATYPE_COUNT -> result of COUNT() from within the sql-query
    DATATYPE_RELATIVE_COUNT -> result of COUNT() from within the sql-query relative to the overall result

Can anyone explain a sample of how the *find_event_arguments might look? Is it an event template? Single or a list?

I got datatype_const (which is sort of an enumeration, but not true in the strict sense)

about [events,data] how are they contained? It would be very clear if Markus gives a complete example. Sample input data, and sample output data.