@spec checkdigit_correct?(String.t()) :: boolean()

Takes an ISBN (10 or 13) and checks its validity by its check digit

examples

Examples

iex> Exisbn.checkdigit_correct?("85-359-0277-5")
true
iex> Exisbn.checkdigit_correct?("978-5-12345-678-1")
true
iex> Exisbn.checkdigit_correct?("978-5-12345-678")
false

@spec correct_hyphens?(binary()) :: boolean()

Checks if an ISBN (10 or 13) code is correctly hyphenated. If ISBN incorrect, that count as no.

examples

Examples

iex> Exisbn.correct_hyphens?("978-85-359-0277-8")
true
iex> Exisbn.correct_hyphens?("97-8853590277-8")
false
iex> Exisbn.correct_hyphens?("0-306-40615-2")
true
iex> Exisbn.correct_hyphens?("03-064-06152")
false
iex> Exisbn.correct_hyphens?("str")
false

@spec fetch_checkdigit(String.t()) :: {:ok, String.t()} | {:error, :invalid_isbn}

Takes an ISBN and returns its checkdigit.

examples

Examples

iex> Exisbn.fetch_checkdigit("9788535902778")
{:ok, "8"}
iex> Exisbn.fetch_checkdigit("2-1234-5680-2")
{:ok, "2"}
iex> Exisbn.fetch_checkdigit("str")
{:error, :invalid_isbn}
iex> Exisbn.fetch_checkdigit("887385107X")
{:ok, "X"}

@spec fetch_checkdigit!(String.t()) :: String.t()

Same as fetch_checkdigit/1, but raises exception.

examples

Examples

iex> Exisbn.fetch_checkdigit!("9788535902778")
"8"
iex> Exisbn.fetch_checkdigit!("2-1234-5680-2")
"2"
iex> Exisbn.fetch_checkdigit!("str")
** (ArgumentError) Invalid ISBN
iex> Exisbn.fetch_checkdigit!("887385107X")
"X"

@spec fetch_prefix(String.t()) ::
  {:ok, String.t()} | {:error, :invalid_isbn | :unknown_group}

Takes an ISBN and returns its prefix.

Returns {:error, :unknown_group} when the ISBN is structurally valid but belongs to a registration group not present in the dataset.

examples

Examples

iex> Exisbn.fetch_prefix("9788535902778")
{:ok, "978-85"}
iex> Exisbn.fetch_prefix("2-1234-5680-2")
{:ok, "978-2"}
iex> Exisbn.fetch_prefix("str")
{:error, :invalid_isbn}
iex> Exisbn.fetch_prefix("9799012345674")
{:error, :unknown_group}

@spec fetch_prefix!(String.t()) :: String.t()

Same as fetch_prefix/1, but raises exception.

examples

Examples

iex> Exisbn.fetch_prefix!("9788535902778")
"978-85"
iex> Exisbn.fetch_prefix!("2-1234-5680-2")
"978-2"
iex> Exisbn.fetch_prefix!("str")
** (ArgumentError) Invalid ISBN

iex> Exisbn.fetch_prefix!("9799012345674")
** (ArgumentError) Invalid ISBN

@spec fetch_publication_element(String.t()) ::
  {:ok, String.t()}
  | {:error, :invalid_isbn | :unknown_group | :unknown_publisher}

Takes an ISBN and returns its publication element.

Propagates {:error, :unknown_group} and {:error, :unknown_publisher} from fetch_registrant_element/1.

examples

Examples

iex> Exisbn.fetch_publication_element("978-1-86197-876-9")
{:ok, "876"}
iex> Exisbn.fetch_publication_element("9789529351787")
{:ok, "5178"}
iex> Exisbn.fetch_publication_element("str")
{:error, :invalid_isbn}
iex> Exisbn.fetch_publication_element("9799012345674")
{:error, :unknown_group}
iex> Exisbn.fetch_publication_element("9786110000000")
{:error, :unknown_publisher}

@spec fetch_publication_element!(String.t()) :: String.t()

Same as fetch_publication_element/1, but raises exception.

examples

Examples

iex> Exisbn.fetch_publication_element!("978-1-86197-876-9")
"876"
iex> Exisbn.fetch_publication_element!("9789529351787")
"5178"
iex> Exisbn.fetch_publication_element!("str")
** (ArgumentError) Invalid ISBN

iex> Exisbn.fetch_publication_element!("9799012345674")
** (ArgumentError) Invalid ISBN

iex> Exisbn.fetch_publication_element!("9786110000000")
** (ArgumentError) Invalid ISBN

@spec fetch_registrant_element(String.t()) ::
  {:ok, String.t()}
  | {:error, :invalid_isbn | :unknown_group | :unknown_publisher}

