ˀh~ddlmZddlmZddlmZerddlmZddlm Z m Z m Z m Z m Z ddlmZeGddZy ) ) annotations) TYPE_CHECKING) expr_dispatch)Series) EndiannessIntoExprPolarsDataTypeSizeUnitTransferEncoding)PySeriescleZdZdZdZddZddZddZddZdddd Z dd Z ddd Z d d  ddZ y)BinaryNameSpacezSeries.bin namespace.binc&|j|_y)N)_s)selfseriess p/var/www/html/wine-match-dev/backend/winematch-backend/venv/lib/python3.12/site-packages/polars/series/binary.py__init__zBinaryNameSpace.__init__s "IIcy)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 ] N)rliterals rcontainszBinaryNameSpace.containsrcy)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)rsuffixs r ends_withzBinaryNameSpace.ends_with7rrcy)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)rprefixs r starts_withzBinaryNameSpace.starts_withMrrT)strictcy)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)rencodingr"s rdecodezBinaryNameSpace.decodecrrcy)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)rr$s rencodezBinaryNameSpace.encoderrcy)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)runits rsizezBinaryNameSpace.sizerrlittle) endiannesscy)a? Interpret a buffer as a numerical polars type. 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 if binary array is too short value will be null. If binary array is too long, remainder will be ignored. 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)rdtyper,s r reinterpretzBinaryNameSpace.reinterpretrrN)rrreturnNone)rrr0r)rrr0r)r rr0r)r$r r"boolr0r)r$r r0r)b)r)r r0r)r.r r,rr0r) __name__ __module__ __qualname____doc__ _accessorrrrr!r%r'r*r/rrrrrsZI& 6 , ,DH6 p& P 2BJ & 4>  rrN) __future__rtypingrpolars.series.utilsrpolarsrpolars._typingrrr r r polars.polarsr rrrrr?s?" -'f f f r