Skip to content

Commit a2851a6

Browse files
authored
isbn-verifier: Include more succinct description of ISBN-10 (#417)
Fixes exercism/problem-specifications#1011. A simple definition of what the system should do before getting in to exactly what the digits of an ISBN mean would be good, in my opinion. exercism/problem-specifications#1019
1 parent 9a2b8d9 commit a2851a6

File tree

1 file changed

+25
-20
lines changed

1 file changed

+25
-20
lines changed

exercises/isbn-verifier/README.md

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,45 @@
11
# Isbn Verifier
22

3-
Check if a given ISBN-10 is valid.
3+
The [ISBN-10 verification process](https://en.wikipedia.org/wiki/International_Standard_Book_Number) is used to validate book identification
4+
numbers. These normally contain dashes and look like: `3-598-21508-8`
45

5-
## Functionality
6+
## ISBN
67

7-
Given an unknown string the program should check if the provided string is a valid ISBN-10.
8-
Putting this into place requires some thinking about preprocessing/parsing of the string prior to calculating the check digit for the ISBN.
8+
The ISBN-10 format is 9 digits (0 to 9) plus one check character (either a digit or an X only). In the case the check character is an X, this represents the value '10'. These may be communicated with or without hyphens, and can be checked for their validity by the following formula:
99

10-
The program should allow for ISBN-10 without the separating dashes to be verified as well.
10+
```
11+
(x1 * 10 + x2 * 9 + x3 * 8 + x4 * 7 + x5 * 6 + x6 * 5 + x7 * 4 + x8 * 3 + x9 * 2 + x10 * 1) mod 11 == 0
12+
```
1113

12-
## ISBN
14+
If the result is 0, then it is a valid ISBN-10, otherwise it is invalid.
1315

14-
Let's take a random ISBN-10 number, say `3-598-21508-8` for this.
15-
The first digit block indicates the group where the ISBN belongs. Groups can consist of shared languages, geographic regions or countries. The leading '3' signals this ISBN is from a german speaking country.
16-
The following number block is to identify the publisher. Since this is a three digit publisher number there is a 5 digit title number for this book.
17-
The last digit in the ISBN is the check digit which is used to detect read errors.
16+
## Example
1817

19-
The first 9 digits in the ISBN have to be between 0 and 9.
20-
The check digit can additionally be an 'X' to allow 10 to be a valid check digit as well.
18+
Let's take the ISBN-10 `3-598-21508-8`. We plug it in to the formula, and get:
19+
```
20+
(3 * 10 + 5 * 9 + 9 * 8 + 8 * 7 + 2 * 6 + 1 * 5 + 5 * 4 + 0 * 3 + 8 * 2 + 8 * 1) mod 11 == 0
21+
```
22+
23+
Since the result is 0, this proves that our ISBN is valid.
24+
25+
## Task
26+
27+
Given a string the program should check if the provided string is a valid ISBN-10.
28+
Putting this into place requires some thinking about preprocessing/parsing of the string prior to calculating the check digit for the ISBN.
2129

22-
A valid ISBN-10 is calculated with this formula `(x1 * 10 + x2 * 9 + x3 * 8 + x4 * 7 + x5 * 6 + x6 * 5 + x7 * 4 + x8 * 3 + x9 * 2 + x10 * 1) mod 11 == 0`
23-
So for our example ISBN this means:
24-
(3 * 10 + 5 * 9 + 9 * 8 + 8 * 7 + 2 * 6 + 1 * 5 + 5 * 4 + 0 * 3 + 8 * 2 + 8 * 1) mod 11 = 0
30+
The program should be able to verify ISBN-10 both with and without separating dashes.
2531

26-
Which proves that the ISBN is valid.
2732

2833
## Caveats
2934

30-
Converting from string to number can be tricky in certain languages.
31-
It's getting even trickier since the check-digit of an ISBN-10 can be 'X'.
35+
Converting from strings to numbers can be tricky in certain languages.
36+
Now, it's even trickier since the check digit of an ISBN-10 may be 'X' (representing '10'). For instance `3-598-21507-X` is a valid ISBN-10.
3237

3338
## Bonus tasks
3439

35-
* Generate a valid ISBN-13 from the input ISBN-10 (and maybe verify it again with a derived verifier)
40+
* Generate a valid ISBN-13 from the input ISBN-10 (and maybe verify it again with a derived verifier).
3641

37-
* Generate valid ISBN, maybe even from a given starting ISBN
42+
* Generate valid ISBN, maybe even from a given starting ISBN.
3843
## Rust Installation
3944

4045
Refer to the [exercism help page][help-page] for Rust installation and learning

0 commit comments

Comments
 (0)