# cf.contain

`cf.``contain`(value, units=None, attr=None)

  Return a `cf.Query` object for cells of a variable for containing a value.

  If cells are not defined then return a `cf.Query` object for a variable for being equal to a value, i.e. this case is equivalent to `cf.eq`.

  New in version 1.0.

  See also

  `cf.eq`, `cf.ge`, `cf.gt`, `cf.ne`, `cf.le`, `cf.lt`, `cf.set`, `cf.wi`, `cf.wo`

  Parameters: | value: The value which a variable is to be compared with. units: `str` or cf.Units, optional The units of each element of values. By default, the same units as the variable being tested are assumed, if applicable. attr: `str`, optional Return a query object for a variable’s attr attribute.
  Returns: | out: `cf.Query` The query object.
  Examples: |

      >>>  cf.contain(30, 'degrees_east')
      <CF Query: (contain <CF Data: 30 degrees_east>)>
      >>>  cf.contain(cf.Data(10, 'km'))
      <CF Query: (contain <CF Data: 10 km>)>

      >>> c
      <CF DimensionCoordinate: longitude(4) degrees_east>
      >>> print c.bounds.array
      [[  0   90]
       [ 90  180]
       [180  270]
       [270  360]]
      >>> print (cf.contain(100) == c).array
      [False True False False]
      >>> print (cf.contain(9999) == c).array
      [False False False False]