depset

Laporkan masalah Lihat sumber Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Struktur data khusus yang mendukung operasi penggabungan yang efisien dan memiliki urutan traversal yang ditentukan. Umumnya digunakan untuk mengumpulkan data dari dependensi transitif dalam aturan dan aspek. Untuk informasi selengkapnya, lihat di sini.

Elemen depset harus dapat di-hash dan semuanya memiliki jenis yang sama (seperti yang ditentukan oleh fungsi type(x) bawaan), tetapi depset bukan sekadar set hash dan tidak mendukung pengujian keanggotaan cepat. Jika memerlukan jenis data set umum, Anda dapat menyimulasikannya menggunakan kamus tempat semua kunci dipetakan ke True.

Depset tidak dapat diubah. Depset harus dibuat menggunakan fungsi konstruktor dan digabungkan atau ditambah dengan depset lain melalui argumen transitive.

Parameter order menentukan jenis traversal yang dilakukan untuk mengonversi depset menjadi iterabel. Ada empat kemungkinan nilai:

  • "default" (sebelumnya "stable"): Urutan tidak ditentukan (tetapi deterministik).
  • "postorder" (sebelumnya "compile"): Urutan pasca-pengurutan dari kiri ke kanan. Secara tepat, ini secara berulang menjelajahi semua turunan dari kiri ke kanan, lalu elemen langsung dari kiri ke kanan.
  • "preorder" (sebelumnya "naive_link"): Praorder dari kiri ke kanan. Secara khusus, ini akan menjelajahi elemen langsung dari kiri ke kanan, lalu secara rekursif menjelajahi turunan dari kiri ke kanan.
  • "topological" (sebelumnya "link"): Pengurutan topologi dari root hingga ke daun. Tidak ada jaminan kiri ke kanan.

Dua depset hanya dapat digabungkan jika kedua depset memiliki urutan yang sama, atau salah satunya memiliki urutan "default". Dalam kasus terakhir, urutan depset yang dihasilkan akan sama dengan urutan yang lain.

Depset dapat berisi nilai duplikat, tetapi nilai tersebut akan disembunyikan saat melakukan iterasi (menggunakan to_list()). Duplikat dapat mengganggu semantik pengurutan.

Anggota

to_list

list depset.to_list()

Menampilkan daftar elemen, tanpa duplikat, dalam urutan traversal depset. Perhatikan bahwa urutan tidak ditentukan (tetapi determenistik) untuk elemen yang ditambahkan lebih dari sekali ke depset. Urutan juga tidak ditentukan untuk depset yang diurutkan "default", dan untuk elemen depset turunan yang urutannya berbeda dengan depset induk. Daftar ini adalah salinan; mengubahnya tidak akan berdampak pada depset, begitu pula sebaliknya.