C GUI Calculator

A GUI-based calculator developed in C using GTK.

Project maintained by rafisarkar0128 Hosted on GitHub Pages — Theme by mattgraham

🧮 C GUI Calculator

A beginner-friendly project developed as part of the CSE115 course in the Department of Electrical & Computer Engineering in North South University. This GUI-based calculator performs both basic arithmetic and scientific operations using the C programming language with a graphical interface powered by GTK.

🧪 Project Reactor Status

Issues Forks Stargazers Contributors MIT License Last Commit

🗂️ Project Structure

c-gui-calculator/
├── main.c              # Main code file to run the project
├── README.md           # Project documentation
├── requirements.txt    # List of required tools/libraries
├── .github/            # GitHub workflows and issue templates
├── .gitignore          # Ignore unnecessary files
├── LICENSE             # Project license
├── SECURITY.md         # Security policy
├── _config.yml         # Configuration file (for GitHub Pages)
├── data/               # Datasets (images, etc.)
├── support/            # Other code files
├── others/             # Final & update presentations, reports, and demo video
│   ├── final_presentation.pptx
│   ├── final_report.pdf
│   ├── update_presentation.pptx
│   ├── update_report.pdf
│   └── demo_video.mp4

🚀 Features

📊 Basic Operations

🔬 Scientific Functions

🧠 Advanced Features

📝 Usage Examples

Basic Arithmetic

2 + 3 * 4 = 14          # Respects operator precedence
(2 + 3) * 4 = 20        # Parentheses override precedence
15 / 3 + 2 = 7          # Left-to-right evaluation for same precedence
50% = 0.5               # Percentage conversion

Scientific Functions

sqrt(16) = 4            # Square root
sqrt(2) = 1.414...      # Works with non-perfect squares
log(100) = 2            # Base-10 logarithm
ln(2.718) = 1           # Natural logarithm (approximately e)
sin(30) = 0.5           # Sine in degrees
cos(60) = 0.5           # Cosine in degrees
tan(45) = 1             # Tangent in degrees

Power Operations

2^3 = 8                 # Basic exponentiation
2^3^2 = 512             # Right associative: 2^(3^2), not (2^3)^2
(-2)^3 = -8             # Negative base with integer exponent
4^0.5 = 2               # Fractional exponents (same as sqrt)

Complex Expressions

sin(90) + sqrt(cos(0) * 4) = 3     # Mixed functions: 1 + sqrt(1 * 4) = 1 + 2 = 3
(5 + 3) * sqrt(16) / 2 = 16        # Multiple operations: 8 * 4 / 2 = 16
log(10^3) = 3                      # Logarithm of power: log(1000) = 3
2 * sin(30) + cos(60) = 1.5        # Multiple trig functions: 2 * 0.5 + 0.5 = 1.5

⌨️ Keyboard Shortcuts

Key Action Description
Enter Calculate Same as pressing the = button
Backspace Delete Remove last character from input
Numbers 0-9 Input Use on-screen buttons only
Operators Input Use on-screen buttons only

Note: Most input requires using the on-screen buttons to ensure proper token recognition by the expression parser.

❌ Error Handling

The calculator provides comprehensive error checking for mathematical edge cases:

Domain Errors

sqrt(-4)        → "Cannot take square root of negative number"
log(0)          → "Logarithm undefined for zero or negative numbers"
log(-5)         → "Logarithm undefined for zero or negative numbers"
ln(0)           → "Natural log undefined for zero or negative numbers"

Division Errors

5 / 0           → "Division by zero"
1 / (2-2)       → "Division by zero"
0^(-2)          → "Cannot raise zero to negative power"

Power Function Errors

(-2)^1.5        → "Cannot raise negative number to non-integer power"
(-3)^0.333      → "Cannot raise negative number to non-integer power"

Trigonometric Errors

tan(90)         → "Tangent undefined at 90° and odd multiples"
tan(270)        → "Tangent undefined at 90° and odd multiples"
tan(-90)        → "Tangent undefined at 90° and odd multiples"

Syntax Errors

((2+3)          → "Mismatched parentheses"
2++)            → "Invalid character in expression"
sin(            → "Function 'sin' requires an argument"
+ * 2           → "Not enough operands for operator"

🤝 Team Members

This project was collaboratively developed by:

🚀 Quick Start

Prerequisites

Ensure you have the following installed:

Installation & Setup

  1. Clone the repository

     git clone https://github.com/rafisarkar0128/c-gui-calculator.git
 cd c-gui-calculator

  2. Install dependencies

    Linux (Ubuntu/Debian):

     sudo apt update
 sudo apt install gcc pkg-config libgtk-3-dev

    Linux (Fedora/CentOS/RHEL):

     sudo dnf install gcc pkgconf-pkg-config gtk3-devel

    Windows (MSYS2):

     pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-pkg-config mingw-w64-x86_64-gtk3

    macOS (Homebrew):

     brew install gcc pkg-config gtk+3

  3. Compile & Run

     gcc -o calculator main.c `pkg-config --cflags --libs gtk+-3.0` -lm
 ./calculator

📖 Need help? See our comprehensive Getting Started Guide for detailed setup instructions, troubleshooting tips, and platform-specific notes.

🏗️ Technical Architecture

The calculator implements several advanced computer science concepts:

Expression Parsing

Memory Management

GUI Architecture

📚 Learning Outcomes

🤝 Contributing

We welcome contributions! Here’s how you can help:

  1. Fork the repository and create your feature branch
  2. Follow our coding standards - consistent formatting and documentation
  3. Test thoroughly - ensure all features work across platforms
  4. Submit a pull request with a clear description of changes

Development Setup

  1. Follow the Quick Start guide above
  2. Make your changes in a feature branch
  3. Test compilation and functionality
  4. Submit your pull request

📞 Contact & Support

For questions, bug reports, or contributions:

📚 References & Resources

🧠 Acknowledgments

Thanks to our instructor and the CSE115 course staff for their guidance and resources, and to the open-source community for tools and inspiration.

📄 License

This project is licensed under the MIT License.