# Filter by String

### Description
Selects objects by the value of a string property.
Values to compare against can be given in input or as literals.

### Input
- `SOURCE [OBJ]`: The list of objects to filter
- `VALUES [STRING]` (optional): the list of values to compare objects' values against

### Output
- `TRUE [OBJ]`: the objects for which the selection applies
- `FALSE [OBJ]`: the objects for which the selection does not apply

### Parameters
- `Property`: the string property to check. Use `*` to consider all properties.
- `Use sub-properties`: when set to `true`, the values of all sub properties are also included. Sub-properties can be defined in the data with the `rdfs:subPropertyOf` relation.
- `Value` (unless input `Values` is connected): the value to compare each object's value against
- `Language`: when a language is selected, only the strings in this language are extracted. This uses the language tags that are defined in the data.
- `Operation`: comparison function to use (`equal`,`contains`,`startsWith`,`endsWith`)
- `Case-sensitive`: if set to `false`, upper/lower case is ignored
- `Input items matching logic`:
  - `Any can match`: objects from `SOURCE` are selected if they match any of the items in `INPUT`
  - `All must match`: objects from `SOURCE` are selected only if they match all the items in `INPUT`

Output scores can be [aggregated](docs://score_aggregation) and/or [normalised](docs://score_normalisation).