StringStore

Look up strings by 64-bit hashes. As of v2.0, spaCy uses hash values instead of integer IDs. This ensures that strings always map to the same ID, even from different StringStores.

<Infobox variant ="warning">

Note that a StringStore instance is not static. It increases in size as texts with new tokens are processed.

</Infobox>

StringStore.__init__ {id="init",tag="method"}

Create the StringStore.

Example

pythonCopy

from spacy.strings import StringStore
stringstore = StringStore(["apple", "orange"])

Name	Description
strings	A sequence of strings to add to the store. Optional[Iterable[str]]

StringStore.__len__ {id="len",tag="method"}

Get the number of strings in the store.

Example

pythonCopy

stringstore = StringStore(["apple", "orange"])
assert len(stringstore) == 2

Name	Description
RETURNS	The number of strings in the store. int

StringStore.__getitem__ {id="getitem",tag="method"}

Retrieve a string from a given hash, or vice versa.

Example

pythonCopy

stringstore = StringStore(["apple", "orange"])
apple_hash = stringstore["apple"]
assert apple_hash == 8566208034543834098
assert stringstore[apple_hash] == "apple"

Name	Description
string_or_id	The value to encode. Union[bytes, str, int]
RETURNS	The value to be retrieved. Union[str, int]

StringStore.__contains__ {id="contains",tag="method"}

Check whether a string is in the store.

Example

pythonCopy

stringstore = StringStore(["apple", "orange"])
assert "apple" in stringstore
assert not "cherry" in stringstore

Name	Description
string	The string to check. str
RETURNS	Whether the store contains the string. bool

StringStore.__iter__ {id="iter",tag="method"}

Iterate over the strings in the store, in order. Note that a newly initialized store will always include an empty string "" at position 0.

Example

pythonCopy

stringstore = StringStore(["apple", "orange"])
all_strings = [s for s in stringstore]
assert all_strings == ["apple", "orange"]

Name	Description
YIELDS	A string in the store. str

StringStore.add {id="add",tag="method",version="2"}

Add a string to the StringStore.

Example

pythonCopy

stringstore = StringStore(["apple", "orange"])
banana_hash = stringstore.add("banana")
assert len(stringstore) == 3
assert banana_hash == 2525716904149915114
assert stringstore[banana_hash] == "banana"
assert stringstore["banana"] == banana_hash

Name	Description
string	The string to add. str
RETURNS	The string's hash value. int

StringStore.to_disk {id="to_disk",tag="method",version="2"}

Save the current state to a directory.

Example

pythonCopy

stringstore.to_disk("/path/to/strings")

Name	Description
path	A path to a directory, which will be created if it doesn't exist. Paths may be either strings or Path-like objects. Union[str, Path]

StringStore.from_disk {id="from_disk",tag="method",version="2"}

Loads state from a directory. Modifies the object in place and returns it.

Example

pythonCopy

from spacy.strings import StringStore
stringstore = StringStore().from_disk("/path/to/strings")

Name	Description
path	A path to a directory. Paths may be either strings or Path-like objects. Union[str, Path]
RETURNS	The modified StringStore object. StringStore

StringStore.to_bytes {id="to_bytes",tag="method"}

Serialize the current state to a binary string.

Example

pythonCopy

store_bytes = stringstore.to_bytes()

Name	Description
RETURNS	The serialized form of the StringStore object. bytes

StringStore.from_bytes {id="from_bytes",tag="method"}

Load state from a binary string.

Example

pythonCopy

from spacy.strings import StringStore
store_bytes = stringstore.to_bytes()
new_store = StringStore().from_bytes(store_bytes)

Name	Description
bytes_data	The data to load from. bytes
RETURNS	The StringStore object. StringStore

Utilities {id="util"}

strings.hash_string {id="hash_string",tag="function"}

Get a 64-bit hash for a given string.

Example

pythonCopy

from spacy.strings import hash_string
assert hash_string("apple") == 8566208034543834098

Name	Description
string	The string to hash. str
RETURNS	The hash. int