search_vd_smart: Search VecDyn using the explorer's filters

View source: R/search_vd_smart.R

search_vd_smartR Documentation

Search VecDyn using the explorer's filters

Description

Retrieve the IDs for any VecDyn datasets matching the given filter.

Usage

search_vd_smart(field, operator, value, basereq = vb_basereq())

Arguments

field

a field of VecDyn to search.

operator

an operator to use when searching.

value

the value that the field might/might not be.

basereq

an httr2 request object, as generated by vb_basereq(). If NA, uses the default request.

Value

An ohvbd.ids vector of VecDyn dataset IDs.

Valid fields

The following field names are valid (shortcut names are listed in brackets):

  • SpeciesName (species)

  • Title

  • Collections

  • Years (yrs)

  • CollectionMethods (methods)

  • Tags

Valid operators

The following operators are valid (alternative names are listed in brackets):

  • contains (contain, has, have)

  • !contains (!contains, !has, !have, ncontains)

  • equals (=, ==, equal, eq)

  • !equals (!=, not, !equal, !eq, neq)

  • starts (starts with, start with, start, sw)

  • !starts (not starts with, not start with, !start, nsw)

  • ⁠in⁠ (within)

  • ⁠!in⁠ (not in, not within, !within, nin)

  • greater (greater than, gt, >)

  • less (less than, lt, <)

Author(s)

Francis Windram

Examples


search_vd_smart("Collections", "gt", "1000")


ohvbd documentation built on March 10, 2026, 1:07 a.m.