o ¹­§i›"ã@srddlmZddlmZddlmZer.ddlmZddlm Z ddl m Z m Z m Z mZmZeGdd„dƒƒZd S) é)Ú annotations)Ú TYPE_CHECKING)Ú expr_dispatch)ÚSeries)ÚPySeries)Ú EndiannessÚIntoExprÚPolarsDataTypeÚSizeUnitÚTransferEncodingc@s–eZdZdZdZd7dd„Zd8d d „Zd9dd„Zd:dd„Zddœd;dd„Z dd d!„Z d"d#œd?d(d)„Z d@dAd/d0„Z dBdCd3d4„ZdBdCd5d6„Zd*S)DÚBinaryNameSpacezSeries.bin namespace.ÚbinÚseriesrÚreturnÚNonecCs |j|_dS©N)Z_s)Úselfr©rúK/home/app/Keep/.python/lib/python3.10/site-packages/polars/series/binary.pyÚ__init__s zBinaryNameSpace.__init__ÚliteralrcCódS)a+ Check if binaries in Series contain a binary substring. Parameters ---------- literal The binary substring to look for Returns ------- Series Series of data type :class:`Boolean`. Examples -------- >>> s = pl.Series("colors", [b"\x00\x00\x00", b"\xff\xff\x00", b"\x00\x00\xff"]) >>> s.bin.contains(b"\xff") shape: (3,) Series: 'colors' [bool] [ false true true ] Nr)rrrrrÚcontainsózBinaryNameSpace.containsÚsuffixcCr)a¶ Check if string values end with a binary substring. Parameters ---------- suffix Suffix substring. Examples -------- >>> s = pl.Series("colors", [b"\x00\x00\x00", b"\xff\xff\x00", b"\x00\x00\xff"]) >>> s.bin.ends_with(b"\x00") shape: (3,) Series: 'colors' [bool] [ true true false ] Nr)rrrrrÚ ends_with7rzBinaryNameSpace.ends_withÚprefixcCr)a³ Check if values start with a binary substring. Parameters ---------- prefix Prefix substring. Examples -------- >>> s = pl.Series("colors", [b"\x00\x00\x00", b"\xff\xff\x00", b"\x00\x00\xff"]) >>> s.bin.starts_with(b"\x00") shape: (3,) Series: 'colors' [bool] [ true false true ] Nr)rrrrrÚ starts_withMrzBinaryNameSpace.starts_withT)ÚstrictÚencodingr rÚboolcCr)a„ Decode values using the provided encoding. Parameters ---------- encoding : {'hex', 'base64'} The encoding to use. strict Raise an error if the underlying value cannot be decoded, otherwise mask out with a null value. Returns ------- Series Series of data type :class:`String`. Examples -------- Decode values using hexadecimal encoding. >>> s = pl.Series("colors", [b"000000", b"ffff00", b"0000ff"]) >>> s.bin.decode("hex") shape: (3,) Series: 'colors' [binary] [ b"\x00\x00\x00" b"\xff\xff\x00" b"\x00\x00\xff" ] Decode values using Base64 encoding. >>> s = pl.Series("colors", [b"AAAA", b"//8A", b"AAD/"]) >>> s.bin.decode("base64") shape: (3,) Series: 'colors' [binary] [ b"\x00\x00\x00" b"\xff\xff\x00" b"\x00\x00\xff" ] Set `strict=False` to set invalid values to null instead of raising an error. >>> s = pl.Series("colors", [b"000000", b"ffff00", b"invalid_value"]) >>> s.bin.decode("hex", strict=False) shape: (3,) Series: 'colors' [binary] [ b"\x00\x00\x00" b"\xff\xff\x00" null ] Nr)rrrrrrÚdecodecrzBinaryNameSpace.decodecCr)a1 Encode values using the provided encoding. Parameters ---------- encoding : {'hex', 'base64'} The encoding to use. Returns ------- Series Series of data type :class:`String`. Examples -------- Encode values using hexadecimal encoding. >>> s = pl.Series("colors", [b"\x00\x00\x00", b"\xff\xff\x00", b"\x00\x00\xff"]) >>> s.bin.encode("hex") shape: (3,) Series: 'colors' [str] [ "000000" "ffff00" "0000ff" ] Encode values using Base64 encoding. >>> s.bin.encode("base64") shape: (3,) Series: 'colors' [str] [ "AAAA" "//8A" "AAD/" ] Nr)rrrrrÚencode›rzBinaryNameSpace.encodeÚbÚunitr cCr)aì Get the size of the binary values in a Series in the given unit. Returns ------- Series Series of data type :class:`UInt32`. Examples -------- >>> from os import urandom >>> s = pl.Series("data", [urandom(n) for n in (512, 256, 2560, 1024)]) >>> s.bin.size("kb") shape: (4,) Series: 'data' [f64] [ 0.5 0.25 2.5 1.0 ] Nr)rr$rrrÚsizeÃrzBinaryNameSpace.sizeÚlittle)Ú endiannessÚdtyper r'rcCr)aÏ Interpret bytes as another type. Supported types are numerical or temporal dtypes, or an ``Array`` of these dtypes. Parameters ---------- dtype : PolarsDataType Which type to interpret binary column into. endianness : {"big", "little"}, optional Which endianness to use when interpreting bytes, by default "little". Returns ------- Series Series of data type `dtype`. Note that rows of the binary array where the length does not match the size in bytes of the output array (number of items * byte size of item) will become NULL. Examples -------- >>> s = pl.Series("data", [b"\x05\x00\x00\x00", b"\x10\x00\x01\x00"]) >>> s.bin.reinterpret(dtype=pl.Int32, endianness="little") shape: (2,) Series: 'data' [i32] [ 5 65552 ] Nr)rr(r'rrrÚ reinterpretÛrzBinaryNameSpace.reinterpretNÚoffsetÚintÚlengthú int | NonecCr)a² Slice the binary values. Parameters ---------- offset Start index. Negative indexing is supported. length Length of the slice. If set to ``None`` (default), the slice is taken to the end of the value. Returns ------- Series Series of data type :class:`Binary`. Examples -------- >>> colors = pl.Series([b"\x00\x00\x00", b"\xff\xff\x00", b"\x00\x00\xff"]) >>> colors.bin.slice(1, 2) shape: (3,) Series: '' [binary] [ b"\x00\x00" b"\xff\x00" b"\x00\xff" ] Nr)rr*r,rrrÚslicerzBinaryNameSpace.sliceéÚncCr)a` Take the first `n` bytes of the binary values. Parameters ---------- n Length of the slice. Negative indexing is supported; see note (2) below. Returns ------- Series Series of data type :class:`Binary`. Notes ----- (1) A similar method exists for taking the last `n` bytes: :func:`tail`. (2) If `n` is negative, it is interpreted as "until the nth byte from the end", e.g., ``head(-3)`` returns all but the last three bytes. Examples -------- >>> colors = pl.Series([b"\x00\x00\x00", b"\xff\xff\x00", b"\x00\x00\xff"]) >>> colors.bin.head(2) shape: (3,) Series: '' [binary] [ b"\x00\x00" b"\xff\xff" b"\x00\x00" ] Nr©rr0rrrÚheadrzBinaryNameSpace.headcCr)aZ Take the last `n` bytes of the binary values. Parameters ---------- n Length of the slice. Negative indexing is supported; see note (2) below. Returns ------- Series Series of data type :class:`Binary`. Notes ----- (1) A similar method exists for taking the first `n` bytes: :func:`head`. (2) If `n` is negative, it is interpreted as "starting at the nth byte", e.g., ``tail(-3)`` returns all but the first three bytes. Examples -------- >>> colors = pl.Series([b"\x00\x00\x00", b"\xff\xff\x00", b"\x00\x00\xff"]) >>> colors.bin.tail(2) shape: (3,) Series: '' [binary] [ b"\x00\x00" b"\xff\x00" b"\x00\xff" ] Nrr1rrrÚtail?rzBinaryNameSpace.tail)rrrr)rrrr)rrrr)rrrr)rr rr rr)rr rr)r#)r$r rr)r(r r'rrrr)r*r+r,r-rr)r/)r0r+rr)Ú__name__Ú __module__Ú __qualname__Ú__doc__Ú _accessorrrrrr!r"r%r)r.r2r3rrrrr s     8 (ÿ % !r N)Ú __future__rÚtypingrZpolars.series.utilsrZpolarsrZ polars._plrrZpolars._typingrrr r r r rrrrÚs