pydicom.charset.encode_string

pydicom.charset.encode_string(value: str, encodings: Sequence[str]) → bytes[source]

Encode a unicode string value into bytes using encodings.

Parameters:

  • value (str) – The unicode string as presented to the user.

  • encodings (list of str) – The encodings needed to encode the string as a list of Python encodings, converted from the encodings in (0008,0005) Specific Character Set.

Returns:

The encoded string. If value could not be encoded with any of the given encodings, and reading_validation_mode is not RAISE, a warning is issued, and value is encoded using the first encoding with replacement characters, resulting in data loss.

Return type:

bytes

Raises:

UnicodeEncodeError – If writing_validation_mode is set to RAISE and value could not be encoded with the supplied encodings.