flag_get_entity_flags() @return docs are incomprehensible

 *   If no flag name is given, an array of flagging data, keyed by the user
 *   ID that flagged the entity. Each flagging array is structured as
 *   an array of flag information for each flag, keyed by the flag name. If
 *   a flag name is specified, only the information for that flag is returned.
 *   If no flags were found an empty array is returned.

Argh.