Takes an ISBN and returns its registrant element.

Returns {:error, :unknown_group} when the registration group is not in the dataset, and {:error, :unknown_publisher} when the group has no publisher ranges defined.

examples

Examples

iex> Exisbn.fetch_registrant_element("9788535902778")
{:ok, "359"}
iex> Exisbn.fetch_registrant_element("978-1-86197-876-9")
{:ok, "86197"}
iex> Exisbn.fetch_registrant_element("9789529351787")
{:ok, "93"}
iex> Exisbn.fetch_registrant_element("str")
{:error, :invalid_isbn}
iex> Exisbn.fetch_registrant_element("9799012345674")
{:error, :unknown_group}
iex> Exisbn.fetch_registrant_element("9786110000000")
{:error, :unknown_publisher}

@spec fetch_registrant_element!(String.t()) :: String.t()

Same as fetch_registrant_element/1, but raises exception.

examples

Examples

iex> Exisbn.fetch_registrant_element!("9788535902778")
"359"
iex> Exisbn.fetch_registrant_element!("978-1-86197-876-9")
"86197"
iex> Exisbn.fetch_registrant_element!("9789529351787")
"93"
iex> Exisbn.fetch_registrant_element!("str")
** (ArgumentError) Invalid ISBN

iex> Exisbn.fetch_registrant_element!("9799012345674")
** (ArgumentError) Invalid ISBN

iex> Exisbn.fetch_registrant_element!("9786110000000")
** (ArgumentError) Invalid ISBN

@spec hyphenate(String.t()) :: {:ok, String.t()} | {:error, :invalid_isbn}

Takes an ISBN (10 or 13) and hyphenates it.

examples

Examples

iex> Exisbn.hyphenate("9788535902778")
{:ok, "978-85-359-0277-8"}
iex> Exisbn.hyphenate("0306406152")
{:ok, "0-306-40615-2"}
iex> Exisbn.hyphenate("str")
{:error, :invalid_isbn}

@spec hyphenate!(String.t()) :: String.t()

Same as hyphenate/1, but raises exception.

examples

Examples

iex> Exisbn.hyphenate!("9788535902778")
"978-85-359-0277-8"
iex> Exisbn.hyphenate!("0306406152")
"0-306-40615-2"
iex> Exisbn.hyphenate!("str")
** (ArgumentError) Invalid ISBN

@spec isbn10_checkdigit(String.t()) :: {:ok, String.t()} | {:error, :invalid_isbn}

Takes an ISBN 10 code as string, returns its check digit.

examples

Examples

iex> Exisbn.isbn10_checkdigit("85-359-0277")
{:ok, "5"}
iex> Exisbn.isbn10_checkdigit("5-02-013850")
{:ok, "9"}
iex> Exisbn.isbn10_checkdigit("0str")
{:error, :invalid_isbn}
iex> Exisbn.isbn10_checkdigit("887385107")
{:ok, "X"}

@spec isbn10_checkdigit!(String.t()) :: String.t()

Same as isbn10_checkdigit/1, but raises exception.

examples

Examples

iex> Exisbn.isbn10_checkdigit!("85-359-0277")
"5"
iex> Exisbn.isbn10_checkdigit!("5-02-013850")
"9"
iex> Exisbn.isbn10_checkdigit!("0str")
** (ArgumentError) Invalid ISBN
iex> Exisbn.isbn10_checkdigit!("887385107")
"X"

@spec isbn10_to_13(String.t()) :: {:ok, String.t()} | {:error, :invalid_isbn}

Takes an ISBN 10 and converts it to ISBN 13.

examples

Examples

iex> Exisbn.isbn10_to_13("85-359-0277-5")
{:ok, "9788535902778"}
iex> Exisbn.valid?("9788535902778")
true
iex> Exisbn.isbn10_to_13("0306406152")
{:ok, "9780306406157"}
iex> Exisbn.valid?("9780306406157")
true
iex> Exisbn.isbn10_to_13("0-19-853453123")
{:error, :invalid_isbn}

@spec isbn10_to_13!(String.t()) :: String.t()

Same as isbn10_to_13/1, but raises exception.

examples

Examples

iex> Exisbn.isbn10_to_13!("85-359-0277-5")
"9788535902778"
iex> Exisbn.valid?("9788535902778")
true
iex> Exisbn.isbn10_to_13!("0306406152")
"9780306406157"
iex> Exisbn.valid?("9780306406157")
true
iex> Exisbn.isbn10_to_13!("0-19-853453123")
** (ArgumentError) Invalid ISBN

@spec isbn13_checkdigit(binary()) :: {:ok, String.t()} | {:error, :invalid_isbn}

Takes an ISBN 13 code as string, returns its check digit.

