__sub__()#

relationalai.Producer
#Producer.__sub__(other: Any) -> Expression

Returns an Expression that produces the difference between the Producer values and other.

Parameters#

NameTypeDescription
otherAnyA numeric value or another Producer object.

Returns#

An Expression object.

Example#

You may subtract a number literal from a Producer object:

#import relationalai as rai

model = rai.Model("people")
Person = model.Type("Person")

with model.rule():
    Person.add(name="Fred", age=39)
    Person.add(name="Wilma", age=36)

with model.query() as select:
    person = Person()
    # `person.age` returns an `InstanceProperty` object,
    # which are also `Producer` objects.
    years_as_adult = person.age - 18
    response = select(person.name, years_as_adult)

print(response.results)
# Output:
#     name   v
# 0   Fred  21
# 1  Wilma  18

You may also subtract two Producer objects:

#with model.rule():
    fred = Person(name="Fred")
    fred.set(expected_retirement_age=65)

with model.rule():
    wilma = Person(name="Wilma")
    wilma.set(expected_retirement_age=62)

with model.query() as select:
    person = Person()
    # `person.age`, and `person.expected_retirement_age` return
    # `InstanceProperty` objects, which are also `Producer` objects.
    years_to_retirement = person.retirement_age - person.age
    response = select(person.name, years_to_retirement)

print(response.results)
# Output:
#     name   v
# 0   Fred  26
# 1  Wilma  26

See Also#