>, Paul Hudson    @twostraws    February 9th 2021. SwiftUI’s @FetchRequest property wrapper is great for making simple requests for objects, providing both sorting and filtering. The @FetchRequest property wrapper is arguably the simplest way to fetch data from Core Data in a SwiftUI view. However, the principle of this code applies to iOS 13 too. Use Fetch Requests to retrieve objects from disk. How to batch delete in Core Data. No matter the flavor that you use, they all require that you inject a managed object context into your view's environment. What's nice about @FetchRequest is that it will automatically refresh your view if any of the fetched objects are updated. SwiftUI implements many data management types, like State and Binding, as In this week's post, we took a look at fetching objects from Core Data in a SwiftUI application. Note that my TodoItemStorage inherits from NSObject. Leveraging Property Wrappers. For example, we could show a table of all languages like this: SPONSORED Are you tired of wasting time debugging your Swift app? While you can fetch data from Core Data with @FetchRequest just fine, I tend to avoid it in my apps. You would only initialize the TodoItemStorage in your SceneDelegate and pass it to your MainView from there rather than making it an @StateObject on the App struct. It frequently also contains: A predicate (an instance of NSPredicate) that specifies which properties to filter by and the constraints on selection, for example, “last name begins with a ‘J’”. Here‘s an example SwiftUI CoreData project with an dynamic changeable predicate in a FetchRequest. We also understood what a managedObjectContext is and how we can fetch stored data by using SwiftUI’s @FetchRequest. Once you’ve passed an NSManagedObjectContext instance to your SwiftUI View, you’ll need to pull data out of your Core Data persistent store with a fetch request.. First Things First. Availability. You'll get thirteen chapters, a Playground and a handful of sample projects to help you get up and running with Combine as soon as possible. This method is called whenever the fetched results controller adds, removes, or updates any of the items that it fetched. While this approach is going to work fine, it does sacrifice some of the optimizations that you get with NSFetchedResultsController. Because FetchedResults is a collection type, you can use it in a List the same way that you would use an array. You can also bind the array controllerâ s filterPredicate binding to a method that returns an NSPredicate object. Published by donnywals on August 10, 2020August 10, 2020. The book is available as a digital download for just $29.99! In this week's post, I will present two different ways that you can use to retrieve data from Core Data and present it in your SwiftUI application. We talked through all basic CRUD operations: Creating, reading, updating, and deleting data. That step is required. You learned how to use Core Data in SwiftUI to store data persistently. If you want to fetch your items without sorting them, you can pass an empty array. We also need to pass sort descriptors to make sure our fetched objects are sorted property. The property that @FetchRequest is applied to has FetchedResults as its type. This book is intended to help you learn Core Data from scratch using modern techniques and every chapter features sample Read more…, I love posts where I get to put write about two of my favorite frameworks at the moment; Combine and Core Data. Context to fetch a way such that this will print the body in the complexities of memory? In my example setup we created a ProgrammingLanguages entity that had name and creator attributes, so we could create a fetch request for it like this: That loads all programming languages, sorted alphabetically by their name. With just a couple of line of code you can implement Core Data in SwiftUI to manage your data locally ... so we need just one fetch request without filtering the data. Once you’ve passed an NSManagedObjectContext instance to your SwiftUI View, you’ll need to pull data out of your Core Data persistent store with a fetch request.. First Things First. Fetch requests allow us to load Core Data results that match specific criteria we specify, and SwiftUI can bind those results directly to user interface elements. Core Data: Part 3 – Fetch Request Get SwiftUI - The Complete Developer Course and SwiftUI Bible now with O’Reilly online learning. I'm spending hours to figure out how to fetch values uniquely from a property of a data model (CoreData). When you use SwiftUI’s @FetchRequest property wrapper to pull objects out of Core Data, you get to specify how you want the data to be sorted – should it alphabetically by one of the fields? If an NSFetchedResultsController doesn't work for your purposes, you could listen to Core Data related notifications in NotificationCenter yourself and perform a new fetch request if needed. Using Core Data in Your SwiftUI App with Combine, MVVM and Protocols (this tutorial). Response actually using higher level objects representing the code. If you're familiar with Core Data you might wonder how you would use an NSPredicate to filter your fetched objects with @FetchRequest. Specifically, using a Core Data NSManagedObject as a data provider of a View. Usually, this shouldn't be a problem because an unsorted list in Core Data will always come back in an undefined order which, in my experience, is not desirable for most applications. Using Core Data with SwiftUI App Protocol. The remainder of this how-to assumes that you’ve already got a way to initialize the Core Data stack. In the init for MyApplication I create my PersistenceManager and extract a managed object context from it. This article covers a topic that is extensively covered in my Practical Core Data book. Please see attached screens from the core data editor. In this section, I will show you an approach that should fit common use cases where the only prerequisite is that you have a property to sort your fetched objects on. In this video, Mohammad Azam is going to demonstrate how to fetch and display data from a Web API using SwiftUI and Combine Framework. We talked through all basic CRUD operations: Creating, reading, updating, and deleting data. Note that not setting a managed object context on the view's environment while using @FetchRequest will result in a crash. Fetch requests allow us to load Core Data results that match specific criteria we specify, and SwiftUI can bind those results directly to user interface elements. This abstraction is built on top of NSFetchedResultsContoller which is a very convenient way to fetch data using a fetch request, and receive updates whenever the result of the fetch request changes. The data that I am going to u se in this app will come from the movie site where you can register an account and get the API key. Active 2 years, 11 months ago. Learn everything you need to know about Combine and how you can use it in your projects with my new book Practical Combine. Inside of MainView, you can create a property that's annotated with @FetchRequest to fetch objects using the managed object context that you injected into MainView's environment. There is more than one way to build an abstraction that fetches data from Core Data and updates your views as needed. CoreData is a framework that helps you manage the model layer objects in your application and it’s quite simple to use as some of … Shared Models, Core Data Managed Object Model, Utils, as well as extensions to help us build the project. To learn more about the Core Data part, please refer to the part 1 of this tutorial series, Building Expense Tracker iOS App with Core Data & SwiftUI; WatchOS App Target with empty implementation. Code of Conduct. Instabug’s SDK is here to help you minimize debugging time by providing you with complete device details, network logs, and reproduction steps with every bug report. To learn more about the Core Data part, please refer to the part 1 of this tutorial series, Building Expense Tracker iOS App with Core Data & SwiftUI; WatchOS App Target with empty implementation. Unfortunately, @FetchRequest by its very definition is incompatible with this approach. Let's look at a basic example of @FetchRequest usage: The version of the @FetchRequest property wrapper takes two arguments. Several flavors of the @FetchRequest property wrapper are available. < How to access a Core Data managed object context from a SwiftUI view, How to filter Core Data fetch requests using a predicate >, Core Data and SwiftUI set up instructions, All SwiftUI property wrappers explained and compared, How to configure Core Data to work with SwiftUI, Introduction to using Core Data with SwiftUI, How to create a document-based app using FileDocument and DocumentGroup, How to position views in a grid using LazyVGrid and LazyHGrid, Click here to visit the Hacking with Swift store >>. As you can see, the sortDescriptors parameter is an array, so you can provide as many sorting options as you need like this: Yes, that’s a massive line of code, so I wouldn’t blame you if you broke it up into something a little easier to read: Regardless of how you create your fetch request, the results can be used directly inside SwiftUI views. You can set up your own fetch request and pass it to @FetchRequest as follows: I prefer this way of setting up a fetch request because it's more reusable, and it's also a lot cleaner when using @FetchRequest in your views. That step is required. While this object is commonly used in conjunction with table views and collection views, we can also use it to drive a SwiftUI view. And because TodoItemStorage is built on top of NSFetchedResultsController we can easily update the dueSoon property when needed. When conducting an NS Fetch Request, you most likely do not want every record in your database, but a subset of the date. In my opinion, this is one of the powers of hiding Core Data behind a simple storage abstraction. SwiftUI - Deleting from a Core Data NSSet - @FetchRequest with .onDelete() 7 @FetchRequest results not updating in SwiftUI when change source is share extension. Or numerically with the highest numbers first? You might not even want to update another context but reload your UI Read more…, earlier post I wrote about using Core Data in a SwiftUI 2.0 application, Preventing unwanted fetches when using NSFetchedResultsController and fetchBatchSize, Observing the result of saving a background managed object context with Combine, Responding to changes in a managed object context, Expose data to your SwiftUI views with an observable object and an. Hard to believe, but in less than 40 lines of code, we’re able to not only define a simple data model for books, as well as some sample data, but also a screen that displays the books in a list - that’s the power of SwiftUI! First, the entity description for the object that you want to fetch. The main reason for this is that I've always tried to separate my Core Data code from the rest of my application as much as possible. ... How to use Core Data Relationship in ForEach SwiftUI. ... /* Fetch request, get the patient with that UUID, etc... */} func changePatient(to: UUID) {}} And whenever that patient changes all my SwiftUI views that are observing the "patient" variable reloads automatically. The result of doing this was a view that is blissfully unaware of Core Data and fetch requests. If you have any questions about this post, or if you have feedback for me, don't hesitate to reach out to me on Twitter. If you prefer Objective-C, then I recommend reading my earlier series on the Core Data framework. Next, I assign the fetched results controller's fetched objects to my dueSoon property. Creating a fetch request requires two pieces of information: the entity you want to query, and a sort descriptor that determines the order in which results are returned. When conducting an NS Fetch Request, you most likely do not want every record in your database, but a subset of the date. I know I said that I wouldn't enhance this project any further, but after hearing no real new news along these lines from Apple at WWDC 2020, I felt I had to tidy up a few loose ends and make a few additional enhancements for myself. By the end of this post you will be able to: Since @FetchRequest is by far the simplest approach, let's look at that first. Is it a @ObjectBinding? Once you’ve passed an NSManagedObjectContext instance to your SwiftUI View, you’ll need to pull data out of your Core Data persistent store with a fetch request.. First Things First. Refund Policy             Distribute value data throughout your app by storing it in the Environment. Fetch and parse data. It frequently also contains: A predicate (an instance of NSPredicate) that specifies which properties to filter by and the constraints on selection, for example, “last name begins with a ‘J’”. Note that it uses a static method nextWeek() that I defined on Date myself. First, you learned about the built-in @FetchRequest property wrapper and saw several different ways to use it. All MainView knows is that it has a reference to an instance of TodoItemStorage which has an @Published property that exposes todo items that are due soon. Pulp Fiction is copyright © 1994 Miramax Films. With the release of iOS 13 Beta 5, Apple gave developers a way forward with using Core Data with SwiftUI but provide little in the way of usage details: While this change was welcomed, it wasn’t… Use SwiftUI’s data flow to access what you need in the Core Data framework. No matter the flavor that you use, they all require that you inject a managed object context into your view's environment. One of the SwiftUI questions I’ve been asked more than any other is this: how can I dynamically change a Core Data @FetchRequest to use a different predicate or sort order? Try watching this video on www.youtube.com, or enable JavaScript if it is disabled in your browser. The wrapper I created does not have such an optimization and forces the fetched results controller to load all objects into memory, and they are then kept in memory by the @Published property. Pass data up through the view hierarchy from child views with a Preference Key. By assigning the fetched result controller's fetchedObjects to dueSoon again, the @Published property is updated and your SwiftUI view is updated. The fetch request is passed to the managed object context, which executes the fetch request when we invoke executeFetchRequest(_:). Swift, the Swift logo, Swift Playgrounds, Xcode, Instruments, Cocoa Touch, Touch ID, AirDrop, iBeacon, iPhone, iPad, Safari, App Store, watchOS, tvOS, Mac and macOS are trademarks of Apple Inc., registered in the U.S. and other countries. Are there any best practices or sample code provided for SwiftUI and Core Data? Benchmade Infidel Fixed Blade Review, Hardest Chopin Pieces Ranked, How To Make Liquid Silicone At Home, Select Drapery Hardware Phone Number, Texas Association Of Realtors Commercial Lease 2019, Civ 6 City Placement, "/>

