Create |ASN.1| schema or value object. |ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its objects are immutable and duck-type :class:`bytes`. When used in Unicode context, |ASN.1| type assumes "|encoding|" serialisation. Keyword Args ------------ v
| 691 | |
| 692 | |
| 693 | class OctetString(base.SimpleAsn1Type): |
| 694 | """Create |ASN.1| schema or value object. |
| 695 | |
| 696 | |ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its |
| 697 | objects are immutable and duck-type :class:`bytes`. |
| 698 | When used in Unicode context, |ASN.1| type |
| 699 | assumes "|encoding|" serialisation. |
| 700 | |
| 701 | Keyword Args |
| 702 | ------------ |
| 703 | value: :class:`unicode`, :class:`str`, :class:`bytes` or |ASN.1| object |
| 704 | :class:`bytes`, alternatively :class:`str` |
| 705 | representing character string to be serialised into octets |
| 706 | (note `encoding` parameter) or |ASN.1| object. |
| 707 | If `value` is not given, schema object will be created. |
| 708 | |
| 709 | tagSet: :py:class:`~pyasn1.type.tag.TagSet` |
| 710 | Object representing non-default ASN.1 tag(s) |
| 711 | |
| 712 | subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` |
| 713 | Object representing non-default ASN.1 subtype constraint(s). Constraints |
| 714 | verification for |ASN.1| type occurs automatically on object |
| 715 | instantiation. |
| 716 | |
| 717 | encoding: :py:class:`str` |
| 718 | Unicode codec ID to encode/decode |
| 719 | :class:`str` the payload when |ASN.1| object is used |
| 720 | in text string context. |
| 721 | |
| 722 | binValue: :py:class:`str` |
| 723 | Binary string initializer to use instead of the *value*. |
| 724 | Example: '10110011'. |
| 725 | |
| 726 | hexValue: :py:class:`str` |
| 727 | Hexadecimal string initializer to use instead of the *value*. |
| 728 | Example: 'DEADBEEF'. |
| 729 | |
| 730 | Raises |
| 731 | ------ |
| 732 | ~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error |
| 733 | On constraint violation or bad initializer. |
| 734 | |
| 735 | Examples |
| 736 | -------- |
| 737 | .. code-block:: python |
| 738 | |
| 739 | class Icon(OctetString): |
| 740 | ''' |
| 741 | ASN.1 specification: |
| 742 | |
| 743 | Icon ::= OCTET STRING |
| 744 | |
| 745 | icon1 Icon ::= '001100010011001000110011'B |
| 746 | icon2 Icon ::= '313233'H |
| 747 | ''' |
| 748 | icon1 = Icon.fromBinaryString('001100010011001000110011') |
| 749 | icon2 = Icon.fromHexString('313233') |
| 750 | """ |