Documentation's instructions generate Exception: "io.realm.exceptions.RealmException: Removing is not supported."

I just started playing around with Realm on a small project I have. I want to be able to delete objects from the database. Your documentation states I should do the following:

// remove a single object
Dog dog = result.get(5);
dog.removeFromRealm();

This throws an exception instead of working:

    io.realm.exceptions.RealmException: Removing is not supported.
    at io.realm.RealmResults$RealmResultsIterator.remove(RealmResults.java:552)
    at java.util.AbstractCollection.remove(AbstractCollection.java:229)

And it is because the code always throws an exception at that point: https://github.com/realm/realm-java/blob/71e94e1ab8688bfb796e9f0e401462060428cd40/realm/src/main/java/io/realm/RealmResults.java#L552

What is the workaround here? Why hasn’t the documentation been updated?

[MobileOak]

I have tried again to get this working, to no avail.

I load from the database players for my app:

mPlayers = realm.where(Player.class).findAll();

This array is then passed to an ArrayAdapter class to be shown in a listview, with a button for deleting the player.

        mViewHolder.delete.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (mListener != null) {
                    mListener.deletePlayer(player);
                }
            }
        });

This calls delete player on the original Activity. Originally I had this code:

public void deletePlayer(final Player player) {
    mPlayers.remove(player);
    mAdapter.notifyDataSetChanged();
    player.removeFromRealm();

I thought this would work as per the example in your documentation, but it doesn’t, it calls the “Removing is not supported” function and crashes my app.

So based on your suggestion, I thought I needed to do a new get() call on the original RealmResults and remove it that way, so I changed the code:

public void deletePlayer(final Player player) {
    mPlayers.remove(player);
    mAdapter.notifyDataSetChanged();

    for (int i = 0; i < mPlayers.size(); i++) {
      if (player == mPlayers.get(i)) {
        mPlayers.get(i).removeFromRealm();
      }
    }

This as well causes the Exception to be thrown.

This is your documentation:

// remove a single object
Dog dog = result.get(5);
dog.removeFromRealm();

There is no context here at all for me to figure out what result is, or how it was acquired. How is my code any different from what’s in your documentation? There’s no warning that the iterator version of the the removeFromRealm method will always throw an exception, nor how to avoid that. This is so far some of the worst documentation I’ve run into for an Android library, and if you expect people to use your product you should have better examples and documentation.

[multivoltage]

I tried some times, but I arrive at the same exception: I have a a list of TravelsRealms object:

for(TravelRealm t : travelRealms){
                    if(t.createdWhen == travel_key){
                        int index = travelRealms.indexOf(t);
                        realm.beginTransaction();
                        travelRealms.remove(index);
                        realm.commitTransaction();
                        homePagerAdapter.notifyDataSetChanged();
                        break;
                    }
}

I user “for” to search inside this list. when objcet is correct, I delete it with a simple remove. I tried with other method like remove(Object), or call t.deleteFromReam(). I have the same error every time