Python/Справочник по библиотеке Python 3.1

Документация Python Эта статья — часть Документации по языку Python

Автор языка	Гвидо ван Россум (Guido van Rossum)
Владелец	Python Software Foundation
E-mail	docs@python.org
Исходный текст	http://docs.python.org/3.1/library/index.html
Релиз	3.1
Версия от	4 февраля 2010

Введение

“Библиотека Python” содержит несколько различных видов компонентов.

В ней содержатся данные типов которые обычно считаются частью "ядра" в языке, такие как числа или списки. Для этих типов ядро Python'a разделено на основные формы и места некоторых ограничений на их семантику, но семантику определяет не полностью. (С другой стороны, ядро языка определяет синтаксические правила, такие как написание и приоритеты операторов) Библиотека также содержит встроенные функции и исключения — объекты могут быть использованы в любом месте кода Python'а без необходимости вызова import Некоторые из них определены в ядре языка, но большинство не имеют большого значения для семантики ядра и только описаны здесь.

Однако большая часть библиотеки состоит из других модулей. Есть много способов разбирать эту коллекцию. Некоторые модули написаны на С и встроены в интерпретатор Python'a; другие написаны на Питоне и импортированы в форме исходников. Некоторые модули обеспечивают интерфейс к высокоуровневым возможностям Питона, таким как печать трассировки стека; доступ к специфичным функциям операционной системы, таким как доступ к определенному оборудованию; другие специфичны для определенных областей применения, таких как интернет. Некоторые модули доступны во всех версиях Питона; другие доступны только когда основные системы поддерживают или нуждаются в них; другие же доступны только исходя из вариантов конфигурации, при которых Питон был скомпилирован и установлен. Это руководство организовано "от малого к большому": сначала идет описание встроенных типов данных, затем встроенных функций и исключений, и, наконец, модулей, сгруппированных в главы, объединяющие схожие модули. Порядок следование глав, а также порядок расположения модулей в каждой главе таков, что идет от наиболее до наименее важных.

Это значит, что если вы начинаете читать это руководство сначала и перейдете на другую главу, когда вам скучно, вы получите разумный обзор доступных модулей и областей применения поддерживаемых библиотекой Питона. Конечно, вам не следует это читать как роман - вы также можете просматривать оглавление (в верхней части руководства), или искать конкретные функции, модули. И последнее, если вы любите изучать о случайных предметах, выберете случайную страницу (смотри модуль random) и читайте секцию или две. Независимо от того в каком порядке вы будете читать это руководство, необходимо начать с главы о встроенных типах: остальная часть руководства предполагает ознакомление с этим материалом.

Поехали!

Встроенные функции

Интерпретатор питона имеет некоторое число встроенных функций, которые доступны всегда. Они перечислены ниже в алфавитном порядке:

abs(x)

Возвращает модуль числа. Аргумент может быть целым числом или числом с плавающей точкой. Если аргумент комплексное число, то возвращается его модуль.

all(последовательность)

Возвращает True если все значения итерабельной последовательности истинны (True) или последовательность пуста. Эквивалентно:

def all(iterable):
    for element in iterable:
        if not element:
            return False
    return True

any(последовательность)

Возвращает True если хоть один из элементов итерабельной последовательности имеет значение истина (True). Если последовательность пуста возвращает False. Эквивалентно:

def any(iterable):
        for element in iterable:
            if element:
                return True
        return False

ascii(объект)

Как и repr(), возвращает строку, содержащую представление объекта в текстовом виде, но избегая не-ASCII символов в строке, возвращаемой repr() с использованием символов \x, \u или \U. Эта функция генерируют строку, подобную строке возвращаемой функцией repr() в Питон 2.

bin(x)

Конвертирование целого числа в бинарную строку. Результат является коррекктным выражением Питона. Если х не является объектом Питона int, то вместо x будет взят результат вызова метода __index__(), который вернет целое число.

bool([x])

Конвертирует значение в булево, используя стандартную процедуру тестирования истинности. Если значение х ложно или отсутствует, то возвращает False(ложь); в другом случае True(истина) bool также является классом, который является подклассом int. У класса bool не может быть подкласса. Он может принимать значение только False(ложь) или True(истина)

bytearray([source[, encoding[, errors]]])