locals()

Introspection

Returns a dictionary of the current local symbol table.

Signature

locals()

Returns

dict

Example

def demo():
    x = 42
    y = 'hello'
    print(locals())  # {'x': 42, 'y': 'hello'}
demo()

About locals()

locals is a Python introspection function with the signature locals(). Returns a dictionary of the current local symbol table. It returns a value of type dict.

Python provides a rich set of built-in functions and standard library modules that cover common programming tasks. Understanding these functions helps you write more idiomatic, efficient Python code. The localsfunction is commonly used in data processing, web development, scripting, and automation tasks.

When working with locals(), consider edge cases like empty inputs, None values, and type mismatches. Python's duck typing means many built-in functions work with any object that implements the required protocol (e.g., __len__ for len(), __iter__ for iteration). This flexibility is a key strength of Python's design philosophy.

Related Functions