pydicom.charset.encode_string¶
- pydicom.charset.encode_string(value: str, encodings: Sequence[str]) bytes [source]¶
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
reading_validation_mode
is notRAISE
, a warning is issued, and value is encoded using the first encoding with replacement characters, resulting in data loss.- Return type
- Raises
UnicodeEncodeError – If
writing_validation_mode
is set toRAISE
and value could not be encoded with the supplied encodings.