How do I check if a Python variable exists?

Variables are defined as the containers used to store data in memory. In Python, variables don't need explicit type declaration and are created by simply assigning a value to a name. However, before using a variable, it must be defined first to avoid errors.

x = 5
print(x)

5

Here, x is the variable name holding an integer value.

Understanding Variable Scope

Variable scope determines where an identifier can be accessed within a program. Python has two basic scopes ?

• Local variables − Defined within a function or block
• Global variables − Defined outside all functions

Local Variables Example

Variables defined inside a function are only accessible within that function ?

def greet():
    name = 'Rahul'
    print('Hello', name)

greet()

# This will cause an error
try:
    print(name)
except NameError as e:
    print(f"Error: {e}")

Hello Rahul
Error: name 'name' is not defined

Global Variables Example

Global variables can be accessed from anywhere in the program ?

name = 'Rahul'  # Global variable

def greet():
    print("Hello", name)

greet()
print("Global name:", name)

Hello Rahul
Global name: Rahul

Method 1: Using locals() Function

The locals() function returns a dictionary of current local variables. Use the in operator to check if a variable exists ?

def check_local():
    test_var = "Hello"
    
    if 'test_var' in locals():
        print("Variable found in local scope")
    else:
        print("Variable not found in local scope")
        
    if 'unknown_var' in locals():
        print("Unknown variable found")
    else:
        print("Unknown variable not found")

check_local()

Variable found in local scope
Unknown variable not found

Method 2: Using globals() Function

The globals() function returns a dictionary of global variables ?

global_var = "Python"

if 'global_var' in globals():
    print("Variable present in global namespace")
else:
    print("Variable not present in global namespace")
    
if 'missing_var' in globals():
    print("Missing variable found")
else:
    print("Missing variable not found")

Variable present in global namespace
Missing variable not found

Method 3: Using hasattr() for Class Attributes

The hasattr() function checks if an object has a specific attribute ?

Syntax

hasattr(object, attribute_name)

Example

class Fruit:
    color = 'Red'
    name = 'Apple'

fruit_obj = Fruit()

if hasattr(fruit_obj, 'name'):
    print("Fruit's name:", fruit_obj.name)

if hasattr(fruit_obj, 'color'):
    print("Fruit's color:", fruit_obj.color)
    
if hasattr(fruit_obj, 'taste'):
    print("Fruit's taste:", fruit_obj.taste)
else:
    print("Taste attribute not found")

Fruit's name: Apple
Fruit's color: Red
Taste attribute not found

Comparison of Methods

Practical Example: Complete Variable Check

x = 10  # Global variable

class Vehicle:
    wheels = 4
    
    def check_variables(self):
        local_speed = 60  # Local variable
        
        # Check local variable
        if 'local_speed' in locals():
            print("local_speed is a local variable")
        
        # Check global variable
        if 'x' in globals():
            print("x is a global variable")
        
        # Check class attribute
        if hasattr(self, 'wheels'):
            print("wheels is a class attribute")

car = Vehicle()
car.check_variables()

local_speed is a local variable
x is a global variable
wheels is a class attribute

Conclusion

Use locals() for checking local variables, globals() for global variables, and hasattr() for class attributes. These methods provide safe ways to verify variable existence without causing NameError exceptions.