dnb_search: Search the DNB catalogue - simple search

In chgrl/rdnb: R Interface to the 'Deutsche Nationalbibliothek (German National Library) API'

Search the DNB catalogue - simple search

Description

dnb_search exposes a search in the DNB catalogue.

Usage

dnb_search(
  title,
  author,
  year,
  publisher,
  keyword,
  type,
  language,
  limit = 10,
  clean = TRUE,
  print = FALSE
)

Arguments

title	the title (including subtitle, short title, volume title, etc.); optional single string value or vector of strings.
author	the author(s); optional single string value or vector of strings.
year	the year of publishing; optional single integer value or vector of integers.
publisher	the publisher (publisher name and/or location); optional single string value or vector of strings.
keyword	one or a set of keywords describing the work (subjects, persons, locations, organisations, etc.); optional single string value or vector of strings.
type	the type of publication (optional), one or a vector of articles, manuscript, biographicaldoc, letters, bequest, collections, books, brailles, maps, discs, dissertations, online, films, microfiches, multimedia, music, scores, serials, persons, subjects, corperations, works, events, geographics.
language	the language of the work by ISO 639-2/B code (https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes); single string value or vector of strings.
limit	number and (optional) starting point of results returned; single integer value (number of results), vector of two integer values (number of results and first result, >=1) or "all" for a complete list of results.
clean	if TRUE (the default), the results are cleaned (see dnb_advanced for details).
print	if TRUE the search results are printed (default is FALSE).

Details

to do

Value

A list of results with metadata.

Examples

## Not run: 
# title search
single.title <- dnb_search(title="katze")
multi.title <- dnb_search(title=c("katze", "kater", "+maus", "-hund"))

# author search
single.author <- dnb_search(author="kern")
author.or.author <- dnb_search(author=c("kern", "locke"))
author.and.author <- dnb_search(author=c("kern", "+locke"))
author.not.author <- dnb_search(author=c("kern", "-locke"))

# publication year 
single.year <- dnb_search(title="katze", year=2015)
sequence.of.years <- dnb_search(title="katze", year=2010:2015)
set.of.years <- dnb_search(title="katze", year=c(2010:2013, 2015))

# publisher search
single.publisher <- dnb_search(title="katze", publisher="kiepenheuer")
set.of.publishers <- dnb_search(title="katze", publisher=c("kiepenheuer", "piper"))

# keyword search
single.keyword <- dnb_search(author="kern")
keyword.or.keyword <- dnb_search(keyword=c("katze", "hund"))
keyword.and.keyword <- dnb_search(keyword=c("katze", "+hund"))
keyword.not.keyword <- dnb_search(keyword=c("katze", "-hund"))

# type search
single.type <- dnb_search(title="katze", type="books")
set.of.types <- dnb_search(title="katze", type=c("books", "articles", "online"))

# language search
single.language <- dnb_search(title="cat", language="eng")
set.of.languages <- dnb_search(title=c("cat", "katze"), language=c("eng", "ger"))

# change limit of results
first.result <- dnb_search(title="katze", limit=1)
5.results.starting.with.the.21st <- dnb_search(title="katze", limit=c(5, 21))
all.results <- dnb_search(title="katze", limit="all")

## End(Not run)

chgrl/rdnb documentation built on Feb. 10, 2024, 2:28 a.m.