📦 Репозиторий занятия 24

## Определение

**Тюпл (tuple)** — это неизменяемая (immutable) упорядоченная коллекция объектов.

(Грубо, но почти точно: **"тюпл - это неизменяемый список"**)

## `tuple()` - функция создания тюпла из коллекции

По аналогии с функцией `list()`:

```python
print(tuple('abc'))    # ('a', 'b', 'c')

print(tuple(5))
# TypeError: 'int' object is not iterable
```

## Синтаксис

* Последовательность, разделённая запятыми
* Может дополнительно браться в круглые скобки `()`
* Если элемент всего один - запятая обязательна 
* Если тюпл пустой - скобки обязательны

* Записывается через круглые скобки `()`
* Может содержать элементы разных типов и повторяющиеся элементы
* Поддерживает индексацию и слайсинг (срезы)

Пример:

```python
# пустой тюпл
t0 = ()
print(t0)  # ()

t1 = tuple()
print(t1)  # ()

# один элемент (запятая обязательна!)
t2 = (5,)
print(t2)  # (5,)

# без скобок
t3 = 1, 2, 3
print(t3)  # (1, 2, 3)

# со скобками
t4 = ("a", "b", "c")
print(t4)  # ('a', 'b', 'c')

# элементы разных типов
t5 = 1, "hello", 3.14, True, (1,)
print(t5)  # (1, 'hello', 3.14, True, (1,))
```

---

## Основные свойства тюпла

1. **Упорядоченность** — элементы имеют фиксированный порядок.
…

## Определение

**Packing** — упаковывание нескольких объектов в одну коллекцию (tuple, list, dict)  
с помощью символа `*` (или  `**`).

**Unpacking** — распаковка коллекции на отдельные объекты с помощью символа `*` (или `**`).

Чаще всего используется для запаковки параметров или распаковки аргументов функции.

### Пример packing

`*args` запаковывает любое кол-во аргументов в один тюпл

```python
def total_amount(*args):
    # print(args)       # (2, 3, 4)
    # print(type(args)) # (2, 3, 4)
    print(sum(args))    # amount: 9


total_amount(2, 3, 4) # 9
```

### Пример unpacking

Звёздочка перед коллекцией распаковывает один объект (коллекцию) на элементы

```python
lst = [1, 2, 3]

print(lst, sep='---')
# [1, 2, 3]

print(*lst, sep='---')
# 1---2---3
```

## ВАЖНО!

`*` - символ пакинга / анпакинга, разрешён ТОЛЬКО:
    - внутри последовательности
    - внутри функции

```python
lst = [1, 2, 3]
x = *lst  

#      x = *lst
#          ^^^
# SyntaxError: can't use starred expression here
```

## Другие примеры

```python
t1 = [1, 2]
t2 = [3, 4, 5]

r1 = (t1, t2)
print(r1)   # ([1, 2], [3, 4, 5])
…

## Распаковка последовательности* (`iterable unpacking`)

    * Точнее будет "Распаковка итерируемого объекта". Поскольку не все итерируемые объекты являются последовательностями.

Это присваивание элементов последовательности (списка, тюпла, строки)  
нескольким переменным одновременно.

Количество переменных должно СТРОГО совпадать с количеством элементов последовательности, иначе будет ошибка.

(Часто называется также ["Множественное присваивание" (`multiple assignment`)](../less_03__arithmetic_operations__type_conversion/theory_04__additional_types_of_assignments.md)

```python
a, b, c = 'ABC'
print('a:', a)  # A
print('b:', b)  # B
print('c:', c)  # C


a, b = 'ABC'
# ValueError: too many values to unpack (expected 2)


a, b, c, d = 'ABC'
# ValueError: not enough values to unpack (expected 4, got 3)
```

## Можно ли избежать ошибки в последних двух случаях?

ОТВЕТ: Да, если использовать packing.

```python

a, b, *rest = 'ABC'
print('a:', a)          # A
print('b:', b)          # B
print('rest:', rest)    # [C]


a, b, c, *rest = 'ABC'
print('a:', a)          # A
print('b:', b)          # B
print('c:', c)          # C
print('rest:', rest)    # []
```

## Удобное сочетание индекса и значения в одной итерации


```python
fruits = ['apple', 'lemon', 'orange']

for i, fruit in enumerate(fruits):
    print(i, fruit)


# 0 apple
# 1 lemon
# 2 orange
```

## Установка начального значения индекса

```python
fruits = ['apple', 'lemon', 'orange']

for i, fruit in enumerate(fruits, start=1):
    print(i, fruit)


# 1 apple
# 2 lemon
# 3 orange
```

### Пояснения к [./theory_01__tuple.md](theory_01__tuple.md)

```python
n1, n2, lst = 1, 2, [1, 2]

t = (n1, n2, lst)

print(t)         # (1, 2, [1, 2])
print(type(t))   # <class 'tuple'>

print(id(n1), id(n2), id(lst))       # 12216648 12216680 140492792400640
print(id(t[0]), id(t[1]), id(t[2]))  # 12216648 12216680 140492792400640

lst = [1, 2, 3]
print(lst)      # [1, 2, 3]
print(id(lst))  # 140492792400640

print(t)  # (1, 2, [1, 2, 3])
```