diff --git a/Projects/1-Beginner/DecToHex.md b/Projects/1-Beginner/DecToHex.md new file mode 100644 index 00000000..5a869fa8 --- /dev/null +++ b/Projects/1-Beginner/DecToHex.md @@ -0,0 +1,45 @@ +# DecToHex + +**Tier:** Beginner + +Decimal (Base 10) is the standard counting numbers system. +Hexadecimal (Base 16) is used for various purposes such as + - assembly programming languages and in machine code. + - It is often used to refer to memory addresses. + - It can be used during the debugging stage of writing a computer program and to represent numbers stored in a CPU's registers or in main memory. + +DecToHex lets the user enter any integer and displays its hexadeicmal (base 16) conversions. +Its main purpose is to allow users to understand the mathmathics behind decimal to hexadecimal conversions. + + + +This challenge requires that the developer implementing it follow these +constraints: + +- Since, the main purpose of the program is to allow users to understand the math behind decimal to hex conversions, the 'hex' function may not be used + + + +## User Stories + +- [ ] User should enter only a decimal (base 10) integer. Can be positive or negative. + +- [ ] User can see the decimal number in base 16. + +- [ ] If input is not a base 10 integer, the user is asked to enter a valid value until they do. + +## Bonus Features + +- [ ] User should be able to convert a hexadecimal number to decimal as well as decimal to hex. + +- [ ] User should be able to see the math behind the conversion of decimial to hex or vice versa. + +## Userful links/resources + +- [Decimal Number Wikipedia](https://en.wikipedia.org/wiki/Decimal) +- [Hexadecimal Number Wikipedia](https://en.wikipedia.org/wiki/Hexadecimal) +- [Converting Decimal to Hexadecimal](https://www.wikihow.com/Convert-from-Decimal-to-Hexadecimal) +- [What are the uses of Hexadecimal values](https://medium.com/@savas/why-do-we-use-hexadecimal-d6d80b56f026) +## Example project +- [Decimal to Hex and vice versa converter](https://www.rapidtables.com/convert/number/decimal-to-hex.html) +