- Python »
- 3.13.0 Documentation »
- The Python Language Reference »
- 7. Simple statements
- Theme Auto Light Dark |
7. Simple statements ¶
A simple statement is comprised within a single logical line. Several simple statements may occur on a single line separated by semicolons. The syntax for simple statements is:
7.1. Expression statements ¶
Expression statements are used (mostly interactively) to compute and write a value, or (usually) to call a procedure (a function that returns no meaningful result; in Python, procedures return the value None ). Other uses of expression statements are allowed and occasionally useful. The syntax for an expression statement is:
An expression statement evaluates the expression list (which may be a single expression).
In interactive mode, if the value is not None , it is converted to a string using the built-in repr() function and the resulting string is written to standard output on a line by itself (except if the result is None , so that procedure calls do not cause any output.)
7.2. Assignment statements ¶
Assignment statements are used to (re)bind names to values and to modify attributes or items of mutable objects:
(See section Primaries for the syntax definitions for attributeref , subscription , and slicing .)
An assignment statement evaluates the expression list (remember that this can be a single expression or a comma-separated list, the latter yielding a tuple) and assigns the single resulting object to each of the target lists, from left to right.
Assignment is defined recursively depending on the form of the target (list). When a target is part of a mutable object (an attribute reference, subscription or slicing), the mutable object must ultimately perform the assignment and decide about its validity, and may raise an exception if the assignment is unacceptable. The rules observed by various types and the exceptions raised are given with the definition of the object types (see section The standard type hierarchy ).
Assignment of an object to a target list, optionally enclosed in parentheses or square brackets, is recursively defined as follows.
If the target list is a single target with no trailing comma, optionally in parentheses, the object is assigned to that target.
If the target list contains one target prefixed with an asterisk, called a “starred” target: The object must be an iterable with at least as many items as there are targets in the target list, minus one. The first items of the iterable are assigned, from left to right, to the targets before the starred target. The final items of the iterable are assigned to the targets after the starred target. A list of the remaining items in the iterable is then assigned to the starred target (the list can be empty).
Else: The object must be an iterable with the same number of items as there are targets in the target list, and the items are assigned, from left to right, to the corresponding targets.
Assignment of an object to a single target is recursively defined as follows.
If the target is an identifier (name):
If the name does not occur in a global or nonlocal statement in the current code block: the name is bound to the object in the current local namespace.
Otherwise: the name is bound to the object in the global namespace or the outer namespace determined by nonlocal , respectively.
The name is rebound if it was already bound. This may cause the reference count for the object previously bound to the name to reach zero, causing the object to be deallocated and its destructor (if it has one) to be called.
If the target is an attribute reference: The primary expression in the reference is evaluated. It should yield an object with assignable attributes; if this is not the case, TypeError is raised. That object is then asked to assign the assigned object to the given attribute; if it cannot perform the assignment, it raises an exception (usually but not necessarily AttributeError ).
Note: If the object is a class instance and the attribute reference occurs on both sides of the assignment operator, the right-hand side expression, a.x can access either an instance attribute or (if no instance attribute exists) a class attribute. The left-hand side target a.x is always set as an instance attribute, creating it if necessary. Thus, the two occurrences of a.x do not necessarily refer to the same attribute: if the right-hand side expression refers to a class attribute, the left-hand side creates a new instance attribute as the target of the assignment:
This description does not necessarily apply to descriptor attributes, such as properties created with property() .
If the target is a subscription: The primary expression in the reference is evaluated. It should yield either a mutable sequence object (such as a list) or a mapping object (such as a dictionary). Next, the subscript expression is evaluated.
If the primary is a mutable sequence object (such as a list), the subscript must yield an integer. If it is negative, the sequence’s length is added to it. The resulting value must be a nonnegative integer less than the sequence’s length, and the sequence is asked to assign the assigned object to its item with that index. If the index is out of range, IndexError is raised (assignment to a subscripted sequence cannot add new items to a list).
If the primary is a mapping object (such as a dictionary), the subscript must have a type compatible with the mapping’s key type, and the mapping is then asked to create a key/value pair which maps the subscript to the assigned object. This can either replace an existing key/value pair with the same key value, or insert a new key/value pair (if no key with the same value existed).
For user-defined objects, the __setitem__() method is called with appropriate arguments.
If the target is a slicing: The primary expression in the reference is evaluated. It should yield a mutable sequence object (such as a list). The assigned object should be a sequence object of the same type. Next, the lower and upper bound expressions are evaluated, insofar they are present; defaults are zero and the sequence’s length. The bounds should evaluate to integers. If either bound is negative, the sequence’s length is added to it. The resulting bounds are clipped to lie between zero and the sequence’s length, inclusive. Finally, the sequence object is asked to replace the slice with the items of the assigned sequence. The length of the slice may be different from the length of the assigned sequence, thus changing the length of the target sequence, if the target sequence allows it.
CPython implementation detail: In the current implementation, the syntax for targets is taken to be the same as for expressions, and invalid syntax is rejected during the code generation phase, causing less detailed error messages.
Although the definition of assignment implies that overlaps between the left-hand side and the right-hand side are ‘simultaneous’ (for example a, b = b, a swaps two variables), overlaps within the collection of assigned-to variables occur left-to-right, sometimes resulting in confusion. For instance, the following program prints [0, 2] :
The specification for the *target feature.
7.2.1. Augmented assignment statements ¶
Augmented assignment is the combination, in a single statement, of a binary operation and an assignment statement:
(See section Primaries for the syntax definitions of the last three symbols.)
An augmented assignment evaluates the target (which, unlike normal assignment statements, cannot be an unpacking) and the expression list, performs the binary operation specific to the type of assignment on the two operands, and assigns the result to the original target. The target is only evaluated once.
An augmented assignment statement like x += 1 can be rewritten as x = x + 1 to achieve a similar, but not exactly equal effect. In the augmented version, x is only evaluated once. Also, when possible, the actual operation is performed in-place , meaning that rather than creating a new object and assigning that to the target, the old object is modified instead.
Unlike normal assignments, augmented assignments evaluate the left-hand side before evaluating the right-hand side. For example, a[i] += f(x) first looks-up a[i] , then it evaluates f(x) and performs the addition, and lastly, it writes the result back to a[i] .
With the exception of assigning to tuples and multiple targets in a single statement, the assignment done by augmented assignment statements is handled the same way as normal assignments. Similarly, with the exception of the possible in-place behavior, the binary operation performed by augmented assignment is the same as the normal binary operations.
For targets which are attribute references, the same caveat about class and instance attributes applies as for regular assignments.
7.2.2. Annotated assignment statements ¶
Annotation assignment is the combination, in a single statement, of a variable or attribute annotation and an optional assignment statement:
The difference from normal Assignment statements is that only a single target is allowed.
The assignment target is considered “simple” if it consists of a single name that is not enclosed in parentheses. For simple assignment targets, if in class or module scope, the annotations are evaluated and stored in a special class or module attribute __annotations__ that is a dictionary mapping from variable names (mangled if private) to evaluated annotations. This attribute is writable and is automatically created at the start of class or module body execution, if annotations are found statically.
If the assignment target is not simple (an attribute, subscript node, or parenthesized name), the annotation is evaluated if in class or module scope, but not stored.
If a name is annotated in a function scope, then this name is local for that scope. Annotations are never evaluated and stored in function scopes.
If the right hand side is present, an annotated assignment performs the actual assignment before evaluating annotations (where applicable). If the right hand side is not present for an expression target, then the interpreter evaluates the target except for the last __setitem__() or __setattr__() call.
The proposal that added syntax for annotating the types of variables (including class variables and instance variables), instead of expressing them through comments.
The proposal that added the typing module to provide a standard syntax for type annotations that can be used in static analysis tools and IDEs.
Changed in version 3.8: Now annotated assignments allow the same expressions in the right hand side as regular assignments. Previously, some expressions (like un-parenthesized tuple expressions) caused a syntax error.
7.3. The assert statement ¶
Assert statements are a convenient way to insert debugging assertions into a program:
The simple form, assert expression , is equivalent to
The extended form, assert expression1, expression2 , is equivalent to
These equivalences assume that __debug__ and AssertionError refer to the built-in variables with those names. In the current implementation, the built-in variable __debug__ is True under normal circumstances, False when optimization is requested (command line option -O ). The current code generator emits no code for an assert statement when optimization is requested at compile time. Note that it is unnecessary to include the source code for the expression that failed in the error message; it will be displayed as part of the stack trace.
Assignments to __debug__ are illegal. The value for the built-in variable is determined when the interpreter starts.
7.4. The pass statement ¶
pass is a null operation — when it is executed, nothing happens. It is useful as a placeholder when a statement is required syntactically, but no code needs to be executed, for example:
7.5. The del statement ¶
Deletion is recursively defined very similar to the way assignment is defined. Rather than spelling it out in full details, here are some hints.
Deletion of a target list recursively deletes each target, from left to right.
Deletion of a name removes the binding of that name from the local or global namespace, depending on whether the name occurs in a global statement in the same code block. If the name is unbound, a NameError exception will be raised.
Deletion of attribute references, subscriptions and slicings is passed to the primary object involved; deletion of a slicing is in general equivalent to assignment of an empty slice of the right type (but even this is determined by the sliced object).
Changed in version 3.2: Previously it was illegal to delete a name from the local namespace if it occurs as a free variable in a nested block.
7.6. The return statement ¶
return may only occur syntactically nested in a function definition, not within a nested class definition.
If an expression list is present, it is evaluated, else None is substituted.
return leaves the current function call with the expression list (or None ) as return value.
When return passes control out of a try statement with a finally clause, that finally clause is executed before really leaving the function.
In a generator function, the return statement indicates that the generator is done and will cause StopIteration to be raised. The returned value (if any) is used as an argument to construct StopIteration and becomes the StopIteration.value attribute.
In an asynchronous generator function, an empty return statement indicates that the asynchronous generator is done and will cause StopAsyncIteration to be raised. A non-empty return statement is a syntax error in an asynchronous generator function.
7.7. The yield statement ¶
A yield statement is semantically equivalent to a yield expression . The yield statement can be used to omit the parentheses that would otherwise be required in the equivalent yield expression statement. For example, the yield statements
are equivalent to the yield expression statements
Yield expressions and statements are only used when defining a generator function, and are only used in the body of the generator function. Using yield in a function definition is sufficient to cause that definition to create a generator function instead of a normal function.
For full details of yield semantics, refer to the Yield expressions section.
7.8. The raise statement ¶
If no expressions are present, raise re-raises the exception that is currently being handled, which is also known as the active exception . If there isn’t currently an active exception, a RuntimeError exception is raised indicating that this is an error.
Otherwise, raise evaluates the first expression as the exception object. It must be either a subclass or an instance of BaseException . If it is a class, the exception instance will be obtained when needed by instantiating the class with no arguments.
The type of the exception is the exception instance’s class, the value is the instance itself.
A traceback object is normally created automatically when an exception is raised and attached to it as the __traceback__ attribute. You can create an exception and set your own traceback in one step using the with_traceback() exception method (which returns the same exception instance, with its traceback set to its argument), like so:
The from clause is used for exception chaining: if given, the second expression must be another exception class or instance. If the second expression is an exception instance, it will be attached to the raised exception as the __cause__ attribute (which is writable). If the expression is an exception class, the class will be instantiated and the resulting exception instance will be attached to the raised exception as the __cause__ attribute. If the raised exception is not handled, both exceptions will be printed:
A similar mechanism works implicitly if a new exception is raised when an exception is already being handled. An exception may be handled when an except or finally clause, or a with statement, is used. The previous exception is then attached as the new exception’s __context__ attribute:
Exception chaining can be explicitly suppressed by specifying None in the from clause:
Additional information on exceptions can be found in section Exceptions , and information about handling exceptions is in section The try statement .
Changed in version 3.3: None is now permitted as Y in raise X from Y .
Added the __suppress_context__ attribute to suppress automatic display of the exception context.
Changed in version 3.11: If the traceback of the active exception is modified in an except clause, a subsequent raise statement re-raises the exception with the modified traceback. Previously, the exception was re-raised with the traceback it had when it was caught.
7.9. The break statement ¶
break may only occur syntactically nested in a for or while loop, but not nested in a function or class definition within that loop.
It terminates the nearest enclosing loop, skipping the optional else clause if the loop has one.
If a for loop is terminated by break , the loop control target keeps its current value.
When break passes control out of a try statement with a finally clause, that finally clause is executed before really leaving the loop.
7.10. The continue statement ¶
continue may only occur syntactically nested in a for or while loop, but not nested in a function or class definition within that loop. It continues with the next cycle of the nearest enclosing loop.
When continue passes control out of a try statement with a finally clause, that finally clause is executed before really starting the next loop cycle.
7.11. The import statement ¶
The basic import statement (no from clause) is executed in two steps:
find a module, loading and initializing it if necessary
define a name or names in the local namespace for the scope where the import statement occurs.
When the statement contains multiple clauses (separated by commas) the two steps are carried out separately for each clause, just as though the clauses had been separated out into individual import statements.
The details of the first step, finding and loading modules, are described in greater detail in the section on the import system , which also describes the various types of packages and modules that can be imported, as well as all the hooks that can be used to customize the import system. Note that failures in this step may indicate either that the module could not be located, or that an error occurred while initializing the module, which includes execution of the module’s code.
If the requested module is retrieved successfully, it will be made available in the local namespace in one of three ways:
If the module name is followed by as , then the name following as is bound directly to the imported module.
If no other name is specified, and the module being imported is a top level module, the module’s name is bound in the local namespace as a reference to the imported module
If the module being imported is not a top level module, then the name of the top level package that contains the module is bound in the local namespace as a reference to the top level package. The imported module must be accessed using its full qualified name rather than directly
The from form uses a slightly more complex process:
find the module specified in the from clause, loading and initializing it if necessary;
for each of the identifiers specified in the import clauses:
check if the imported module has an attribute by that name
if not, attempt to import a submodule with that name and then check the imported module again for that attribute
if the attribute is not found, ImportError is raised.
otherwise, a reference to that value is stored in the local namespace, using the name in the as clause if it is present, otherwise using the attribute name
If the list of identifiers is replaced by a star ( '*' ), all public names defined in the module are bound in the local namespace for the scope where the import statement occurs.
The public names defined by a module are determined by checking the module’s namespace for a variable named __all__ ; if defined, it must be a sequence of strings which are names defined or imported by that module. The names given in __all__ are all considered public and are required to exist. If __all__ is not defined, the set of public names includes all names found in the module’s namespace which do not begin with an underscore character ( '_' ). __all__ should contain the entire public API. It is intended to avoid accidentally exporting items that are not part of the API (such as library modules which were imported and used within the module).
The wild card form of import — from module import * — is only allowed at the module level. Attempting to use it in class or function definitions will raise a SyntaxError .
When specifying what module to import you do not have to specify the absolute name of the module. When a module or package is contained within another package it is possible to make a relative import within the same top package without having to mention the package name. By using leading dots in the specified module or package after from you can specify how high to traverse up the current package hierarchy without specifying exact names. One leading dot means the current package where the module making the import exists. Two dots means up one package level. Three dots is up two levels, etc. So if you execute from . import mod from a module in the pkg package then you will end up importing pkg.mod . If you execute from ..subpkg2 import mod from within pkg.subpkg1 you will import pkg.subpkg2.mod . The specification for relative imports is contained in the Package Relative Imports section.
importlib.import_module() is provided to support applications that determine dynamically the modules to be loaded.
Raises an auditing event import with arguments module , filename , sys.path , sys.meta_path , sys.path_hooks .
7.11.1. Future statements ¶
A future statement is a directive to the compiler that a particular module should be compiled using syntax or semantics that will be available in a specified future release of Python where the feature becomes standard.
The future statement is intended to ease migration to future versions of Python that introduce incompatible changes to the language. It allows use of the new features on a per-module basis before the release in which the feature becomes standard.
A future statement must appear near the top of the module. The only lines that can appear before a future statement are:
the module docstring (if any),
blank lines, and
other future statements.
The only feature that requires using the future statement is annotations (see PEP 563 ).
All historical features enabled by the future statement are still recognized by Python 3. The list includes absolute_import , division , generators , generator_stop , unicode_literals , print_function , nested_scopes and with_statement . They are all redundant because they are always enabled, and only kept for backwards compatibility.
A future statement is recognized and treated specially at compile time: Changes to the semantics of core constructs are often implemented by generating different code. It may even be the case that a new feature introduces new incompatible syntax (such as a new reserved word), in which case the compiler may need to parse the module differently. Such decisions cannot be pushed off until runtime.
For any given release, the compiler knows which feature names have been defined, and raises a compile-time error if a future statement contains a feature not known to it.
The direct runtime semantics are the same as for any import statement: there is a standard module __future__ , described later, and it will be imported in the usual way at the time the future statement is executed.
The interesting runtime semantics depend on the specific feature enabled by the future statement.
Note that there is nothing special about the statement:
That is not a future statement; it’s an ordinary import statement with no special semantics or syntax restrictions.
Code compiled by calls to the built-in functions exec() and compile() that occur in a module M containing a future statement will, by default, use the new syntax or semantics associated with the future statement. This can be controlled by optional arguments to compile() — see the documentation of that function for details.
A future statement typed at an interactive interpreter prompt will take effect for the rest of the interpreter session. If an interpreter is started with the -i option, is passed a script name to execute, and the script includes a future statement, it will be in effect in the interactive session started after the script is executed.
The original proposal for the __future__ mechanism.
7.12. The global statement ¶
The global statement is a declaration which holds for the entire current code block. It means that the listed identifiers are to be interpreted as globals. It would be impossible to assign to a global variable without global , although free variables may refer to globals without being declared global.
Names listed in a global statement must not be used in the same code block textually preceding that global statement.
Names listed in a global statement must not be defined as formal parameters, or as targets in with statements or except clauses, or in a for target list, class definition, function definition, import statement, or variable annotation.
CPython implementation detail: The current implementation does not enforce some of these restrictions, but programs should not abuse this freedom, as future implementations may enforce them or silently change the meaning of the program.
Programmer’s note: global is a directive to the parser. It applies only to code parsed at the same time as the global statement. In particular, a global statement contained in a string or code object supplied to the built-in exec() function does not affect the code block containing the function call, and code contained in such a string is unaffected by global statements in the code containing the function call. The same applies to the eval() and compile() functions.
7.13. The nonlocal statement ¶
When the definition of a function or class is nested (enclosed) within the definitions of other functions, its nonlocal scopes are the local scopes of the enclosing functions. The nonlocal statement causes the listed identifiers to refer to names previously bound in nonlocal scopes. It allows encapsulated code to rebind such nonlocal identifiers. If a name is bound in more than one nonlocal scope, the nearest binding is used. If a name is not bound in any nonlocal scope, or if there is no nonlocal scope, a SyntaxError is raised.
The nonlocal statement applies to the entire scope of a function or class body. A SyntaxError is raised if a variable is used or assigned to prior to its nonlocal declaration in the scope.
The specification for the nonlocal statement.
Programmer’s note: nonlocal is a directive to the parser and applies only to code parsed along with it. See the note for the global statement.
7.14. The type statement ¶
The type statement declares a type alias, which is an instance of typing.TypeAliasType .
For example, the following statement creates a type alias:
This code is roughly equivalent to:
annotation-def indicates an annotation scope , which behaves mostly like a function, but with several small differences.
The value of the type alias is evaluated in the annotation scope. It is not evaluated when the type alias is created, but only when the value is accessed through the type alias’s __value__ attribute (see Lazy evaluation ). This allows the type alias to refer to names that are not yet defined.
Type aliases may be made generic by adding a type parameter list after the name. See Generic type aliases for more.
type is a soft keyword .
Added in version 3.12.
Introduced the type statement and syntax for generic classes and functions.
Table of Contents
- 7.1. Expression statements
- 7.2.1. Augmented assignment statements
- 7.2.2. Annotated assignment statements
- 7.3. The assert statement
- 7.4. The pass statement
- 7.5. The del statement
- 7.6. The return statement
- 7.7. The yield statement
- 7.8. The raise statement
- 7.9. The break statement
- 7.10. The continue statement
- 7.11.1. Future statements
- 7.12. The global statement
- 7.13. The nonlocal statement
- 7.14. The type statement
Previous topic
6. Expressions
8. Compound statements
- Report a Bug
- Show Source
Declaration and Reassignment
Declaring single variables.
In Python, a variable is created during assignment. Python is type inferred — therefore there is no need to explicitly define a variable’s type. It can simply be created by naming it and then assigning any value irrespective of the type to it.
For instance, let’s name a variable moving_average . To save or assign a value to it, we will use the assignment operator (=) followed by the said value.
Here, the variables are moving_average , name_of_language , and main_languages , and each variable has a different type of value. 10.2, “Python”, and [‘Python’, ‘JavaScript’, ‘C++’, ‘Java’, ‘GO’] are literals. In Python, literals refer to a specific and fixed value of a variable at any instant.
Literals , in Python, refer to a specific and fixed value at any instant.
Note : We can not use reserved keywords to name variables. The following table shows the list of reserved keywords found in Python 3.12.0.
Reassigning Variables
When there is a need to update a variable, they can be reassigned values easily as well
Suppose the moving_average changes to 10.5, Python allows changing the value of a variable by simply reassigning it again.
Declaring Multiple Variables
We can define multiple variables in one line by following a comma separated syntax. Python also provides for the ease of saving the same value in more than one variable.
For example, let’s create two variables, called mean and median , and save 5 and 7 in them, respectively. Let’s also create sorted_list and sorted_list2 and save [‘1’, ‘2’, ‘3’, ‘4’] in both of these variables.
The FinAnalytics
Core Programs
Primer programs, financial articles, interview guides, success stories, understanding variables in python: declaration, assignment, and naming conventions.
Variables are essential elements in programming languages like Python. they serve as containers to store data values that can be manipulated or referenced in a program. Understanding how variables are declared, assigned values, and named according to conventions is crucial for writing clean and readable Python code.
Variable Declaration and Assignment in Python
In Python, variables are declared by simply assigning a value to them. Unlike some other programming languages, Python does not require explicit declaration of variables or specifying their data types. the variable's data type is inferred based on the value assigned to it. this process is known as variable assignment, which can be done using the equals sign "=" (also known as the assignment operator). Once the value is assigned to a variable, it is created, and we can start using it in other statements or expressions.
for instance, the following code snippet creates a variable named " stockPrice " and assigns the value 100 (an integer) to it.
the variable stockPrice is now created and holds the value 100 . You can use it in other expressions or statements as shown below.
Variables in Python can be reassigned to different values, allowing for dynamic changes in a program. A variable's value can be updated by simply assigning a new value to it. You can re-declare a variable by assigning a new value to it. for instance, we can change the value of the " stockPrice " variable to 150 as follows:
You can also assign the values to multiple variables simultaneously using the chaining assignment operation as shown below.
the simultaneous assignment operation in Python provides programmers with a concise and efficient way to assign values to multiple variables in a single line of code.
Naming Conventions for Variables
While naming variables in Python, it is essential to follow proper naming conventions for code clarity and maintainability. Here are some guidelines to follow when naming variables:
Start with a Letter or Underscore: Variable names must begin with a letter (a-z, A-Z) or an underscore (_) character. for example: "stockPrice" or "_stockPrice" are acceptable variable names.
Avoid Starting with a Number: Variable names cannot begin with a number. for example: "1stockPrice" or "1_stockPrice" are invalid variable names.
Use Alphanumeric Characters and Underscores: Variable names can only contain alphanumeric characters (A-Z, a-z, 0-9) and underscores (_). for example: "stockPrice", "stock_Price", "stockPrice_1", and "stockPrice_2" are all valid variable names.
Avoid Whitespace and Special Characters: Variable names should not contain whitespace or special characters such as +, -, etc. for example: "stock price" or "stock-price" are invalid variable names.
Case Sensitive: Variable names are case-sensitive. for example: "StockPrice", "stockPrice", and "Stockprice" are considered distinct variables.
Avoid Python Keywords: Avoid using Python keywords as variable names. for example: keywords such as "str", "is", and "for" cannot be used as variable names as they are reserved keywords in Python.
In addition to these guidelines, professional programmers follow certain conventions to enhance code readability (best practices). these practices include using a name that describes the purpose " stockPrice ", instead of using dummy or temporary names " temp ". It's also common practice to separate words in variable names with underscores " stock_price ", and start variable names with lowercase letters " stockPrice ".
Following these guidelines and practices can make your code more readable and maintainable. Remember that these are good coding practices recommended by professional programmers, which can be applied to any programming language.
- Python Basics
- Interview Questions
- Python Quiz
- Popular Packages
- Python Projects
- Practice Python
- AI With Python
- Learn Python3
- Python Automation
- Python Web Dev
- DSA with Python
- Python OOPs
- Dictionaries
Different Forms of Assignment Statements in Python
We use Python assignment statements to assign objects to names. The target of an assignment statement is written on the left side of the equal sign (=), and the object on the right can be an arbitrary expression that computes an object.
There are some important properties of assignment in Python :-
- Assignment creates object references instead of copying the objects.
- Python creates a variable name the first time when they are assigned a value.
- Names must be assigned before being referenced.
- There are some operations that perform assignments implicitly.
Assignment statement forms :-
1. Basic form:
This form is the most common form.
2. Tuple assignment:
When we code a tuple on the left side of the =, Python pairs objects on the right side with targets on the left by position and assigns them from left to right. Therefore, the values of x and y are 50 and 100 respectively.
3. List assignment:
This works in the same way as the tuple assignment.
4. Sequence assignment:
In recent version of Python, tuple and list assignment have been generalized into instances of what we now call sequence assignment – any sequence of names can be assigned to any sequence of values, and Python assigns the items one at a time by position.
5. Extended Sequence unpacking:
It allows us to be more flexible in how we select portions of a sequence to assign.
Here, p is matched with the first character in the string on the right and q with the rest. The starred name (*q) is assigned a list, which collects all items in the sequence not assigned to other names.
This is especially handy for a common coding pattern such as splitting a sequence and accessing its front and rest part.
6. Multiple- target assignment:
In this form, Python assigns a reference to the same object (the object which is rightmost) to all the target on the left.
7. Augmented assignment :
The augmented assignment is a shorthand assignment that combines an expression and an assignment.
There are several other augmented assignment forms:
Similar Reads
- Python Programs
- python-basics
Improve your Coding Skills with Practice
What kind of Experience do you want to share?
Mastering Python Variables: Declaration, Types, and Best Practices
Variables are a fundamental building block of programming. They allow developers to store, manipulate, and reference data in a program. Understanding how to properly declare, initialize, and use variables is essential to writing clean, functional code in any programming language.
This comprehensive guide will explain what variables are, why they are important, and how to work with them in Python. It provides a step-by-step walkthrough of variable concepts, supported by example code snippets and citations from authoritative sources. Readers will learn variable declaration syntax, data types, naming conventions, scoping rules, and best practices for using variables effectively. Real-world examples demonstrate how variables are applied in Python programming.
By the end of this guide, readers will have a solid grasp of variables and be equipped to use them proficiently when coding in Python. The knowledge gained will boost coding skills and support further learning and development.
Table of Contents
What are variables, why use variables, declaring and initializing variables in python, variable data types in python, variable naming conventions, variable assignment in python, accessing and using variables in python, variable scope in python, modifying variables in python, real-world examples of using variables in python, common errors using variables in python, best practices for using variables.
A variable is a named location in memory where a program can store data that will be used later on. This data can be a number, string, Boolean, list, dictionary, or other Python object. The value stored in a variable can be updated and changed throughout the execution of a program (Python Docs, 2022).
Variables act as containers for data. By assigning values to variables, developers can give data meaningful names. This makes code more readable and maintainable compared to working with raw, unlabeled data.
Here is a simple example declaring a variable in Python and assigning a string value to it:
This stores the string “Ada Lovelace” in a variable called name . Now we can easily reference this data by its meaningful name.
Variables are indispensible in programming because they provide several key benefits:
Readability - Well-named variables make code more understandable compared to using raw values.
Reusability - Storing values in variables allows them to be easily reused throughout a program.
Editability - Changing one variable can update a value everywhere it is used.
Traceability - Tracking bugs is easier when values have descriptive variable names.
Maintainability - Code using well-structured variables is easier to change and update.
Proper use of variables promotes good coding practices and reduces errors. They help programmers neatly organize data, follow logic flows, and write clean, pragmatic code.
In Python, variables must be declared and initialized before they can be used.
Declaration means creating the variable name.
Initialization means assigning it an initial value.
Python is a dynamically typed language, meaning variables can be declared without specifying their type. The Python interpreter infers the variable type based on the first value assigned to it (Lutz, 2013).
Here is the syntax for declaring and initializing a variable in Python:
For example:
This syntax does both the declaration and initialization in one line by setting variable_name equal to initial_value .
Some key points about declaring variables in Python:
Variable names can contain letters, numbers, or underscores but cannot start with a number.
Spaces are not allowed in variable names. Underscores can be used to separate words.
Names are case-sensitive - age and Age are different variables.
Reserved Python keywords cannot be used as variable names.
Use descriptive, unambiguous names that indicate the data being stored.
Variables can hold values of various data types. Some common Python data types that can be stored in variables include:
- Integers - Whole numbers like 10, 25, -3 etc.
- Floats - Decimal numbers like 1.5, 3.4567, -20.0 etc.
- Strings - Ordered sequences of characters defined with quotes.
- Booleans - Logical values True or False.
- Lists - Ordered collections of objects defined in square brackets.
- Tuples - Immutable ordered sequences of objects.
The Python interpreter automatically sets the variable’s type based on the data assigned to it. The type can be checked using the type() function:
Variables can be reassigned values of a different type after initialization, known as dynamic typing.
When declaring variables in Python, it is best practice to follow the standard Python style guide PEP 8 recommendations for variable naming (PEP 8, 2022):
Use lowercase letters, numbers, and underscores - no spaces.
Start with a lowercase letter or underscore.
Use underscores to separate words in long names.
Avoid single character names except for counters or iterators.
Use nouns for variable names that store data.
Use verbs for variables that refer to functions.
Avoid overly abbreviated or vague names.
Use capitalized acronyms or abbreviation in variables names.
These conventions produce clean, readable code that conveys the meaning and purpose of variables. For example:
Adhering to naming standards makes code more understandable for other developers as well.
The assignment operator = is used to assign values to variables in Python.
This binds the name on the left-hand side to the object on the right-hand side.
Some key points about variable assignment:
The right-hand value is evaluated first before storing the result in the left-hand variable.
Chained assignments can be used to assign the same value to multiple variables:
- Variables can be reassigned new values later on:
- Multiple variables can be assigned from a sequence or iterator in one line:
- Swapping variables is easy by using a tuple assignment:
While variables themselves are not mutable or immutable, they can reference different data types which have varying mutability. Care should be taken when modifying variables holding references to mutable objects.
Once declared, variables can be accessed and used throughout a Python program by referencing the variable name:
Everywhere the variable is referenced, it will evaluate to the value currently stored in that variable.
Some examples of common operations using variables:
Printing variable values with print()
Using variables in math expressions
Passing variables as arguments to functions
Comparing variable values with comparison operators
Formatting variables into strings with f-strings like f"{name} is a scientist"
Iterating over sequences stored in variables with loops
Adding and removing items from variables pointing to mutable objects like lists and dictionaries
Testing if variables are of expected types with isinstance()
Scope refers to where a variable is visible and accessible within a program. Understanding scope helps avoid bugs caused by unintended variable access.
In Python, there are two main types of scope:
Local scope - Variables defined inside a function are only visible within that function and its inner nested functions. They cannot be referenced or altered from outside.
Global scope - Variables declared at the top level of a Python script file are globally scoped. They can be accessed by all functions in that file.
The global and nonlocal keywords can be used to modify this default scoping behavior. global declares a variable as global even if assigned inside a function. nonlocal references a variable in the enclosing function scope rather than the global scope.
Unlike constants, variables are meant to have modifiable values. In Python, the value stored in an existing variable can be changed:
Updating variables follows these rules:
- Rebinding - Assigning a variable a new object changes the value
- Mutability - Altering a mutable object in-place also changes the variable
- Immutability - An immutable object like string must be reassigned
Care should be taken when modifying variables holding references to mutable objects.
Here are some examples of how variables are useful in real Python programs:
1. Accepting user input
2. Performing math operations
3. Function arguments and return values
4. Collections of data
Some frequent errors that can occur when working with variables include:
- NameError - Trying to use a variable before it is defined.
- TypeError - Trying to use a value of the wrong type for an operation.
- UnboundLocalError - Accessing a local variable in a function before assigning it.
- SyntaxError - Misspelling a variable name or using invalid syntax.
These errors can be avoided by carefully declaring variables, checking types with isinstance() , handling exceptions, and testing code thoroughly.
Here are some best practices to follow when using variables in Python:
- Use meaningful, descriptive variable names
- Avoid single letter names except for counters
- Follow PEP 8 style guidelines for names
- Initialize variables before use
- Leverage Python’s dynamic typing carefully
- Use global and nonlocal keywords appropriately
- Define function parameters with type hints
- Check types with isinstance() where relevant
- Name variables based on their intended usage
- Limit variable scope when appropriate
- Handle potential errors with try/except blocks
Understanding variables is essential to writing effective Python programs. Variables allow developers to organize data, follow program logic, reuse values, and write clean, pragmatic code.
This guide covered key variable concepts including declaration, initialization, data types, naming conventions, assignment, scope, modification, and common errors. Variables should be properly declared with descriptive names and appropriate data types. Values can be dynamically assigned and updated based on program logic. Scope governs where variables are accessible. Following Python style standards and best practices for using variables produces robust and maintainable programs.
With this knowledge, Python developers will be prepared to leverage variables proficiently in their own code. They will understand how to store program state, structure data intuitively, reuse values efficiently, and avoid common pitfalls. Robust use of variables serves as a cornerstone of strong Python programming skills.
- python
- variables-and-operators
previous episode
Python for absolute beginners, next episode, variables and assignment.
Overview Teaching: 15 min Exercises: 15 min Questions How can I store data in programs? Objectives Write scripts that assign values to variables and perform calculations with those values. Correctly trace value changes in scripts that use assignment.
Use variables to store values
Variables are one of the fundamental building blocks of Python. A variable is like a tiny container where you store values and data, such as filenames, words, numbers, collections of words and numbers, and more.
The variable name will point to a value that you “assign” it. You might think about variable assignment like putting a value “into” the variable, as if the variable is a little box 🎁
(In fact, a variable is not a container as such but more like an adress label that points to a container with a given value. This difference will become relevant once we start talking about lists and mutable data types.)
You assign variables with an equals sign ( = ). In Python, a single equals sign = is the “assignment operator.” (A double equals sign == is the “real” equals sign.)
- Variables are names for values.
- In Python the = symbol assigns the value on the right to the name on the left.
- The variable is created when a value is assigned to it.
- Here, Python assigns an age to a variable age and a name in quotation marks to a variable first_name :
Variable names
Variable names can be as long or as short as you want, but there are certain rules you must follow.
- Cannot start with a digit.
- Cannot contain spaces, quotation marks, or other punctuation.
- May contain an underscore (typically used to separate words in long variable names).
- Having an underscore at the beginning of a variable name like _alistairs_real_age has a special meaning. So we won’t do that until we understand the convention.
- The standard naming convention for variable names in Python is the so-called “snake case”, where each word is separated by an underscore. For example my_first_variable . You can read more about naming conventions in Python here .
Use meaningful variable names
Python doesn’t care what you call variables as long as they obey the rules (alphanumeric characters and the underscore). As you start to code, you will almost certainly be tempted to use extremely short variables names like f . Your fingers will get tired. Your coffee will wear off. You will see other people using variables like f . You’ll promise yourself that you’ll definitely remember what f means. But you probably won’t.
So, resist the temptation of bad variable names! Clear and precisely-named variables will:
- Make your code more readable (both to yourself and others).
- Reinforce your understanding of Python and what’s happening in the code.
- Clarify and strengthen your thinking.
Use meaningful variable names to help other people understand what the program does. The most important “other person” is your future self!
Python is case-sensitive
Python thinks that upper- and lower-case letters are different, so Name and name are different variables. There are conventions for using upper-case letters at the start of variable names so we will use lower-case letters for now.
Off-Limits Names
The only variable names that are off-limits are names that are reserved by, or built into, the Python programming language itself — such as print , True , and list . Some of these you can overwrite into variable names (not ideal!), but Jupyter Lab (and many other environments and editors) will catch this by colour coding your variable. If your would-be variable is colour-coded green, rethink your name choice. This is not something to worry too much about. You can get the object back by resetting your kernel.
Use print() to display values
We can check to see what’s “inside” variables by running a cell with the variable’s name. This is one of the handiest features of a Jupyter notebook. Outside the Jupyter environment, you would need to use the print() function to display the variable.
You can run the print() function inside the Jupyter environment, too. This is sometimes useful because Jupyter will only display the last variable in a cell, while print() can display multiple variables. Additionally, Jupyter will display text with \n characters (which means “new line”), while print() will display the text appropriately formatted with new lines.
- Python has a built-in function called print() that prints things as text.
- Provide values to the function (i.e., the things to print) in parentheses.
- To add a string to the printout, wrap the string in single or double quotations.
- The values passed to the function are called ‘arguments’ and are separated by commas.
- When using the print() function, we can also separate with a ‘+’ sign. However, when using ‘+’ we have to add spaces in between manually.
- print() automatically puts a single space between items to separate them.
- And wraps around to a new line at the end.
Variables must be created before they are used
If a variable doesn’t exist yet, or if the name has been misspelled, Python reports an error (unlike some languages, which “guess” a default value).
The last line of an error message is usually the most informative. This message lets us know that there is no variable called eye_color in the script.
Variables Persist Between Cells Variables defined in one cell exist in all other cells once executed, so the relative location of cells in the notebook do not matter (i.e., cells lower down can still affect those above). Notice the number in the square brackets [ ] to the left of the cell. These numbers indicate the order, in which the cells have been executed. Cells with lower numbers will affect cells with higher numbers as Python runs the cells chronologically. As a best practice, we recommend you keep your notebook in chronological order so that it is easier for the human eye to read and make sense of, as well as to avoid any errors if you close and reopen your project, and then rerun what you have done. Remember: Notebook cells are just a way to organize a program! As far as Python is concerned, all of the source code is one long set of instructions.
Variables can be used in calculations
- We can use variables in calculations just as if they were values. Remember, we assigned 42 to age a few lines ago.
This code works in the following way. We are reassigning the value of the variable age by taking its previous value (42) and adding 3, thus getting our new value of 45.
Use an index to get a single character from a string
- The characters (individual letters, numbers, and so on) in a string are ordered. For example, the string ‘AB’ is not the same as ‘BA’. Because of this ordering, we can treat the string as a list of characters.
- Each position in the string (first, second, etc.) is given a number. This number is called an index or sometimes a subscript.
- Indices are numbered from 0 rather than 1.
- Use the position’s index in square brackets to get the character at that position.
Use a slice to get a substring
A part of a string is called a substring. A substring can be as short as a single character. A slice is a part of a string (or, more generally, any list-like thing). We take a slice by using [start:stop] , where start is replaced with the index of the first element we want and stop is replaced with the index of the element just after the last element we want. Mathematically, you might say that a slice selects [start:stop] . The difference between stop and start is the slice’s length. Taking a slice does not change the contents of the original string. Instead, the slice is a copy of part of the original string.
Use the built-in function len() to find the length of a string
The built-in function len() is used to find the length of a string (and later, of other data types, too).
Note that the result is 6 and not 7. This is because it is the length of the value of the variable (i.e. 'helium' ) that is being counted and not the name of the variable (i.e. element )
Also note that nested functions are evaluated from the inside out, just like in mathematics. Thus, Python first reads the len() function, then the print() function.
Choosing a Name Which is a better variable name, m , min , or minutes ? Why? Hint: think about which code you would rather inherit from someone who is leaving the library: ts = m * 60 + s tot_sec = min * 60 + sec total_seconds = minutes * 60 + seconds Solution minutes is better because min might mean something like “minimum” (and actually does in Python, but we haven’t seen that yet).
Swapping Values Draw a table showing the values of the variables in this program after each statement is executed. In simple terms, what do the last three lines of this program do? x = 1.0 y = 3.0 swap = x x = y y = swap Solution swap = x # x->1.0 y->3.0 swap->1.0 x = y # x->3.0 y->3.0 swap->1.0 y = swap # x->3.0 y->1.0 swap->1.0 These three lines exchange the values in x and y using the swap variable for temporary storage. This is a fairly common programming idiom.
Predicting Values What is the final value of position in the program below? (Try to predict the value without running the program, then check your prediction.) initial = "left" position = initial initial = "right" Solution initial = "left" # Initial is assigned the string "left" position = initial # Position is assigned the variable initial, currently "left" initial = "right" # Initial is assigned the string "right" print(position) left The last assignment to position was “left”
Can you slice integers? If you assign a = 123 , what happens if you try to get the second digit of a ? Solution Numbers are not stored in the written representation, so they can’t be treated like strings. a = 123 print(a[1]) TypeError: 'int' object is not subscriptable
Slicing What does the following program print? library_name = 'social sciences' print('library_name[1:3] is:', library_name[1:3]) If thing is a variable name, low is a low number, and high is a high number: What does thing[low:high] do? What does thing[low:] (without a value after the colon) do? What does thing[:high] (without a value before the colon) do? What does thing[:] (just a colon) do? What does thing[number:negative-number] do? Solution library_name[1:3] is: oc It will slice the string, starting at the low index and ending an element before the high index It will slice the string, starting at the low index and stopping at the end of the string It will slice the string, starting at the beginning on the string, and ending an element before the high index It will print the entire string It will slice the string, starting the number index, and ending a distance of the absolute value of negative-number elements from the end of the string
Key Points Use variables to store values. Use meaningful variable names. Python is case-sensitive. Use print() to display values. Variables must be created before they are used. Variables persist between cells. Variables can be used in calculations. Use an index to get a single character from a string. Use a slice to get a substring. Use the built-in function len to find the length of a string.
COMMENTS
An assignment statement evaluates the expression list (remember that this can be a single expression or a comma-separated list, the latter yielding a tuple) and assigns the single resulting object to each of the target lists, from left to right. Assignment is defined recursively depending on the form of the target (list).
There is no such thing as "variable declaration" or "variable initialization" in Python. There is simply what we call "assignment", but should probably just call "naming". Assignment means "this name on the left-hand side now refers to the result of evaluating the right-hand side, regardless of what it referred to before (if anything)".
In Python, a variable is created during assignment. Python is type inferred — therefore there is no need to explicitly define a variable's type. It can simply be created by naming it and then assigning any value irrespective of the type to it. Example. For instance, let's name a variable moving_average. To save or assign a value to it, we ...
In Python, variables are declared by simply assigning a value to them. Unlike some other programming languages, Python does not require explicit declaration of variables or specifying their data types. the variable's data type is inferred based on the value assigned to it. this process is known as variable assignment, which can be done using the equals sign "=" (also known as the assignment ...
Here, variable represents a generic Python variable, while expression represents any Python object that you can provide as a concrete value—also known as a literal—or an expression that evaluates to a value. To execute an assignment statement like the above, Python runs the following steps: Evaluate the right-hand expression to produce a concrete value or object.
There are some important properties of assignment in Python :-Assignment creates object references instead of copying the objects. Python creates a variable name the first time when they are assigned a value. Names must be assigned before being referenced. There are some operations that perform assignments implicitly. Assignment statement forms ...
Understanding variables is essential to writing effective Python programs. Variables allow developers to organize data, follow program logic, reuse values, and write clean, pragmatic code. This guide covered key variable concepts including declaration, initialization, data types, naming conventions, assignment, scope, modification, and common ...
In Python, a single equals sign = is the "assignment operator." (A double equals sign == is the "real" equals sign.) Variables are names for values. In Python the = symbol assigns the value on the right to the name on the left. The variable is created when a value is assigned to it.
If you have closures, you need to precisely declare which scope a variable belongs to. Imagine a language without a declaration keyword, and implicit declaration through assignment (e.g. PHP or Python). Both of these are syntactically challenged with respect to closures, because they either ascribe a variable to the outermost or innermost ...
The variable declaration on the first line works and is valid Python syntax. However, this declaration doesn't really create a new variable for you. ... Parallel Assignment. Python also allows you to run multiple assignments in a single line of code. This feature makes it possible to assign the same value to several variables simultaneously: