Copyright (c) Hyperion Entertainment and contributors.

Difference between revisions of "AmigaOS Manual: Python Elements of Python"

From AmigaOS Documentation Wiki
Jump to navigation Jump to search
 
(6 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
== Strings ==
 
== Strings ==
   
== Lists ==
+
== Arrays ==
   
  +
Python has four types of arrays (data collections) with different properties:
Python has the following functions for the lists:
 
  +
* '''Lists''': duplicate members are allowed, lists are ordered and indexed, and their content can be changed.
  +
* '''Tuples''': duplicate members are allowed, tuples are ordered and indexed, and their content cannot be changed.
  +
* '''Sets''': duplicate members are not allowed, sets are unordered and unindexed, and their content cannot be changed.
  +
* '''Dictionaries''': duplicate members are not allowed, dictionaries are unordered but indexed, and their content can be changed.
  +
  +
=== Lists ===
  +
  +
Python has the following functions for the lists
 
{| class="wikitable"
 
{| class="wikitable"
  +
! style="text-align:left;" | Function
! Function !! Explanation
 
  +
! style="text-align:left;" | Explanation
 
|-
 
|-
| '''cmp''' ( firstList, secondList ) || Compare lists.
+
| '''cmp''' ( <firstList>, <secondList> ) || Compare lists <firstList> and <secondList>.
 
|-
 
|-
| '''len''' ( list ) || Get the number of elements on the list.
+
| '''len''' ( <list> ) || Get the number of elements on the list <list>. See [[AmigaOS_Manual:_Python_Functions#len.28.29|len()]] for more information.
 
|-
 
|-
| '''max''' ( list ) || Get the maximum valued element from the list.
+
| '''max''' ( <list> ) || Get the maximum valued element on the list <list>. See [[AmigaOS_Manual:_Python_Functions#max.28.29|max()]] for more information.
 
|-
 
|-
| '''min''' ( list ) || Get the minimum valued element from the list.
+
| '''min''' ( <list> ) || Get the minimum valued element on the list <list>. See [[AmigaOS_Manual:_Python_Functions#min.28.29|min()]] for more information.
 
|-
 
|-
| '''list''' ( tuple ) || Convert a tuple into a list.
+
| '''list''' ( <tuple> ) || Convert the tuple <tuple> into a list. See [[AmigaOS_Manual:_Python_Functions#list.28.29|list()]] for more information.
 
|}
 
|}
   
Python has the following methods for the list objects:
+
and the following methods for the list objects
 
{| class="wikitable"
 
{| class="wikitable"
  +
! style="text-align:left;" | Method
! Method !! Explanation
 
  +
! style="text-align:left;" | Explanation
 
|-
 
|-
| list.'''append''' ( object ) || Append ''object'' to the ''list''.
+
| <list>.'''append''' ( <object> ) || Append an object <object> to the list <list>.
 
|-
 
|-
| list.'''count''' ( object ) || Counts how many times ''object'' appears on the list.
+
| <list>.'''count''' ( <object> ) || Count how many times object <object> appears on the list <list>.
 
|-
 
|-
| list.'''extend''' ( secondList ) || Append list ''secondList'' into a list.
+
| <list>.'''extend''' ( <secondList> ) || Append list <secondList> into the list <list>.
 
|-
 
|-
| list.'''index''' ( object ) || Find the first appearance of ''object'' on the list.
+
| <list>.'''index''' ( <object> ) || Find the first appearance of the object <object> on the list.
 
|-
 
|-
| list.'''insert''' ( index, object ) || Insert ''object'' into the list at offset ''index''.
+
| <list>.'''insert''' ( <index>, <object> ) || Insert object <object> into the list <list> at offset <index>.
 
|-
 
|-
| list.'''pop''' ( [index] ) || Remove and return the last object from the list or at the supplied offset.
+
| <list>.'''pop''' ( [<index>] ) || Remove and return the last object from the list <list> or an object at the supplied offset.
 
|-
 
|-
| list.'''remove''' ( object ) || Remove ''object'' from the list.
+
| <list>.'''remove''' ( <object> ) || Remove object <object> from the list <list>.
 
|-
 
|-
| list.'''reverse''' () || Reverses list order.
+
| <list>.'''reverse''' () || Reverses the list <list> order.
 
|-
 
|-
| list.'''sort''' ( [function] ) || Sort the list. Uses the optional compare function ''function'', if given.
+
| <list>.'''sort''' ( [<function>] ) || Sort the list <list>. Uses the optional compare function <function>, if given.
 
|}
 
|}
   
== Tuples ==
+
=== Tuples ===
   
== Sets ==
+
=== Sets ===
   
== Dictionaries ==
+
=== Dictionaries ===
   
 
== Files ==
 
== Files ==
 
== Other data types ==
 
   
 
= Objects =
 
= Objects =
Line 137: Line 145:
 
| & || Bitwise AND || Bitwise AND of the numbers.
 
| & || Bitwise AND || Bitwise AND of the numbers.
 
|-
 
|-
| | || Bitwise OR || Bitwise OR of the numbers.
+
| <nowiki>|</nowiki> || Bitwise OR || Bitwise OR of the numbers.
 
|-
 
|-
 
| ^ || Bitwise XOR || Bitwise XOR of the numbers.
 
| ^ || Bitwise XOR || Bitwise XOR of the numbers.

Latest revision as of 13:06, 5 December 2022

Data types

Numbers

Strings

Arrays

Python has four types of arrays (data collections) with different properties:

  • Lists: duplicate members are allowed, lists are ordered and indexed, and their content can be changed.
  • Tuples: duplicate members are allowed, tuples are ordered and indexed, and their content cannot be changed.
  • Sets: duplicate members are not allowed, sets are unordered and unindexed, and their content cannot be changed.
  • Dictionaries: duplicate members are not allowed, dictionaries are unordered but indexed, and their content can be changed.

Lists

Python has the following functions for the lists

Function Explanation
cmp ( <firstList>, <secondList> ) Compare lists <firstList> and <secondList>.
len ( <list> ) Get the number of elements on the list <list>. See len() for more information.
max ( <list> ) Get the maximum valued element on the list <list>. See max() for more information.
min ( <list> ) Get the minimum valued element on the list <list>. See min() for more information.
list ( <tuple> ) Convert the tuple <tuple> into a list. See list() for more information.

and the following methods for the list objects

Method Explanation
<list>.append ( <object> ) Append an object <object> to the list <list>.
<list>.count ( <object> ) Count how many times object <object> appears on the list <list>.
<list>.extend ( <secondList> ) Append list <secondList> into the list <list>.
<list>.index ( <object> ) Find the first appearance of the object <object> on the list.
<list>.insert ( <index>, <object> ) Insert object <object> into the list <list> at offset <index>.
<list>.pop ( [<index>] ) Remove and return the last object from the list <list> or an object at the supplied offset.
<list>.remove ( <object> ) Remove object <object> from the list <list>.
<list>.reverse () Reverses the list <list> order.
<list>.sort ( [<function>] ) Sort the list <list>. Uses the optional compare function <function>, if given.

Tuples

Sets

Dictionaries

Files

Objects

Operators

Arithmetic operators

Operator Name Explanation
+ Plus Adds the two objects.
- Minus Either gives a negative number or gives the subtraction of one number from the other.
* Multiply Gives the multiplication of the two numbers or returns the string repeated that many times.
** Power Returns x to the power of y.
/ Divide Divide x by y.
// Floor Division Returns the floor of the quotient.
% Modulo Returns the remainder of the division.

Comparison operators

Operator Name Explanation
< Less Than Returns whether x is less than y. All comparison operators return 1 for true and 0 for false. This is equivalent to the special variables True and False respectively. Note the capitalization of these variables' names.
> Greater Than Returns whether x is greater than y.
<= Less Than or Equal To Returns whether x is less than or equal to y.
>= Greater Than or Equal To Returns whether x is greater than or equal to y.
== Equal To Compares if the objects are equal.
!= Not Equal To Compares if the objects are not equal.

Assignment Operators

Operator Name Explanation
= Assignment Assigns values from right side operands to left side operand.
+= Addition and assignment Adds right operand to the left operand and assigns the result to left operand.
-= Subtraction and assignment Subtracts right operand from the left operand and assigns the result to left operand.
*= Multiplication and assignment Multiplies right operand with the left operand and assigns the result to left operand.
/= Division and assignment Divides left operand with the right operand and assigns the result to left operand.
%= Modulo and assignment Takes modulus using two operands and assigns the result to left operand.
**= Power of and assignment Performs exponential (power) calculation on operators and assigns value to the left operand.
//= Floor division and assignment Performs floor division on operators and assigns value to the left operand.

Logical Operators

Operator Name Explanation
not Boolean NOT If x is True, it returns False. If x is False, it returns True.
and Boolean AND x and y returns False if x is False, else it returns evaluation of y.
or Boolean OR If x is True, it returns True, else it returns evaluation of y.

Bitwise Operations on Integer Types

Operator Name Explanation
<< Left Shift Shifts the bits of the number to the left by the number of bits specified.
>> Right Shift Shifts the bits of the number to the right by the number of bits specified.
& Bitwise AND Bitwise AND of the numbers.
| Bitwise OR Bitwise OR of the numbers.
^ Bitwise XOR Bitwise XOR of the numbers.
~ Bitwise Invert The bitwise inversion of x.

Membership Operators

Identity Operators

Comments

Indentation