UniversalString type¶
-
class
pyasn1.type.char.
UniversalString
(value=NoValue(), tagSet=TagSet(), subtypeSpec=ConstraintsIntersection(), encoding='us-ascii')¶ Creates UniversalString type or object.
UniversalString objects are immutable and duck-type Python 2
unicode
or Python 3str
. When used in octet-stream context, UniversalString type assumes “utf-32-be” encoding.Parameters: - value (
unicode
,str
,bytes
or UniversalString object) – unicode object (Python 2) or string (Python 3), alternatively string (Python 2) or bytes (Python 3) representing octet-stream of serialized unicode string (note encoding parameter) or UniversalString class instance. - tagSet (
TagSet
) – Object representing non-default ASN.1 tag(s) - subtypeSpec (
ConstraintsIntersection
) – Object representing non-default ASN.1 subtype constraint(s) - encoding (
str
) – Unicode codec ID to encode/decodeunicode
(Python 2) orstr
(Python 3) the payload when UniversalString object is used in octet-stream context.
Raises: : :py:class:`pyasn1.error.PyAsn1Error` – On constraint violation or bad initializer.
Note
The UniversalString type models a Unicode (ISO10646-1) character string implicitly serialized into UTF-32 big endian.
-
clone
(value=NoValue(), tagSet=TagSet(), subtypeSpec=ConstraintsIntersection(), encoding='us-ascii')¶ Creates a copy of a UniversalString type or object.
Any parameters to the clone() method will replace corresponding properties of the UniversalString object.
Parameters: - value (
unicode
,str
,bytes
or UniversalString object) – unicode object (Python 2) or string (Python 3), alternatively string (Python 2) or bytes (Python 3) representing octet-stream of serialized unicode string (note encoding parameter) or UniversalString class instance. - tagSet (
TagSet
) – Object representing non-default ASN.1 tag(s) - subtypeSpec (
ConstraintsIntersection
) – Object representing non-default ASN.1 subtype constraint(s) - encoding (
str
) – Unicode codec ID to encode/decodeunicode
(Python 2) orstr
(Python 3) the payload when UniversalString object is used in octet-stream context.
Returns: new instance of UniversalString type/value
- value (
-
subtype
(value=NoValue(), implicitTag=Tag(), explicitTag=Tag(), subtypeSpec=ConstraintsIntersection(), encoding='us-ascii')¶ Creates a copy of a UniversalString type or object.
Any parameters to the subtype() method will be added to the corresponding properties of the UniversalString object.
Parameters: - value (
unicode
,str
,bytes
or UniversalString object) – unicode object (Python 2) or string (Python 3), alternatively string (Python 2) or bytes (Python 3) representing octet-stream of serialized unicode string (note encoding parameter) or UniversalString class instance. - implicitTag (
Tag
) – Implicitly apply given ASN.1 tag object to caller’sTagSet
, then use the result as new object’s ASN.1 tag(s). - explicitTag (
Tag
) – Explicitly apply given ASN.1 tag object to caller’sTagSet
, then use the result as new object’s ASN.1 tag(s). - subtypeSpec (
ConstraintsIntersection
) – Object representing non-default ASN.1 subtype constraint(s) - encoding (
str
) – Unicode codec ID to encode/decodeunicode
(Python 2) orstr
(Python 3) the payload when UniversalString object is used in octet-stream context.
Returns: new instance of UniversalString type/value
- value (
-
tagSet
= TagSet((), Tag(tagClass=0, tagFormat=0, tagId=28))¶ Default
TagSet
object for UniversalString objects
-
hasValue
()¶ Indicate if UniversalString object represents ASN.1 value or ASN.1 type.
The PyASN1 type objects can only participate in types comparison and serve as a blueprint for serialization codecs to resolve ambiguous types.
The PyASN1 value objects can additionally participate to most of built-in Python operations.
Returns: bool
–True
if object is ASN.1 value,False
otherwise.
-
isSameTypeWith
(other, matchTags=True, matchConstraints=True)¶ Examine UniversalString type for equality with other ASN.1 type.
ASN.1 tags (
tag
) and constraints (constraint
) are examined when carrying out ASN.1 types comparison.No Python inheritance relationship between PyASN1 objects is considered.
Parameters: other (a pyasn1 type object) – Class instance representing ASN.1 type. Returns: bool
–True
if other is UniversalString type,False
otherwise.
-
isSuperTypeOf
(other, matchTags=True, matchConstraints=True)¶ Examine UniversalString type for subtype relationship with other ASN.1 type.
ASN.1 tags (
tag
) and constraints (constraint
) are examined when carrying out ASN.1 types comparison.No Python inheritance relationship between PyASN1 objects is considered.
Parameters: other (a pyasn1 type object) – Class instance representing ASN.1 type. Returns: bool
–True
if other is a subtype of UniversalString type,False
otherwise.
- value (