📝 docs: add comments explain

walterowisk · Aug 17, 2023 · 2b7254f · 2b7254f
1 parent 11cf3e9
commit 2b7254f
Show file tree

Hide file tree

Showing 15 changed files with 27 additions and 5 deletions.
diff --git a/01 - Estrutura de dados/03 - Conjuntos/03_union.py b/01 - Estrutura de dados/03 - Conjuntos/03_union.py
@@ -1,5 +1,6 @@
+# União dos elementos dos dois conjuntos
 conjunto_a = {1, 2}
 conjunto_b = {3, 4}
 
 resultado = conjunto_a.union(conjunto_b)
-print(resultado)
+print(resultado) # {2, 3}
diff --git a/01 - Estrutura de dados/03 - Conjuntos/04_intersection.py b/01 - Estrutura de dados/03 - Conjuntos/04_intersection.py
@@ -1,5 +1,6 @@
+# Elementos em comum nos conjuntos referenciados
 conjunto_a = {1, 2, 3}
 conjunto_b = {2, 3, 4}
 
 resultado = conjunto_a.intersection(conjunto_b)
-print(resultado)
+print(resultado) # {2 ,3}
diff --git a/01 - Estrutura de dados/03 - Conjuntos/05_difference.py b/01 - Estrutura de dados/03 - Conjuntos/05_difference.py
@@ -1,8 +1,9 @@
+# Tudo que está em um conjunto e não está no outro
 conjunto_a = {1, 2, 3}
 conjunto_b = {2, 3, 4}
 
 resultado = conjunto_a.difference(conjunto_b)
-print(resultado)
+print(resultado) # {1}
 
 resultado = conjunto_b.difference(conjunto_a)
-print(resultado)
+print(resultado) # {4}
diff --git a/01 - Estrutura de dados/03 - Conjuntos/06_symmetric_difference.py b/01 - Estrutura de dados/03 - Conjuntos/06_symmetric_difference.py
@@ -1,5 +1,6 @@
+# Todos os elementos que não estão na intersecção
 conjunto_a = {1, 2, 3}
 conjunto_b = {2, 3, 4}
 
 resultado = conjunto_a.symmetric_difference(conjunto_b)
-print(resultado)
+print(resultado) # {1 ,4}
diff --git a/01 - Estrutura de dados/03 - Conjuntos/07_issubset.py b/01 - Estrutura de dados/03 - Conjuntos/07_issubset.py
@@ -1,3 +1,4 @@
+# Se A é subconjunto de B significa que todos os elementos de A estão em B (True)
 conjunto_a = {1, 2, 3}
 conjunto_b = {4, 1, 2, 5, 6, 3}
 

diff --git a/01 - Estrutura de dados/03 - Conjuntos/08_issuperset.py b/01 - Estrutura de dados/03 - Conjuntos/08_issuperset.py
@@ -1,3 +1,8 @@
+# Verifica se um conjunto contém todos os elementos de outro conjunto, 
+# podendo ter mais elementos além desses.
+# Um conjunto A é um superset de um conjunto B se todos os elementos de B também estiverem em A, 
+# e possivelmente mais elementos adicionais estiverem em A.
+
 conjunto_a = {1, 2, 3}
 conjunto_b = {4, 1, 2, 5, 6, 3}
 

diff --git a/01 - Estrutura de dados/03 - Conjuntos/09_isdisjoint.py b/01 - Estrutura de dados/03 - Conjuntos/09_isdisjoint.py
@@ -1,3 +1,4 @@
+# Verifica se os conjuntos referenciados possuem elementos em comum.
 conjunto_a = {1, 2, 3, 4, 5}
 conjunto_b = {6, 7, 8, 9}
 conjunto_c = {1, 0}

diff --git a/01 - Estrutura de dados/03 - Conjuntos/10_add.py b/01 - Estrutura de dados/03 - Conjuntos/10_add.py
@@ -1,3 +1,4 @@
+# Adiciona elementos ao conjunto mas só se ele não existir previamente.
 sorteio = {1, 23}
 
 sorteio.add(25)  # {1, 23, 25}

diff --git a/01 - Estrutura de dados/03 - Conjuntos/11_clear.py b/01 - Estrutura de dados/03 - Conjuntos/11_clear.py
@@ -1,3 +1,5 @@
+# Limpa o set
+
 sorteio = {1, 23}
 
 print(sorteio)  # {1,23}

diff --git a/01 - Estrutura de dados/03 - Conjuntos/12_copy.py b/01 - Estrutura de dados/03 - Conjuntos/12_copy.py
@@ -1,3 +1,4 @@
+# Gera uma cópia do conjunto
 sorteio = {1, 23}
 
 print(sorteio)  # {1, 23}

diff --git a/01 - Estrutura de dados/03 - Conjuntos/13_discard.py b/01 - Estrutura de dados/03 - Conjuntos/13_discard.py
@@ -1,3 +1,4 @@
+# Descarta do conjunto o valor referenciado.
 numeros = {1, 2, 3, 1, 2, 4, 5, 5, 6, 7, 8, 9, 0}
 
 print(numeros)  # {1, 2, 3, 4, 5, 6, 7, 8, 9, 0}

diff --git a/01 - Estrutura de dados/03 - Conjuntos/14_pop.py b/01 - Estrutura de dados/03 - Conjuntos/14_pop.py
@@ -1,3 +1,4 @@
+# Remove valores do conjunto
 numeros = {1, 2, 3, 1, 2, 4, 5, 5, 6, 7, 8, 9, 0}
 
 print(numeros)  # {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}

diff --git a/01 - Estrutura de dados/03 - Conjuntos/15_remove.py b/01 - Estrutura de dados/03 - Conjuntos/15_remove.py
@@ -1,3 +1,6 @@
+# Remove o item referenciado assim como no discard.abs
+# A diferença é que o discard não retorna erro caso o elemento
+# referenciado não exista no conjunto, enquanto que o método Remove retorna erro nesse caso.
 numeros = {1, 2, 3, 1, 2, 4, 5, 5, 6, 7, 8, 9, 0}
 
 print(numeros)  # {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}

diff --git a/01 - Estrutura de dados/03 - Conjuntos/16_len.py b/01 - Estrutura de dados/03 - Conjuntos/16_len.py
@@ -1,3 +1,4 @@
+# Mostra o tamanho do conjunto (quantidade de itens).
 numeros = {1, 2, 3, 1, 2, 4, 5, 5, 6, 7, 8, 9, 0}
 
 print(len(numeros))  # 10
diff --git a/01 - Estrutura de dados/03 - Conjuntos/17_in.py b/01 - Estrutura de dados/03 - Conjuntos/17_in.py
@@ -1,3 +1,4 @@
+# Verifica se um objeto está dentro do conjunto.
 numeros = {1, 2, 3, 1, 2, 4, 5, 5, 6, 7, 8, 9, 0}
 
 print(1 in numeros)  # True