pydicom.charset.encode_string

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

Encode a unicode string value into bytes using encodings.

New in version 1.2.

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 enforce_valid_values is False, 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 enforce_valid_values is True and value could not be encoded with the supplied encodings.