LINK="#0000bb"  VLINK="#551a8b" ALINK="#ff0000">
<H3>
ASN.1 universal data types
</H3>

<P>
The <STRONG>pysnmp.asn1.univ</STRONG> module implements so-called "universal"
ASN.1 types as defined by <A HREF="intro.html">ASN.1 standard</A>.
</P>

<P>
The following classes implement <STRONG>simple</STRONG> ASN.1 types:
</P>

<A NAME="Boolean"></A>
<P>
<DL>
<DT>class <STRONG>Boolean</STRONG>([<STRONG>value</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 BOOLEAN data type. This is a
subclass of <A HREF="base.html#SimpleAsn1Object">base.SimpleAsn1Object</A>
class, with additional methods (<A HREF="#Subsections">see below</A>) and
the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x01
<LI>Single value constraint set to [0, 1]
<LI>Python type constraint set to [IntType, LongType]
</UL>
</P>
<P>
The default value for <STRONG>Boolean</STRONG> object is 0 (false).
</P>
</DD>
</DL>

<A NAME="Integer"></A>
<P>
<DL>
<DT>class <STRONG>Integer</STRONG>([<STRONG>value</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 INTEGER data type. This is a
subclass of <A HREF="base.html#SimpleAsn1Object">base.SimpleAsn1Object</A>
class, with additional methods (<A HREF="#Subsections">see below</A>) and
the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x02
<LI>Python type constraint set to [IntType, LongType]
</UL>
</P>
<P>
The default value for <STRONG>Integer</STRONG> object is 0L.
</P>
</DD>
</DL>

<A NAME="BitString"></A>
<P>
<DL>
<DT>class <STRONG>BitString</STRONG>([<STRONG>value</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 BITSTRING data type. This is a
subclass of <A HREF="base.html#SimpleAsn1Object">base.SimpleAsn1Object</A>
class, with the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x03
<LI>Python type constraint set to [StringType]
</UL>
</P>
</DD>
</DL>

<A NAME="OctetString"></A>
<P>
<DL>
<DT>class <STRONG>OctetString</STRONG>([<STRONG>value</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 OCTETSTRING data type. This is a
subclass of <A HREF="base.html#SimpleAsn1Object">base.SimpleAsn1Object</A>
class, with additional methods (<A HREF="#Subsections">see below</A>) and
the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x04
<LI>Python type constraint set to [StringType]
</UL>
</P>
</DD>
</DL>

<A NAME="Null"></A>
<P>
<DL>
<DT>class <STRONG>Null</STRONG>([<STRONG>value</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 NULL data type. This is a
subclass of <A HREF="base.html#SimpleAsn1Object">base.SimpleAsn1Object</A>
class, with the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x05
<LI>Single value constraint set to [0, 0L, '', None]
<LI>Python type constraint set to [IntType, LongType, StringType, NoneType]
</UL>
</P>
</DD>
</DL>

<A NAME="ObjectIdentifier"></A>
<P>
<DL>
<DT>class <STRONG>ObjectIdentifier</STRONG>([<STRONG>value</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 OBJECT IDENTIFIER data type. This is a
subclass of <A HREF="base.html#SimpleAsn1Object">base.SimpleAsn1Object</A>
class, with additional methods (<A HREF="#Subsections">see below</A>) and
the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x06
<LI>Python type constraint set to [StringType, ListType]
</UL>
</P>
<P>
The <STRONG>ObjectIdentifier</STRONG> objects operate with ASN.1 OBJECT
IDENTIFIER values given as string (in '1.3.4' like notation) or list of
integers ([1, 3, 4]).
</P>
</DD>
</DL>

<P>
The following classes inplement <STRONG>structured</STRONG> ASN.1 types:
</P>

<A NAME="Sequence"></A>
<P>
<DL>
<DT>class <STRONG>Sequence</STRONG>([<STRONG>**kwargs</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 SEQUENCE data type. This is a
subclass of <A HREF="base.html#RecordTypeAsn1Object">base.RecordTypeAsn1Object</A>
class, with the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x10
</UL>
</P>
</DD>
</DL>

<A NAME="SequenceOf"></A>
<P>
<DL>
<DT>class <STRONG>SequenceOf</STRONG>([<STRONG>args</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 SEQUENCE OF data type. This is a
subclass of <A HREF="base.html#VariableTypeAsn1Object">
base.VariableTypeAsn1Object</A> class, with the following deviations from the
base class:
<UL>
<LI>ASN.1 tag set to 0x10
</UL>
</P>
</DD>
</DL>

<A NAME="Set"></A>
<P>
<DL>
<DT>class <STRONG>Set</STRONG>([<STRONG>**kwargs</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 SET data type. This is a
subclass of <A HREF="base.html#RecordTypeAsn1Object">base.RecordTypeAsn1Object</A>
class, with the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x11
</UL>
</P>
</DD>
</DL>

<A NAME="SetOf"></A>
<P>
<DL>
<DT>class <STRONG>SetOf</STRONG>([<STRONG>args</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 SET OF data type. This is a
subclass of <A HREF="base.html#VariableTypeAsn1Object">base.VariableTypeAsn1Object
</A> class, with the following deviations from the base class:
<UL>
<LI>ASN.1 tag set to 0x11
</UL>
</P>
</DD>
</DL>

<A NAME="Choice"></A>
<P>
<DL>
<DT>class <STRONG>Choice</STRONG>([<STRONG>**kwargs</STRONG>])</DT>
<DD>
<P>
Instances of this class represent ASN.1 CHOICE data type. This is a
subclass of <A HREF="base.html#ChoiceTypeAsn1Object">base.ChoiceTypeAsn1Object
</A>class, with the following deviations from the base class:
<UL>
<LI>Tag category set to 'UNTAGGED'
</UL>
</P>
</DD>
</DL>

<P>
Methods of the above classes may raise exceptions based on
<STRONG>error.Asn1Error</STRONG> base class.
</P>

<HR><STRONG>Subsections</STRONG>

<A NAME="Subsections"></A>

<P>
<UL>
<LI><A HREF="univ-boolean-objects.html">
Additional methods of Boolean objects.</A>
<LI><A HREF="univ-integer-objects.html">
Additional methods of Integer objects.</A>
<LI><A HREF="univ-string-objects.html">
Additional methods of OctetString objects.</A>
<LI><A HREF="univ-oid-objects.html">
Additional methods of ObjectIdentifier objects.</A>
<LI><A HREF="univ-integer-example.html">
Example of Integer object usage</A>.
<LI><A HREF="univ-string-example.html">
Example of OctetString object usage</A>.
<LI><A HREF="univ-oid-example.html">
Example of ObjectIdentifier object usage</A>.
<LI><A HREF="univ-sequence-example.html">
Example of Sequence object usage</A>.
<LI><A HREF="univ-sequenceof-example.html">
Example of SequenceOf object usage</A>.
<LI><A HREF="univ-choice-example.html">
Example of Choice object usage</A>.
</UL>
</P>

<HR>

<ADDRESS>
ilya@glas.net
</ADDRESS>