# Delete

Artifact: [androidx.room:room-common](https://developer.android.com/jetpack/androidx/releases/room) [View Source](https://cs.android.com/search?q=file:androidx/room/Delete.kt+class:androidx.room.Delete) Added in [2.0.0](https://developer.android.com/jetpack/androidx/releases/room#2.0.0)

*** ** * ** ***

Common/AllAndroid/JVMNative/C/iOSJavaScript
- Cmn

  ```
  @Target(allowedTargets = [AnnotationTarget.FUNCTION])
  @Retention(value = AnnotationRetention.BINARY)
  annotation Delete
  ```

*** ** * ** ***

Marks a method in a `https://developer.android.com/reference/kotlin/androidx/room/Dao` annotated class as a delete method.

The implementation of the method will delete its parameters from the database.

All of the parameters of the Delete method must either be classes annotated with `https://developer.android.com/reference/kotlin/androidx/room/Entity` or collections/array of it.

Example:

```kotlin
@Dao
public interface MusicDao {
    @Delete
    public fun deleteSongs(vararg songs: Song)

    @Delete
    public fun deleteAlbumAndSongs(album: Album, songs: List<Song>)
}
```

If the target entity is specified via `https://developer.android.com/reference/kotlin/androidx/room/Delete#entity()` then the parameters can be of arbitrary POJO types that will be interpreted as partial entities. For example:

```kotlin
@Entity
data class Playlist (
    @PrimaryKey
    val playlistId: Long,
    val ownerId: Long,
    val name: String,
    @ColumnInfo(defaultValue = "normal")
    val category: String
)

data class OwnerIdAndCategory (
    val ownerId: Long,
    val category: String
)

@Dao
public interface PlaylistDao {
    @Delete(entity = Playlist::class)
    fun deleteByOwnerIdAndCategory(varargs idCategory: OwnerIdAndCategory)
}
```

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/room/Insert` |   |
| `https://developer.android.com/reference/kotlin/androidx/room/Update` |   |

## Summary

| ### Public constructors |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/room/Delete#Delete(kotlin.reflect.KClass)(entity: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.reflect/-k-class/index.html<*>)` | Cmn |

| ### Public properties |
|---|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.reflect/-k-class/index.html<*>` | `https://developer.android.com/reference/kotlin/androidx/room/Delete#entity()` The target entity of the delete method. | Cmn |

## Public constructors

### Delete

Cmn Added in [2.8.5](https://developer.android.com/jetpack/androidx/releases/room#2.8.5)

```
Delete(entity: KClass<*> = Any::class)
```

## Public properties

### entity

Cmn

```
val entity: KClass<*>
```

The target entity of the delete method.

When this is declared, the delete method parameters are interpreted as partial entities when the type of the parameter differs from the target. The POJO class that represents the entity must contain a subset of the fields of the target entity. The fields value will be used to find matching entities to delete.

By default the target entity is interpreted by the method parameters.

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.reflect/-k-class/index.html<*>` | the target entity of the delete method or none if the method should use the parameter type entities. |