Docs Menu
Docs Home
/
MongoDB Atlas
/
Atlas Device SDK
/
C++ SDK
/
CRUD - C++ SDK

CRUD - Update - C++ SDK

項目一覧

  • オブジェクトの更新
  • 埋め込みオブジェクト プロパティの更新
  • 埋め込みオブジェクト プロパティの上書き
  • 逆の関係の更新
  • マップ プロパティを更新
  • セット プロパティの更新

Realm オブジェクトへの更新は、書込みトランザクション (write transaction) 内で発生する必要があります。 書込みトランザクション (write transaction) の詳細については、「書込みトランザクション (write transaction) 」を参照してください。

オブジェクトの更新

書込みトランザクション (write transaction) 内で Realm オブジェクトのプロパティを変更できます。

// Query for the object you want to update
auto dogs = realm.objects<realm::Dog>();
auto dogsNamedMaui =
    dogs.where([](auto &dog) { return dog.name == "Maui"; });
CHECK(dogsNamedMaui.size() >= 1);
// Access an object in the results set.
auto maui = dogsNamedMaui[0];
std::cout << "Dog " << maui.name.detach() << " is " << maui.age.detach()
          << " years old\n";
// Assign a new value to a member of the object in a write transaction
int64_t newAge = 2;
realm.write([&] { maui.age = newAge; });

モデル

この例では、次のモデルを使用します。

struct Dog {
  std::string name;
  int64_t age;
};
REALM_SCHEMA(Dog, name, age)

埋め込みオブジェクト プロパティの更新

埋め込みオブジェクト内のプロパティを更新するには、書込みトランザクション内のプロパティを変更します。

auto managedBusinesses = realm.objects<realm::Business>();
auto businessesNamedMongoDB = managedBusinesses.where(
    [](auto &business) { return business.name == "MongoDB"; });
CHECK(businessesNamedMongoDB.size() >= 1);
auto mongoDB = businessesNamedMongoDB[0];
realm.write(
    [&] { mongoDB.contactDetails->emailAddress = "info@example.com"; });
std::cout << "New email address: "
          << mongoDB.contactDetails->emailAddress.detach() << "\n";

モデル

この例では、次のモデルを使用します。

namespace realm {
struct ContactDetails {
  // Because ContactDetails is an embedded object, it cannot have its own _id
  // It does not have a lifecycle outside of the top-level object
  std::string emailAddress;
  std::string phoneNumber;
};
REALM_EMBEDDED_SCHEMA(ContactDetails, emailAddress, phoneNumber)
struct Business {
  realm::object_id _id;
  std::string name;
  ContactDetails *contactDetails;
};
REALM_SCHEMA(Business, _id, name, contactDetails)
}  // namespace realm

埋め込みオブジェクト プロパティの上書き

埋め込みオブジェクトを上書きするには、埋め込みオブジェクトのプロパティを、書込みトランザクション（write transaction）の新しい インスタンスの未加工のポインターに再割り当てします。

auto businesses = realm.objects<realm::Business>();
auto mongoDBBusinesses = businesses.where(
    [](auto &business) { return business.name == "MongoDB"; });
auto theMongoDB = mongoDBBusinesses[0];
realm.write([&] {
  auto newContactDetails = realm::ContactDetails{
      .emailAddress = "info@example.com", .phoneNumber = "234-567-8901"};
  // Overwrite the embedded object
  theMongoDB.contactDetails = &newContactDetails;
});

モデル

この例では、次のモデルを使用します。

auto managedBusinesses = realm.objects<realm::Business>();
auto businessesNamedMongoDB = managedBusinesses.where(
    [](auto &business) { return business.name == "MongoDB"; });
CHECK(businessesNamedMongoDB.size() >= 1);
auto mongoDB = businessesNamedMongoDB[0];
realm.write(
    [&] { mongoDB.contactDetails->emailAddress = "info@example.com"; });
std::cout << "New email address: "
          << mongoDB.contactDetails->emailAddress.detach() << "\n";

逆の関係の更新

