Skip to content

README.md

Latest commit

 

History

History
92 lines (78 loc) · 2.93 KB

README.md

File metadata and controls

92 lines (78 loc) · 2.93 KB

📱Bitwise Calculator

A comprehensive command-line calculator for bitwise operations, bit shifting, and logical inversion. This educational tool provides detailed step-by-step calculations and binary representations for better understanding of bitwise operations.

⚙️Features

0️⃣1️⃣ Bitwise Operations

  • AND (&) - Logical AND operation between multiple numbers
  • OR (|) - Logical OR operation between multiple numbers
  • XOR (^) - Exclusive OR operation between multiple numbers

⏪⏩ Bit Shifting

  • Left Shift (<<) - Shifts bits to the left by specified positions
  • Right Shift (>>) - Shifts bits to the right by specified positions

🔄 Bit Inversion

  • NOT (~) - Bitwise inversion with automatic width detection and two's complement representation

⬇️ Installation

  1. Clone the repository:
git clone https://github.com/Sarmatae685/Bitwise-Calculator.git
cd Bitwise-Calculator/src
  1. Run the program:
python3 main.py

📌Examples

Bitwise XOR Operation

Enter an action from the following  &  |  ^  <<  >>  ~ : ^
Selected action: ^
This is a Bitwise operation, requires at least 2 operands: x1 ^ x2...
Enter numbers for XOR separated by a space (type 'exit' for exit): 12 7 3
Input values: 
1100(12), 0111(7), 0011(3)

12 ^ 7 ^ 3 = 8

1 ^ 0 ^ 0 = 1
1 ^ 1 ^ 0 = 0
0 ^ 1 ^ 1 = 0
0 ^ 1 ^ 1 = 0
Result: 1000 (8)

Bit Shifting

Enter an action from the following  &  |  ^  <<  >>  ~ : <<
Selected action: <<
This is a shift operation, requires 2 operands: num << steps to shift
enter number to shift to the LEFT by how many bits to shift(example: 23 5) or type 'exit' for exit: 5 4
5 << 4 = 80
Input: 00000101(5) << 4
Output: 01010000(80)

Bit Inversion

Enter an action from the following  &  |  ^  <<  >>  ~ : ~
Selected action: ~
This is logical NOT: ~x = -(x + 1)
Enter number to invert (type 'exit' to exit): 5
~5 = -6
two's complement (8-bit): 
11111010(-6 or 250)

📁 Project Structure

bitwise-calculator/
├── main.py                 # Main program logic and menu
├── bitwise_operations.py   # Bitwise AND, OR, XOR operations
├── bit_shift.py            # Left and right bit shifting
├── bit_inversion.py        # Bitwise NOT operation
└── input_handlers.py       # Input validation and user interaction

⚙️ Key Features

Smart Input Validation

  • Flexible operator input: Accepts multiple consecutive operators (e.g., &&&& → &)
  • Robust error handling: Validates numeric inputs and operation parameters
  • User-friendly prompts: Clear instructions and error messages

Detailed Binary Visualization

  • Step-by-step calculation: Shows bit-by-bit operation process
  • Automatic width detection: Adjusts binary representation width based on input numbers
  • Two's complement support: Proper handling of negative numbers in bit inversion

🧾 License

This project is open source and available under the MIT License.