X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=gtk2_ardour%2Fport_group.cc;h=96db6f73e718a5ce36c45d286ad0f1aa12203fef;hb=cf52d6e4b40111eb04b244ec054055a4ec15dbe0;hp=1d36a52364e85ab5c16cedd78832af6520293715;hpb=60cc81ea1a4637defa51b059da9ad2a2285ae276;p=ardour.git diff --git a/gtk2_ardour/port_group.cc b/gtk2_ardour/port_group.cc index 1d36a52364..96db6f73e7 100644 --- a/gtk2_ardour/port_group.cc +++ b/gtk2_ardour/port_group.cc @@ -19,23 +19,31 @@ #include #include +#include + +#include "midi++/mmc.h" -#include "ardour/audio_track.h" #include "ardour/audioengine.h" +#include "ardour/auditioner.h" #include "ardour/bundle.h" -#include "ardour/user_bundle.h" +#include "ardour/control_protocol_manager.h" #include "ardour/io_processor.h" -#include "ardour/midi_track.h" +#include "ardour/midi_port.h" +#include "ardour/midiport_manager.h" #include "ardour/port.h" +#include "ardour/profile.h" #include "ardour/session.h" -#include "ardour/auditioner.h" +#include "ardour/user_bundle.h" + +#include "control_protocol/control_protocol.h" +#include "gui_thread.h" #include "port_group.h" #include "port_matrix.h" #include "time_axis_view.h" #include "public_editor.h" -#include "i18n.h" +#include "pbd/i18n.h" using namespace std; using namespace Gtk; @@ -50,6 +58,14 @@ PortGroup::PortGroup (std::string const & n) } +PortGroup::~PortGroup() +{ + for (BundleList::iterator i = _bundles.begin(); i != _bundles.end(); ++i) { + delete *i; + } + _bundles.clear (); +} + /** Add a bundle to a group. * @param b Bundle. * @param allow_dups true to allow the group to contain more than one bundle with the same port, otherwise false. @@ -80,35 +96,38 @@ PortGroup::add_bundle (boost::shared_ptr b, boost::shared_ptr io, Gd add_bundle_internal (b, io, true, c, false); } +PortGroup::BundleRecord::BundleRecord (boost::shared_ptr b, boost::shared_ptr iop, Gdk::Color c, bool has_c) + : bundle (b) + , io (iop) + , colour (c) + , has_colour (has_c) +{ +} + void PortGroup::add_bundle_internal (boost::shared_ptr b, boost::shared_ptr io, bool has_colour, Gdk::Color colour, bool allow_dups) { assert (b.get()); if (!allow_dups) { - + /* don't add this bundle if we already have one with the same ports */ - + BundleList::iterator i = _bundles.begin (); - while (i != _bundles.end() && b->has_same_ports (i->bundle) == false) { + while (i != _bundles.end() && b->has_same_ports ((*i)->bundle) == false) { ++i; } - + if (i != _bundles.end ()) { return; } } - BundleRecord r; - r.bundle = b; - r.io = io; - r.colour = colour; - r.has_colour = has_colour; - r.changed_connection = b->Changed.connect (sigc::mem_fun (*this, &PortGroup::bundle_changed)); + BundleRecord* br = new BundleRecord (b, io, colour, has_colour); + b->Changed.connect (br->changed_connection, invalidator (*this), boost::bind (&PortGroup::bundle_changed, this, _1), gui_context()); + _bundles.push_back (br); - _bundles.push_back (r); - - Changed (); + Changed (); } void @@ -117,7 +136,7 @@ PortGroup::remove_bundle (boost::shared_ptr b) assert (b.get()); BundleList::iterator i = _bundles.begin (); - while (i != _bundles.end() && i->bundle != b) { + while (i != _bundles.end() && (*i)->bundle != b) { ++i; } @@ -125,7 +144,7 @@ PortGroup::remove_bundle (boost::shared_ptr b) return; } - i->changed_connection.disconnect (); + delete *i; _bundles.erase (i); Changed (); @@ -142,7 +161,7 @@ void PortGroup::clear () { for (BundleList::iterator i = _bundles.begin(); i != _bundles.end(); ++i) { - i->changed_connection.disconnect (); + delete *i; } _bundles.clear (); @@ -153,7 +172,7 @@ bool PortGroup::has_port (std::string const& p) const { for (BundleList::const_iterator i = _bundles.begin(); i != _bundles.end(); ++i) { - if (i->bundle->offers_port_alone (p)) { + if ((*i)->bundle->offers_port_alone (p)) { return true; } } @@ -165,16 +184,16 @@ boost::shared_ptr PortGroup::only_bundle () { assert (_bundles.size() == 1); - return _bundles.front().bundle; + return _bundles.front()->bundle; } -uint32_t +ChanCount PortGroup::total_channels () const { - uint32_t n = 0; + ChanCount n; for (BundleList::const_iterator i = _bundles.begin(); i != _bundles.end(); ++i) { - n += i->bundle->nchannels (); + n += (*i)->bundle->nchannels (); } return n; @@ -184,7 +203,7 @@ boost::shared_ptr PortGroup::io_from_bundle (boost::shared_ptr b) const { BundleList::const_iterator i = _bundles.begin (); - while (i != _bundles.end() && i->bundle != b) { + while (i != _bundles.end() && (*i)->bundle != b) { ++i; } @@ -192,28 +211,76 @@ PortGroup::io_from_bundle (boost::shared_ptr b) const return boost::shared_ptr (); } - return i->io; + boost::shared_ptr io ((*i)->io.lock ()); + return io; +} + +/** Remove bundles whose channels are already represented by other, larger bundles */ +void +PortGroup::remove_duplicates () +{ + BundleList::iterator i = _bundles.begin(); + while (i != _bundles.end()) { + + BundleList::iterator tmp = i; + ++tmp; + + bool remove = false; + + for (BundleList::iterator j = _bundles.begin(); j != _bundles.end(); ++j) { + + if ((*j)->bundle->nchannels() > (*i)->bundle->nchannels()) { + /* this bundle is larger */ + + uint32_t k = 0; + while (k < (*i)->bundle->nchannels().n_total()) { + /* see if this channel on *i has an equivalent on *j */ + uint32_t l = 0; + while (l < (*j)->bundle->nchannels().n_total() && (*i)->bundle->channel_ports (k) != (*j)->bundle->channel_ports (l)) { + ++l; + } + + if (l == (*j)->bundle->nchannels().n_total()) { + /* it does not */ + break; + } + + ++k; + } + + if (k == (*i)->bundle->nchannels().n_total()) { + /* all channels on *i are represented by the larger bundle *j, so remove *i */ + remove = true; + break; + } + } + } + + if (remove) { + _bundles.erase (i); + } + + i = tmp; + } } /** PortGroupList constructor. */ PortGroupList::PortGroupList () - : _type (DataType::AUDIO), _signals_suspended (false), _pending_change (false), _pending_bundle_change ((Bundle::Change) 0) + : _signals_suspended (false), _pending_change (false), _pending_bundle_change ((Bundle::Change) 0) { } -void -PortGroupList::set_type (DataType t) +PortGroupList::~PortGroupList() { - _type = t; - clear (); + /* XXX need to clean up bundles, but ownership shared with PortGroups */ } void PortGroupList::maybe_add_processor_to_list ( - boost::weak_ptr wp, list >* route_bundles, bool inputs, set >& used_io + boost::weak_ptr wp, list >* route_ios, bool inputs, set >& used_io ) { boost::shared_ptr p (wp.lock()); @@ -229,16 +296,38 @@ PortGroupList::maybe_add_processor_to_list ( boost::shared_ptr io = inputs ? iop->input() : iop->output(); if (io && used_io.find (io) == used_io.end()) { - route_bundles->push_back (io->bundle ()); + route_ios->push_back (io); used_io.insert (io); } } } +struct RouteIOs { + RouteIOs (boost::shared_ptr r, boost::shared_ptr i) { + route = r; + ios.push_back (i); + } + + boost::shared_ptr route; + /* it's ok to use a shared_ptr here as RouteIOs structs are only used during ::gather () */ + std::list > ios; +}; -/** Gather bundles from around the system and put them in this PortGroupList */ +class RouteIOsComparator { +public: + bool operator() (RouteIOs const & a, RouteIOs const & b) { + return a.route->presentation_info ().order() < b.route->presentation_info().order(); + } +}; + +/** Gather ports from around the system and put them in this PortGroupList. + * @param type Type of ports to collect, or NIL for all types. + * @param use_session_bundles true to use the session's non-user bundles. Doing this will mean that + * hardware ports will be gathered into stereo pairs, as the session sets up bundles for these pairs. + * Not using the session bundles will mean that all hardware IO will be presented separately. + */ void -PortGroupList::gather (ARDOUR::Session* session, bool inputs, bool allow_dups) +PortGroupList::gather (ARDOUR::Session* session, ARDOUR::DataType type, bool inputs, bool allow_dups, bool use_session_bundles) { clear (); @@ -246,63 +335,67 @@ PortGroupList::gather (ARDOUR::Session* session, bool inputs, bool allow_dups) return; } - boost::shared_ptr bus (new PortGroup (_("Bus"))); - boost::shared_ptr track (new PortGroup (_("Track"))); - boost::shared_ptr system (new PortGroup (_("System"))); - boost::shared_ptr ardour (new PortGroup (_("Ardour"))); + boost::shared_ptr bus (new PortGroup (string_compose (_("%1 Busses"), PROGRAM_NAME))); + boost::shared_ptr track (new PortGroup (string_compose (_("%1 Tracks"), PROGRAM_NAME))); + boost::shared_ptr system (new PortGroup (_("Hardware"))); + boost::shared_ptr program (new PortGroup (string_compose (_("%1 Misc"), PROGRAM_NAME))); boost::shared_ptr other (new PortGroup (_("Other"))); - /* Find the bundles for routes. We use the RouteBundle class to join - the route's input/output and processor bundles together so that they - are presented as one bundle in the matrix. */ + /* Find the IOs which have bundles for routes and their processors. We store + these IOs in a RouteIOs class so that we can then sort the results by route + order key. + */ boost::shared_ptr routes = session->get_routes (); + list route_ios; for (RouteList::const_iterator i = routes->begin(); i != routes->end(); ++i) { - list > route_bundles; + /* we never show the monitor bus inputs */ + + if (inputs && (*i)->is_monitor()) { + continue; + } /* keep track of IOs that we have taken bundles from, so that we can avoid taking the same IO from both - Route::output() and the main_outs Delivery */ + Route::output() and the main_outs Delivery + */ set > used_io; boost::shared_ptr io = inputs ? (*i)->input() : (*i)->output(); used_io.insert (io); - route_bundles.push_back (io->bundle ()); - - (*i)->foreach_processor (sigc::bind (sigc::mem_fun (*this, &PortGroupList::maybe_add_processor_to_list), &route_bundles, inputs, used_io)); + RouteIOs rb (*i, io); + (*i)->foreach_processor (boost::bind (&PortGroupList::maybe_add_processor_to_list, this, _1, &rb.ios, inputs, used_io)); - /* Work out which group to put these bundles in */ - boost::shared_ptr g; - if (_type == DataType::AUDIO) { - - if (boost::dynamic_pointer_cast (*i)) { - g = track; - } else if (!boost::dynamic_pointer_cast(*i)) { - g = bus; - } + route_ios.push_back (rb); + } + /* Sort RouteIOs by the routes' editor order keys */ + route_ios.sort (RouteIOsComparator ()); - } else if (_type == DataType::MIDI) { + /* Now put the bundles that belong to these sorted RouteIOs into the PortGroup. + Note that if the RouteIO's bundles are multi-type, we may make new Bundles + with only the ports of one type. + */ - if (boost::dynamic_pointer_cast (*i)) { - g = track; - } + for (list::iterator i = route_ios.begin(); i != route_ios.end(); ++i) { + TimeAxisView* tv = PublicEditor::instance().axis_view_from_stripable (i->route); - /* No MIDI busses yet */ + /* Work out which group to put these IOs' bundles in */ + boost::shared_ptr g; + if (boost::dynamic_pointer_cast (i->route)) { + g = track; + } else { + g = bus; } - if (g) { - - TimeAxisView* tv = PublicEditor::instance().axis_view_from_route (*i); - for (list >::iterator i = route_bundles.begin(); i != route_bundles.end(); ++i) { - if (tv) { - g->add_bundle (*i, io, tv->color ()); - } else { - g->add_bundle (*i, io); - } + for (list >::iterator j = i->ios.begin(); j != i->ios.end(); ++j) { + if (tv) { + g->add_bundle ((*j)->bundle(), *j, tv->color ()); + } else { + g->add_bundle ((*j)->bundle(), *j); } } } @@ -314,94 +407,263 @@ PortGroupList::gather (ARDOUR::Session* session, bool inputs, bool allow_dups) boost::shared_ptr b = session->bundles (); for (BundleList::iterator i = b->begin(); i != b->end(); ++i) { - if (boost::dynamic_pointer_cast (*i) && (*i)->ports_are_inputs() == inputs && (*i)->type() == _type) { + if (boost::dynamic_pointer_cast (*i) && (*i)->ports_are_inputs() == inputs) { system->add_bundle (*i, allow_dups); } } - for (BundleList::iterator i = b->begin(); i != b->end(); ++i) { - if (boost::dynamic_pointer_cast (*i) == 0 && (*i)->ports_are_inputs() == inputs && (*i)->type() == _type) { - system->add_bundle (*i, allow_dups); + /* Only look for non-user bundles if instructed to do so */ + if (use_session_bundles) { + for (BundleList::iterator i = b->begin(); i != b->end(); ++i) { + if (boost::dynamic_pointer_cast (*i) == 0 && (*i)->ports_are_inputs() == inputs) { + system->add_bundle (*i, allow_dups); + } } } - - /* Ardour stuff */ - if (!inputs && _type == DataType::AUDIO) { - ardour->add_bundle (session->the_auditioner()->output()->bundle()); - ardour->add_bundle (session->click_io()->bundle()); + /* miscellany */ + + if (type == DataType::AUDIO || type == DataType::NIL) { + if (!inputs) { + program->add_bundle (session->the_auditioner()->output()->bundle()); + program->add_bundle (session->click_io()->bundle()); + /* Note: the LTC ports do not have the usual ":audio_out 1" postfix, so + * program->add_bundle (session->ltc_output_io()->bundle()); + * won't work + */ + boost::shared_ptr ltc (new Bundle (_("LTC Out"), inputs)); + ltc->add_channel (_("LTC Out"), DataType::AUDIO, session->engine().make_port_name_non_relative (session->ltc_output_port()->name())); + program->add_bundle (ltc); + } else { + boost::shared_ptr ltc (new Bundle (_("LTC In"), inputs)); + ltc->add_channel (_("LTC In"), DataType::AUDIO, session->engine().make_port_name_non_relative (session->ltc_input_port()->name())); + program->add_bundle (ltc); + } } - /* Now find all other ports that we haven't thought of yet */ + /* our control surfaces */ - std::vector extra_system; - std::vector extra_other; + /* XXX assume for now that all control protocols with ports use + * MIDI. If anyone created a control protocol that used audio ports, + * this will break. + */ - const char **ports = session->engine().get_ports ("", _type.to_jack_type(), inputs ? - JackPortIsInput : JackPortIsOutput); - if (ports) { + if ((type == DataType::MIDI || type == DataType::NIL)) { + ControlProtocolManager& m = ControlProtocolManager::instance (); + for (list::iterator i = m.control_protocol_info.begin(); i != m.control_protocol_info.end(); ++i) { + if ((*i)->protocol) { + list > b = (*i)->protocol->bundles (); + for (list >::iterator j = b.begin(); j != b.end(); ++j) { + if ((*j)->ports_are_inputs() == inputs) { + program->add_bundle (*j); + } + } + } + } + } - int n = 0; - string client_matching_string; + /* our sync ports */ + + if ((type == DataType::MIDI || type == DataType::NIL)) { + boost::shared_ptr sync (new Bundle (_("Sync"), inputs)); + AudioEngine* ae = AudioEngine::instance(); + + if (inputs) { + sync->add_channel ( + _("MTC in"), DataType::MIDI, ae->make_port_name_non_relative (session->mtc_input_port()->name()) + ); + sync->add_channel ( + _("MIDI control in"), DataType::MIDI, ae->make_port_name_non_relative (session->midi_input_port()->name()) + ); + sync->add_channel ( + _("MIDI clock in"), DataType::MIDI, ae->make_port_name_non_relative (session->midi_clock_input_port()->name()) + ); + sync->add_channel ( + _("MMC in"), DataType::MIDI, ae->make_port_name_non_relative (session->mmc_input_port()->name()) + ); + } else { + sync->add_channel ( + _("MTC out"), DataType::MIDI, ae->make_port_name_non_relative (session->mtc_output_port()->name()) + ); + sync->add_channel ( + _("MIDI control out"), DataType::MIDI, ae->make_port_name_non_relative (session->midi_output_port()->name()) + ); + sync->add_channel ( + _("MIDI clock out"), DataType::MIDI, ae->make_port_name_non_relative (session->midi_clock_output_port()->name()) + ); + sync->add_channel ( + _("MMC out"), DataType::MIDI, ae->make_port_name_non_relative (session->mmc_output_port()->name()) + ); + } - client_matching_string = session->engine().client_name(); - client_matching_string += ':'; + program->add_bundle (sync); + } - while (ports[n]) { + /* Now find all other ports that we haven't thought of yet */ - std::string const p = ports[n]; + std::vector extra_system[DataType::num_types]; + std::vector extra_program[DataType::num_types]; + std::vector extra_other[DataType::num_types]; + + string lpn (PROGRAM_NAME); + boost::to_lower (lpn); + string lpnc = lpn; + lpnc += ':'; + + vector ports; + if (type == DataType::NIL) { + vector p1; + AudioEngine::instance()->get_ports ("", DataType::AUDIO, inputs ? IsInput : IsOutput, ports); + AudioEngine::instance()->get_ports ("", DataType::MIDI, inputs ? IsInput : IsOutput, p1); + for (vector::const_iterator s = p1.begin(); s != p1.end(); ++s) { + ports.push_back (*s); + } + } else { + AudioEngine::instance()->get_ports ("", type, inputs ? IsInput : IsOutput, ports); + } + + if (ports.size () > 0) { + + for (vector::const_iterator s = ports.begin(); s != ports.end(); ) { + + std::string const p = *s; if (!system->has_port(p) && !bus->has_port(p) && !track->has_port(p) && - !ardour->has_port(p) && + !program->has_port(p) && !other->has_port(p)) { - if (port_has_prefix (p, "system:") || - port_has_prefix (p, "alsa_pcm") || - port_has_prefix (p, "ardour:")) { - extra_system.push_back (p); - } else { - extra_other.push_back (p); + /* special hack: ignore MIDI ports labelled Midi-Through. these + are basically useless and mess things up for default + connections. + */ + + if (p.find ("Midi-Through") != string::npos) { + ++s; + continue; + } + + /* special hack: ignore our monitor inputs (which show up here because + we excluded them earlier. + */ + + string lp = p; + boost::to_lower (lp); + + if ((lp.find (N_(":monitor")) != string::npos) && + (lp.find (lpn) != string::npos)) { + ++s; + continue; + } + + /* can't use the audio engine for this as we + * are looking at ports not owned by the + * application, and the audio engine/port + * manager doesn't seem them. + */ + + PortEngine::PortHandle ph = AudioEngine::instance()->port_engine().get_port_by_name (p); + if (ph) { + DataType t (AudioEngine::instance()->port_engine().port_data_type (ph)); + if (t != DataType::NIL) { + if (port_has_prefix (p, N_("system:")) || + port_has_prefix (p, N_("alsa_pcm:")) || + port_has_prefix (p, N_("alsa_midi:"))) { + extra_system[t].push_back (p); + } else if (port_has_prefix (p, lpnc)) { + /* Hide scene ports from non-Tracks Live builds */ + if (!ARDOUR::Profile->get_trx()) { + if (p.find (_("Scene ")) != string::npos) { + ++s; + continue; + } + } + extra_program[t].push_back (p); + } else { + extra_other[t].push_back (p); + } + } } } - ++n; + ++s; } + } - free (ports); + for (DataType::iterator i = DataType::begin(); i != DataType::end(); ++i) { + if (!extra_system[*i].empty()) { + boost::shared_ptr b = make_bundle_from_ports (extra_system[*i], *i, inputs); + system->add_bundle (b); + } } - if (!extra_system.empty()) { - boost::shared_ptr b = make_bundle_from_ports (extra_system, inputs); - system->add_bundle (b); + for (DataType::iterator i = DataType::begin(); i != DataType::end(); ++i) { + if (!extra_program[*i].empty()) { + /* remove program name prefix from port name and use rest as bundle name */ + std::string bundle_name = extra_program[*i].front().substr (lpnc.length()); + boost::shared_ptr b = make_bundle_from_ports (extra_program[*i], *i, inputs, bundle_name); + program->add_bundle (b); + } } - if (!extra_other.empty()) { - other->add_bundle (make_bundle_from_ports (extra_other, inputs)); + for (DataType::iterator i = DataType::begin(); i != DataType::end(); ++i) { + if (extra_other[*i].empty()) continue; + std::string cp; + std::vector nb; + for (uint32_t j = 0; j < extra_other[*i].size(); ++j) { + std::string nn = extra_other[*i][j]; + std::string pf = nn.substr (0, nn.find_first_of (":") + 1); + if (pf != cp && !nb.empty()) { + boost::shared_ptr b = make_bundle_from_ports (nb, *i, inputs); + other->add_bundle (b); + nb.clear(); + } + cp = pf; + nb.push_back(extra_other[*i][j]); + } + if (!nb.empty()) { + boost::shared_ptr b = make_bundle_from_ports (nb, *i, inputs); + other->add_bundle (b); + } + } + + if (!allow_dups) { + system->remove_duplicates (); } - add_group_if_not_empty (system); - add_group_if_not_empty (bus); - add_group_if_not_empty (track); - add_group_if_not_empty (ardour); add_group_if_not_empty (other); + if (type != DataType::MIDI) { + add_group_if_not_empty (bus); + } + add_group_if_not_empty (track); + add_group_if_not_empty (program); + add_group_if_not_empty (system); emit_changed (); } boost::shared_ptr -PortGroupList::make_bundle_from_ports (std::vector const & p, bool inputs) const +PortGroupList::make_bundle_from_ports (std::vector const & p, ARDOUR::DataType type, bool inputs, std::string const& bundle_name) const { - boost::shared_ptr b (new Bundle ("", _type, inputs)); - + boost::shared_ptr b (new Bundle ("", inputs)); std::string const pre = common_prefix (p); - if (!pre.empty()) { - b->set_name (pre.substr (0, pre.length() - 1)); + + if (!bundle_name.empty()) { + b->set_name (bundle_name); + } else { + if (!pre.empty()) { + b->set_name (pre.substr (0, pre.length() - 1)); + } } for (uint32_t j = 0; j < p.size(); ++j) { - b->add_channel (p[j].substr (pre.length())); + std::string n = p[j].substr (pre.length()); + std::string pn = AudioEngine::instance()->get_pretty_name_by_name (p[j]); + if (!pn.empty()) { + n = pn; + } + b->add_channel (n, type); b->set_port (j, p[j]); } @@ -463,13 +725,7 @@ void PortGroupList::clear () { _groups.clear (); - - for (std::vector::iterator i = _bundle_changed_connections.begin(); i != _bundle_changed_connections.end(); ++i) { - i->disconnect (); - } - - _bundle_changed_connections.clear (); - + _bundle_changed_connections.drop_connections (); emit_changed (); } @@ -486,10 +742,10 @@ PortGroupList::bundles () const return _bundles; } -uint32_t +ChanCount PortGroupList::total_channels () const { - uint32_t n = 0; + ChanCount n; for (PortGroupList::List::const_iterator i = begin(); i != end(); ++i) { n += (*i)->total_channels (); @@ -511,11 +767,8 @@ PortGroupList::add_group (boost::shared_ptr g) { _groups.push_back (g); - g->Changed.connect (sigc::mem_fun (*this, &PortGroupList::emit_changed)); - - _bundle_changed_connections.push_back ( - g->BundleChanged.connect (sigc::mem_fun (*this, &PortGroupList::emit_bundle_changed)) - ); + g->Changed.connect (_changed_connections, invalidator (*this), boost::bind (&PortGroupList::emit_changed, this), gui_context()); + g->BundleChanged.connect (_bundle_changed_connections, invalidator (*this), boost::bind (&PortGroupList::emit_bundle_changed, this, _1), gui_context()); emit_changed (); } @@ -589,11 +842,5 @@ PortGroupList::io_from_bundle (boost::shared_ptr b) const bool PortGroupList::empty () const { - List::const_iterator i = _groups.begin (); - while (i != _groups.end() && (*i)->total_channels() == 0) { - ++i; - } - - return (i == _groups.end()); + return _groups.empty (); } -