Meaning
Adds a single element to a set, ensuring uniqueness; if the element already exists, the set remains unchanged.
Primary Function
Data structure manipulation
Communicative Purpose
Insert an element into a set while maintaining uniqueness.
Pattern
set_var.add(element)
Core Structure
... .add(...)
Função primária
Data structure manipulation
Propósito comunicativo
Insert an element into a set while maintaining uniqueness.
Situações de gatilho
Data processing: building a collection of unique items; Log analysis: deduplicating input lines; Iteration: tracking seen values during loop
Contextos
Any Python code using sets, such as processing logs, graph algorithms, or caching unique keys.
Padrão
set_var.add(element)
Estrutura central
... .add(...)
Slots de substituição
set_var: identifier of a set, element: hashable object to add
Colocados típicos
- set initialization
- set comprehension
- membership testing with 'in'
- iterating over sets
Substituições comuns
- Using list.append for lists
- set.update to add multiple elements
- or set |= {elem} for union
Erros comuns
Calling .add on a list (which uses .append), attempting to add unhashable types like lists or dicts to a set, expecting a return value from .add
Similar / contraste
list.append (adds to end of list, allows duplicates), set.update (adds multiple elements from an iterable)
Interferências
Coming from Java: Set.add behaves similarly, but Python sets require hashable items and are unordered.
Família do chunk
- set initialization
- set comprehension
- set removal (.discard
- .remove)
- set union/intersection
Nuance
Operation is O(1) average; if element already present, set unchanged; returns None.
Efeito pragmático
Guarantees a collection of unique elements without manual duplicate checks.
Dica de memória
Think of dropping a fruit into a basket that only keeps one of each kind.
Nota
.add returns None, so it cannot be chained; operation is O(1) average case; if element already present, set remains unchanged.
Upgrade path
Using set.update(|=) to add multiple elements at once, or using frozenset for immutable sets.
Log in to save chunks.