FileStorage

Blocks per piece for the v2 merkle layout (pieceLength / 16KiB, at least 1).

Files in their canonical order.

True for a single-file torrent.

The torrent name: the file name for single-file, the root directory for multi-file.

Number of pieces covering the concatenated data.

Piece size in bytes (a power of two for well-formed torrents).

Sum of all file sizes.

The file index that owns the byte range at the start of piece piece: port of file_storage::file_index_at_piece. For v2/hybrid (piece-aligned) torrents this is the file the whole piece belongs to. Returns -1 for an out-of-range piece or when there are no files. Pad files are included (they occupy real pieces in the layout).

Alias matching libtorrent's file_index_at_piece.

Number of v2 pieces in file fileIndex: port of file_storage::file_num_pieces. Equivalent to numPiecesInFile but computed from the file size alone (independent of the concatenated-stream offset), matching how v2 per-file trees are laid out.

The piece index this file starts on (file_offset / piece_length).

True if file fileIndex is a BEP-47 padding file (not downloadable content).

True if the geometry is usable (positive piece length).

Number of 16 KiB merkle leaf blocks in file fileIndex: port of file_storage::file_num_blocks. Rounds the file size up to whole blocks.

Number of pieces (partial pieces counted) that file fileIndex spans.

The piece-layer offset of file fileIndex's piece pieceInFile within that file's tree.

The piece range covering file fileIndex, inclusive at both ends. The range runs from the piece holding the file's first byte to the piece holding its last byte. This is analogous to file_storage::file_piece_range. A zero-length file returns IntRange.EMPTY.

Size of piece index; the final piece is usually shorter than pieceLength.