pynetdicom.pdu_items.UserIdentitySubItemAC¶

class pynetdicom.pdu_items.UserIdentitySubItemAC[source][source]¶

A User Identity (AC) Sub-item.

A User Identity (AC) Sub-item is used to response with the server identity to the association requestor.

item_length¶

The number of bytes from the first byte following the Item Length field to the last byte of the Item.

Type:	int

item_type¶

The Item Type field value (0x59).

Type:	int

server_response_length¶

The Server Response Length field value.

Type:	int

server_response¶

The Server Response field value.

Type:	bytes

Notes

A User Identity (RQ) Sub-item requires the following parameters:

Item type (1, fixed, 0x59)
Item length (1)
Server response length (1)
Server response (1)

Encoding

When encoded, a User Identity (AC) Sub-item has the following structure, taken from Tables D.3-15 [1] (offsets shown with Python indexing). Items are always encoded using Big Endian [2].

Offset	Length	Description
0	1	Item type
1	1	Reserved
2	2	Item length
4	2	Server response length
6	Variable	Server response

References

[1]	DICOM Standard, Part 7, Annex D.3.3.7

[2]	DICOM Standard, Part 8, Section 9.3.1

__init__()[source][source]¶: Initialise a new User Identity (AC) Item.

Methods

`__init__`()	Initialise a new User Identity (AC) Item.
`decode`(bytestream)	Decode bytestream and use the result to set the field values of the PDU item.
`encode`()	Return the encoded PDU as bytes.
`from_primitive`(primitive)	Set the item’s values using an User Identity primitive.
`to_primitive`()	Return an User Identity primitive from the current Item.

Attributes

`item_length`	Return the item’s Item Length field value as an int.
`item_type`	Return the item’s Item Type field value as an int.
`response`	Return the item’s Server Response field value.
`server_response_length`	Return the item’s Server Response Length field value.

decode(bytestream)[source]¶

Decode bytestream and use the result to set the field values of the PDU item.

Parameters:	bytestream (bytes) – The PDU data to be decoded.

encode()[source]¶

Return the encoded PDU as bytes.

Returns:	The encoded PDU.
Return type:	bytes

from_primitive(primitive)[source][source]¶

Set the item’s values using an User Identity primitive.

Parameters:	primitive (pdu_primitives.UserIdentityNegotiation) – The primitive to use to set the Item’s field values.

item_length: Return the item’s Item Length field value as an int.

item_type: Return the item’s Item Type field value as an int.

response¶: Return the item’s Server Response field value.

server_response_length: Return the item’s Server Response Length field value.

to_primitive()[source][source]¶

Return an User Identity primitive from the current Item.

Returns:	The primitive representation of the current Item.
Return type:	pdu_primitives.UserIdentityNegotiation