逆関係プロパティを直接更新することはできません。 代わりに、関連するオブジェクトを通じて割り当てを変更することで、逆関係は自動的に更新されます。

この例では、 PersonオブジェクトはDogオブジェクトと 1 対 1 の関係にあり、 DogはPersonと逆の関係にあります。 PersonオブジェクトがDog関係を更新すると、逆関係は自動的に更新されます。

auto config = realm::db_config();
auto realm = realm::db(std::move(config));
auto dog = realm::Dog{.name = "Wishbone"};
auto [joe] = realm.write([&realm]() {
  auto person =
      realm::Person{.name = "Joe", .age = 27, .dog = nullptr};
  return realm.insert(std::move(person));
});
realm.write([&dog, joe = &joe]() { joe->dog = &dog; });
// After assigning `&dog` to jack's `dog` property,
// the backlink automatically updates to reflect
// the inverse relationship through the dog's `owners`
// property.
CHECK(joe.dog->owners.size() == 1);

モデル

この例では、次のモデルを使用します。

struct Dog;
struct Person {
  realm::primary_key<int64_t> _id;
  std::string name;
  int64_t age = 0;
  Dog* dog;
};
REALM_SCHEMA(Person, _id, name, age, dog)
struct Dog {
  realm::primary_key<int64_t> _id;
  std::string name;
  int64_t age = 0;
  linking_objects<&Person::dog> owners;
};
REALM_SCHEMA(Dog, _id, name, age, owners)

マップ プロパティを更新

邦土 マッププロパティ は、標準のC++ マップ と同様に更新できます。

// You can check that a key exists using `find`
auto findTuesday = tommy.locationByDay.find("Tuesday");
if (findTuesday != tommy.locationByDay.end())
  realm.write([&] {
    tommy.locationByDay["Tuesday"] =
        realm::Employee::WorkLocation::HOME;
  });
;

モデル

この例では、次のモデルを使用します。

namespace realm {
struct Employee {
  enum class WorkLocation { HOME, OFFICE };
  int64_t _id;
  std::string firstName;
  std::string lastName;
  std::map<std::string, WorkLocation> locationByDay;
};
REALM_SCHEMA(Employee, _id, firstName, lastName, locationByDay)
}  // namespace realm

セット プロパティの更新

書込みトランザクション (write transaction) 内でセットのプロパティを更新できます。 セットに.insert()要素を追加したり、セットからerase()要素を追加したり、 std::setアルゴリズムを使用してセットを変更したりできます。

// Add elements to the set in a write transaction
realm.write([&] { managedDocsRealm.openPullRequestNumbers.insert(3066); });
CHECK(managedDocsRealm.openPullRequestNumbers.size() == 4);
// Use std::set algorithms to update a set
// In this example, use std::set_union to add elements to the set
// 3064 already exists, so it won't be added, but 3065 and 3067 are
// unique values and will be added to the set.
auto newOpenPullRequests = std::set<int64_t>({3064, 3065, 3067});
realm.write([&] {
  std::set_union(
      docsRealm.openPullRequestNumbers.begin(),
      docsRealm.openPullRequestNumbers.end(), newOpenPullRequests.begin(),
      newOpenPullRequests.end(),
      std::inserter(managedDocsRealm.openPullRequestNumbers,
                    managedDocsRealm.openPullRequestNumbers.end()));
});
CHECK(managedDocsRealm.openPullRequestNumbers.size() == 6);
// Erase elements from a set
auto it3065 = managedDocsRealm.openPullRequestNumbers.find(3065);
CHECK(it3065 != managedDocsRealm.openPullRequestNumbers.end());
realm.write([&] { managedDocsRealm.openPullRequestNumbers.erase(it3065); });

モデル

この例では、次のモデルを使用します。

namespace realm {
struct Repository {
  std::string ownerAndName;
  std::set<int64_t> openPullRequestNumbers;
};
REALM_SCHEMA(Repository, ownerAndName, openPullRequestNumbers)
}  // namespace realm

戻る

読み取り

次へ

削除