AmigaOS Manual: Python Functions - Revision history

Janne Peräaho: Added example

2018-07-21T00:13:45Z

Added example

← Older revision		Revision as of 00:13, 21 July 2018
Line 297:		Line 297:

	Take two (non complex) numbers as arguments and return a pair of numbers consisting of their quotient and remainder when using integer division. With mixed operand types, the rules for binary arithmetic operators apply. For integers, the result is the same as (a // b, a % b). For floating point numbers the result is (q, a % b), where q is usually math.floor(a / b) but may be 1 less than that. In any case q * b + a % b is very close to a, if a % b is non-zero it has the same sign as b, and 0 <= abs(a % b) < abs(b).		Take two (non complex) numbers as arguments and return a pair of numbers consisting of their quotient and remainder when using integer division. With mixed operand types, the rules for binary arithmetic operators apply. For integers, the result is the same as (a // b, a % b). For floating point numbers the result is (q, a % b), where q is usually math.floor(a / b) but may be 1 less than that. In any case q * b + a % b is very close to a, if a % b is non-zero it has the same sign as b, and 0 <= abs(a % b) < abs(b).

			Example:
			<syntaxhighlight lang="python">
			divmod( 6, 2 ) -> (3, 0)
			</syntaxhighlight>

	== enumerate() ==		== enumerate() ==

Janne Peräaho at 23:53, 20 July 2018

2018-07-20T23:53:37Z

@@ Line 94: / Line 94: @@
 Convert an integer number to a binary string prefixed with “0b”. The result is a valid Python expression. If num is not a Python int object, it has to define an __index__() method that returns an integer. Some examples:
 If prefix “0b” is desired or not, you can use either of the following ways.
- ('0b1110', '1110')
+format(14, '#b'), format(14, 'b') -> ('0b1110', '1110')
 See also [[AmigaOS_Manual:_Python_Functions#format.28.29|format()]] for more information.

Janne Peräaho: Renamed argument

2018-07-20T23:42:47Z

Renamed argument

← Older revision		Revision as of 23:42, 20 July 2018
Line 739:		Line 739:
	== ord() ==		== ord() ==

	<nowiki>ord(c)</nowiki>		<nowiki>ord(char)</nowiki>

	Given a string representing one Unicode character, return an integer representing the Unicode code point of that character. For example, ord('a') returns the integer 97 and ord('€') (Euro sign) returns 8364. This is the inverse of chr().		Given a string representing one Unicode character, return an integer representing the Unicode code point of that character. For example, ord('a') returns the integer 97 and ord('€') (Euro sign) returns 8364. This is the inverse of chr().

Janne Peräaho: Renamed the argument

2018-07-20T23:39:57Z

Renamed the argument

← Older revision		Revision as of 23:39, 20 July 2018
Line 455:		Line 455:
	== hex() ==		== hex() ==

	<nowiki>hex(x)</nowiki>		<nowiki>hex(num)</nowiki>

	Convert an integer number to a lowercase hexadecimal string prefixed with “0x”. If x is not a Python int object, it has to define an __index__() method that returns an integer. Some examples:		Convert an integer number to a lowercase hexadecimal string prefixed with “0x”. If '''num''' is not a Python int object, it has to define an __index__() method that returns an integer. Some examples:

	>>> hex(255)		>>> hex(255)

Janne Peräaho: Renamed the argument

2018-07-20T23:36:11Z

Renamed the argument

← Older revision		Revision as of 23:36, 20 July 2018
Line 111:		Line 111:
	== bool() ==		== bool() ==

	<nowiki>class bool([x])</nowiki>		<nowiki>class bool([value])</nowiki>

	Return a Boolean value, i.e. one of True or False. x is converted using the standard truth testing procedure. If x is false or omitted, this returns False; otherwise it returns True. The bool class is a subclass of int (see Numeric Types — int, float, complex). It cannot be subclassed further. Its only instances are False and True (see Boolean Values).		Return a Boolean value, i.e. one of True or False. '''value''' is converted using the standard truth testing procedure. If '''value''' is false or omitted, this returns False; otherwise it returns True. The bool class is a subclass of int (see Numeric Types — int, float, complex). It cannot be subclassed further. Its only instances are False and True (see Boolean Values).

	== breakpoint() ==		== breakpoint() ==

Janne Peräaho: Changed argument name

2018-07-20T23:34:20Z

Changed argument name

← Older revision		Revision as of 23:34, 20 July 2018
Line 91:		Line 91:
	== bin() ==		== bin() ==

	<nowiki>bin(x)</nowiki>		<nowiki>bin(num)</nowiki>

	Convert an integer number to a binary string prefixed with “0b”. The result is a valid Python expression. If x is not a Python int object, it has to define an __index__() method that returns an integer. Some examples:		Convert an integer number to a binary string prefixed with “0b”. The result is a valid Python expression. If num is not a Python int object, it has to define an __index__() method that returns an integer. Some examples:
	>>> bin(3)		>>> bin(3)
	'0b11'		'0b11'

Janne Peräaho: Changed argument name and added an example

2018-07-20T23:31:30Z

Changed argument name and added an example

← Older revision		Revision as of 23:31, 20 July 2018
Line 44:		Line 44:
	== abs() ==		== abs() ==

	<nowiki>abs(x)</nowiki>		<nowiki>abs(num)</nowiki>

	Return the absolute value of a number. The argument may be an integer or a floating point number. If the argument is a complex number, its magnitude is returned.		Return the absolute value of a number. The argument num may be an integer or a floating point number. If the argument is a complex number, its magnitude is returned. For example:

			<syntaxhighlight lang="python">
			abs( 3.5 + -1.234 ) -> 2.266
			</syntaxhighlight>

	== all() ==		== all() ==

Janne Peräaho: /* zip */

2018-07-15T14:59:32Z

zip

← Older revision		Revision as of 14:59, 15 July 2018
Line 1,013:		Line 1,013:
	Without an argument, vars() acts like locals(). Note, the locals dictionary is only useful for reads since updates to the locals dictionary are ignored.		Without an argument, vars() acts like locals(). Note, the locals dictionary is only useful for reads since updates to the locals dictionary are ignored.

	== zip ==		== zip() ==

			<nowiki>zip(*iterables)</nowiki>

			Make an iterator that aggregates elements from each of the iterables.

			Returns an iterator of tuples, where the i-th tuple contains the i-th element from each of the argument sequences or iterables. The iterator stops when the shortest input iterable is exhausted. With a single iterable argument, it returns an iterator of 1-tuples. With no arguments, it returns an empty iterator. Equivalent to:

			<syntaxhighlight lang="python">
			def zip(*iterables):
			# zip('ABCD', 'xy') --> Ax By
			sentinel = object()
			iterators = [iter(it) for it in iterables]
			while iterators:
			result = []
			for it in iterators:
			elem = next(it, sentinel)
			if elem is sentinel:
			return
			result.append(elem)
			yield tuple(result)
			</syntaxhighlight>

			The left-to-right evaluation order of the iterables is guaranteed. This makes possible an idiom for clustering a data series into n-length groups using zip([iter(s)]n). This repeats the same iterator n times so that each output tuple has the result of n calls to the iterator. This has the effect of dividing the input into n-length chunks.

			zip() should only be used with unequal length inputs when you don’t care about trailing, unmatched values from the longer iterables. If those values are important, use itertools.zip_longest() instead.

			zip() in conjunction with the * operator can be used to unzip a list:

			>>> x = [1, 2, 3]
			>>> y = [4, 5, 6]
			>>> zipped = zip(x, y)
			>>> list(zipped)
			[(1, 4), (2, 5), (3, 6)]
			>>> x2, y2 = zip(*zip(x, y))
			>>> x == list(x2) and y == list(y2)
			True

Janne Peräaho: /* import */

2018-07-15T14:59:12Z

__import__

@@ Line 1: / Line 1: @@
 = Built-in Functions Reference =
-== __import__ ==
+== __import__() ==
 == abs() ==

Janne Peräaho: /* vars */

2018-07-15T14:52:57Z

vars

← Older revision		Revision as of 14:52, 15 July 2018
Line 963:		Line 963:
	Changed in version 3.6: Subclasses of type which don’t override type.__new__ may no longer use the one-argument form to get the type of an object.		Changed in version 3.6: Subclasses of type which don’t override type.__new__ may no longer use the one-argument form to get the type of an object.

	== vars ==		== vars() ==

			<nowiki>vars([object])</nowiki>

			Return the __dict__ attribute for a module, class, instance, or any other object with a __dict__ attribute.

			Objects such as modules and instances have an updateable __dict__ attribute; however, other objects may have write restrictions on their __dict__ attributes (for example, classes use a types.MappingProxyType to prevent direct dictionary updates).

			Without an argument, vars() acts like locals(). Note, the locals dictionary is only useful for reads since updates to the locals dictionary are ignored.

	== zip ==		== zip ==

AmigaOS Manual: Python Functions - Revision history

Janne Peräaho: Added example

Janne Peräaho at 23:53, 20 July 2018

Janne Peräaho: Renamed argument

Janne Peräaho: Renamed the argument

Janne Peräaho: Renamed the argument

Janne Peräaho: Changed argument name

Janne Peräaho: Changed argument name and added an example

Janne Peräaho: /* zip */

Janne Peräaho: /* __import__ */

Janne Peräaho: /* vars */

Janne Peräaho: /* import */