examples

Examples

iex> Exisbn.isbn13_checkdigit("978-5-12345-678")
{:ok, "1"}
iex> Exisbn.isbn13_checkdigit("978-0-306-40615")
{:ok, "7"}
iex> Exisbn.isbn13_checkdigit("0str")
{:error, :invalid_isbn}

@spec isbn13_checkdigit!(binary()) :: String.t()

Same as isbn13_checkdigit/1, but raises exception.

examples

Examples

iex> Exisbn.isbn13_checkdigit!("978-5-12345-678")
"1"
iex> Exisbn.isbn13_checkdigit!("978-0-306-40615")
"7"
iex> Exisbn.isbn13_checkdigit!("0str")
** (ArgumentError) Invalid ISBN

@spec isbn13_to_10(String.t()) ::
  {:ok, String.t()} | {:error, :invalid_isbn | :no_isbn10_equivalent}

Takes an ISBN 13 and converts it to ISBN 10.

ISBNs with prefix 979 have no ISBN-10 equivalent and return {:error, :no_isbn10_equivalent}.

examples

Examples

iex> Exisbn.isbn13_to_10("9788535902778")
{:ok, "8535902775"}
iex> Exisbn.valid?("8535902775")
true
iex> Exisbn.isbn13_to_10("9780306406157")
{:ok, "0306406152"}
iex> Exisbn.valid?("0306406152")
true
iex> Exisbn.isbn13_to_10("str")
{:error, :invalid_isbn}
iex> Exisbn.isbn13_to_10("9798893031355")
{:error, :no_isbn10_equivalent}

@spec isbn13_to_10!(String.t()) :: String.t()

Same as isbn13_to_10/1, but raises exception.

examples

Examples

iex> Exisbn.isbn13_to_10!("9788535902778")
"8535902775"
iex> Exisbn.valid?("8535902775")
true
iex> Exisbn.isbn13_to_10!("9780306406157")
"0306406152"
iex> Exisbn.valid?("0306406152")
true
iex> Exisbn.isbn13_to_10!("str")
** (ArgumentError) Invalid ISBN

iex> Exisbn.isbn13_to_10!("9798893031355")
** (ArgumentError) Invalid ISBN

@spec publisher_country_code(String.t()) ::
  {:ok, String.t() | nil} | {:error, :invalid_isbn}

Takes an ISBN and returns its ISO 3166-1 alpha-2 country code.

Returns {:ok, nil} for groups that span multiple countries or language areas (e.g. English language, French language, German language, former U.S.S.R, Caribbean Community).

examples

Examples

iex> Exisbn.publisher_country_code("9788535902778")
{:ok, "BR"}
iex> Exisbn.publisher_country_code("9780306406157")
{:ok, nil}
iex> Exisbn.publisher_country_code("str")
{:error, :invalid_isbn}

@spec publisher_country_code!(String.t()) :: String.t() | nil

Same as publisher_country_code/1, but raises exception.

examples

Examples

iex> Exisbn.publisher_country_code!("9788535902778")
"BR"
iex> Exisbn.publisher_country_code!("9780306406157")
nil
iex> Exisbn.publisher_country_code!("str")
** (ArgumentError) Invalid ISBN

@spec publisher_zone(String.t()) :: {:ok, String.t()} | {:error, :invalid_isbn}

Takes an ISBN and returns its publisher zone.

Returns {:error, :invalid_isbn} for ISBNs whose registration group is not present in the dataset.

examples

Examples

iex> Exisbn.publisher_zone("9788535902778")
{:ok, "Brazil"}
iex> Exisbn.publisher_zone("2-1234-5680-2")
{:ok, "French language"}
iex> Exisbn.publisher_zone("str")
{:error, :invalid_isbn}
iex> Exisbn.publisher_zone("9799012345674")
{:error, :invalid_isbn}

@spec publisher_zone!(String.t()) :: String.t()

Same as publisher_zone/1, but raises exception.

examples

Examples

iex> Exisbn.publisher_zone!("9788535902778")
"Brazil"
iex> Exisbn.publisher_zone!("2-1234-5680-2")
"French language"
iex> Exisbn.publisher_zone!("str")
** (ArgumentError) Invalid ISBN

iex> Exisbn.publisher_zone!("9799012345674")
** (ArgumentError) Invalid ISBN

@spec valid?(String.t()) :: boolean()

Takes an ISBN (10 or 13) and checks its validity by checking the checkdigit, length and characters.

examples

Examples

iex> Exisbn.valid?("978-5-12345-678-1")
true
iex> Exisbn.valid?("978-5-12345-678")
false
iex> Exisbn.valid?("85-359-0277-5")
true
iex> Exisbn.valid?("85-359-0277")
false