Summary  
This chapter explains how to use Python’s list.insert(index, element) method to add an item at a specific position in a list, causing all subsequent elements to shift right.

General domain of usage  
Travel planning

Entä jos haluamme lisätä alkion ei listan loppuun, vaan tiettyyn kohtaan? Tätä varten käytetään `insert()`-metodia.

`insert()`-metodin syntaksi on:
``` python
list.insert(index, element)
```
- `index`: kohta listassa, johon uusi alkio halutaan lisätä. Huomaa, että Python käyttää **nollapohjaista** indeksointia;
- `element`: alkio, jonka haluat lisätä listaan.

Kuvittele suunnittelevasi matkaa ja sinulla on lista kaupungeista, joissa haluat vierailla.

travel_wishlist = ["Paris", "Oslo", "Kyoto", "Sydney"]

print(travel_wishlist)  # Output: ['Paris', 'Oslo', 'Kyoto', 'Sydney']

Suunnitelmat kuitenkin muuttuvat, ja päätät muuttaa kohteiden järjestystä.
Nyt haluat asettaa "Chicago" ensimmäiseksi kohteeksi.

travel_wishlist = ["Paris", "Oslo", "Kyoto", "Sydney"]

# Adding "Chicago" as the first destination
travel_wishlist.insert(0, "Chicago")
print(travel_wishlist)  # Output: ['Chicago', 'Paris', 'Oslo', 'Kyoto', 'Sydney']

Tämän jälkeen "Chicago" saa indeksin `0`. Se on nyt ylimpänä, ja muut kohteet ovat siirtyneet alaspäin. Nyt listassa on 5 kohdetta:





`insert()`-funktiolla voi lisätä **vain yhden** kohteen kerrallaan.

Huomio

import unittest
from contextlib import redirect_stdout
import io
import importlib

def _dynamic_test(test_case, condition, success_message, failure_message):
    if condition:
        test_case._testMethodName = success_message
        test_case.assertTrue(True, success_message)
    else:
        test_case._testMethodName = failure_message
        test_case.fail(failure_message)

class TestUserCode(unittest.TestCase):

    def test_travel_wishlist_is_declared(self):
        import user_code
        _dynamic_test(
            self,
            hasattr(user_code, 'travel_wishlist'),
            "The `travel_wishlist` list is declared.",
            "Expected `travel_wishlist` to be declared."
        )

    def test_cities_prioritized_correctly(self):
        import user_code
        expected_list = ["London", "Paris", "Budapest", "Oslo", "Kyoto", "Sydney"]
        _dynamic_test(
            self,
            user_code.travel_wishlist == expected_list,
            f"The cities were prioritized correctly: {user_code.travel_wishlist}.",
            f"Expected travel_wishlist to be {expected_list}, but got {user_code.travel_wishlist}."
        )

    def test_insert_method_used(self):
        with open('user_code.py', 'r') as file:
            user_code_source = file.read()
        
        _dynamic_test(
            self,
            ".insert(" in user_code_source,
            "The `insert` method is used to prioritize cities.",
            "Expected the `insert` method to be used to prioritize cities."
        )

if __name__ == '__main__':
    unittest.main()


test_main.py

Tutustu Python-ohjelmointikielen keskeisiin tietorakenteisiin, kuten listoihin, sanakirjoihin, tuplisiin ja joukkoihin, sekä niiden tehokkaaseen hyödyntämiseen todellisten ohjelmointiongelmien ratkaisemisessa.

Mikä on lista? Lista on järjestetty kokoelma, jota voidaan muokata. Se sallii myös päällekkäiset alkiot.

Mikä on sanakirja? Sanakirja on järjestetty kokoelma, jota voidaan muokata, mutta se ei salli päällekkäisiä merkintöjä. Se koostuu avain:arvo-pareista, joita käytetään rakenteen optimointiin.

Mikä on tuple? Tuple on järjestetty kokoelma, jota ei voi muuttaa. Se voi sisältää päällekkäisiä alkioita. Vaikka se muistuttaa listaa, tuplen arvot voivat olla mitä tahansa tyyppiä ja ne indeksoidaan kokonaisluvuilla. Vaikka se ei ole pakollista, on tavallista sulkea tuplen arvot sulkuihin, mikä tekee niistä helpommin ymmärrettäviä Pythonissa.

Mikä on joukko? Pythonissa joukko on järjestämätön kokoelma, joka on iteroitava ja muokattavissa, eikä siinä ole toistuvia alkioita. Vaikka joukon alkioiden järjestys ei ole kiinteä, se voi sisältää erilaisia alkioita. Merkittävä etu joukkojen käyttämisessä listoihin verrattuna on niiden erittäin tehokas tapa selvittää, kuuluuko alkio joukkoon.

Insert()-menetelmän Käyttäminen

Ratkaisu