rdnb (version 0.1-5)

dnb_search: 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).

Value

A list of results with metadata.

Details

to do

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")
# }