swiftui core data fetch request

I'm sure you can imagine that using @FetchRequest with more complex sort descriptors and predicates can get quite wieldy, and you might also want to have a little bit of extra control over your fetch request. Hot Network Questions What did Grothendieck mean by "the capacity to … Product pages backed via an example, you change in your hit list. The first contains the property wrappers used for generic data flow, which you can use in any view. iOS 13.0+ macOS 10.15+ Mac Catalyst 13.0+ tvOS 13.0+ watchOS 6.0+ Framework. Core Dataを使った新規プロジェクトの作成方法は、【SwiftUI】Core Dataの使い方:準備編を参照して下さい。 デフォルトで生成される標準テンプレートのコードとエンティティ(Item)は削除してし … Hacking with Swift is ©2021 Hudson Heavy Industries. The remainder of this how-to assumes that you’ve already got a way to initialize the Core Data stack. Define and create new model objects using Core Data. So buckle up and learn more about Core Data’s capabilities and how it … The simplest way to fetch data using a fetch request while responding to any changes that impact your fetch request's results is to use an NSFetchResultsController. To fetch data from Firestore, you’ll first have to … Adding Firebase. >>, Paul Hudson    @twostraws    February 9th 2021. SwiftUI’s @FetchRequest property wrapper is great for making simple requests for objects, providing both sorting and filtering. The @FetchRequest property wrapper is arguably the simplest way to fetch data from Core Data in a SwiftUI view. However, the principle of this code applies to iOS 13 too. Use Fetch Requests to retrieve objects from disk. How to batch delete in Core Data. No matter the flavor that you use, they all require that you inject a managed object context into your view's environment. What's nice about @FetchRequest is that it will automatically refresh your view if any of the fetched objects are updated. SwiftUI implements many data management types, like State and Binding, as In this week's post, we took a look at fetching objects from Core Data in a SwiftUI application. Note that my TodoItemStorage inherits from NSObject. Leveraging Property Wrappers. For example, we could show a table of all languages like this: SPONSORED Are you tired of wasting time debugging your Swift app? While you can fetch data from Core Data with @FetchRequest just fine, I tend to avoid it in my apps. You would only initialize the TodoItemStorage in your SceneDelegate and pass it to your MainView from there rather than making it an @StateObject on the App struct. It frequently also contains: A predicate (an instance of NSPredicate) that specifies which properties to filter by and the constraints on selection, for example, “last name begins with a ‘J’”. Here‘s an example SwiftUI CoreData project with an dynamic changeable predicate in a FetchRequest. We also understood what a managedObjectContext is and how we can fetch stored data by using SwiftUI’s @FetchRequest. Once you’ve passed an NSManagedObjectContext instance to your SwiftUI View, you’ll need to pull data out of your Core Data persistent store with a fetch request.. First Things First. Availability. You'll get thirteen chapters, a Playground and a handful of sample projects to help you get up and running with Combine as soon as possible. This method is called whenever the fetched results controller adds, removes, or updates any of the items that it fetched. While this approach is going to work fine, it does sacrifice some of the optimizations that you get with NSFetchedResultsController. Because FetchedResults is a collection type, you can use it in a List the same way that you would use an array. You can also bind the array controllerâ s filterPredicate binding to a method that returns an NSPredicate object. Published by donnywals on August 10, 2020August 10, 2020. The book is available as a digital download for just $29.99! In this week's post, I will present two different ways that you can use to retrieve data from Core Data and present it in your SwiftUI application. We talked through all basic CRUD operations: Creating, reading, updating, and deleting data. That step is required. You learned how to use Core Data in SwiftUI to store data persistently. If you want to fetch your items without sorting them, you can pass an empty array. We also need to pass sort descriptors to make sure our fetched objects are sorted property. The property that @FetchRequest is applied to has FetchedResults as its type. This book is intended to help you learn Core Data from scratch using modern techniques and every chapter features sample Read more…, I love posts where I get to put write about two of my favorite frameworks at the moment; Combine and Core Data. Context to fetch a way such that this will print the body in the complexities of memory? In my example setup we created a ProgrammingLanguages entity that had name and creator attributes, so we could create a fetch request for it like this: That loads all programming languages, sorted alphabetically by their name. With just a couple of line of code you can implement Core Data in SwiftUI to manage your data locally ... so we need just one fetch request without filtering the data. Once you’ve passed an NSManagedObjectContext instance to your SwiftUI View, you’ll need to pull data out of your Core Data persistent store with a fetch request.. First Things First. Fetch requests allow us to load Core Data results that match specific criteria we specify, and SwiftUI can bind those results directly to user interface elements. Core Data: Part 3 – Fetch Request Get SwiftUI - The Complete Developer Course and SwiftUI Bible now with O’Reilly online learning. I'm spending hours to figure out how to fetch values uniquely from a property of a data model (CoreData). When you use SwiftUI’s @FetchRequest property wrapper to pull objects out of Core Data, you get to specify how you want the data to be sorted – should it alphabetically by one of the fields? If an NSFetchedResultsController doesn't work for your purposes, you could listen to Core Data related notifications in NotificationCenter yourself and perform a new fetch request if needed. Using Core Data in Your SwiftUI App with Combine, MVVM and Protocols (this tutorial). Response actually using higher level objects representing the code. If you're familiar with Core Data you might wonder how you would use an NSPredicate to filter your fetched objects with @FetchRequest. Specifically, using a Core Data NSManagedObject as a data provider of a View. Usually, this shouldn't be a problem because an unsorted list in Core Data will always come back in an undefined order which, in my experience, is not desirable for most applications. Using Core Data with SwiftUI App Protocol. The remainder of this how-to assumes that you’ve already got a way to initialize the Core Data stack. In the init for MyApplication I create my PersistenceManager and extract a managed object context from it. This article covers a topic that is extensively covered in my Practical Core Data book. Please see attached screens from the core data editor. In this section, I will show you an approach that should fit common use cases where the only prerequisite is that you have a property to sort your fetched objects on. In this video, Mohammad Azam is going to demonstrate how to fetch and display data from a Web API using SwiftUI and Combine Framework. We talked through all basic CRUD operations: Creating, reading, updating, and deleting data. Note that not setting a managed object context on the view's environment while using @FetchRequest will result in a crash. Fetch requests allow us to load Core Data results that match specific criteria we specify, and SwiftUI can bind those results directly to user interface elements. This abstraction is built on top of NSFetchedResultsContoller which is a very convenient way to fetch data using a fetch request, and receive updates whenever the result of the fetch request changes. The data that I am going to u se in this app will come from the movie site where you can register an account and get the API key. Active 2 years, 11 months ago. Learn everything you need to know about Combine and how you can use it in your projects with my new book Practical Combine. Inside of MainView, you can create a property that's annotated with @FetchRequest to fetch objects using the managed object context that you injected into MainView's environment. There is more than one way to build an abstraction that fetches data from Core Data and updates your views as needed. CoreData is a framework that helps you manage the model layer objects in your application and it’s quite simple to use as some of … Shared Models, Core Data Managed Object Model, Utils, as well as extensions to help us build the project. To learn more about the Core Data part, please refer to the part 1 of this tutorial series, Building Expense Tracker iOS App with Core Data & SwiftUI; WatchOS App Target with empty implementation. Code of Conduct. Instabug’s SDK is here to help you minimize debugging time by providing you with complete device details, network logs, and reproduction steps with every bug report. To learn more about the Core Data part, please refer to the part 1 of this tutorial series, Building Expense Tracker iOS App with Core Data & SwiftUI; WatchOS App Target with empty implementation. Unfortunately, @FetchRequest by its very definition is incompatible with this approach. Let's look at a basic example of @FetchRequest usage: The version of the @FetchRequest property wrapper takes two arguments. Several flavors of the @FetchRequest property wrapper are available. < How to access a Core Data managed object context from a SwiftUI view, How to filter Core Data fetch requests using a predicate >, Core Data and SwiftUI set up instructions, All SwiftUI property wrappers explained and compared, How to configure Core Data to work with SwiftUI, Introduction to using Core Data with SwiftUI, How to create a document-based app using FileDocument and DocumentGroup, How to position views in a grid using LazyVGrid and LazyHGrid, Click here to visit the Hacking with Swift store >>. As you can see, the sortDescriptors parameter is an array, so you can provide as many sorting options as you need like this: Yes, that’s a massive line of code, so I wouldn’t blame you if you broke it up into something a little easier to read: Regardless of how you create your fetch request, the results can be used directly inside SwiftUI views. You can set up your own fetch request and pass it to @FetchRequest as follows: I prefer this way of setting up a fetch request because it's more reusable, and it's also a lot cleaner when using @FetchRequest in your views. That step is required. While this object is commonly used in conjunction with table views and collection views, we can also use it to drive a SwiftUI view. And because TodoItemStorage is built on top of NSFetchedResultsController we can easily update the dueSoon property when needed. When conducting an NS Fetch Request, you most likely do not want every record in your database, but a subset of the date. In my opinion, this is one of the powers of hiding Core Data behind a simple storage abstraction. SwiftUI - Deleting from a Core Data NSSet - @FetchRequest with .onDelete() 7 @FetchRequest results not updating in SwiftUI when change source is share extension. Or numerically with the highest numbers first? You might not even want to update another context but reload your UI Read more…, earlier post I wrote about using Core Data in a SwiftUI 2.0 application, Preventing unwanted fetches when using NSFetchedResultsController and fetchBatchSize, Observing the result of saving a background managed object context with Combine, Responding to changes in a managed object context, Expose data to your SwiftUI views with an observable object and an. Hard to believe, but in less than 40 lines of code, we’re able to not only define a simple data model for books, as well as some sample data, but also a screen that displays the books in a list - that’s the power of SwiftUI! First, the entity description for the object that you want to fetch. The main reason for this is that I've always tried to separate my Core Data code from the rest of my application as much as possible. ... How to use Core Data Relationship in ForEach SwiftUI. ... /* Fetch request, get the patient with that UUID, etc... */} func changePatient(to: UUID) {}} And whenever that patient changes all my SwiftUI views that are observing the "patient" variable reloads automatically. The result of doing this was a view that is blissfully unaware of Core Data and fetch requests. If you have any questions about this post, or if you have feedback for me, don't hesitate to reach out to me on Twitter. If you prefer Objective-C, then I recommend reading my earlier series on the Core Data framework. Next, I assign the fetched results controller's fetched objects to my dueSoon property. Creating a fetch request requires two pieces of information: the entity you want to query, and a sort descriptor that determines the order in which results are returned. When conducting an NS Fetch Request, you most likely do not want every record in your database, but a subset of the date. I know I said that I wouldn't enhance this project any further, but after hearing no real new news along these lines from Apple at WWDC 2020, I felt I had to tidy up a few loose ends and make a few additional enhancements for myself. By the end of this post you will be able to: Since @FetchRequest is by far the simplest approach, let's look at that first. Is it a @ObjectBinding? Once you’ve passed an NSManagedObjectContext instance to your SwiftUI View, you’ll need to pull data out of your Core Data persistent store with a fetch request.. First Things First. Refund Policy             Distribute value data throughout your app by storing it in the Environment. Fetch and parse data. It frequently also contains: A predicate (an instance of NSPredicate) that specifies which properties to filter by and the constraints on selection, for example, “last name begins with a ‘J’”. Note that it uses a static method nextWeek() that I defined on Date myself. First, you learned about the built-in @FetchRequest property wrapper and saw several different ways to use it. All MainView knows is that it has a reference to an instance of TodoItemStorage which has an @Published property that exposes todo items that are due soon. Pulp Fiction is copyright © 1994 Miramax Films. With the release of iOS 13 Beta 5, Apple gave developers a way forward with using Core Data with SwiftUI but provide little in the way of usage details: While this change was welcomed, it wasn’t… Use SwiftUI’s data flow to access what you need in the Core Data framework. No matter the flavor that you use, they all require that you inject a managed object context into your view's environment. One of the SwiftUI questions I’ve been asked more than any other is this: how can I dynamically change a Core Data @FetchRequest to use a different predicate or sort order? Try watching this video on www.youtube.com, or enable JavaScript if it is disabled in your browser. The wrapper I created does not have such an optimization and forces the fetched results controller to load all objects into memory, and they are then kept in memory by the @Published property. Pass data up through the view hierarchy from child views with a Preference Key. By assigning the fetched result controller's fetchedObjects to dueSoon again, the @Published property is updated and your SwiftUI view is updated. The fetch request is passed to the managed object context, which executes the fetch request when we invoke executeFetchRequest(_:). Swift, the Swift logo, Swift Playgrounds, Xcode, Instruments, Cocoa Touch, Touch ID, AirDrop, iBeacon, iPhone, iPad, Safari, App Store, watchOS, tvOS, Mac and macOS are trademarks of Apple Inc., registered in the U.S. and other countries. Are there any best practices or sample code provided for SwiftUI and Core Data?

Benchmade Infidel Fixed Blade Review, Hardest Chopin Pieces Ranked, How To Make Liquid Silicone At Home, Select Drapery Hardware Phone Number, Texas Association Of Realtors Commercial Lease 2019, Civ 6 City Placement,

Reader Interactions

Leave a Reply

Your email address will not be published. Required fields are marked *