📄 libbitstream_io-d66e0d17bd6e685b.rmeta
/home/palash/git/iron_learn/target/debug/deps/libbitstream_io-d66e0d17bd6e685b.rmeta
Language: rmeta • Lines: 18142
rust
�#rustc 1.92.0 (ded5c06cf 2025-12-08)��١�	�T�6a��D�
-5080178c80bf7a93��uӰ]����d��!�-06039bcfba61f665��**�٭T��HО�9�-3e2e950d4bac10b5���	ⷄ�ۆ��p��-225863f279df55c4��	�t�#3Ҵη��Ǣ-d25e598578fbf080�rustc_std_workspace_core������Nm��gmY���-327ea4f353b4eb8c���y.:i���gy"1�r-94fdfaf0af91a65d�miniz_oxide�M�^�yTLm�L�d=B-5312b588e5cfab93�adler2��;~�7�ɴ,P?���-1e0b0d62df36c85c�	hashbrown�L�ϫ	2݆y��q-2ed6a8f06fc51a9d�rustc_std_workspace_alloc�a���p��H����6Z�-05b02707a5b2a256�
std_detect�	c�LN����=1�ʶӐ-5978f0713dd5442d�rustc_demangle�X�Fq��UՃ�>7z
��-43b2ff22c18e1125�cfg_if�֦<����ɐ¬�-6a40188dd7d989d2�	addr2line���,2�!xb�"6�!�	-11d54e777384a9e5�gimli��2��I.�ġ�����-35018e994bad7042�object��T �f��Y�
hQec-2dc10b344e05b569�memchr��xZT9�C��I�Mg�-09f2ab7e0d97e07a��~ݤ	����h���-932f22f820d1e5ec�io��3�<�3�,�3|�3��39���<��,�|�������<��,�|������	

huffman�FromBits�Symbol�	from_bits�F�E�ToBits��	to_bits�!�	!�	define_huffman_tree�compile_read_tree_nodes�compile_write_tree_nodes�'STOP_BIT�'MAXIMUM�'�	'�	+�	+�	+/�
/�/�	/�	3�	3�	33	3	read�9999999999	9
999
999J�99M�9BitRead�Oread_bit�PP	O�SBITS�SI�Oread_var�V�
O
read_count�XMAX�XX	Oread_counted�\�
\�
O
read_unsigned�_�_U�Oread_unsigned_var�b�Oread_unsigned_counted�d�
d�Oread_signed�g�gS�Oread_signed_var�j�Oread_signed_counted�l�
l�l!impl TryInto<SignedBitCount<MAX>>�O
read_const�p�pVALUE�p�	ppOread_to�vV�O
read_as_to�x�	x�O�{	|	O
read_bytes�~O
read_to_bytes��SIZE��Oread_to_vec��	O
read_unary���
��Oread_checked��jOparse���	O
parse_with��'a���	Oparse_using���	Obyte_aligned�O
byte_align�Oread_huffman����	Oread_unsigned_vbr��
FIELD_SIZE�����	Oread_signed_vbr�����
�	Oread_vbr�����
Oby_ref�9�R���������
��
��
��
��
��
��
��
��
������������
����������������
������������	������������
����	������	��������9BitRead2�������
�read_in�����
�����read_signed_in�������������	���������������	�read_unary0��read_unary1�����	������	���������	9��������
������
������������������	����������������9����	��
�endian��into_reader�9����	�reader��aligned_reader��into_bytereader��
bytereader�9����	����������
��������
�����	����������������	������	��������
����9����	�	seek_bits��position_in_bits�9skip_aligned����skip_chunks����������9ByteRead������read_as���	������������	������	������	����	�
reader_ref�9	����	��
�������into_bitreader��	bitreader�9
����	��������	��������!9����	�seek�9
FromBitStream����from_reader���9FromBitStreamWith����{����#��9FromBitStreamUsing��{����#��9FromByteStream�����#��9FromByteStreamWith����{����#��9FromByteStreamUsing��{����#��9��'impl FnMut(&mut [u8]) -> io::Result<()>��	MAX_CHUNK���write�����������	�
���
����������	BitWriter��W���	�writer����bits��phantom����'��	��
���into_writer���'�aligned_writer��into_bytewriter��
bytewriter��flush��BitWrite��	write_bit����&����
�	write_var���
�write_unsigned������write_unsigned_var����write_signed������write_signed_var����write_count���
��
write_counted���
��
�write_unsigned_counted������write_signed_counted���
�����write_const�������
write_from����
write_as_from���	���pad�����	��write_unary���
���
���
write_checked��j�build����
build_with������build_using��������
write_huffman����	�write_unsigned_vbr�������write_signed_vbr�����
�	write_vbr�����
�����'��(��&����
��+������)��
��)������)����*������*����*��
��*��
��
��+������+��
������,����,��	����,����,��
��-�j��-����-����������.���	BitWrite2���(���&��
�	write_out�����
��)���write_unsigned_out�������*���write_signed_out�������,����,��	����,����	��write_unary0��write_unary1���-����-����������.���	���'��(��&��
��3����
��)����3������*����4������,����,��	����,����4���5��������'��	��(��)������+������+�����"impl TryInto<SignedBitCount<BITS>>��	��*������,�����,��	�����-�j�������������Counter��checked_add_assign��checked_mul����define_counter������
����written��	���into_written��
����(��+������	��)������	��*�������+��
���	��+��
�����	��,���	��,��	���	��,�	���	��,��
��	��-�j�	�������	��
�����	��:�
����	��;�����	��(��+������)������*������+��
����+��
������,����,��	����,����,��
���bit_recorder���BitRecorder�����	��'��'�����	��
�
with_capacity�����:�written_checked��	�	�playback���'�clear������	�>�����	��(��&����
��+������)��
��)������)����*������*����*��
��*��
��
��+������+��
������,����,��	����,����,��
��-����-����������.�������	�best���	�'impl FnOnce(&mut Self) -> Result<(), F>��
write_byte���'�
ByteWriter���'��	��'��'���'��	��
����(��'�into_bitwriter��	bitwriter��	ByteWrite���&���write_as���	������,��-����-������-���
writer_ref����'��	��&����G��	����,�����H�ToBitStream����	to_writer���'��'�j�bits_len��j��	�ToBitStreamWith����{����I��'��'�j��I�j��	�ToBitStreamUsing��{����I��'��'�j�ToByteStream�����I��'�bytes��j�ToByteStreamWith����{����I��'��K�j�ToByteStreamUsing��{����I��'��K�j��j��&�	��(��j��&���	��G��	���	���	��,�	��H !"#$%&'()*+,-./	Primitive��Bytes��buffer��to_be_bytes��to_le_bytes��
from_be_bytes��
from_le_bytes�define_primitive_numeric������O���O���O��O��O��OInteger���������
��
����&����'��)��
��'
VBRInteger���������/����'���������
��
����&����'���)��
��'����
���������	��
��
����	��&����'�	��)��
��'�	����
���������	�	��/����'�	Numeric��	BITS_SIZE��ZERO��ONE��from_u8��to_u8�define_numeric�UnsignedInteger��MSB_BIT��LSB_BIT��ALL��Signed��as_non_negative��as_negative��as_negative_fixed����checked_shl��checked_shr��shl_default��shr_default�define_unsigned_integer�
SignedInteger��Unsigned��is_negative���V��V��V��define_signed_integer�private�����������	�
�
Endianness��pop_bit_refill����	pop_unary���
���push_bit_flush��	read_bits��	�
�	��	��read_bits_fixed��	��	��	��write_bits_checked��	�
�	�'�	��write_signed_bits_checked��	�
�	�'�	����	�
�	��	����	
CHUNK_SIZE��	����	�[�	�'�bytes_to_primitive��	P��primitive_to_bytes��	�\�read_primitive��	��	��write_primitive��	�'�	��	Checkable��	write_endian��	�	�	�'�Y	read_byte��	��		�F�	�'�	�
�	�
�	��	�	checked_add��	NEW_MAX��	checked_sub��	�^�	try_map��	�^�	�	�		�		�	max��	signed_count��	mask_lsb��	��	�	�		�	range��	��	min��	��	��	��	��	�
�	��	��	�
�	��	�	unknown��	�
�	�	�	�
�	�
�	��	�	�^�	�^�	�^�	�^�	�^�	�^�	�	�		�	�_�	��	unsigned_count��	�_�	�
�	�
�	��	�
�	��	��	�
�	��	��		
�	�
�	��	��	��
j�
��
into_count_value��

into_value��
j�
��
�CheckedUnsigned��
�
�
��
�
�
��
�&�
�'�
written_bits��
�
�
��
	CountType��
��
��
	�
�
�
��
�]�
�	�
�'�
�
�
��
�
�
impl TryInto<BitCount<MAX>>��
	�
	new_fixed��
��
�
�
��
��
��
�
�
��
�CheckedUnsignedFixed��
��
��
��
��
�e�
�
��
��
�&�
�'�
�d�
��
��
�]�
�	�
�'�
��
��
�d�
��
�
CheckedSigned��
�
�
��
�
�
��
�&�
�'�
�d�
�
�
��
�d�
��
��
	�
�
�
��
�]�
�	�
�' �
�
�
��
�
�
��
	�
�e�
��
!�
��
�"�
��
�
�
��
�CheckedSignedFixed��
��
�#�
��
��
�e�
$�
��
��
�&�
�'�
�d%������]��	��'&������d�����]��&��'��dCheckablePrimitive���d����BE�'�read_bits_checked���
�����������	()��Y�	��Y��
������Z���������Z��
��'������'����Z��
��'����Y����Y��
����	�	�	�	�	�	����
��������[�����	�	����[��'���	�	��\��\��\��\��\������\��'��LE�*��l��
�����������	+,��Y�	��Y��
������Z���������Z��
��'������'����Z��
��'����Y����Y��
����	�	�	�	�	�	����
��������[�����	�	����[��'���	�	��\��\��\��\��\������\��'��
find_unary����impl Fn(u8) -> u32��impl Fn(&mut u32) -> u32��impl Fn(u8, u32) -> Option<u8>�LimitedUnary��
��
����
������
����������
������9VariableWidthOverflow��
99
��9��9	BitReader�����	������'��'9����	��9����	��9
ByteReader�����	��'��9����	���
Overflowed��
����������:��:�����:��:�����:��:�����:��:�����:��:���BitsWritten�����'��
��
>�
BitCounter��
��
�	�
�'�
�'��
��
�	�
>�ByteCounterWriter��
j�
���
j�
>�	ByteCount��
j�
�'��
j�
>-�
�V�
�U�
�U�
�V�
�V�
�V�
�V�
��
�V�
�V.�
��
��
��
�
�
�
�
��
�&�
��
�'�
�)�
�
�
�'/�
��
��
��
�/�
��
�'0�
��
��
��
�
	�
�
�
�
�
��
	�
�&�
��
�'�
�
�)�
�
�
�'1�
��
��
��
	�
�/�
��
�'2�
��
��
��
�
�
�
�
��
�&�
��
�'�
	�
�)�
�
�
�'�
	3�
��
��
��
�/�
��
�'�
	4�
�T�
�U�
�U�
�U�
�U5�
�O�
�
�O�
�
�O�
�O�
�O�
�O6�
�V�
�U�
�U�
�V�
�V�
�V�
�V�
��
�V�
�V7��������
��
����&����'��)��
��'8��������/����'9��������	��
��
���	��&����'���)��
��':�������	��/����';��������
��
����&����'�	��)��
��'�	<��������/����'�	=��T��U��U��U��U>��O���O���O��O��O��O?��V��U��U��V��V��V��V����V��V@��������
��
����&����'��)��
��'A��������/����'B��������	��
��
���	��&����'���)��
��'C�������	��/����'D��������
��
����&����'�	��)��
��'�	E��������/����'�	F��T��U��U��U��UG��O���O���O��O��O��OH��V��U��U��V��V��V��V����V��VI��������
��
����&����'��)��
��'J��������/����'K��������	��
��
���	��&����'���)��
��'L�������	��/����'M��������
��
����&����'�	��)��
��'�	N��������/����'�	O��T��U��U��U��UP��O���O���O��O��O��OQ��V��U��U��V��V��V��V����V��VR��������
��
����&����'��)��
��'S��������/����'T��������	��
��
���	��&����'���)��
��'U�������	��/����'V��������
��
����&����'�	��)��
��'�	W��������/����'�	X��T��U��U��U��UY��O���O���O��O��O��OZ��W��W��V��V��V��[��������
��
����&����'��)��
��'\��������/����']��T��U��U��U��U^��O���O���O��O��O��O_��W��W��V��V��V��`��������
��
����&����'��)��
��'a��������/����'b��T��U��U��U��Uc��O���O���O��O��O��Od��W��W��V��V��V��e��������
��
����&����'��)��
��'f��������/����'g��T��U��U��U��Uh��O���O���O��O��O��Oi��W��W��V��V��V��j��������
��
����&����'��)��
��'k��������/����'l��T��U��U��U��Um��O���O���O��O��O��On��W��W��V��V��V��o��������
��
����&����'��)��
��'p��������/����'q��T��U��U��U��Ur��O���O���O��O��O��Os��O���O���O��O��O��Ot��O���O���O��O��O��OBitCount���
��'u��
�v��
����w��
���x��
�����y��
���z��
�{��
����SignedBitCount���
��'�unsigned�|��
�}��
����~��
�����
��������
������
����
����CheckedError��
ExcessiveBits��
�ExcessiveValue��
�������Checked��j��������j����j������j����
FixedBitCount��
�������������������FixedSignedBitCount��
�������������������	BigEndian��
�������LittleEndian��
�������K8K8K8P8S8V8X8\8_8b8d8g8j8l8p8v8x8{8~8~8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�	8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�
8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8O��������������������������	�	�������u/D�\�;s��
�����_�����������w�ć�ڃ�����_���_�����������
�"�f+�c��O8�������w��9��9��'9��'9x�
^
���	�_��O���_���x��'9��9
���z�������������8�'��'����'��'������'���'�$��՚#�(���������y���m�������_���_�������������������z�
�'���H��B������
�
�{�
�'��
�'�}���2�������������@��'���'������a������������F��'���'���]�ކ(�������
�
�{�
��+u���
Fj�����
�
�|�
�'��c��i�������������
�����������	�	�	��	��	yk���9��������������������;t���������������	�	�	��	��	yk���9��������������������;t���������������	�	�	��	��	yk���9��������������������;t���������������	�	�	��	��	yk���9��������������������;t���������������	�	�	��	��	yk���9��������������������;t��������������������������������������Ť��'�<��)h��
����_���`������������������_������������'���C�.׬�y��
����_���`���������������_�����������������������.V䚜6>����_������_����������������U�˸����������_����������������U�˸����������	������ީ�>o��q������_�����Ť��'�<��)h���������Ť��'�<��)h��
���������U�˸��������	��������������U�˸����������	������ʪӁމX+������_���������'���C�.׬�y�������������'���C�.׬�y��
���������U�˸��������	������������c��8�v����_���	����������sOa=ل�]����_���	�����������������������������������������������������������������������������'�/�J����	��	��	�L����	�M����	�	�	��
��
��
��������
������
���������
��
�
���
�
�
�
����
��
��
��������������
�
�	�
�����	������	������	������	����������
�
�	�
�����	������	������	������	���������
����������
�
�������������������������	��	��	��
��
��
��
��
��
��
��
��
��
����
��
��
��������������M�_
T[�_�"�O,�����!���#��
�@���
��2��`������#���	�	���>=�	�~`ZD�>�
�	�~Z)	�~Z!	�~Z}�>�
�]

�
�]
�Ş>
:G�>`f��=V."4<96�XH�
_���C=��~`ZD�C�
��~Z)�~Z!�~Z}�D��]

��]��̍D��7D�D]c��CV6"4963�XE�
_��
Q'291�	�"�@)<�@�@�
�@1�%�]

�%�]����@��7"�@"�@	|�A�A�
D�A˔0ܘAL�A�A�
�A1	.�
,\s
z|�A
ĕ���A��A�&�@��)�]

�)�]����AEC��
8&�B&�B	��@�Z	1.��iit�`W�
��
�˔��
��
_��*��L��	$�����4���.���%���	t���$���5	1�.�az� �	D����!�ģ�,���5iE�-�]

�-�]���ף��9*��*��
���
u$	/�������r6�����������v�_���(3:8��.��=�/�~`ZD��	�
�/�~Z)/�~Z!/�~Z~.���2�]

�2�]�������
8F.��`f���V�$!6@<9�ZK�
_����)4;1�|��	T�����4̔�	T���d����8�3��5
��>��	13��3��
���9���7�������_����)4;8����&180���&181�	�7��=���	$���d����8�:�]

�:�]���̭��
87�7�
,�����

셮
�	��<@���.
d��
�	�st�������;��E|ɮ,ɮ			
%<Ϯ
�P������'���C�.׬�y��	qLϮ�׮	;��;��
,��	t��

4��
�P��8D��t	�>�]


�>�]���ڮ+)��
9���������������*�������������������;t��������Ť��'�<��)h���ġ�GC��FC����������_����-8?8���-8?8��@�)4;64�$���-8?1024����-8?8����-8?256�$���-8?1024�$���-8?4096�$������,��&4096�L����'29=�	MAX_CHUNK�L����'29=�	MAX_CHUNK��+
�(3:1��I��)<��	���
��4�L�]

�L�]�������
8I��I��
��B�$/���I��
_��M޽�L��	$�����4���.���%���	t���$���5	1�.�az� �	D����!����,���5iE�P�]

�P�]���ľ" ��9M��M�
�н�
�%	0�������s7�����������w�_���@�)4;64����)4;8��Q��=�R�~`ZD��	�
�R�~Z)R�~Z!R�~Z~Q���U�]

�U�]��̆���
8FQ��`f���V�$!6@<9�ZK�
_����

���
�	  7���0���Ť��'�<��)h� d��[_��� �)4;32��� �)4;32�|��	T�����4̩�	T���d�����6�Y��5
���>���4YÏY
���9���7
�������_����)4;1���@�)4;64����)4;8����&180����&181�ײ�-8?8����-8?8�$Ӹ�-8?1024��d���L��	$�����4���.���%���	t���$���5	1�.�az� �	D����!����,���5iE�g�]

�g�]�����" ��9d��d��
����
�%	0�������s7�����������w�_��h��@���	$���d�����6�k�]

�k�]�����!��9h��h��
���Y�$/���I������_�	�l��@���	$���d����8�o�]

�o�]�����!��9l��l��
,�����

��
�	��<@���.
d��
�	�st�������p��t|��,��			
%<��
�P������'���C�.׬�y��	qL�����	p��p��
,��	t��

4��
�P��8D��t	�s�]


�s�]�����,	*��
9���������������*�������������������;t��������Ť��'�<��)h������GC��FC����������_��t��=�u�~`ZD��	�
�u�~Z)u�~Z!u�~Z~t���x�]

�x�]�������
8Ft��`f���V�$!6@<9�ZK�
_����-8?8��|�i4L�i$�i��i1��]

��]����i 
��
8|�i|�i	��hM�#.���H��_����n4L�n$�n��n1��]
���]����n 
��
:��n��n
��nM�#.���H��_����@
���@
�(.�
<GN{ _ }����A
���A��#)�
7BI{ _ }�؅����
�����+:���������'	&IF��щ7�
������A_����
�����
 ���*0��ˊ
�����
 �Ċ*1�����x�����ʟ=	7�2kЄ��!	���B�˟����1�
 �����B�!�_���
��۟�
 ��*1�H���
�������
 ���*J��u8::MAX���������� ����x����;��]
���]������0.��=���
���������
'2���L����_���������� ����x����;��]
���]������0.��=���
���������
'2���L����_����@
���@
�(.�<GN{ _ }����A
���A��#)�7BI{ _ }�ؐ����
�����+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1�����x�����ʟ=	7�2kЏ��!	���C �˟����1�
 ���
��B�#�_���
��۟�
 ��*1�H���
�������
 ���*J��u16::MAX���������� ����x����;��]
���]������0.��=���
���������'2���L����_���������� ����x����;��]
���]������0.��=���
���������'2���L����_����@
���@
�(.�<GN{ _ }����A
���A��#)�7BI{ _ }�؛����
�����+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1�����x�����ʟ=	7�2kК�� !	���E"�˟����1� �����B�'�_���
��۟� ��*1�H���
˔����� ���*J˔u32::MAX���������� ����x����;��]
���]������0.��=���
���������'2���L����_���������� ����x����;��]
���]������0.��=���
���������'2���L����_����@
���@
�(.�<GN{ _ }����A
���A��#)�7BI{ _ }�ئ����
�����+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1�����x�����ʟ=	7�2kХ��@!	���I&�˟����1� ����"�B �/�_���
��۟� ��*1�H���
����� ���*J�u64::MAX���������� ����x����;��]
���]������0.��=���
���������'2���L����_���������� ����x����;��]
���]������0.��=���
���������'2���L����_����@
���@
�(.�<GN{ _ }����A
���A�#)�7BI{ _ }�ر����
����+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1�����x�����ʟ=	7�2kа���!	���Q.�˟����1� ���)�2�B0�?�_���
��۟� ��*1�H���
������ ���*J��	u128::MAX���������� ����x����;��]
���]������0.��=���
���������'2���L����_���������� ����x����;��]
���]������0.��=���
���������'2���L����_����@
���@
�(.�<GN{ _ }����A
���A��#)�7BI{ _ }�ؼ����
�����+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1����@
���@
�(.�<GN{ _ }����A
���A��#)�7BI{ _ }�ؿ����
�����+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1����@
���@
�(.�<GN{ _ }����A
���A��#)�7BI{ _ }�������
�����+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1����@
���@
�(.�<GN{ _ }����A
���A��#)�7BI{ _ }�������
�����+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1����@
���@
�(.�<GN{ _ }����A
���Aȴ#)�7BI{ _ }�������
���ȴ+:���������'	&IF��щ7�������A_����
����� ���*0��ˊ
����� �Ċ*1����@
���@
�(.�<GN{ _ }����A
���A�#)�7BI{ _ }����@
���@
�(.�<GN{ _ }����A
���A��#)�7BI{ _ }����J
�	�
������
��
$������	������$���"��	�
�b�����+\��	$������
2���]
���]�������
:���
������D�	$/���I����
_�ܚ�L��	$��	5
<\��
�J7�����	v	���!$��
����Ť��'�<��)h��^J$��			�|��
$��		
<���^;

��	
w}����$��
	

��^
��
���
������		��
*	T�������	�������8����������������;t����������$��$������������������;t��������	4?'&������'��'��'�	RT�^܃�L��	$��	5
<\��
�J7�����	v	���!$��
����$��			�|��
$��		
<���^;

��	
w}����$��
	

��^
��
���
������		��
*	T�������	�������8�������$��$����76&��P���������87p�'s�'��'	���^���
���	��2����,��3a�
Ħ�L��	"
)\����4��t����h	����$߉
����$҈	����h,��	���$��			
��
	��	_
��
lj	�ۈn
����ȉ	���	�և��͈|
����������������;t����������,���� T͈���t��s��gfR�'��D��˔d���	#A˔{ u32::MAX }�$��	l��
����������	���E��Ť��'�<��)h�����$��$����'k���D
�	�
������	
���
�	�
�5ܺ�D��	$�����4	0�-_w
��
�����n
��
��	���	������$��g��:��
	�F��	�
�'�3�����%D��	$�����4���]
���]�����
��
:���
������>�	$/���I��_�
���L��	��$��	6
=\��
�	�
�^VB�����	�	���!�b$��
��������'���C�.׬�y��^V	D��	������l��			��$��
	
7
>\����	H
4�����
		u	���%$��
����
D��	������d
D��	D��	2

��^��	���j
����
��
	��		�����	�����������|����������������;t����������$��$����O��O>t����k��U��TCt����������������'�bits_new����9
���L��	��$��	6
=\��
�	�
�^VB�����	�	���!�f$��
����	D��	������l��			��$��
	
7
>\����	H
4�����
		u	���%$�
����
D��	������d
D��	D��	2

��^Հ	���j
����
ր
	��		�����	�����������|�������$��$���������t����'�����t����~��h��g��\��'����������
���	�Ɍ2���,ڌ3a�
L������	���D��lڏ��,Џ1lƓ��ٓ�	���Q��l����,��1����@���	$���d�����6���]
���]�����!��;���
������Y�
$/���I������_����
)4;0�����@���	$���d�����6���]
���]�����!��;���
������Y�
$/���I������_�����@���	$���d�����6���]
���]�����!��;�ޙ
�ݙ���Y�
$/���I������_���ʴ@�Ҵ	$Ҵ�dڴ���6���]
���]����!��;���
������Y�
$/���I������_�����=���	$���d�����6��]
���]�������
:���
������V�$/���I������_�����=���~`ZD��	�
���~Z)��~Z
!��~Z
�����]
���]���ӣ��
:I���
dj���V�$)6ID@�ZR�
_�����=���	$���d�����6��]
���]�������
:���
������V�$/���I������_����=���~`ZD��	�
���~Z)��~Z
!��~Z
������]
���]��̔���
:I���
dj��V�$)6ID@�ZR�
_�9���������	�	�	�
�
�
�
�������������������,�2��2�<�3��<�3�	BitAnd�4�3��BitOr�,�3��	BitOrAssign�\�4��
BitXor�4�4ϺNot��4�Rem��4�
	RemAssign�L�4��Shl��4�	ShlAssign�L�4��Shr��4��	ShrAssign�L�4��Sub��4��,�4�_��_PhantomData�\�4���mem��5���5��
��$�
��%�
Ą"&�<�5O��D�5���wL�6���D�6���xT�6���"l�6���#��6���#��6���$t�6���$��6���$��7���@\�7����(D�7���2L�7���'L�7���z\�8���GL�8���FT�8���I\�8���J��8���J|�8���Kd�8���L��8���K��8���{T�9�
�������;8 Traits and helpers for bitstream handling functionality�����A> Bitstream readers are for reading signed and unsigned integer���<9 values from a stream whose sizes may not be whole bytes.���A> Bitstream writers are for writing signed and unsigned integer���DA values to a stream, also potentially un-aligned at a whole byte.�����<9 Both big-endian and little-endian streams are supported.�����EB The only requirement for wrapped reader streams is that they must���>; implement the [`io::Read`] trait, and the only requirement���KH for writer streams is that they must implement the [`io::Write`] trait.�����=: In addition, reader streams do not consume any more bytes���?< from the underlying reader than necessary, buffering only a���" single partial byte as needed.���JG Writer streams also write out all whole bytes as they are accumulated.��	���	>; Readers and writers are also designed to work with integer���	 types of any possible size.���
C@ Many of Rust's built-in integer types are supported by default.���
 # Minimum Compiler Version��
���
EB Beginning with version 2.4, the minimum compiler version has been�̲ updated to Rust 1.79.�����41 The issue is that reading an excessive number of���30 bits to a type which is too small to hold them,���DA or writing an excessive number of bits from too small of a type,��� are always errors:�<�
 ```���
  use std::io::{Read, Cursor};���
63 use bitstream_io::{BigEndian, BitReader, BitRead};���
 let data = [0; 10];���A> let mut r = BitReader::endian(Cursor::new(&data), BigEndian);���^[ let x: Result<u32, _> = r.read_var(64);  // reading 64 bits to u32 always fails at runtime�Į assert!(x.is_err());�<�����?< but those errors will not be caught until the program runs,���96 which is less than ideal for the common case in which���85 the number of bits is already known at compile-time.�����GD But starting with Rust 1.79, we can now have read and write methods���LI which take a constant number of bits and can validate the number of bits���EB are small enough for the type being read/written at compile-time:��� ```rust,compile_fail��� ����6�������A����IF let x: Result<u32, _> = r.read::<64, _>();  // doesn't compile at all�<�����?< Since catching potential bugs at compile-time is preferable���=: to encountering errors at runtime, this will hopefully be���#  an improvement in the long run.�ġ # Changes From 3.X.X�����KH Version 4.0.0 features significant optimizations to the [`BitRecorder`]���B? and deprecates the [`BitCounter`] in favor of [`BitsWritten`],���63 which no longer requires specifying an endianness.�����JG In addition, the [`BitRead::read_bytes`] and [`BitWrite::write_bytes`]���B? methods are significantly optimized in the case of non-aligned��� reads and writes.�����A> Finally, the [`Endianness`] traits have been sealed so as not���EB to be implemented by other packages.  Given that other endianness���EB types are extremely rare in file formats and end users should not���A> have to implement this trait themselves, this should not be a�d�	 concern.����� # Changes From 2.X.X�����GD Version 3.0.0 has made many breaking changes to the [`BitRead`] and�Ķ [`BitWrite`] traits.�����A> The [`BitRead::read`] method takes a constant number of bits,���HE and the [`BitRead::read_var`] method takes a variable number of bits���EB (reversing the older [`BitRead2::read_in`] and [`BitRead2::read`]���>; calling methods to emphasize using the constant-based one,���2/ which can do more validation at compile-time).���>; A new [`BitRead2`] trait uses the older calling convention���96 for compatibility with existing code and is available��� *' for anything implementing [`BitRead`].�� ��� FC In addition, the main reading methods return primitive types which���!&# implement a new [`Integer`] trait,���!1. which delegates to [`BitRead::read_unsigned`]���!?< or [`BitRead::read_signed`] depending on whether the output���"" is an unsigned or signed type.��"���"85 [`BitWrite::write`] and [`BitWrite::write_var`] work���"=: similarly to the reader's `read` methods, taking anything���#:7 that implements [`Integer`] and writing an unsigned or���#30 signed value to [`BitWrite::write_unsigned`] or���$.+ [`BitWrite::write_signed`] as appropriate.��$���$96 And as with reading, a [`BitWrite2`] trait is offered���% for compatibility.��%���%=: In addition, the Huffman code handling has been rewritten���%1. to use a small amount of macro magic to write���&30 code to read and write symbols at compile-time.���&74 This is significantly faster than the older version���'1. and can no longer fail to compile at runtime.��'���'B? Lastly, there's a new [`BitCount`] struct which wraps a humble���(96 `u32` but encodes the maximum possible number of bits���( at the type level.���(=: This is intended for file formats which encode the number���),) of bits to be read in the format itself.���)74 For example, FLAC's predictor coefficient precision���)=: is a 4 bit value which indicates how large each predictor�Ժ* coefficient is in bits���*.+ (each coefficient might be an `i32` type).���+96 By keeping track of the maximum value at compile time���+30 (4 bits' worth, in this case), we can eliminate���+85 any need to check that coefficients aren't too large��, for an `i32` at runtime.���,<9 This is accomplished by using [`BitRead::read_count`] to���-:7 read a [`BitCount`] and then reading final values with���-85 that number of bits using [`BitRead::read_counted`].���- # Migrating From Pre 1.0.0��.���.C@ There are now [`BitRead`] and [`BitWrite`] traits for bitstream���.<9 reading and writing (analogous to the standard library's���/B? `Read` and `Write` traits) which you will also need to import.���/96 The upside to this approach is that library consumers���0<9 can now make functions and methods generic over any sort���0=: of bit reader or bit writer, regardless of the underlying���1%" stream byte source or endianness.�9���������	�	�	�
�
�
�
�����������������������������	����������	΂���
��Ϻ��������
��������������������������_���_��������������
�$�
�%�
�&��O������w��������x����"����#����#����$����$����$����@�����(����2����'����z����G����F����I����J����J����K����L����K����{��
��"�"�"��2�"��2x"��3m"��3a"��3pP"S"="@"$"'"""�!"�!�!�!�!�!�!�!�!�!�!�!�!w!z!��4,T�4s!��4J!#!&!<�5!|�5��C@ Traits and implementations for reading or writing Huffman codes�ę from or to a stream.�<�5������;8 A trait for building a final value from individual bits�����?< Though similar to the [`crate::read::FromBitStream`] trait,���A> this is intended to parse short symbols from a stream of bits���B? while `FromBitStream` is meant for parsing larger structs from��� a whole reader.���DA For example, one might have several [`FromBits`] implementations���B? in a single program that all generate `i32` symbols from bits,���=: but implementing `FromBitStream` multiple times for `i32`���" isn't possible (or practical).�D��������������d���\��� Our returned symbol type�4���	g��:7 Given a fallable bit generator, return our output type���d�	 # Errors�����1. Passes along any error from the bit generator�L�	�	��������������������q�aX���	�	�	�����	�����	�����	�����������������������q�aX��|�

�������$�	��������
30 For building individual bits from a final value��
���
>; Though similar to the [`crate::write::ToBitStream`] trait,���DA this is intended to generate a stream of bits from short symbols���>; while `ToBitStream` is meant for writing larger structs to��� a whole writer.���B? For example, one might have several [`ToBits`] implementations���=: in a single program that all write `i32` symbols to bits,���
;8 but implementing `ToBitStream` multiple times for `i32`���
"��4���������� ! !���� d���!\���  The type we accept to output�4���s��85 Given a value to generate, write out bits as needed.�����0- Outputs nothing if the symbol isn't defined.���d�������1��<�������������������������q�aX���	"�	#"#������������������l�
!�������,��&,�WY\^�� ��63 Defines a new Huffman tree for reading and writing�����>; Its syntax is: `define_huffman_tree!(name : type = nodes)`���?< where `name` is some identifier to identify the tree in the���63 macro's current scope, `type` is the tree's output���JG type (which should implement `Copy` and `Eq`), and `nodes` is either a���@= final leaf value or a `[bit_0, bit_1]` pair where `bit_0` is���B? the tree visited on a `0` bit, and `bit_1` is the tree visited��� on a `1` bit.���l�
 # Example���<�����?< use bitstream_io::{define_huffman_tree, huffman::FromBits};���XU define_huffman_tree!(TreeName : &'static str = ["bit 0", ["bit 1->0", "bit 1->1"]]);���1. let mut bits = [true, false].iter().copied();���SP assert_eq!(TreeName::from_bits(|| bits.next().ok_or(())).unwrap(), "bit 1->0");�<���'|��.����,�8�
$�&�8�,�&�,�8!$�&�8���,�8nodes�,�&�8��*���+���8�4���8~$�$�8t,�$�8�,�84�,�8�
$�%�8$�,�8,�'�8�	<�'�8�	D�8
�,�8�
$���%8!$�8�	4��,�8!$�%�8�8�	L��8�	�$�8�	����8�8�$�&�8�	�(�8�4��8$�'�8�	4�$�8�	��8$,�8�	�&�8�,���(�8�4��8�$�$�8�	��$���,�8,�'�8�
��	���8�$�$�,�8��,�8$�,�8,�'�8�	<�'�8�	4�8
�,�8�
$���"8!$�8�	4��,�8!$�%�8�8�	<��8�	�$�8�	����
8�,�&�8$�'�8�	4�$�8�8�&,�&�8�	�(�8�4����$�8�	��8$,�8�	�&�8�,���8�$�(�8�4����$�8�	����	,�8,�'�8�
ģ	���8�,�%�8�&,�%�,�8��,�%�%�8������%���$��>; A helper macro for compiling individual Huffman tree nodes�'|�;5��!��,�8�$�&�8�,�$���	,�8bit_0�,�&�8��$�,�8bit_1�,�&�8��*��� 8�,�8�$���-��� ,�8,�'�8�
��	��� ,�8�$�$� ,� 8��,� 8$� � � ,� 8,� '� 8�
�� 	� � � ,� 8�$� $� ,� 8��,� %� � �!	,� 8�$� &� 8�,� $� ,� 8*,� &�!8��!*�!�!�!8��!�!�!,�!8*,�!%�!��!%��!>��'|�!�7�"�/�"�",�"8*,�"&�"8��"*�"�"�"7��"%�"�#�#�#�#	,�#8��,�#&�#8��#$�#,�#8��,�#&�#8��#*�#�#�$8�
��#	�#�#�#,�#8��,�#�#8�
��#	�$�$�$,�$8��,�$%�$�$�%,�$8�,�$&�$8�,�$%�$,�$8�&,�$&�$8�,�$%�$�$�%	,�$8��,�$&�%8��%$�%,�%8��,�%&�%8��%%�%*�%�%�(8�%,�%8,�%'�%8�
İ%	�%�%�%,�%8��,�%�%,�%8,�%'�%8�
��%	�%�%�%,�%8��,�%�%�',�&8,�&'�&8�
ĕ&	�&�&�&
,�&8�,�&%�&,�&8�&,�&%�&,�&8��,�&%�&8,�&%�&,�&8,�&'�&8�
��&	�&�&�'
,�'8�,�'%�',�'8�&,�'%�',�'8��,�'%�'8 $�'%�'8$�'�'�(,�'8,�''�'8�
��'	�'�'�(
,�'8�,�'%�',�'8�&,�'%�',�'8��,�'%�'8,�'%�(,�(8,�('�(8�
Ę(	�(�(�(
,�(8�,�(%�(,�(8�&,�(%�(,�(8��,�(%�(8 $�(%�(%�(�)�),�)8�,�)&�)8�,�)%�),�)8�&,�)&�)8�,�)%�)�)�)	,�)8��,�)&�)8��)$�),�)8��,�)&�)8��)%�),�)�)�),�)8�'$�)&�)8��)$�)
�)*�)�)�-8�),�)8,�)'�)8�
��)	�*�*�*,�*8��,�*�*,�*8,�*'�*8�
Ħ*	�*�*�*,�*8��,�*�*�,,�*8,�*'�*8�
��*	�*�*�+,�*8�,�*%�*,�+8�&,�+%�+,�+8��,�+%�+,�+�+�+,�+8�'$�+$�+
�+$�+8,�+%�+,�+8,�+'�+8�
ļ+	�+�+�,,�+8�,�+%�+,�+8�&,�+%�+,�+8��,�+%�+,�+�+�+,�+8�'$�+$�+
�+$�+8 $�+%�,8$�,�,�-,�,8,�,'�,8�
Ī,	�,�,�,,�,8�,�,%�,,�,8�&,�,%�,,�,8��,�,%�,,�,�,�,,�,8�'$�,$�,
�,$�,8,�,%�,,�-8,�-'�-8�
Ĉ-	�-�-�-,�-8�,�-%�-,�-8�&,�-%�-,�-8��,�-%�-,�-�-�-,�-8�'$�-$�-
�-$�-8 $�-%�-%�-�.�.,�.8�,�.&�.8�,�.%�.,�.8�&,�.&�.8�,�.%�.,�.8*,�.&�.8��.%�.,�.�.�.,�.8�'$�.&�.8��.$�.
�.*�.�.�/8�.,�.8�,�.�.,�.8*,�.�/�/,�/�/�/,�/8�&,�/�/�/,�/8�'$�/-�/%�/
�/84�/8��/�/�/�/�/%�/%�/��;Y�
(�)()�
��;���<��*++#D�<<�<\�<4�<''����<kL�<�	��������������������q�aX���	'�	,�	-,-'�����=����=�����=�����������������������q�aX�|�=
+�
�����$�=����Հ+�..+���AW�
0�110����A����A��23 !3D�A<�A\�B4�B//����Bv<�B������������������������q�aX�/�	4�	554/���B���B������C�������l�C
3�
�����,�B�&,�B_adfK�3�663���E3<closure_kind>�7<closure_signature>�7<upvars>�7737�
���������I3ܕ8��8��8838�
����ȗ֗d�5��>; Traits and implementations for reading bits from a stream.�$�5O�����������������:9;�9;���?9<���9=ŤD��9?�l���9@�YT��	9A�P<��9B�\��9C��9C�NL��9D��t��9E�Wl��9F�U|��9G�QT��9H�<��9I��9<D�<������������������vxgi��\��1��K�_K��@���������^�^��^��[�^buf��[����e�S����������������������q�aXÅÅą��:����J�J
K$�����1����.��N�N��	=$�	����MM
N����;8 A trait for anything that can read a variable number of���63 potentially un-aligned values from an input stream�<�OO����қO���� PSVX\_bdgjlpvx{~��������������PSVX\_bdgjlpvx{~���������������X���d�g�j��p��vP�SVl�\_�bx{�~��*��
'$ Reads a single bit from the stream.���
+( `true` indicates 1, `false` indicates 0��
�d�
������:7 Passes along any I/O error from the underlying stream.���t� # Examples�<�����63 use bitstream_io::{BitReader, BitRead, BigEndian};�����&# let bytes: &[u8] = &[0b1000_1110];���41 let mut r = BitReader::endian(bytes, BigEndian);���,) assert_eq!(r.read_bit().unwrap(), true);���-* assert_eq!(r.read_bit().unwrap(), false);���-����-����,ĥ��,ĥ��,ĥ��-����<9 assert!(r.read_bit().is_err());  // no more bits to read�<�����<�����96 use bitstream_io::{BitReader, BitRead, LittleEndian};�����&ؤ��74 let mut r = BitReader::endian(bytes, LittleEndian);���-����,ĥ��,ĥ��,ĥ��-����-����-����,ĥ��<��<���D�������������������������q�aX��O�O
P��$�Â�PܕR��R��RRPR����$U��96 Reads a signed or unsigned value from the stream with���&# the given constant number of bits.���d�������:����;8 A compile-time error occurs if the given number of bits���#  is larger than the output type.���t��<�����6������41 let bytes: &[u8] = &[0b0001_1111, 0b1011_11_00];���4����#  // reading unsigned value is ok���.+ assert_eq!(r.read::<4, u8>().unwrap(), 1);���&# // reading signed value is also ok���/, assert_eq!(r.read::<4, i8>().unwrap(), -1);���)& // reading an array of bits is ok too���MJ assert_eq!(r.read::<1, [bool; 4]>().unwrap(), [true, false, true, true]);��� 1. // reading an array of any Integer type is ok��� >; assert_eq!(r.read::<2, [u8; 2]>().unwrap(), [0b11, 0b00]);���!2/ // reading more bytes than we have is an error���!(% assert!(r.read::<4, u8>().is_err());�<�"���"�Į"����"6���#���#,) let bytes: &[u8] = &[0b0001_1111, 0, 0];���#4����#52 // reading 9 bits to a u8 is a compile-time error���$ r.read::<9, u8>();�<�$��$�$������������������������q�aX�
��O�T�
UUT�%O�|�$�����%���<�%
S�����$�%>$�$57��.[��%9����&&# the given variable number of bits.��&�d�&���&���&:����'96 Also returns an error if the output type is too small���')& to hold the requested number of bits.��(�t�(�<�(����(6����)&# let bytes: &[u8] = &[0b0001_1111];���)4����)#����*0- assert_eq!(r.read_var::<u8>(4).unwrap(), 1);���*&����*1. assert_eq!(r.read_var::<i8>(4).unwrap(), -1);���+2����+*' assert!(r.read_var::<u8>(4).is_err());�<�,���,�<�,����,6����,(% let bytes: &[u8] = &[0, 0, 0, 0, 0];���-4����-0- // reading 9 bits to a u8 is a runtime error���.&# // no matter how much data is left���.*' assert!(r.read_var::<u8>(9).is_err());�<�.��D�.������������������������q�aX����O�
WW�/O����,�/���<�/
V����$�/�'$�/�/��?E��02/ Given a desired maximum value for a bit count,���074 reads the necessary bits to fill up to that amount.��1���1?< For example, if the maximum bit count is 15 - or `0b1111` -���1KH reads a 4-bit unsigned value from the stream and returns a [`BitCount`]���2*' which can be used in subsequent reads.��2���2A> Note that `MAX` must be greater than 0, and `MAX + 1` must be�Ԥ3 an exact power of two.��3�d�3���3���396 Passes along an I/O error from the underlying stream.��4�t�4��4�<�4����46���5���5&# let bytes: &[u8] = &[0b100_11110];���54����5,) let count = r.read::<3, u32>().unwrap();���60- assert_eq!(count, 4);  // reads 0b100 - or 4���6@= // may need to verify count is not larger than u8 at runtime���796 assert_eq!(r.read_var::<u8>(count).unwrap(), 0b1111);�<�7���7�<�7����8@= use bitstream_io::{BigEndian, BitReader, BitRead, BitCount};��8���8&����84����91. let count = r.read_count::<0b111>().unwrap();���9C@ assert_eq!(count, BitCount::new::<4>());  // reads 0b100 - or 4���:B? // maximum size of bit count is known to be 7 at compile-time,���:HE // so no runtime check needed to know 7 bits is not larger than a u8���;DA assert_eq!(r.read_counted::<0b111, u8>(count).unwrap(), 0b1111);�<�<���<�ġ<����<6���<���=&����=4����=@= // maximum bit count is 6 (0b110), so we need to read 3 bits���>>; // but no idea what to do if a value of 7 (0b111) is read,���>&# // so this does not compile at all���?(% let count = r.read_count::<0b110>();�<�?��T�?������������������������q�aX����O�
YY�?O�
t�?
X���
$�?�?�X�ZZX�4�CXܕ[��[��[[X[���
˗����Jy��C9���D the given number of bits.��D�d�D���D���D:����E9ȸ��E)���E�t�F�<�F����F@= use bitstream_io::{BitReader, BitRead, BigEndian, BitCount};��F���F&# let bytes: &[u8] = &[0b1111_0000];���G4����G<9 // reading 4 bits with a maximum of 4 will fit into a u8���H! // so no runtime check needed���HOL assert_eq!(r.read_counted::<4, u8>(BitCount::new::<4>()).unwrap(), 0b1111);���IB? // reading 4 bits with a maximum of 64 might not fit into a u8���I+( // so we need to verify this at runtime���JPM assert_eq!(r.read_counted::<64, u8>(BitCount::new::<4>()).unwrap(), 0b0000);�<�J��d�K�������O�
]�
^]^�KO��t�K��,�K��<�K
\���
��$�K�'$�K5�K�K��Wf��L0- Reads an unsigned value from the stream with���L&Ԭ�M�d�M���M���M:����M;����N#���N�t�N�<�N����N6����O&# let data: &[u8] = &[0b1_01_10111];���O85 let mut reader = BitReader::endian(data, BigEndian);���P>; assert_eq!(reader.read_unsigned::<1, u8>().unwrap(), 0b1);���P?< assert_eq!(reader.read_unsigned::<2, u8>().unwrap(), 0b01);���QB? assert_eq!(reader.read_unsigned::<5, u8>().unwrap(), 0b10111);�<�Q���Q�<�Q����R96 use bitstream_io::{LittleEndian, BitReader, BitRead};���R&# let data: &[u8] = &[0b10110_11_1];���R;8 let mut reader = BitReader::endian(data, LittleEndian);���S>����S?< assert_eq!(reader.read_unsigned::<2, u8>().unwrap(), 0b11);���TB? assert_eq!(reader.read_unsigned::<5, u8>().unwrap(), 0b10110);�<�U���U�ĕU����U6����U'$ let data: &[u8] = &[0, 0, 0, 0, 0];���V8����V // doesn't compile at all���VA> reader.read_unsigned::<9, u8>();  // can't read  9 bits to u8�<�W��l�W������������������������q�aX����O�`�aa`�WO�|�W�����W���|�X
_�����$�W>$�W57��fd��X0���Y���Y�d�Y���Y���Y:����Z9ȸ��Z)���[�t�[�<�[����[6����[&����\8����\@= assert_eq!(reader.read_unsigned_var::<u8>(1).unwrap(), 0b1);���]A> assert_eq!(reader.read_unsigned_var::<u8>(2).unwrap(), 0b01);���]DA assert_eq!(reader.read_unsigned_var::<u8>(5).unwrap(), 0b10111);�<�^���^�<�^����^9����_&����_;����_@����`A> assert_eq!(reader.read_unsigned_var::<u8>(2).unwrap(), 0b11);���`DA assert_eq!(reader.read_unsigned_var::<u8>(5).unwrap(), 0b10110);�<�a���a�<�a����a6����b'����b8����cWT assert!(reader.read_unsigned_var::<u8>(9).is_err());    // can't read  9 bits to u8���cXU assert!(reader.read_unsigned_var::<u16>(17).is_err());  // can't read 17 bits to u16���dXU assert!(reader.read_unsigned_var::<u32>(33).is_err());  // can't read 33 bits to u32���eXU assert!(reader.read_unsigned_var::<u64>(65).is_err());  // can't read 65 bits to u64�<�e����f������������������������q�aX����O�cc�fO�����f���|�f
b����$�f�'$�f/1��n���g0���h���h�d�h���h���h:����i9ȸ��i)���i�t�i�<�j����j@���j���j&����k4����k<����l!����lXU assert_eq!(r.read_unsigned_counted::<4, u8>(BitCount::new::<4>()).unwrap(), 0b1111);���mB����m+����nYV assert_eq!(r.read_unsigned_counted::<64, u8>(BitCount::new::<4>()).unwrap(), 0b0000);�<�n����n��������O�
e�fef�oO��t�o���o��|�o
d���
��$�o�'$�o5�o57��|b��o=: Reads a twos-complement signed value from the stream with���p&Ԭ�p�d�p���p���q:����q;8 A compile-time error occurs if the number of bits is 0,���r0- since one bit is always needed for the sign.���r;����r#���s�t�s�<�s����s6���t���t%" let data: &[u8] = &[0b1011_0111];���t8����t;8 assert_eq!(reader.read_signed::<4, i8>().unwrap(), -5);���u:7 assert_eq!(reader.read_signed::<4, i8>().unwrap(), 7);���u41 assert!(reader.read_signed::<4, i8>().is_err());�<�v���v�<�v����v9���w���w%����w;����w:����x;����x4��<�y���y���y����y9���z���z'����z;����{63 // reading 9 bits to an i8 is a compile-time error���{" reader.read_signed::<9, i8>();�<�{��\�|������������������������q�aX����O�h�ihi�|O�|�|�����|���l�|
g�����$�|>$�|57���`��}=����}���}�d�~���~���~:����~0- Returns an error if the number of bits is 0,���0����9ȸ���)�����t���<Ѐ���܀6�����%�����8�����=: assert_eq!(reader.read_signed_var::<i8>(4).unwrap(), -5);����<9 assert_eq!(reader.read_signed_var::<i8>(4).unwrap(), 7);�<�������<�������9���߃%�����;���Ʉ<�����=��<̅��؅�<������ use std::io::Read;����6���†63 let data: &[u8] = &[0, 0, 0, 0, 0, 0, 0, 0, 0, 0];����30 let mut r = BitReader::endian(data, BigEndian);����NK assert!(r.read_signed_var::<i8>(9).is_err());   // can't read 9 bits to i8����PM assert!(r.read_signed_var::<i16>(17).is_err()); // can't read 17 bits to i16��݈PM assert!(r.read_signed_var::<i32>(33).is_err()); // can't read 33 bits to i32����PM assert!(r.read_signed_var::<i64>(65).is_err()); // can't read 65 bits to i64�<����|��������������������������q�aX����O�kk��O���������l�
j����$���'$��35�˓����=��쁌�����d��������Č:�����0�����0����9ȸ���)��َ�t��<������@��ŏ��͏&����4�����=: // reading 4 bits with a maximum of 4 will fit into an i8���!�����QN assert_eq!(r.read_signed_counted::<4, i8>(BitCount::new::<4>()).unwrap(), 1);���C@ // reading 4 bits with a maximum of 64 might not fit into an i8����+����SP assert_eq!(r.read_signed_counted::<64, i8>(BitCount::new::<4>()).unwrap(), -1);�<�����Γ�������O�
m�n�oomn��O��t������Ћ���!��l��Ћ��䜔
l���
��Ћ$���'$��f�fhac���}���;8 Reads the given constant value from the stream with the�̺� given number of bits.�ؕ����52 Due to current limitations of constant paramters,����$! this is limited to `u32` values.�Ö��˖C@ If the constant read from the stream doesn't match the expected����85 value, returns the generated error from the closure.�З�dؗ������:7 Passes along any I/O error from the underlying stream,����;8 converted to the mismatch error.  Returns the generated���@= error if the read value doesn't match the expected constant.����t���Й�<ؙ����6��������
 enum Error {����     Mismatch,�\Қ     Io,�,� }������)& impl From<std::io::Error> for Error {����/,     fn from(_err: std::io::Error) -> Self {��֛         Self::Io�L�     }�,����������2/ let data: &[u8] = &[0b1000_1011, 0b0000_0001];��Ɯ3�����C@ assert!(r.read_const::<4, 0b1000, _>(Error::Mismatch).is_ok());��ƝC@ assert!(r.read_const::<4, 0b1011, _>(Error::Mismatch).is_ok());����" // 0b1000 doesn't match 0b0000����[X assert!(matches!(r.read_const::<4, 0b1000, _>(Error::Mismatch), Err(Error::Mismatch)));����" // 0b1011 doesn't match 0b0001����[X assert!(matches!(r.read_const::<4, 0b1011, _>(Error::Mismatch), Err(Error::Mismatch)));���� // run out of bits to check����UR assert!(matches!(r.read_const::<4, 0b0000, _>(Error::Mismatch), Err(Error::Io)));�<����T���������O�q�r�	ssqr�O�|¡��ӡ�������|��
p�����$��err��^$ȡX,١XZtĢ<ˢ��p�uup�����I���A> Reads whole value from the stream whose size in bits is equal��¥ to its type's size.�ޥ�d���������:�����tƦ�<٦����6��������1. let bytes: &[u8] = &[0x12, 0x34, 0x56, 0x78];��ާ4�����;8 assert_eq!(r.read_to::<u32>().unwrap(), 0x12_34_56_78);�<ר����<������6��������1����4�����JG assert_eq!(r.read_to::<[u8; 4]>().unwrap(), [0x12, 0x34, 0x56, 0x78]);�<����<��������������������������q�aX���O�ww��O��֡���֡Lë
v��֡$��*,���f�ӫA�����=: to its type's size in an endianness that may be different��۬! from the stream's endianness.����d����������:����l���<�������DA use bitstream_io::{BitReader, BitRead, BigEndian, LittleEndian};�Ю��خ1�����4���ǯLI assert_eq!(r.read_as_to::<LittleEndian, u32>().unwrap(), 0x78_56_34_12);�<����T��������������������������q�aX���O�	y�zyz��O�����������	��T����L��
x������$��QSLN�Ը/���1. Skips the given number of bits in the stream.��Ʊ30 Since this method does not need an accumulator,����@= it may be slightly faster than reading to an empty variable.��ò/, In addition, since there is no accumulator,����1. there is no upper limit on the number of bits�̭� which may be skipped.��˳74 These bits are still read from the stream, however,����.+ and are never skipped via a `seek` method.����d´��Ӵ��۴:�����l����<�������6��������'$ let bytes: &[u8] = &[0b1_00000_10];����4����,ĥ��� assert!(r.skip(5).is_ok());����,ĥ��-�����#  assert!(r.read_bit().is_err());�<ȸ��$׸������������������������q�aX��OܸO
{��$��'$���{ܕ|��|��||{|��˗�����{ܕ}��}��}}{}������:�ѹ74 Completely fills the given buffer with whole bytes.����63 If the stream is already byte-aligned, it will map��Ⱥ:7 to a faster `read_exact` call.  Otherwise it will read����+( bytes individually in 8-bit increments.����d����л��ػ:�����l����<�������6��������74 let bytes: &[u8] = &[0x00, 0x01, 0x02, 0x03, 0x04];����4����� let mut buf = [0; 3];����1. assert_eq!(r.read::<8, u8>().unwrap(), 0x00);��ɾ,) assert!(r.read_bytes(&mut buf).is_ok());����*' assert_eq!(&buf, &[0x01, 0x02, 0x03]);����1. assert_eq!(r.read::<8, u8>().unwrap(), 0x04);�<߿��T�������
�O��O
~��$�����������H���>; Completely fills a whole buffer with bytes and returns it.����6�����:�����+�����d����������:��1.8.0�use read_to() method instead����El������������������������������q�aX���O�����O����
����$��$�����>���63 Completely fills a vector of bytes and returns it.����6�����:�����+�����d����������:�����l����<�������6��������7�����4����������1�����JG assert_eq!(r.read_to_vec(3).unwrap().as_slice(), &[0x01, 0x02, 0x03]);����1��<����\��������������������������q�aX�?�?��?���:�?�	�:$x��Lk��B�B�BGlobal�����I����O��O
���$���K,��,���ܕ���������������°���?���<9 Counts the number of bits in the stream until `STOP_BIT`����  and returns the amount read.���� `STOP_BIT` must be 0 or 1.����:7 Because this field is variably-sized and may be large,����&# its output is always a `u32` type.����d����������:�����2/ May panic if the number of bits exceeds `u32`.����t���<�������6��������41 let bytes: &[u8] = &[0b0_10_11111, 0b10_000000];����4�����85 // read 1 bits until stop bit of 0, big-endian order����0- assert_eq!(r.read_unary::<0>().unwrap(), 0);����0- assert_eq!(r.read_unary::<0>().unwrap(), 1);����0- assert_eq!(r.read_unary::<0>().unwrap(), 6);�<�������<�������6��������41 let bytes: &[u8] = &[0b1_01_00000, 0b01_000000];����4�����85 // read 0 bits until stop bit of 1, big-endian order����0- assert_eq!(r.read_unary::<1>().unwrap(), 0);����0- assert_eq!(r.read_unary::<1>().unwrap(), 1);����0- assert_eq!(r.read_unary::<1>().unwrap(), 6);�<�������<�������9�������41 let bytes: &[u8] = &[0b11111_01_0, 0b000000_01];����7�����;8 // read 1 bits until stop bit of 0, little-endian order����0�����0�����0��<�������<�������9�������41 let bytes: &[u8] = &[0b00000_10_1, 0b111111_10];����7�����;8 // read 0 bits until stop bit of 1, little-endian order����0�����0�����0��<����T��������������������������q�aX��O�
����O�
���
����
$��D�����������j����l���HE Reads to a checked value that is known to fit a given number of bits����l����<������� use bitstream_io::{����OL     BitRead, BitReader, BigEndian, Checked, CheckedUnsigned, CheckedSigned,����63     BitCount, SignedBitCount, BitWrite, BitWriter,�4�� };�������%" let data: &[u8] = &[0b1001_1111];����3��������.+ let bit_count = BitCount::<4>::new::<4>();����RO let checked_u8 = r.read_checked::<CheckedUnsigned<4, u8>>(bit_count).unwrap();����0- assert_eq!(checked_u8.into_value(), 0b1001);�������41 let bit_count = SignedBitCount::<4>::new::<4>();����PM let checked_i8 = r.read_checked::<CheckedSigned<4, i8>>(bit_count).unwrap();����,) assert_eq!(checked_i8.into_value(), -1);�������<9 // note that checked values already know their bit count����85 // so none is required when writing them to a stream����52 let mut w = BitWriter::endian(vec![], BigEndian);����)& w.write_checked(checked_u8).unwrap();����)& w.write_checked(checked_i8).unwrap();����1. assert_eq!(w.into_writer().as_slice(), data);�<����d������j���������������������q�aX����Oj����O������������
�����$���,��46���<���#  Parses and returns complex type�,��������������������������q�aX�����O�	����O�������l��
�����$��+-���z���0- Parses and returns complex type with context�T��������������������������������q�aX������O���	�����O�����������
������$��context�<����NP���\���63 Parses and returns complex type with owned context�\�����������������������������q�aX�����O�	����O����������
�����$����<��57������:7 Returns true if the stream is aligned at a whole byte.����l����<������������6����� let data = [0];����C@ let mut reader = BitReader::endian(data.as_slice(), BigEndian);����,) assert_eq!(reader.byte_aligned(), true);����$! assert!(reader.skip(1).is_ok());����-* assert_eq!(reader.byte_aligned(), false);����$! assert!(reader.skip(7).is_ok());����,��<����d������O��O
���$��̶����@= Throws away all unread bit values until the next whole byte.����2/ Does nothing if the stream is already aligned.����l����<�������6�����$! let data: &[u8] = &[0x00, 0xFF];����8�����30 assert_eq!(reader.read::<4, u8>().unwrap(), 0);���� reader.byte_align();����63 assert_eq!(reader.read::<8, u8>().unwrap(), 0xFF);�<����T������O��O
���$�����e���=: Given a compiled Huffman tree, reads bits from the stream����)& until the next symbol is encountered.����d����������:�����l�������<�������^[ use bitstream_io::{BitReader, BitRead, BigEndian, define_huffman_tree, huffman::FromBits};�������EB define_huffman_tree!(TreeName : char = ['a', ['b', ['c', 'd']]]);�|�� // 'a' is 0���� // 'b' is 1 -> 0�̵� // 'c' is 1 -> 1 -> 0���� // 'd' is 1 -> 1 -> 1�������41 let data: &[u8] = &[0b0_10_110_11, 0b1_0000000];����3�����;8 assert_eq!(r.read_huffman::<TreeName>().unwrap(), 'a');����;8 assert_eq!(r.read_huffman::<TreeName>().unwrap(), 'b');����;8 assert_eq!(r.read_huffman::<TreeName>().unwrap(), 'c');����;8 assert_eq!(r.read_huffman::<TreeName>().unwrap(), 'd');�<����d��������������������������q�aX����O�����O�����������
�����$��*,���ܕ����������������°���[���C@ Reads a number using a variable using a variable width integer.���52 This optimises the case when the number is small.�������EB The integer is mapped to an unsigned value using zigzag encoding.���� For an integer X:����   - if X >= 0 -> 2X����   - else -> -2X + 1�ʂ�d҂������:�����KH Returns an error if the data read would overflow the size of the result����l����<�������6��ۄ���30 let bytes: &[u8] = &[0b0111_1100, 0b1100_0001];����4���ԅ<9 assert_eq!(r.read_unsigned_vbr::<4, u32>().unwrap(), 7);����>; assert_eq!(r.read_unsigned_vbr::<4, u32>().unwrap(), 100);�<؆��<������6��������ZW let bytes: &[u8] = &[0b1111_1111, 0b0011_1000, 0b1000_0100, 0b1000_1000, 0b1000_0000];����4���ˈ^[ assert_eq!(r.read_unsigned_vbr::<4, u8>().unwrap(), 255); // Tries to read <011><111><111>����a^ assert!(r.read_unsigned_vbr::<4, u8>().is_err()); // Tries to read a value of <100><000><000>����fc assert!(r.read_unsigned_vbr::<4, u8>().is_err()); // Tries to read a value of <000><000><000><000>�<�������������O������ˋO����������|��
������$Ћ2T��24��������4���ܕ����������������������ЙW���C���ܓ5��������E�������������������d•��ӕ��ە:�����K����l���<�������6��˗��ӗ30 let bytes: &[u8] = &[0b0110_1011, 0b1100_0001];����4���Ę:7 assert_eq!(r.read_signed_vbr::<4, i32>().unwrap(), 3);����<9 assert_eq!(r.read_signed_vbr::<4, i32>().unwrap(), -50);�<ę��|ә�����O���
�����O���������l��
������$��:T�:<L���ܕ����������������������M���FC Reads a signed or unsigned variable width integer from the stream.�۝�d���������:�����K�����l����<�������6�������3�����4����30 assert_eq!(r.read_vbr::<4, u32>().unwrap(), 6);����52 assert_eq!(r.read_vbr::<4, i32>().unwrap(), -50);�<ס��D�������O���
�����O����������T��
������$��:T��:<���!���74 Creates a "by reference" adaptor for this `BitRead`�������2/ The returned adapter also implements `BitRead`���'$ and will borrow the current reader.����l����<�����Ĥ6��������  fn parse<R: BitRead>(r: R) {����     // perform some parsing�,Х��ڥ��� let data: &[u8] = &[0];����8�����&# // performing parsing by reference��� parse(reader.by_ref());����,) // original owned reader still available����30 assert_eq!(reader.read::<8, u8>().unwrap(), 0);�<���4�������O��O
���$���Ǩ,8���������̨O��<Ϩ������������������������PSVX\_bdgjlvx{~����������������������������������*D������������
�8��$����U$��������������������������q�aX�
������
�������|���ɖ���ɖ<��
�8���ɖ$��H$��?A���[D���������
�������,׫��<ͫ
�8����$���'$�������ET��������������������������q�aX��Ť��'�<��)h��
����
������
t��
�8���
$��!�����yd������������
��
���ƭ��t����,����<��
�8���
ɖ$˭�'$ѭ@��í��fl��������������������������q�aX���������������|���������|��
�8����$��H$��?A���d����������������������|�
�8����$���'$��13�ɱ��̱����������
���������t����ƞ|��
�8���
�$���'$��@�@B���b\��������������������������q�aX�����������ų���|������³���l��
�8�����$ʳH$��?A�δ`|Ѵ�����������������l��
�8����$��'$�13����������������
������������t������������!Σl����������'���C�.׬�y��
�ƶ
�8���
���$���'$�����������I<�������������������ܧL��
�8����$��(*���fT��������������������������q�aX�����	�������������������	��T�����Lع
�8������$��WYRT���/$�����������
�8��$���'$�����:T���������������
�8��$���������>\�����������
�8��$���K,�����?T����������
��Ľ��
���
�8���
$ɽ!D�����<,��������������������������q�aX�������	��¾��������l��
�8����$Ǿ02���zT���������	����������������������q�aX��������	���ҿ������������
�8����$׿��<���MO���d����������
�8��$��ķ�T����������
�8��$�����ed��������������������������q�aX���������������������
�8����$��/1������A> A compatibility trait for older code implementing [`BitRead`]�������63 This is a trait largely compatible with older code�ܠ� from the 2.X.X version,����41 which one can use with a named import as needed.�������96 New code should prefer the regular [`BitRead`] trait.����l����<�������*' use bitstream_io::BitRead2 as BitRead;����-* use bitstream_io::{BitReader, BigEndian};���� let byte = &[0b1111_0000];����C@ let mut reader = BitReader::endian(byte.as_slice(), BigEndian);����63 assert_eq!(reader.read::<u8>(4).unwrap(), 0b1111);����;8 assert_eq!(reader.read_in::<4, u8>().unwrap(), 0b0000);�<����D����������6�����!���������������������������������������������������������+���'�����+Ȣ���d����������:��D������������
���$�����W���0���������d����������:�����9ȸ���)��$����������
�������,����<��
�����$���'$�������X���0�����&Ԭ���d����������:�����;�����#��<�����������
�������|��������<��
������$��2$��24���\���=����������d����������:�����0�����0�����9ȸ���)��\���������������������l��
�����$���'$��,.���e���=�����&Ԭ���d����������:�����;�����0�����;�����#��t�������������������|��������l��
������$��2$��24���I���A����������d����������:��<���������������������L��
���֡$��#%���f���A�����=����!�����d����������:��T����������	����������������˧T��ܧL��
�������$��9;=?���0���1�����3����@�����/����1��̔�����7�����.Ȫ���d����������:��$�����������
���$���'$�����:���7�����6�����:�����+�����d����������:��T���������������
���$������
����H���>�����6�����:�����+�����d����������:���������El������������������������
����$��$�����>���6̺���6�����:�����+�����d����������:��\�����������
���$���K,��,���ܕ��������������°���,���<9 Counts the number of 1 bits in the stream until the next����&# 0 bit and returns the amount read.����:�����&�����d����������:��\������������
���$�����,���<9 Counts the number of 0 bits in the stream until the next����&# 1 bit and returns the amount read.����:�����&�����d����������:��\������������
���$�����]���#��,����������	�����������l��O��<��
�����$��35�������0��T����������������	�����������������<��
������$����<����CE������:��d����������
���$��̉����@�����2��T����������
���$�����e���=�����)�����d����������:��d������������������������
�����$��#%���ܕ����������������°������������O��<������������������������������
������������������*D������������
���$�����W$����������
�������,����<��
�����$���'$������X<����������
�������|�������<��
������$��2$��24���\\���������������������lނ
�����$���'$��,.���et���������������݃��|Ƀ��ڃ��l��
������$�2$σ24��I<���������������������L��
���֡$��#%���fT����������	����������������˧T̆ܧL�
�������$��9;=?���/$‡������LJ�
���$̇�'$҇���:T������������ˆ�
���$Lj��͈���,\���������ȉ�
���$͉\����,\������������
���$�������d����������
���$�����T����������
���$���ː&���	�����А����Ӑ�	��T֐�����5702���(���=: Wraps a BitReader around something that implements `Read`���������
������4ő�ԓ7��=����� with the given endianness.�4ۓ��������
������4�_endian�<�첖���63 Unwraps internal reader and disposes of BitReader.�ӕ�lە
 # Warning������*' Any unread partial bits are discarded.�\��������
�����$Ŗ��0���	��������������D����T��������8:<>���*���96 If stream is byte-aligned, provides mutable reference���1. to internal reader.  Otherwise returns `None`�4����������������������;t����������
�����$����*�ؙ>; Returns byte-aligned mutable reference to internal reader.�������52 Bytes aligns stream if it is not already aligned.�t������������
�����$�����0�ߛ@= Converts `BitReader` to `ByteReader` in the same endianness.����l��������Ɯ*��|��������
�����$����=��>; If stream is byte-aligned, provides temporary `ByteReader`����52 in the same endianness.  Otherwise returns `None`���l���������DA Any reader bits left over when `ByteReader` is dropped are lost.�T���������������������;t������x��'9��9
���z�����������
�����$���נ<���	�����ܠ�����Dߠ��T���������������Pd_lgvx{~����������������������*D������������
�����$�������������ġ���������ǣ���|����ģƞ|��
�������$̣�'$ң?$��?A���fl��������������������|������ƞ|֦
�������$��6$��68����������������
�����������tШ���Ȧ���!Σlԩ�䊩
������
���$��'$��V֨VXZ\���ܕ���������������
�����������b\��������������������|������Σl�
��������$Ŭ6$��68������������I<�������������������ܧL��
�������$��')��DzfTʲ����ͩ��	�����۲���ղ�ز��T����L��
���������$�=?ACD��ƺ3t���<�����ȵ����6��䞶 let data = [0b10110111];����C�����$! assert!(reader.skip(3).is_ok());����96 assert_eq!(reader.read::<5, u8>().unwrap(), 0b10111);�<������<������������9����Ѝ���FC let mut reader = BitReader::endian(data.as_slice(), LittleEndian);��ӹ$�����96 assert_eq!(reader.read::<5, u8>().unwrap(), 0b10110);�<����$ɺ������κ�
�����$Ӻ�'$ݺD���ܕ�������������������:l���<������������6���� let data = b"foobar";����C�����%" assert!(reader.skip(24).is_ok());���� let mut buf = [0;3];����1. assert!(reader.read_bytes(&mut buf).is_ok());���� assert_eq!(&buf, b"bar");�<����T���������������
�����$����������?T����������
����������
������
$�� D�����d����������
�����$�����T����������
�����$�����O���	�������������T����D�����D������;=?A���Bl����<�������*' use std::io::{Read, Cursor, SeekFrom};����6���� let data = [0x00, 0xFF];����FC let mut reader = BitReader::endian(Cursor::new(&data), BigEndian);����63 assert_eq!(reader.position_in_bits().unwrap(), 0);�������<9 let pos = reader.seek_bits(SeekFrom::Start(5)).unwrap();����A> assert!(pos == 5 && 5 == reader.position_in_bits().unwrap());�������?< let pos = reader.seek_bits(SeekFrom::Current(-2)).unwrap();����A> assert!(pos == 3 && 3 == reader.position_in_bits().unwrap());�������:7 let pos = reader.seek_bits(SeekFrom::End(5)).unwrap();����C@ assert!(pos == 11 && 11 == reader.position_in_bits().unwrap());�<����L�������I�I�IStart��I��I�IEnd��I��I�ICurrent��I���:41R,��������������������q�aX������
�����$���$�����5l����<������� use std::fs::read;����*����6����������FҚ���6��������74 let _: i32 = reader.read_signed::<5, _>().unwrap();����63 assert_eq!(reader.position_in_bits().unwrap(), 5);������� reader.read_bit().unwrap();����63 assert_eq!(reader.position_in_bits().unwrap(), 6);�<�����������١����
�����$�����Rd��9������������D��
����4���K,��)+���v\��9����������������������D��
�����4���K,��I$��@B=����;�������JG A trait for anything that can read aligned values from an input stream�D���������������!��������������������
�������������M���)& Reads whole numeric value from stream����d����������:�����t���<������������85 use bitstream_io::{BigEndian, ByteReader, ByteRead};����(% let data = [0b00000000, 0b11111111];����DA let mut reader = ByteReader::endian(data.as_slice(), BigEndian);����B? assert_eq!(reader.read::<u16>().unwrap(), 0b0000000011111111);�<�������<������������;8 use bitstream_io::{LittleEndian, ByteReader, ByteRead};����(�����GD let mut reader = ByteReader::endian(data.as_slice(), LittleEndian);����B? assert_eq!(reader.read::<u16>().unwrap(), 0b1111111100000000);�<����$���������������������L��
���֡$��#%���j���OL Reads whole numeric value from stream in a potentially different endianness����d����������:�����t���<������������FC use bitstream_io::{BigEndian, ByteReader, ByteRead, LittleEndian};����(�����D֬���SP assert_eq!(reader.read_as::<LittleEndian, u16>().unwrap(), 0b1111111100000000);�<�������<������������F����(�����G�����PM assert_eq!(reader.read_as::<BigEndian, u16>().unwrap(), 0b0000000011111111);�<����<����������	����������������˧T��ܧL��
�������$��9;=?���:���7�����d����������:��T���������������
���$���������H���>�����d����������:����use read() method instead����Bl������������������������
����$��$�����>���6̺���d����������:��\�����������
���$���K,��,���ܕ��������������°���1���2/ Skips the given number of bytes in the stream.����d����������:��$�����������
���$���K,�����=���#��,��������������������������q�aX�������	������������t��
�����$��+-���{���0��T��������������������������������q�aX����������	�����������������
������$����<����HJ���]���6��\�����������������������������q�aX�������	���������������
�����$����<��57���.���2/ Returns mutable reference to underlying reader�T�������������
���$�����1���	�������������D����T����������68:<���)���>; Wraps a ByteReader around something that implements `Read`���������
������4����8���>���̄��4����������
������4����<���ֆ���96 Unwraps internal reader and disposes of `ByteReader`.�\݆������
�����$��ه"���1. Provides mutable reference to internal reader�4������������
�����$����.���@= Converts `ByteReader` to `BitReader` in the same endianness.�t��������
�����$�����3�܉:7 Provides temporary `BitReader` in the same endianness.����l����������C@ Any unread bits left over when `BitReader` is dropped are lost.�L���������w��9��9��'9��'9x�
^
���������
�����$�����>���	�������������D����T�������������������[]_a�ˌM$Ό����������֌���ӌܧL��
�������$ی')���j<������ͩ��	�����������������T���L��
���������$��=?AC���:T���������������
�����$���������0$�����������
�����$���K,�����-T�������������
�����$����I���	������������D����D����T�������8:<>���8$�������١�ē�
�����$ɓpos�ϓ������JG Implemented by complex types that don't require any additional context���KH to parse themselves from a reader.  Analogous to [`std::str::FromStr`].����l����<ɕ���ѕ����EB use bitstream_io::{BigEndian, BitRead, BitReader, FromBitStream};�������#  #[derive(Debug, PartialEq, Eq)]��֖ struct BlockHeader {���     last_block: bool,����     block_type: u8,�ġ�     block_size: u32,�,��������ė(% impl FromBitStream for BlockHeader {���$!     type Error = std::io::Error;�������QN     fn from_reader<R: BitRead + ?Sized>(r: &mut R) -> std::io::Result<Self> {���         Ok(Self {����*'             last_block: r.read_bit()?,����.+             block_type: r.read::<7, _>()?,��ؙ/,             block_size: r.read::<24, _>()?,�t��         })�L��ؓ,����������RO let mut reader = BitReader::endian(b"\x04\x00\x00\x7A".as_slice(), BigEndian);�|�� assert_eq!(����/,     reader.parse::<BlockHeader>().unwrap(),����IF     BlockHeader { last_block: false, block_type: 4, block_size: 122 }�4�� );�<����l���������������!���������\���	�T����74 Error generated during parsing, such as `io::Error`�,�������jԂ� Parse Self from reader�\��������������������������q�aX��������ȝ�ϒ���<������,��
�����r�ŝ79������DA Implemented by complex types that require some immutable context��Ԟ&# to parse themselves from a reader.����l����<������������IF use bitstream_io::{BigEndian, BitRead, BitReader, FromBitStreamWith};������� #[derive(Default)]���� struct Streaminfo {����      minimum_block_size: u16,��ʠ      maximum_block_size: u16,���      minimum_frame_size: u32,����      maximum_frame_size: u32,�̭�     sample_rate: u32,��ǡ     channels: u8,��ݡ     bits_per_sample: u8,����     total_samples: u64,����     md5: [u8; 16],�,����������#���ۢ struct FrameHeader {����"     variable_block_size: bool,�ė���̰����ʣ     channel_assignment: u8,���     sample_size: u8,�ԃ�     frame_number: u64,����     crc8: u8,�,����������0- impl FromBitStreamWith<'_> for FrameHeader {���"     type Context = Streaminfo;�������&#     type Error = FrameHeaderError;�������,)     fn from_reader<R: BitRead + ?Sized>(���         r: &mut R,����$!         streaminfo: &Streaminfo,����(%     ) -> Result<Self, Self::Error> {��Ϧ96         if r.read::<14, u16>()? != 0b11111111111110 {����:7             return Err(FrameHeaderError::InvalidSync);�lħ
         }�ҧ��֧'$         if r.read_bit()? != false {����A>             return Err(FrameHeaderError::InvalidReservedBit);�l����Ψ��Ҩ41         let variable_block_size = r.read_bit()?;�������52         let block_size_bits = r.read::<4, u8>()?;�����ũ63         let sample_rate_bits = r.read::<4, u8>()?;�������85         let channel_assignment = r.read::<4, u8>()?;�������85         let sample_size = match r.read::<3, u8>()? {����41             0b000 => streaminfo.bits_per_sample,�ܫ�             0b001 => 8,��ǫ             0b010 => 12,���IF             0b011 => return Err(FrameHeaderError::InvalidSampleSize),�䮬             0b100 => 16,��ˬ             0b101 => 20,���             0b110 => 24,�䅭             0b111 => 32,����$!             _ => unreachable!(),�tǭ         };�֭��ڭ'�����A��lĮ��Ү��֮-*         let frame_number = read_utf8(r)?;����䈯         Ok(FrameHeader {����$!             variable_block_size,��ʯ30             block_size: match block_size_bits {����MJ                 0b0000 => return Err(FrameHeaderError::InvalidBlockSize),��̰"                 0b0001 => 192,���?<                 n @ 0b010..=0b0101 => 576 * (1 << (n - 2)),����63                 0b0110 => r.read::<8, u32>()? + 1,���74                 0b0111 => r.read::<16, u32>()? + 1,����@=                 n @ 0b1000..=0b1111 => 256 * (1 << (n - 8)),��߲(%                 _ => unreachable!(),����             },����52             sample_rate: match sample_rate_bits {��ѳ52                 0b0000 => streaminfo.sample_rate,����$!                 0b0001 => 88200,����%"                 0b0010 => 176400,��Ҵ%"                 0b0011 => 192000,����#                  0b0100 => 8000,����$!                 0b0101 => 16000,����$!                 0b0110 => 22050,���$!                 0b0111 => 24000,����$!                 0b1000 => 32000,����$!                 0b1001 => 44100,��ն$!                 0b1010 => 48000,����$!                 0b1011 => 96000,����96                 0b1100 => r.read::<8, u32>()? * 1000,��ٷ30                 0b1101 => r.read::<16, u32>()?,����85                 0b1110 => r.read::<16, u32>()? * 10,��ƸNK                 0b1111 => return Err(FrameHeaderError::InvalidSampleRate),����(��������ѹ#              channel_assignment,����             sample_size,�쒺             frame_number,����'$             crc8: r.read::<8, _>()?�tغ��L�ؓ,��������� #[derive(Debug)]�ܐ� enum FrameHeaderError {�ܬ�     Io(std::io::Error),��Ȼ     InvalidSync,��ݻ     InvalidReservedBit,����     InvalidSampleSize,�̔�     InvalidBlockSize,�Ԯ�     InvalidSampleRate,�,ɼ��ϼ��Ӽ41 impl From<std::io::Error> for FrameHeaderError {����.+     fn from(err: std::io::Error) -> Self {�̷�         Self::Io(err)�Lѽؓ,۽������QN fn read_utf8<R: BitRead + ?Sized>(r: &mut R) -> Result<u64, std::io::Error> {����?<     r.read::<8, _>()  // left unimplimented in this example�,����������ZW let mut reader = BitReader::endian(b"\xFF\xF8\xC9\x18\x00\xC2".as_slice(), BigEndian);�|ܿ����JG     reader.parse_with::<FrameHeader>(&Streaminfo::default()).unwrap(),����     FrameHeader {����'$         variable_block_size: false,����         block_size: 4096,����         sample_rate: 44100,����"         channel_assignment: 1,����         sample_size: 16,����         frame_number: 0,����         crc8: 0xC2,�L��ؓ4����<����������0- # Example with lifetime-contrained `Context`�������OL In some cases, the `Context` can depend on a reference to another `struct`.����<������������I������������� struct ModeParameters {����     size_len: u8,����     index_len: u8,���     index_delta_len: u8,�t��     // ...�,����������%" struct AuHeaderParseContext<'a> {����#      params: &'a ModeParameters,����      base_index: Option<u32>,�,����������#����� struct AuHeader {����     size: u32,����     index: u32,�t����	,����������1. impl<'a> FromBitStreamWith<'a> for AuHeader {����0-     type Context = AuHeaderParseContext<'a>;�������#      type Error = AuHeaderError;�������,����������+(         ctx: &AuHeaderParseContext<'a>,����(�����FC         let size = r.read_var::<u32>(ctx.params.size_len as u32)?;����.+         let index = match ctx.base_index {����HE             None => r.read_var::<u32>(ctx.params.index_len as u32)?,����%"             Some(base_index) => {����                 base_index����                 + 1����KH                 + r.read_var::<u32>(ctx.params.index_delta_len as u32)?����             }�t����������         Ok(AuHeader {����             size,����             index,����             // ...�t����L��ؓ,����������߈	ċ� enum AuHeaderError {�ܤ���	,����������1. impl From<std::io::Error> for AuHeaderError {����.ŋ	̫���	L��ؓ,����������RO let mut reader = BitReader::endian(b"\xFF\xEA\xFF\x10".as_slice(), BigEndian);�������&# let mode_params = ModeParameters {����     size_len: 10,����     index_len: 6,�܃�     index_delta_len: 2,�t����	4����������(% let mut ctx = AuHeaderParseContext {����     params: &mode_params,�̀�     base_index: None,�4����������?< let header1 = reader.parse_with::<AuHeader>(&ctx).unwrap();�|�������
     header1,����     AuHeader {����         size: 1023,����         index: 42,�L��ؓ4����������)& ctx.base_index = Some(header1.index);����|�������52     reader.parse_with::<AuHeader>(&ctx).unwrap(),������	���         size: 1020,����         index: 44,�L��ؓ4����<�����������������������!����������������	���ܩ	��	������\����		���������$! Some context to use when parsing�<����T�����7��,�����������1. Parse Self from reader with the given context�\��������	��������������������q�aX����	�����������	��O��	<����,��
������	������<��EG�����DA Implemented by complex types that consume some immutable context����&��������85 Like [`FromBitStreamWith`], but consumes its context����0- rather than taking a shared reference to it.�����������������!�����������l��а		�����\���		�d�����(% Some context to consume when parsing�<����T�����7��,�����������1ɪ	\������ذ	��������������������q�aX����	�������ϒ���<����,��
�����������<��8:ě����J�����?< to parse themselves from a reader.  Analagous to `FromStr`.�t���������������!���������\����		�T�����7��,�������kԇ���\��������������������������q�aX����	�������ϒ�����D����,��
���������68��� ���EB Implemented by complex types that require some additional context����?��	�������������������!���������������й	���ȹ	�	������\����		���������$٩	<����T�����7��,�������������\�������	�й	��������������������q�aX����	���������	�����	D����,��
������	������<��FH�����EB Implemented by complex types that consume some additional context����&��������:7 Like [`FromByteStreamWith`], but consumes the context.�����������������!�����������l����		�����\��Ϳ		�d�����$٩	<����T�����7��,�������������\��������	��������������������q�aX��տ	�������ϒ��ȷ	D����,��
�����������<��8:���q\��9�%��%������	���'����	������"���	��	��t��
���	�$���K,��eg���L��9M����l�5��<9 Traits and implementations for writing bits to a stream.�,�5����������������
���
�
���?���$�����<�����<�������[�������ŤD�����]L�����hl��
���c|��
���YT��	���P<�����T<�����\���������NL������t�����Wl�����U|�����QT�����@\���|����9��������<�~���qtbeSVDG58&)
���������������	1��IF For writing bit values to an underlying stream in a given endianness.�����B? Because this only writes whole bytes to the underlying stream,���DA it is important that output is byte-aligned before the bitstream��� writer's lifetime ends.���?< **Partial bytes will be lost** if the writer is disposed of���	 before they can be written.�L�	�'��	��������	���	���L�	��T�	��$��՚#�(����CEHJL�
4�
�����L�
,�
���L�
$�
�����<��������Rҹ��^=x����1�'��	�����	������	L���T�����������8:=?��(��>; Wraps a BitWriter around something that implements `Write`��������
������'4���7��
>��	����4���������
������'4���<�����63 Unwraps internal writer and disposes of BitWriter.���l�������-* Any unwritten partial bits are discarded.�\�������
�����$���*��9����1. to internal writer.  Otherwise returns `None`�4���������������������;t���������
�����$���6��>; Returns byte-aligned mutable reference to internal writer.�����5����d�������:��t�������������������������q�aX��������
�����$���0��@= Converts `BitWriter` to `ByteWriter` in the same endianness.���l�������+( Any written partial bits are discarded.�|�������
�����$���=��>; If stream is byte-aligned, provides temporary `ByteWriter`���5����l�������GD Any unwritten bits left over when `ByteWriter` is dropped are lost.�T���������������������;t������F��'���'���]�ކ(���������
�����$���)��0- Flushes output stream to disk, if necessary.���&# Any partial bytes are not flushed.���d�������74 Passes along any errors from the underlying stream.�,���������
�����$�����<9 A trait for anything that can write a variable number of���52 potentially un-aligned values to an output stream�D�������������!��������������������������������������������������������������������������������������*4��&# Writes a single bit to the stream.��� +Ȣ� �d� ��� ��� :���!�t�!�<�!����!74 use bitstream_io::{BitWriter, BitWrite, BigEndian};��!���"63 let mut w  = BitWriter::endian(vec![], BigEndian);���"'$ assert!(w.write_bit(true).is_ok());���"(% assert!(w.write_bit(false).is_ok());���#(��	��#(��	��#'��	��$'��	��$'��	��$(��	��%0- assert_eq!(w.into_writer(), &[0b1000_1110]);�<�%���%�<�%����%:7 use bitstream_io::{BitWriter, BitWrite, LittleEndian};��&���&96 let mut w  = BitWriter::endian(vec![], LittleEndian);���&(��	��''��	��''��	��''��	��((��	��((��	��)(��	��)'��	��)0��	<�*��L�*�������*�
���$�*bit��*����6a��+C@ Writes a signed or unsigned value to the stream using the given���+ const number of bits.��,�d�,���,���,:����,.+ Returns an error if the value is too large���-$! to fit the given number of bits.���-;����.#���.�t�.�<�.����.7��	�/���/5����/#  // writing unsigned value is ok���/)& assert!(w.write::<4, u8>(1).is_ok());���0! // writing signed value is ok���0*' assert!(w.write::<4, i8>(-1).is_ok());���0)& // writing an array of bits is ok too���1HE assert!(w.write::<1, [bool; 4]>([true, false, true, true]).is_ok());���11. // writing an array of any Integer type is ok���296 assert!(w.write::<2, [u8; 2]>([0b11, 0b00]).is_ok());���2GD // trying to write a value larger than 4 bits in 4 bits is an error���30- assert!(w.write::<4, u8>(u8::MAX).is_err());��3���3>; assert_eq!(w.into_writer(), &[0b0001_1111, 0b1011_11_00]);�<�4���4���4����47��	�5���55����5?< // trying to write 9 bits from a u8 is a compile-time error�ī6 w.write::<9, u8>(1);�<�6��,�6�����������
����6��|�6���6��<�7
������$�7�,�76$�668��A_��8C��	��8 number of bits.��8�d�8���9���9:����930 Returns an error if the input type is too small���9%" to hold the given number of bits.���:.��	��:$��	�;�t�;�<�;����;7��	�;���;5����<#��	��<-* assert!(w.write_var::<u8>(4, 1).is_ok());���=&# // writing signed value is also ok���=.+ assert!(w.write_var::<i8>(4, -1).is_ok());���=0- assert_eq!(w.into_writer(), &[0b0001_1111]);�<�>���>�<�>����>7��	�>���>5����?FC // writing a value larger than 4 bits in 4 bits is a runtime error���@41 assert!(w.write_var::<u8>(4, u8::MAX).is_err());���@74 // writing 9 bits from a u8 is also a runtime error���@.+ assert!(w.write_var::<u8>(9, 0).is_err());�<�A��L�A���������
���A����A��<�B
�����$�A�'$�A�,�A02��Rr��B:7 Writes an unsigned value to the stream using the given�̭C��	�C�d�C���C���C:����D.��	��D$��	��E;����E#���E�t�E�<�F����F74 use bitstream_io::{BigEndian, BitWriter, BitWrite};��F���F:7 let mut writer = BitWriter::endian(vec![], BigEndian);���G1. writer.write_unsigned::<1, u8>(0b1).unwrap();���G2/ writer.write_unsigned::<2, u8>(0b01).unwrap();���H52 writer.write_unsigned::<5, u8>(0b10111).unwrap();���H52 assert_eq!(writer.into_writer(), [0b1_01_10111]);�<�H���I�<�I����I:7 use bitstream_io::{LittleEndian, BitWriter, BitWrite};��I���I=: let mut writer = BitWriter::endian(vec![], LittleEndian);���J1��	��J2/ writer.write_unsigned::<2, u8>(0b11).unwrap();���K52 writer.write_unsigned::<5, u8>(0b10110).unwrap();���K52 assert_eq!(writer.into_writer(), [0b10110_11_1]);�<�L���L�ĘL����L7��	�L���L:��	��M?��	��M&# writer.write_unsigned::<9, u8>(1);�<�N���N�<�N����N use std::io::{Write, sink};���N7��	�O���O52 let mut w = BitWriter::endian(sink(), BigEndian);���ORO assert!(w.write_unsigned::<1, u8>(2).is_err());    // can't write   2 in 1 bit���PSP assert!(w.write_unsigned::<2, u8>(4).is_err());    // can't write   4 in 2 bits���QSP assert!(w.write_unsigned::<3, u8>(8).is_err());    // can't write   8 in 3 bits���QSP assert!(w.write_unsigned::<4, u8>(16).is_err());   // can't write  16 in 4 bits�<�R��t�R���������������S��|�R���S��|�S
������$�S�,�S6$�R68��ep��T:��	��T��	�T�d�T���U���U:����U3��	��V%��	��V.��	��V$��	�W�t�W�<�W����W7��	�W���W:��	��X52 writer.write_unsigned_var::<u8>(1, 0b1).unwrap();���X63 writer.write_unsigned_var::<u8>(2, 0b01).unwrap();���Y96 writer.write_unsigned_var::<u8>(5, 0b10111).unwrap();���Y5��
<�Z���Z�<�Z����Z use std::io::Write;���Z:�
�[���[=��
��[5܌
��\63 writer.write_unsigned_var::<u8>(2, 0b11).unwrap();���\96 writer.write_unsigned_var::<u8>(5, 0b10110).unwrap();���]5��
<�]���]�<�]����]�
��^7��	�^���^5��
��_WT assert!(w.write_unsigned_var::<u8>(9, 0).is_err());    // can't write  u8 in 9 bits���_XU assert!(w.write_unsigned_var::<u16>(17, 0).is_err());  // can't write u16 in 17 bits���`XU assert!(w.write_unsigned_var::<u32>(33, 0).is_err());  // can't write u32 in 33 bits���aXU assert!(w.write_unsigned_var::<u64>(65, 0).is_err());  // can't write u64 in 65 bits���bVS assert!(w.write_unsigned_var::<u8>(1, 2).is_err());    // can't write   2 in 1 bit���bWT assert!(w.write_unsigned_var::<u8>(2, 4).is_err());    // can't write   4 in 2 bits���cWT assert!(w.write_unsigned_var::<u8>(3, 8).is_err());    // can't write   8 in 3 bits���dWT assert!(w.write_unsigned_var::<u8>(4, 16).is_err());   // can't write  16 in 4 bits�<�d����e������������e����e��|�e
�����$�e�'$�e�,�e02��tn��f74 Writes a twos-complement signed value to the stream���g(% with the given const number of bits.��g�d�g���g���g:����h.��	��h$��	��h;����i0����i;����j#���j�t�j�<�j����j7��	�k���k:��	��k.+ writer.write_signed::<4, i8>(-5).unwrap();���l-* writer.write_signed::<4, i8>(7).unwrap();���l30 assert_eq!(writer.into_writer(), [0b10110111]);�<�m���m�<�m����m:�
�m���m=��
��n-��
��n.�
��o3Λ
<�o���o�<�o����o:�
�p���p=��
��pHE // writing a value too large for 4 bits in 4 bits is a runtime error���q<9 assert!(writer.write_signed::<4, i8>(i8::MAX).is_err());�<�r���r�ġr����r:�
�r���s=��
��s85 // writing 9 bits from an i8 is a compile-time error���t63 assert!(writer.write_signed::<9, i8>(1).is_err());�<�t��d�t���������������t��|�t���t��l�u
������$�t�,�t6$�t68��l��u7��
��v" with the given number of bits.��v�d�v���v���v:����w3��	��w%��	��x0����x0����y.��	��y$��	�y�t�y�<�y����z7��	�z���z:��	��{,) writer.write_signed_var(4, -5).unwrap();���{+( writer.write_signed_var(4, 7).unwrap();���{3Λ
<�|���|�<�|����|:�
�}���}=��
��}+��
��},�
��~3Λ
<�~����������������������l�
�����$��'$��,�02���]�Ȁ,) Writes the given bit count to the stream����.+ with the necessary maximum number of bits.�������?�����@= writes the bit count to the stream as a 4-bit unsigned value����+( which can be used in subsequent writes.������+( Note that `MAX` must be greater than 0.����=: Unlike the bit reader, the bit count need not be an exact���85 power of two when writing.  Any bits higher than the����*' bit count can reach are simply left 0.�ӄ�dۄ������9�����<�����ƅ7��	������5���Ć let count = 4;��ۆ&# w.write::<3, u32>(count).unwrap();����@���ˇ.+ w.write_var::<u8>(count, 0b1111).unwrap();���� w.byte_align().unwrap();����0- assert_eq!(w.into_writer(), &[0b100_11110]);�<Ԉ�����<�����A> use bitstream_io::{BigEndian, BitWriter, BitWrite, BitCount};�����‰5�����41 // a bit count of 4, with a maximum of 7 (0b111)����63 let count: BitCount<0b111> = BitCount::new::<4>();����" w.write_count(count).unwrap();����B? // maximum size of count is known to be 7 bits at compile-time��ދEB // so no need to check that 7 bits is larger than a u8 at runtime����96 w.write_counted::<0b111, u8>(count, 0b1111).unwrap();�����
���0��
<����ȍ�<Ѝ���܍A��
������5����41 // a bit count of 4, with a maximum of 6 (0b110)����63 let count: BitCount<0b110> = BitCount::new::<4>();��؏"�
���96 w.write_counted::<0b110, u8>(count, 0b1111).unwrap();�佐��
�ސ%" // bit count is written in 3 bits����.+ // while actual value is written in 4 bits����0��
<���\�����������
�������t��
����
$������������������ʕ85 Writes a signed or unsigned value to the stream with�쇖�����d����–��ʖ:�����.��	���$��	��t��<�������A> use bitstream_io::{BitWriter, BitWrite, BigEndian, BitCount};�Ҙ��ژ5�����<9 // writing 4 bits with a maximum of 8 will fit into a u8��ՙ74 // so we only need check the value fits into 4 bits����LI assert!(w.write_counted::<4, u8>(BitCount::new::<4>(), 0b1111).is_ok());���QN assert!(w.write_counted::<4, u8>(BitCount::new::<4>(), 0b1111 + 1).is_err());����B? // writing 4 bits with a maximum of 64 might not fit into a u8����(% // so need to verify this at runtime����MJ assert!(w.write_counted::<64, u8>(BitCount::new::<4>(), 0b0000).is_ok());����0- assert_eq!(w.into_writer(), &[0b1111_0000]);�<����l�����������
��
�������t��,����<��
����
��$��'$��,��D֝���������,) Writes a signed value to the stream with�칟��۟�d���������:�����.��	��$��	���t���<�������A��
������5���Ƣ<��
���7Ϲ
�ãUR assert!(w.write_unsigned_counted::<4, u8>(BitCount::new::<4>(), 0b1111).is_ok());����ZW assert!(w.write_unsigned_counted::<4, u8>(BitCount::new::<4>(), 0b1111 + 1).is_err());����B��
�å(��
��VS assert!(w.write_unsigned_counted::<64, u8>(BitCount::new::<4>(), 0b0000).is_ok());��˦0��
<������������������������|��������|��
������$ȧ�'$֧�,��D$��DF�ð����/, Writes an unsigned value to the stream with���������d����������:�����.��	���$��	Ӫ�t۪�<������A��
����ȫ5�����=: // writing 4 bits with a maximum of 8 will fit into an i8��Ĭ7Ϲ
���SP assert!(w.write_signed_counted::<4, i8>(BitCount::new::<4>(), 0b0111).is_ok());��حXU assert!(w.write_signed_counted::<4, i8>(BitCount::new::<4>(), 0b0111 + 1).is_err());����B? // writing 4 bits with a maximum of 64 might not fit into a i8����(��
���TQ assert!(w.write_signed_counted::<64, i8>(BitCount::new::<4>(), 0b0000).is_ok());����0- assert_eq!(w.into_writer(), &[0b0111_0000]);�<�����ư����Ћ�����
�������������t۰��������!��l���䕱
����
��Ћ$���'$���,��[�[]_a��N���63 Writes the given constant value to the stream with����������63 Due to current limitations of constant parameters,����$�ϳ�d׳������:�����?< A compile-time error occurs if the number of bits is larger���41 than 32 or if the value is too large too fit the�쬵 requested number of bits.�ε�tֵ���<������7��	������5�����2/ assert!(w.write_const::<4, 0b1000>().is_ok());����2/ assert!(w.write_const::<4, 0b1011>().is_ok());���0- assert_eq!(w.into_writer(), &[0b1000_1011]);�<�������IJ����ϸ7��	������5���͹FC // trying to write a 5 bit value in 4 bits is a compile-time error����" w.write_const::<4, 0b11111>();�<����˺��Ӻ����7��	������5����B? // trying to write a 33 bit value is also a compile-time error�쵼 w.write_const::<33, 1>();�<׼��\������������������|�������
�����$��+$��+,�������������W���74 Writes whole value to the stream whose size in bits���  is equal to its type's size.����d����������:�����t���<�������7��	������5�����85 assert!(w.write_from::<u32>(0x12_34_56_78).is_ok());����;8 assert_eq!(w.into_writer(), &[0x12, 0x34, 0x56, 0x78]);�<�������<�������7��	������5�����GD assert!(w.write_from::<[u8; 4]>([0x12, 0x34, 0x56, 0x78]).is_ok());����;��
<����T������֡��������������L��
���֡$���,��,.���t���7��
���96 is equal to its type's size in an endianness that may����.+ be different from the stream's endianness.����d����������:�����t���<�������EB use bitstream_io::{BitWriter, BitWrite, BigEndian, LittleEndian};�������5�����IF assert!(w.write_as_from::<LittleEndian, u32>(0x12_34_56_78).is_ok());����;8 assert_eq!(w.into_writer(), &[0x78, 0x56, 0x34, 0x12]);�<����l�����������	����������������˧T��ܧL��
�������$���,��BDFH���2���?< Pads the stream by writing 0 over the given number of bits.����d����������:�����l�������<�������7��	������5�����'��	��� assert!(w.pad(7).is_ok());����0- assert_eq!(w.into_writer(), &[0b1_0000000]);�<���������������
���$���'$������7���74 Writes the entirety of a byte buffer to the stream.����d����������:�����l�������<�������ʎ
���7��	���>; let mut writer = BitWriter::endian(Vec::new(), BigEndian);����)& writer.write_var(8, 0x66u8).unwrap();����)& writer.write_var(8, 0x6Fu8).unwrap();����)��
���(% writer.write_bytes(b"bar").unwrap();����0- assert_eq!(writer.into_writer(), b"foobar");�<����\���������������
���$���������ܕ�������������°1����O���>; Writes `value` number of non `STOP_BIT` bits to the stream����@= and then writes a `STOP_BIT`.  This field is variably-sized.���������d����������:7 Passes along any I/O error from the underyling stream.����t���<�������ʎ
���7��	���>��
���(% writer.write_unary::<0>(0).unwrap();����(% writer.write_unary::<0>(3).unwrap();����)& writer.write_unary::<0>(10).unwrap();����?< assert_eq!(writer.into_writer(), [0b01110111, 0b11111110]);�<�������<�������ʎ
���:�
���A> let mut writer = BitWriter::endian(Vec::new(), LittleEndian);����(��
���(��
���)��
���?< assert_eq!(writer.into_writer(), [0b11101110, 0b01111111]);�<�������<�������ʎ
���7��	���>��
���(% writer.write_unary::<1>(0).unwrap();����(% writer.write_unary::<1>(3).unwrap();����)& writer.write_unary::<1>(10).unwrap();����?< assert_eq!(writer.into_writer(), [0b10001000, 0b00000001]);�<�������<�������ʎ
���:�
���A��
���(��
���(��
���)��
���?< assert_eq!(writer.into_writer(), [0b00010001, 0b10000000]);�<����\���������
����������
����
$���,��%D�����������������Է�������E���DA Writes checked value that is known to fit a given number of bits�l����������j������������L��
�����$���,��46���F���" Builds and writes complex type�,������������������������������q�aX�����������������\��
�����$���-,��46�������/, Builds and writes complex type with context�T������������������������������������q�aX������������������������
������$���-,����<����QS�������52 Builds and writes complex type with owned context�\���������������������������������q�aX��������������������
�����$���-,����<��>@������:�����l����<��������
���7��	���:7 let mut writer = BitWriter::endian(sink(), BigEndian);����,) assert_eq!(writer.byte_aligned(), true);����&# writer.write_var(1, 0u8).unwrap();����-* assert_eq!(writer.byte_aligned(), false);����&# writer.write_var(7, 0u8).unwrap();����,��<����d����������
���$�����*���DA Pads the stream with 0 bits until it is aligned at a whole byte.����2�����d����������:��
���l����<�������ʎ
���7��	���>��
���&����! writer.byte_align().unwrap();����)& writer.write_var(8, 0xFFu8).unwrap();����30 assert_eq!(writer.into_writer(), [0x00, 0xFF]);�<����T�����������
���$�����o���KH Given a symbol, writes its representation to the output stream as bits.����HE Generates no output if the symbol isn't defined in the Huffman tree.����d����������:�����l����<�������7��	�݁*' use bitstream_io::define_huffman_tree;�������E��|ނ������̋���̩���ǃ��σ:��	���30 writer.write_huffman::<TreeName>('b').unwrap();��Ƅ30 writer.write_huffman::<TreeName>('c').unwrap();����30 writer.write_huffman::<TreeName>('d').unwrap();����52 assert_eq!(writer.into_writer(), [0b10_110_111]);�<����l�������� ���������������Ԇ
�����$���,��35���ܕ�����������������°���~���DA Writes a number using a variable using a variable width integer.����5��������nk Given a 4-bit VBR field, any 3-bit value (0 through 7) is encoded directly, with the high bit set to zero.����wt Values larger than N-1 bits emit their bits in a series of N-1 bit chunks, where all but the last set the high bit.����d��������Ɋ:�����l����<�������ʎ
�ʋ7��	���>��
�Ɍ+( writer.write_unsigned_vbr::<4,_>(7u32);����-* writer.write_unsigned_vbr::<4,_>(100u32);����A> assert_eq!(writer.into_writer(), [0b0111_1100, 0b1100_0001]);�<��������������������ǎ�Ā���������|��
������$̎�,ڎ;T��;=-�����������z���D���Ô5��������E���ϕ��������������d��������–:�����l����<�������ʎ
�×7��	���>��
�˜&# writer.write_signed_vbr::<4,_>(3);���(% writer.write_signed_vbr::<4,_>(-50);����A> assert_eq!(writer.into_writer(), [0b0110_1011, 0b1100_0001]);�<������������������
��������������l��
������$Ś�,Ӛ;T��;=���Y���DA Writes a signed or unsigned variable width integer to the stream�ߜ�d���������:�����lǝ��<ٝ����ʎ
���7��	���>��
���" writer.write_vbr::<4,_>(6u32);����$! writer.write_vbr::<4,_>(-50i32);��ПA��<����L�������������
�����Ā�����Ԡ��Tנ
������$��,�;Tà;=��!�ʡ85 Creates a "by reference" adaptor for this `BitWrite`�������30 The returned adapter also implements `BitWrite`��Ǣ'����l����<�������7��	գ��ݣ! fn build<W: BitWrite>(w: W) {����      // perform some building�,����������:��	���'$ // performing building by reference�ܥ� build(writer.by_ref());��ť,) // original owned writer still available����&# writer.write::<8, u8>(0).unwrap();����+( assert_eq!(writer.into_writer(), &[0]);�<Ѧ��4�����������
���$�����.8��'������������D���������������������������������������������������������������������������4L����������
�8��$����	���بa,ۨ����ɖ�����
��������|������<��
�8���ɖ$���,��@$�@B���N\�������������������|������
�8����$��6$��0,�����_L�����������
�����������<�
�8����$���'$���,��:<���rtĬ�����������������|Ӭ���ƞ|��
�8����$��,�@$٬@B���p�����������������������|�
�8����$���'$���,��:<�Ưndɯ������������������|֯���Σl��
�8�����$��,��@$ܯ@B���l�����������������������l�
�8����$���'$���,��:<�DzQ\ʲ���������
�����tֲ
�8���
$��,�*ܲ�߳�l�������ɖ���
��
�������t���,޴��<Դ
�8���
ɖ$���'$���,��I���������������ġ�������������|Ե���ƞ|ٶ
�8����$���'$���,��I$ڵIK�ɷ��̷����������
������������t����Ȧ���!Σl���䛸
�8���
���$���'$���,��`�`bdf��WT������������������ܧL��
�8����$���,��13���tl�����������	�����������������Tջ��L�
�8������$���,��GIKM�ļ.Ǽ������˼�
�8��$м�'$ּ���7\���������������
�8��$����ý���K\���������
����������
�8���
$ƾ�,̾*D�����El������j��j��Կ�����ƿ���Lɿ
�8����$ٿ�,߿9;���F,������������������������������q�aX����������������\��
�8����$���-,��9;����T�����������������������������������q�aX���������������������������
�8�����$���-,����<����VX���d����������
�8��$�����*T�����������
�8��$�����ol�������� ����������������
�8����$���,��8:������B? A compatibility trait for older code implementing [`BitWrite`]�������6�����߷���4��������:7 New code should prefer the regular [`BitWrite`] trait.����l����<�������,) use bitstream_io::BitWrite2 as BitWrite;����-* use bitstream_io::{BitWriter, BigEndian};���� let mut byte = vec![];����85 let mut writer = BitWriter::endian(byte, BigEndian);����+( writer.write::<u8>(4, 0b1111).unwrap();����/, writer.write_out::<4, u8>(0b0000).unwrap();����41 assert_eq!(writer.into_writer(), [0b1111_0000]);�<����L����������B�����!���������������������������������������������������������4���&��	���+Ȣ���d����������:��L�����������
���$����	�������[���C��	�����	���d����������:�����3��	���%��	���.��	���$��	,�����������
�����������<��
�����$���'$���,��57���e���C��	�����	���d����������:�����.��	���$��	���;�����#��L�������������
�������|��������<��
������$���,��;$��;=���l���:��	�����	���d����������:�����3��	���%��	���.��	���$��	t����������������������|��
�����$���'$���,��57���v���:��	̱���	���d����������:�����.��	���$��	���;�����#�����������������������|��������|��
������$���,��;$��;=���h���7��
���"�
���d����������:�����3��	���%��	���0�����0�����.��	���$��	d����������������������l��
�����$���'$���,��57���r���7��
���(�
���d����������:�����.��	���$��	���;�����0�����;�����#�����������������������|��������l��
������$���,��;$��;=���W���7��
��� ��
���d����������:��T������֡��������������L��
���֡$���,��,.���t���7��
���9��
���.��
���d����������:��l�����������	����������������˧T��ܧL��
�������$���,��BDFH���2���?��
���d����������:�������������
���$���'$������7���7��
���d����������:�����l�������<�������ʎ
���7��	���>��
���)��
���)��
���)��
���(��
���0��
<����\���������������
���$���������ܕ��������������
°=����9���1. Writes `value` number of 1 bits to the stream����;8 and then writes a 0 bit.  This field is variably-sized.����d����������:��
d�����������
���$���,�����9���1. Writes `value` number of 0 bits to the stream����;8 and then writes a 1 bit.  This field is variably-sized.����d����������:��
d�����������
���$���,�����h���"��
,������������
�������������
\�����D��
�����$���-,��=?�������/��
T��������������
��
���������������
�����D��
������$���-,����<����LN������:��d����������
���$�����*���D�����2��̀�dԀ������:��
���l����<Ɓ���ҁʎ
��7��	���>��
��&����!����)����3ʈ<����T�����������
���$Ä���o�ʅK�����HŊ��d���������:��LJ�lχ��<�����ʎ
���85 use bitstream_io::{BigEndian, BitWriter, BitWrite2};��ƈ*�����E�����>��
���3�����3׍��3�����5ю<���l����������������������Ȍ
�����$���,��,.���ܕ����������������°���!�'����	�����D����������������������������������������������������֍4Lٍ��������
���$���	��͎[,Ў���������
��َ���֎��<��
�����$ގ�'$��,�57���eL�������������
�������|��������<Ԑ
������$���,��;$��;=���lt����������������������|��
�����$Ƒ�'$̑�,ב57���v���������������������|��������|ۓ
������$���,��;$��;=�Ĕhdǔ�����������ה���Ԕ��l��
�����$ܔ�'$��,�57���r���������������������|��������l�
������$���,��;$��;=�ЗWTӗ����֡���������ޗ��L��
���֡$��,�,.��tl�����������	����������������˧TęܧLۙ
�������$���,��BDFH���.�����������
���$ƚ�'$̚���7\���������������
���$���������8d�����������
���$���,�������8d�����������
���$���,��؞���d����������
���$�����*T�����������
���$����>�'��	�����	�������	L���T������������������������
�����������������4L�����������
�����$����	�����rt���������������Ѣ���|����΢ƞ|��
�������$֢�,ܢ?$â?A���������ġ��������������|������ƞ|��
�������$���,���,ЦH$��HJ����������8���������8���������|�������������"Σl�������츪
����������$���'$���,ߪt$��tvoq��ܕ�����������������������������nd���������������������|������Σl�
��������$���,��?$��?A��WT�����������������ܧL��
�������$���,��02$����tl�����������	�����������������Tٴ��L�
���������$���,��FHJLw��ɶEl̶��������j������ڶ��Lݶ
�������$���,�02���7\���������������
�����$������ʟ���d����������
�����$���� ����_����4����������^�^��^��[�^���[����e�S��ޝ����
�$��������&�����#������Ӽ'$ּ������
����M���C@ A common trait for integer types for performing math operations���! which may check for overflow.�<������,�����<�����D�����d�����t�����f��[��M��?��1�����y��k��]��O������������F���FC add rhs to self, returning `Overflowed` if the result is too large������������������������������q�aX������
���$��rhs������<���KH multiply self by rhs, returning `Overflowed` if the result is too large�\��������������������������q�aX������
���$������������B? returns `true` if the number if bits written is divisible by 8�d����������
���$�����t����������,��8t���&��8���*������8$��8�9<��8
��,��8��������8��8�:���������8��8$��$��8����&��8$��(��8�4��������$��8�yT��������
��8$������,��8������'��8�^\������
��8$��$��8���� ��8ok_or�,������8�yT��-��%��8�����������8��8�:\������8$��$��8����&��8$��(��8�4����8$��$��8�yT��������
��,��8������'��8�:\������8$��$��8���� ��8ݬ,������8�yT��8��8�d��������8$��(��8�$������8$����7�����7���%�����������������<�����������'$ Creates new empty BitsWritten value�������
����������������$�����Լ����" Returns number of bits written�<������������
���$���������������������"��d��������
���$�����,����������<������������������������������
������������������5L�����������
���$��_bit�$�����N\������������������|�������
�����$��+$��+,��������������ܕ����������������������rt��������������������|��������|��
������$���,��;$��;=������������ܕ��������������������nd��������������������|��������l��
������$���,��;$��;=֦�������������������������
����������t��������|��
����
��$���,��<��<>���ܕ�������������
���������������Ћ�����
�������������t�����������!��l�������
����
��Ћ$���'$���,��[��[]_a���ܕ�������������
��ЋЋ��������ST������֡��������������L��
���֡$����+-���ܕ������������֡��������pl�����������	����������������˧T��ܧL��
�������$����ACEG���ܕ���������������������.�����������
���$���'$�����ܕ�����������������7\���������������
���$���������ܕ�����������������K\���������
����������
����
$���,��%D�������������ܕ�������������
�����El����������j�����������
L��
�����$���,��,.���ܕ�������������������d����������
���$���ك0���	�����ރ���β<���T����')+-������ Creates new counter�������
������օ-���	�����ۅ�����$ޅ��T����')+-Կ����"��<Ɔ�������Ά�
�����$φ���'���	�������������T����� "$����ć"��d��������
�����$���وQ���	�����ވ�����T���<�����������������������������������������������4L‰������̉�
�����$щ��	׉���N\Ê����������������|ϊĭ���
�������$��/$Պ/,���rt�������������������|������ƞ|Ɍ
�������$���,��?$��?A���nd���������������������|̍��ݍΣl��
��������$��,�?$ҍ?A�����������������
���������t������ƞ|��
������
�$Ə�,ԏ�,�H��HJ�����������������
��������ޑ��t‘��ґȦ���!Σlْ����
������
���$��'$��,��_ȑ_ace�ՓWTؓ����������������ܧL��
�������$��,�02���tl�����������	�����������������Tӕ��L�
���������$���,��FHJL�Ӗ.֖������ږ�
�����$ߖ�'$��ɗ7\̗����������ؗ�
�����$ݗ������K\Ę�������
�������И
������
$��,�)D֘��d���������
�����$���ؚdܚ������?����������������������������[�����������]�������h���
����c���
����Y���	����P�������T���������������������N�������W�������U�������Q�������'������(������2@N����9%����@����FT������FT������GL������I\������J|������J�ӭ����Kd�����K������L�������yTݺ����y����z\������{T��
���{����
���|L���
��Ť��������������,����(���EB For recording writes in order to play them back on another writer�l̛��<ޛ����ʎ
���DA use bitstream_io::{BigEndian, BitWriter, BitWrite, BitRecorder};��ϜGD let mut recorder: BitRecorder<u32, BigEndian> = BitRecorder::new();����*' recorder.write_var(1, 0b1u8).unwrap();��ʝ+( recorder.write_var(2, 0b01u8).unwrap();����.+ recorder.write_var(5, 0b10111u8).unwrap();����&# assert_eq!(recorder.written(), 8);��؞>��
���#  recorder.playback(&mut writer);��ß3Λ
<����\�����	�������������T���������a���2468캠4��������'��'������'���'�$��՚#�(������<��������Rҹ��^=x�����1���	������������<����T�����������9;=?������ Creates new recorder�������
��������*���<9 Creates new recorder sized for the given number of bytes�l������
������K,����� �ȥ2/ Creates new recorder with the given endianness�4��������
������4��ԗ��ا"�����d��	 # Panics�������+( Panics if the number of bits written is���:7 larger than the maximum supported by the counter type.����<9 Use [`BitRecorder::written_checked`] for a non-panicking���
 alternative.�<������������
�����$�����6��"�����d��������˫<9 Returns an error if the number of bits written overflows���� our counter type.�|Ǭ������������������������q�aX�����׬�
�����$ج֭�ܕ������������������ܕ������������������E���-* Plays recorded writes to the given writer�D��������'���'��������
����
D��
������
$���'4��8:����ڱ(% Clears recorder, removing all values�,����������
�����$�����=���	������������<����T�������/135�Դ<״����
��������^���	�������������T׵�<������������������������������������������������������������������������4L�����������
�����$����	�����i,������ɖ�����
���Ƿ���|����ķ��<��
������ɖ$̷�,ҷ?$��?A���N\�������������������|��ĭ���
�������$��/$��/,�����gL�����������
�����������<��
�������$ú�'$ɺ�,Ժ9;���zt��������������������|������ƞ|޼
�������$���,��?$��?A��x����������������������|Ͼ
�������$���'$���,��9;�ǿvdʿ������������������|׿���Σl��
��������$��,��?$ݿ?A���t�����������������������l��
�������$���'$���,��9;���Q\�����������
������t��
������
$���,��)������l��������ɖ���
��
�������t����,����<��
������
ɖ$���'$���,��H���������������ġ��������������|������ƞ|��
�������$���'$���,��H$��HJ�����������������
������������t������Ȧ���!Σl�����
������
���$���'$���,��_��_ace���_T��������������������ܧL��
�������$���,��02����l�����������	�����������������T����L��
���������$���,��FHJL���.�����������
�����$���'$�����7\���������������
�����$���������K\���������
����������
������
$���,��)D�����F,������������������������\��
�������$���-,��02����T�����������������������������������
��������$���-,����<����GI���d����������
�����$�����*T�����������
�����$�����wl������������������������
�������$���,��02���E���	����������������T���<����$����T�����EGIK�������96 Returns shortest option between ourself and candidate�������<9 Executes fallible closure on emptied candidate recorder,����63 compares the lengths of ourself and the candidate,����'$ and returns the shorter of the two.�������85 If the new candidate is shorter, we swap ourself and����96 the candidate so any recorder capacity can be reused.����l�������<�������96 use bitstream_io::{BitRecorder, BitWrite, BigEndian};�������74 let mut best = BitRecorder::<u8, BigEndian>::new();����+( let mut candidate = BitRecorder::new();�������41 // write an 8 bit value to our initial candidate�ܧ� best.write::<8, u8>(0);����" assert_eq!(best.written(), 8);�������0- // try another candidate which writes 4 bits����*' best = best.best(&mut candidate, |w| {����     w.write::<4, u8>(0)����
 }).unwrap();�������+( // which becomes our new best candidate����" assert_eq!(best.written(), 4);�������+( // finally, try a not-so-best candidate���� // which writes 10 bits����*ҭ
��     w.write::<10, u16>(0)������
������+( // so our best candidate remains 4 bits����"��
<����$���������E��������������������q�aX������	��E������������ٲ
���'��ٲ
������"�ٲ
��
���������������������q�aX��l��
�������ٲ
$��	candidate�L������������Su$�����'����	����	L��
����'4��byte�$��-/���2���IF For writing aligned bytes to a stream of bytes in a given endianness.�������DA This only writes aligned values and maintains no internal state.��%�'��	�����	��������	L����T������]�ކ(���;=?A���<�������	L��4����������2�'��	�����	��������	L����T����������68:<���)���?< Wraps a ByteWriter around something that implements `Write`���������
������'4�����8���>��	�����4����������
������'4����<��������96 Unwraps internal writer and disposes of `ByteWriter`.����-��	\��������
�����$�����"���2/ Provides mutable reference to internal writer.�4�������������
�����$�����.���@= Converts `ByteWriter` to `BitWriter` in the same endianness.�t��������
�����$�����3���:7 Provides temporary `BitWriter` in the same endianness.����l����������FC Any unwritten bits left over when `BitWriter` is dropped are lost.�L���������'��'������'���'�$��՚#�(���������
�����$��������JG A trait for anything that can write aligned values to an output stream�w+�������������!���������������������������R���(% Writes whole numeric value to stream����d����������:��t���<�������ʎ
���96 use bitstream_io::{BigEndian, ByteWriter, ByteWrite};����?< let mut writer = ByteWriter::endian(Vec::new(), BigEndian);����1. writer.write(0b0000000011111111u16).unwrap();����?< assert_eq!(writer.into_writer(), [0b00000000, 0b11111111]);�<�������<�������ʎ
���<9 use bitstream_io::{LittleEndian, ByteWriter, ByteWrite};����B? let mut writer = ByteWriter::endian(Vec::new(), LittleEndian);����1��
���?< assert_eq!(writer.into_writer(), [0b11111111, 0b00000000]);�<����,������֡��������������L��
���֡$���,��,.��o���NK Writes whole numeric value to stream in a potentially different endianness����d����������:�����t���<�������ʎ
���GD use bitstream_io::{BigEndian, ByteWriter, ByteWrite, LittleEndian};����?��
��FC writer.write_as::<LittleEndian, u16>(0b0000000011111111).unwrap();����?��
<�������<�������ʎ
���G��
���B��
�ЃC@ writer.write_as::<BigEndian, u16>(0b0000000011111111).unwrap();����?��
<܄��D����������	���������������˧T��ܧLͅ
�������$���,��BDFH���8�݅7��
���d����������:��\���������������
���$�������܈0���@= Pads the stream by writing 0 over the given number of bytes.����d����������:��߈��������
���$��K,����G���"��
,������������������������������q�aX�������Ӊ���‰���dʼn
�����$؉�-,މ46�������/��
T�����������������������������������q�aX�����������������������
������$���-,����<���QS�܌����5��
\ߌ�������������������������������q�aX������������������
�����$���-,����<��>@�Ύ/���2/ Returns mutable reference to underlying writer�Tю��������܎�
���$����@�'��	�����	��������	L����T�������������������[]_a�֏R,ُ���������������ߏܧL��
�������$��,�02���oD�����������	�����������������Tۑ��L�
���������$���,��FHJL��3���������
�����$��K,���������7\���������������
�����$���������.T�������������
�����$������̖J�����#  to build themselves to a writer����l����<͗���՗����DA use bitstream_io::{BigEndian, BitWrite, BitWriter, ToBitStream};�������#���٘�����������Ĥ���,����Ù��Ǚ&# impl ToBitStream for BlockHeader {���$��������UR     fn to_writer<W: BitWrite + ?Sized>(&self, w: &mut W) -> std::io::Result<()> {���*'         w.write_bit(self.last_block)?;����.+         w.write::<7, _>(self.block_type)?;��Ǜ-*         w.write::<24, _>(self.block_size)�L��ؓ,�������� let mut data = Vec::new();����=: let mut writer = BitWriter::endian(&mut data, BigEndian);���^[ writer.build(&BlockHeader { last_block: false, block_type: 4, block_size: 122 }).unwrap();��ŝ*' assert_eq!(data, b"\x04\x00\x00\x7A");�<����?�������������!�������������\ў��
	���Tў���85 Error generated during building, such as `io::Error`�,֞�����n�� Generate self to writer�L������������������������������q�aX��
��'����������D����,�
�����$��w���68���S���/, Returns length of self in bits, if possible�$��������������������������q�aX����
�j������������<����,��
�����$��46���f���-* Returns total length of self, if possible�4.0.0�use of bits() is preferred����CD����
��
������
�j��	����������������
<���	��T����,�
�������$��JLNP쀥���@= Implemented by complex types that require additional context��ܤ#��
CD����������������!�����������������ͥ��
�ۥ��
��
������\����
	������ͥ���$! Some context to use when writing�<ҥ��T����8��
,�����Ҧ�ܲ���
Lզ��������
���
��������������������q�aX��
��'��������
ߦ��
D���,�
�����
$����
����<��FH���l���/��
$����������
��������������������q�aX����
�j��ƨ��������<����,��
������$Ǩ��<ͨDF������-��
��
use of len() is preferred���BD����
��
��������
��
�j��	�������ƫ��ҫ��
<ɫ�	�Tի��,��
�������$���<�Z\^`�ɭ��@= Implemented by complex types that consume additional context����#��
oI�����ɭ������!�������������l����	�����\�ˁ	��d����(% Some context to consume when writing�<����T����8��
,������������
L��������������������������������q�aXӁ��'��į������D����,��
�����$ů��
ӯ��<�@B���k�ð/��
$����������������������������q�aX��Ӂ�j�����������
<����,ܱ
�����$����<��68�����J�����#��
�L������������!�����������\����	��T�����8��
,ô����o�ϴ��
L�����������������������������q�aX����'�����������L����,ص
�����$����
��>@���T��0- Returns length of self in bytes, if possible�,��������������������������q�aX�����j�����������
<����,�
�����$��,.�ڸ���@��
���#��
�O��������ڸ������!��������������������������������\��Ȏ	����������$��
<����T�����8��
,��������܍���
L����������
�����������������������q�aXЎ��'��ں���
����
L����,λ
�����
$ۺ��
���<��NP���m�ڻ0��,������������������������������q�aX��Ў�j�����������
<����,��
������$����<��<>�����@��
�ξ#��
S������������!�������������l����	�����\����	��d�����(��<ƿ��T���Կ8��
,��������ܢ���
L��������������������������������q�aX•��'����������L����,��
�����$����
����<��@B���l���0��,����������������������������q�aX��•�j�����������
<����,��
�����$����<��68���3j�����������<����������02���4,������������������������������q�aX������
���$���������ܕ��������������������%,�����������
���$�����+j��������<�������������������IK���>,������֡��������������L��
���֡$��_value�4��24���ܕ������������֡ߝ���PD�����������	����������������˧T��ܧL��
�������$��՟4��CEGI���ܕ����������������ߝ���7\���������������
���$���������ܕ������������ߝ���/�����������
���$���K,�����ܕ��������������������.T�������������
���$����5���!!33EEWWii{{��������7���7�������!!33EEWWii{{������9���:��9QN A trait intended for simple fixed-length primitives (such as ints and floats)���::7 which allows them to be read and written to streams of���:$! different endiannesses verbatim.�L�:������:������ �������������������;&�����\�;�����\�;��1Ŭ"٬�������;%��;41 The raw byte representation of this numeric type�,�;��ܠ<��;'$ An empty buffer of this type's size�4�<����
�����<$��<! Our value in big-endian bytes�\�<������
���$�<��=$��=$! Our value in little-endian bytes�\�=������
���$�=��>-��=)& Convert big-endian bytes to our value�l�>������
����K,�>��>-��>,) Convert little-endian bytes to our value�l�>������
����K,�?��?%Ĵ?�?�E�?�?,�?8���?&�?8��?*�?�?�E8$�?8�NL�?8
�?,�?8���?�?�E38!$�@8�O,�@�@�@�@8��@%�@8���@'�@8�<�@'�@�@,�@8���@�@�@�@%�@+�@�@�@8�4�@�@�@8�4�@8�@8�O4�@�@�@(�@8$�@'�@8�O,�@�@�A�A�A7��A%�A8���A'�A8�<�A'�A�A,�A8���A�A�A�A+�A�A�A8�4�A�A�A8�4�A8�A8�O\�A�A�A8$�A(�A8$�A'�A8�O,�A�B�B8$�B �B8�O\�B�B�B+�B�B�B8�4�B�B�B8�4�B8�B8�O\�B�B�B8$�B(�B8$�B'�B8�O,�B�C�C8$�C �C8�O\�C�C�C+�C�C�C8�4�C�C�C8�4�C8�C8�Ol�C�C�D8�K,�C&�C8$�C'�C8�O,�C(�D8$�D�D�D�D,�D8���D�D'�D8�Ol�D�D�D8�K,�D+�D�D�D8�4�D�D�D8�4�D8�D8�Ol�D�E�E8�K,�E&�E8$�E'�E8�O,�E(�E8$�E�E�E�E,�E8���E�E'�E8�Ol�E�E�E8�K,�E%�E��E*����t�E�������������������F�ET�F,�F������F4�F�����
����G#\�G�����
��$�G��G#\�G�����
��$�H��H,l�H�����
���K,�H��I,l�I�����
���K,�I��K��I@= This trait is for integer types which can be read or written���J0- to a bit stream as a partial amount of bits.��J���J>; It unifies signed and unsigned integer types by delegating���K74 reads and writes to the signed and unsigned reading���K'$ and writing methods as appropriate.�<�L������K������ ��������������Np��L,) Reads a value of ourself from the stream���L"�
�L�d�L���M���M:����M;���N is larger than our type.�$�N����	��������������������q�aX������������N��|�N��	�Nȭ	<�N��,�O
������	�4�N7$�N79��Q���O,����O"�
�O�d�P���P���P:����P2/ Also returns an error if our type is too small���Q)��D�Q����	������
������Q���t�Q��	�Qȭ	<�R��,�R
����
��	�4�Q�'$�Q?�Q?A��UX��RFC Writes ourself to the stream using the given const number of bits.��S�d�S���S���S:����T.+ Returns an error if our value is too large���T$��	��T;���U��,�U�����
�����'����V��|�U��
�U��
D�U
�����
$�U�'4�U6$�U68��Y���V@= Writes ourself to the stream using the given number of bits.��V�d�V���W���W:����W.+ Returns an error if our value is too small���W%��	��X.����X$��	L�Y�����
�����
��'����Y���t�Y��
�Y��
D�Y
����
�
$�Y�'4�Y�'$�Y>�Y>@�\��Z@����Z/, to a bit stream as variable-width integers.��[���[>����[>; reads and write to the signed and unsigned vbr reading and���\#  writing methods as appropriate.�T�\������\����<�\���*����6��*��������]���\LI Reads a value of ourself from the stream using a variable width integer.��]�d�]���]���]:��D�^����	����������^�Ā��^��	�^ȭ	<�^��,�^
������	�4�^7T�^79��`y��_@= Writes ourself to the stream using a variable width integer.��_�d�_���_���_:��L�`�����
�����'����a���`��
�`��
D�`
�����
$�`�'4�a6T�`68��g��aRO Reading and writing booleans as `Integer` requires the number of bits to be 1.��a���bA> This is more useful when combined with the fixed array target���b$! for reading blocks of bit flags.��b�l�b��<�b����c6���c���c#����c struct Flags {���c
     a: bool,���d
     b: bool,���d
     c: bool,���d
     d: bool,�,�d���d���d%" let data: &[u8] = &[0b1011_0000];���d3����e1. // note the number of bits must be 1 per read���eC@ // while the quantity of flags is indicated by the array length���f[X let flags = r.read::<1, [bool; 4]>().map(|[a, b, c, d]| Flags { a, b, c, d }).unwrap();���fEB assert_eq!(flags, Flags { a: true, b: false, c: true, d: true });�<�g����������������gp$�g��������������h��|�gϒ�h�<�h��,�h
�����4�h:$�g:<�����������i�D�i����������
������j��
t�iϒ�j�<�j��,�k
��
���4�j4�i46��mW,�m���������'����m���|�m��m��D�m
����$�m�'4�m2$�m24�����������o�L�o���������
��'����o���t�o��o��D�o
��
��$�o�'4�o3�o35��rJ���
�������r���r��<�r���$�r���<�r��������������d$�rdf��rp$�r�����������������������q�aX������������s���|�r�����sO��<�s����,�s
��������4�sV$�rMO�t�ܕ�����������������������u�D�u����������
������u��t�u���u��<�v��,�v
�����
���4�u�,�uE�uEG�w�ܕ��������������
����������xW,�x�����'�����'����x���|�x�����x���D�x
�������$�x�'4�xM$�xDF�y�ܕ�����������������������y�L�y�����������
��'����z��t�z���z��D�z
�����
��$�z�'4�z�,�zD�zDF�{�ܕ��������������
����������{P���
�������{���|���T�|��$�|��<�|��������F$�{FH��|�D�|��������������|����|���|��<�}��,�}
��������4�|=T�|=?�~�ܕ��������������������4�~�ܕ����������������������xL������������'���������������D�
�������$��'4��=T�=?߀�ܕ���������������������‚����KH This trait extends many common integer types (both unsigned and signed)���74 with a few trivial methods so that they can be used����'$ with the bitstream handling traits.�<̂����,����Lق���$����<���_��,�������T�������������l������tɃ�����ރ������l�����t�������đ���������l��������|���������Ƅ��������lӄ����������������l����������Ϻ����ܡ�����Ѻ��l������Å�����lDž������܅�������l����(������������������������������������p��a��O��@��.���������������������������������������������~��p��_��Q��B��0��!������������������������������y������������������ Size of type in bits�L�����׆��� The value of 0 in this type�$݆����|���� The value of 1 in this type��������҇���%" Returns a `u8` value in this type�<Շ����
���u�݇�����@= Assuming 0 <= value < 256, returns this value as a `u8` type�,������
���$���Јt݈������,�8���&��8���*������
8�Oć�	������,��8����%��8$��8�T<��8
��,��8����É��18,щ8�TL׉&��8���8���'�8�<�'���,��8����������8��8���
��7���%��8,��8�U$��&��8$����7���%��8,��8�U��&Š8$ĊɊ7�ˊ%̊+ۊ܊�8�4݊��8�4�8��8�U<������8����&��8���(��8$������8����8��,��8����+Njȋ׋8�4ɋϋ֋8�4Ћ8�8�U,���8$�(�8�������8$��8��8���%�����"���96 This trait extends many common unsigned integer types���@= so that they can be used with the bitstream handling traits.�|�������������<ύ���,���8�+����������������������������ď,�Տ�яՏ���|ߏ͏/�#�������������ݍ$! This type's most-significant bit�<�������ʎ���%" This type's least significant bit�<Ў����|���� This type with all bits set��������ď+���! The signed variant of ourself�4ɏ���ߒ)���" Given a twos-complement value,����63 return this value is a non-negative signed number.��ؐC@ The location of the sign bit depends on the stream's endianness����$! and is not stored in the result.�ɑ�lё��<�����&# use bitstream_io::UnsignedInteger;����41 assert_eq!(0b00000001u8.as_non_negative(), 1i8);�<Ӓ��|���Տ��
���$����0���EB Given a two-complement positive value and certain number of bits,��ؓ30 returns this value as a negative signed number.����Cݒ�ؔ$�����l����<�������&���ҕ2/ assert_eq!(0b01111111u8.as_negative(8), -1i8);�<����\����Տ��
���$���'$����<�˖E�����,) returns this value as a negative number.�Ɨ�lΗ��<������&�����<9 assert_eq!(0b01111111u8.as_negative_fixed::<8>(), -1i8);�<ؘ������Տ������|��
����$��$�����/��� Checked shift left�\�����������������;t�������
���$Й��֙���/��� Checked shift right�\��������
���$���������&�ǚ'$ Shift left up to our length in bits������52 If rhs equals our length in bits, returns default�\��������
���$ě��ʛ���&���'��ɜ��ќ2/ If rhs equals our length in bits, returns zero�\��������
���$��������$�����������	,��8����&��8���$��,��8���&��8���*������^8�Ut��	ÞĞǞ,Ş8��ƞ%Ȟ8$Ӟ8�U|؞8
�,�8�����\8!$��8�V4����,��8���%��8,��8�U<��&��8$����7�������˟8$��'��8�TL��ȟ7�ʟ%̟8,۟8�U<�&�8$��7��%�8,��8�V��&��8$������,��8������'��8�
��%��+������8�4������8�4��8ɠ8�V|̠۠�8$ܠ(�8$�'�8�V4����8$��8��,��8���+������8�4������8�4��8ǡ8�V\ʡա�8$֡$ڡ8�'$ܡ&�8��(�8$�'�8�V4���������8$��8��,��8�����������7���������8�'$����7���+ŢƢբ8�4Ǣ͢Ԣ8�4΢8�8�V����8,��8�$��&��8���������8$��(��8$��'��8�V4����ߣ����8$��8��,��8�������ѣ��7�£ģǣУ8�$ȣͣ7�ϣ+�����8�4�����8�4��8��8�V\������8$��$��8����&��8���(��8�4����8$�������8$̤ Ф8�V\Ѥܤ�8��ݤ+������8�4������8�4��8��8�V\������8$��$��8����&��8���(��8�4��¥8$åǥɥ��8$ۥ ߥ8�V\���8���8$��8�P<�8
��,��8������ѱt+������8�4������8�4��8��8�$����8,��8�$��&��8���$ĩ8�Ʃ&ǩ8�<ɩѩ-ө8�,ԩ٩ک�8�4۩&��8�8��(�8��'�8�4���8$����8$,��8$��&��8�,��$������
8�4̪ Ҫ8�
lӪ'��8�$�$�8����+������8�4������8�4��8��8�
D����8,��8�
��&��8���$��8�ëīū�8�4ƫ&̫Ϋ8ϫ8�ӫ$ԫ8�'$֫&ګ8ŤDܫ�8�
��(�8��'�8�4���8$����8$,��8���&��8�<����-��8�,��$��8$Ƭ&ʬ8�,̬$Ѭ߬��
8�4� ��8����'����8�
��$��8��������8�'$��+����ɭ8�4����ȭ8�4­8׭8�&,ڭ߭8,�8�$�&�8��$�8�'�&�8�(D����-��8�,������ʮ8$��$��8�'4��&����8��8�'��$��(̮8�Ϯ'Ѯ8�4Ӯٮڮۮܮޮ��
8�'4� ��8�)t��'����8�$��$��8��������8$��+����¯8�4������8�4��8Я8�)Lӯܯ8,ݯ8�
�&�8��$�8�'��&�8�(D���-��8�,�������8$��$��8�'4��&����8��8�'��$��8�'$ʰ&ΰ8ŤDаذ8�
ٰܰ$ݰ(��8��'�8�4������������DZ8�'4�� ��8�+�������8�'$��$��8$��8$ܱ8�QT�8
�,�8������;+������8�4������8�4��8��8�D����8,��8�T��&��8���$��8�²òIJӲ8�4Ų&˲Ͳ8β8�Ҳ(ղ8�ز'ڲ8�4ܲ�8$��8$,��8���&��8�<����-��8�,��$��8$��&��8�,��$��ɳ��
8�4۳ �8���'���8�T��$��8��������+������8�4������8�4��8��8�/Lô̴8,ʹ8�TӴ&ݴ8�ߴ$�8�'�&�8�(D��-�8�,�������8$��$��8�'4��&����8��8�'��$��(��8�µ'ĵ8�4Ƶ̵͵εϵѵ��
8�'4� �8�.��'����8�T��$��8��������8$��<2 Unsigned NonZero types increment their value by 1����5<& when being read and decrement it by 1���)< when being written.����<�ŷ<�tѷ<��<�<�����6< use core::num::NonZero;�ܷ�<�۸<" let data: &[u8] = &[0b001_00000];���%<+ // reading a regular u8 in 3 bits yields 1����.<L assert_eq!(BitReader::endian(data, BigEndian).read::<3, u8>().unwrap(), 1);��̹O<= // reading a NonZero<u8> in 3 bits of the same data yields 2����@<[ assert_eq!(BitReader::endian(data, BigEndian).read::<3, NonZero<u8>>().unwrap().get(), 2);����^<��<Ի<��<��<�<��	���7<�����<��<����5<' // writing 1 as a regular u8 in 3 bits����*< w.write::<3, u8>(1).unwrap();���!< w.byte_align();����<- assert_eq!(w.into_writer(), &[0b001_00000]);����0<��<����5<( // writing 1 as a NonZero<u8> in 3 bits����+<> w.write::<3, NonZero<u8>>(NonZero::new(1).unwrap()).unwrap();��޿A<�����<- assert_eq!(w.into_writer(), &[0b000_00000]);����0<��<��8$��8�P<��8
��8�<����,��8����������t+������8�4��8��8�$����8,��8�$��&��8���$��8���&��8�<����-��8�,��������8�4��&����8��8���(��8���'��8�4����8$����8$,��8$��&��8�,��$������8,������8�4��	������
8�$������,��8������'��8�TL��$��7.BITS must be less than the type's size in bits����0%����,��8����8��8�P<����'��8�$��'����8�$��$��8���������8�4�� ��8�	������
��8������8�<��'��8�
������8������7��� ��8�4������+������8�4��8��8�
D����8,��8�
��&��8���$��8���������8�4��&����8��8���$��8�,����8ŤD������8�'$��&��8ŤD����8�
����$��(��8���'��8�4����8$����8$,��8���&��8�<����-��8�,��$��8$��&��8�,��$������8��8�
������,��8������'��8�TL����8�'$������,��8������'��8�TL��������,��8����8��8�P<����'��8�
D��'����8�
��$��8���������8�4��$��8�,�� ��8�	������
��8������8�<��'��8�
������8������7��� ��8�4������8$������8�������8���'��8�,��'��8�
������8���'��8	ErrorKind�L��'��8InvalidInput�d��$��73bit count must be less than the type's size in bits����5$��+������8�4��8��8�&,����8,��8�$��&��8���$��8�'��&��8�(D����-��8�,��������8$��$��8�'4��&����8��8�'��$��(��8���'��8�4��������������8,������8�4��	������
8�$������,��8������'��8�TL��$��7�����0%����,��8����8��8�P<����'��8�&,��'����8�$��$��8�'��������8$�� ��8get���������7���$��8�'4��+������8�4��8��8�)L����8,��8�
��&��8���$��8�'��&��8�(D����-��8�,��������8$��$��8�'4��&����8��8�'��$��8�,����8ŤD������8�'$��&��8ŤD����8�
����$��(��8���'��8�4��������������8��8�
������,��8������'��8�TL����8�'$������,��8������'��8�TL��������,��8����8��8�P<����'��8�)L��'����8�
��$��8�'��������
8$�� ��8����������7���$��8�'4��$��8�,��8$������8�������8���'��8�,��'��8�
������8���'��8��L��'��8��d��$��7�����5$��8$��8�QT��8
��8�<����,��8����������;+������8�4��8��8�D����8,��8�T��&��8���$��8���������8�4��&����8��8���(��8���'��8�4����8$����8$,��8���&��8�<����-��8�,��$��8$��&��8�,��$��������,��8����8��8�QT����'��8�D��'����8�T��$��8���������8�4�� ��8�	������
��8������8�<��'��8�
������8������7��� ��8�4������+������8�4��8��8�/L����8,��8�T��&��8���$��8�'��&��8�(D����-��8�,��������8$��$��8�'4��&����8��8�'��$��(��8���'��8�4����������������,��8����8��8�QT����'��8�/L��'����8�T��$��8�'��������8$�� ��8����������7���$��8�'4��8$��8�P<��8
��8�4����8�<����,��8����������t+������8�4��8��8�$����8,��8�$��&��8���$��8���&��8�<����-��8�,��������8�4��&����8��8���(��8���'��8�4����8$����8$,��8$��&��8�,��$��������,��8����8��8�P<����'��8�$��'����8�$��$��8���������8�4�� ��8�	������8�<��'��8�
��+������8�4��8��8�
D����8,��8�
��&��8���$��8���������8�4��&����8��8���$��8�,��&��8ŤD����8�
����(��8���'��8�4����8$����8$,��8���&��8�<����-��8�,��$��8$��&��8�,��$��������,��8����8��8�P<����'��8�
D��'����8�
��$��8���������8�4��$��8�,�� ��8�	������8�<��'��8�
��+������8�4��8��8�&,����8,��8�$��&��8���$��8�'��&��8�(D����-��8�,��������8$��$��8�'4��&����8��8�'��$��(��8���'��8�4����������������,��8����8��8�P<����'��8�&,��'����8�$��$��8�'��������	8$�� ��8�	��������8n�����8��� ��8�������� ��8�L������7���$��8�'4��+������8�4��8��8�)L����8,��8�
��&��8���$��8�'��&��8�(D����-��8�,��������8$��$��8�'4��&����8��8�'��$��8�,��&��8ŤD����8�
����$��(��8���'��8�4����������������,��8����8��8�P<����'��8�)L��'����8�
��$��8�'��������8$�� ��8�	��������8�����8��� ��8�������� ��8�L������7���$��8�'4��$��8�,��$��8$��8�QT��8
��8�4����8�<����,��8����������;+������8�4������8�4��8��8�D����8,��8�T��&��8���$��8���������8�4��&����8��8���(��8���'��8�4����8$����8$,��8���&��8�<����-��8�,��$��8$��&��8�,��$��������,��8����8��8�QT����'��8�D��'����8�T��$��8��������8�4�� ��8�	������8�<��'��8�
��+������8�4��8��8�/L����8,��8�T��&��8���$��8�'��&��8�(D����-��8�,��������8$��$��8�'4��&����8��8�'��$��(��8���'��8�4����������������,��8����8��8�QT����'��8�/L��'����8�T��$��8�'��������
8$�� ��8�	��������8�����8��� ��8�������� ��8�L������7���$��8�'4��$��%����� ���74 This trait extends many common signed integer types����@��������@= This trait was formerly named `SignedNumeric` in 2.X.X code.����0- If backwards-compatibility is needed one can����.+ import `SignedInteger` as `SignedNumeric`.�l�����������<�����$���0�+������������������.�����������l����/��#���������-���#  The unsigned variant of ourself�D���������*' Returns true if this value is negative����l����<�������$! use bitstream_io::SignedInteger;����  assert!(!1i8.is_negative());����" assert!((-1i8).is_negative());�<����\������
���$�����+���,) Returns ourself as a non-negative value.����Cݒ���$�����l����<�������$�����41 assert_eq!(1i8.as_non_negative(), 0b00000001u8);�<����|��������
���$�����2���85 Given a negative value and a certain number of bits,����<9 returns this value as a twos-complement positive number.����Cݒ���$�����l����<�������$�����41 assert_eq!((-1i8).as_negative(8), 0b01111111u8);�<����\��������
���$���'$�����>���8�����<ϭ���l����<�������$�����>; assert_eq!((-1i8).as_negative_fixed::<8>(), 0b01111111u8);�<�����������������|��
����$��$�����"�����������	,��8����&��8���$��,��8����&��8���*������8�Ut��	������,��8����%��8$��8�Wl��8
��,��8��������,8!$��8�WD����,��8����%��+������8�4������8�4��8��8�W\������8$��(��8�$������8$�� ��8�W\������8��8�V|������8$��(��8$��'��8�WD������8$��8��,��8����8��8�V\������8$��$��8�'$��&��8���(��8$��'��8�WD����������8$����������7���������8�'$����7���8��,��8����8��8�V�����8,��8�$��&��8���������8$��(��8$��'��8�WD����������8$����������7���������8�$����7���8��,��8����8$��8�P<��8
��,��8������ޅt+������8�4������8�4��8��8�$����8,��8�$��&��8���$��8���&��8�<����-��8�,��������8�4��&����8��8���(��8���'��8�4����8$����8$,��8$��&��8�,��$������
8�4�� ��8�\��'����8�$��$��8��������+������8�4������8�4��8��8�
D����8,��8�
��&��8���$��8���������8�4��&����8��8���$��8�'$��&��8ŤD����8�
����(��8���'��8�4����8$����8$,��8���&��8�<����-��8�,��$��8$π&Ӏ8�,Հ$ڀ���
8�4�� ��8����'����8�
��$��8��������8�'$��+����Ё8�4ȁρ8�4Ɂ8ށ8�&,��8,�8�$�&�8��$��8�'��&��8�(D����-��8�,������т8$��$��8�'4��&����8��8�'‚$Â(ӂ8�ւ'؂8�4ڂ��������
8�'4�� ��8�*d��'����8�$��$��8��������8$��+����ǃ8�4����ƃ8�4��8Ճ8�)L؃�8,�8�
�&�8��$��8�'�&�8�(D����-��8�,��������8$��$��8�'4��&����8��8�'��$��8�'$τ&ӄ8ŤDՄ݄8�
ބ�$�(�8���'��8�4������������ԅ
8�'4�� ��8�+���'����8�
��$��8������ƅ8�'$��$��8$…8$�8�QT�8
��,��8��������;+������8�4������8�4��8��8�D����8,��8�T��&Ȇ8�ʆ$͆8�φІц��8�4҆&؆چ8ۆ8�߆(�8��'�8�4��8$���8$,��8���&��8�<����-��8�,��$��8$��&��8�,Ç$ȇև��
8�4� �8�|�'����8�T��$��8��������+������8�4������8�4��8ˈ8�/LΈ׈8,؈8�Tވ&�8��$�8�'�&��8�(D���-��8�,������ȉ8$��$��8�'4��&����8��8�'��$��(ʉ8�͉'ω8�4щ׉؉ىډ܉��
8�'4� �8�.���'����8�T��$��8��������8$��%��\��<���	������ŤD������<��O����(D�������hl���
���c|���
���NLȎ�����tӎ����Wl�����U|���������������������uwbdPR>@ܱ�T������,ǣ��������	�	�	�	�	�	�	�	�	�	�	�	���	�	�	�	�	�	�	�	�	�	�	�	�	�	��	�	�	�	�	�	��	�	�	�	�Ĥ�tǤ������������������֤��D��
������4�queue_value�\��
queue_bits�T��KM�ߧ�L�������	������
�	��	�	�	�����������	�����	D��
����
��	�4����\����TΨXD�OQ���Wt����������������������;t�������
�	����\����TĪ��	ڪ�ȫ�L˫������	��������
�	��	��	�	�	�	�����tի��������D��ƞ|��
�	���
��	��4����\����T���,جf۫fhjl����|��������	�������	��	��	�	�	�	���|����Ȯ��ˮ��D�ƞ|��
�	�����	��4ۮ��\����T��]$��]_ac�Ӱ��ְ�����
����������U�˸���������
�	�'�	��	�	�	�	�����t���
��������
LŲƞ|߲
�	���
�
��'4����\����Tʱ�,�n�nprt����̼������
����������U�˸����������
�	�'�	��	�	�	�	�����tֳ��
������L��Σlʵ
�	���
�
���'4����\����T���,ٴfܳfhjl�����������	������
�	��	��	�	�	�	ݶ���t����Ƕ��ʶȭ	<ķΣlܷ
�	���
��	����ڶ�'$�S��SUWY����T��������	�������[�	��	�	�	���[�����Ѹ��D��
�	���[��	�4���\����T������QT��QS�Ϻ�\Һ�����
�������[�	�'�	�	�	������޺��
����L��
�	���[�
�'4����\����T���QT�QS���8����\�����\�	�	����������L��
�	��������-/���6���������\�	�	�������L��
�	����p���%'���s��
�t����
���������	��	�	�	ƿ����������<��ܧL��
�	��������ÿ;=?A������
���|����
���������'�	��	�	�	���������������D��ܧL��
�	��������
���,��DFHJ���L���	�	�������	����!�	�	�	����d���������
����	�	�	�'�	�	�	���	������
�����T����L��
�	�����
$���'4����\����T��^`bd���)���96 A stream's endianness, or byte order, for determining���� how bits should be read.�������85 It comes in `BigEndian` and `LittleEndian` varieties����-* (which may be shortened to `BE` and `LE`)����?< and is not something programmers should implement directly.�T���	�	�����,�������	��+����7��+���GL������������������������q�aX����	�	������D��
�	���4�� "$���	ܕ�	���	���	�	�	�	����
���ST������'�	�	��	����	L��
�	���'4��ҵ
$��*,���"�
�	�	��t�����	�	�	�	�	�	�	�	�	�	�	*�����+���-* Builds a bit count from a constant number����2/ of bits, which must not be greater than `MAX`.�������/, Intended to be used for defining constants.�������(% Use `TryFrom` to conditionally build����" counts from values at runtime.����t������<�������@�����%" let data: &[u8] = &[0b111_00000];����3�����96 // reading 3 bits from a stream out of a maximum of 8����<9 // doesn't require checking that the bit count is larger����?< // than a u8 at runtime because specifying the maximum of 8����96 // guarantees our bit count will not be larger than 8����NK assert_eq!(r.read_counted::<8, u8>(BitCount::new::<3>()).unwrap(), 0b111);�<��������������� use bitstream_io::BitCount;����85 // trying to build a count of 10 with a maximum of 8���� // fails to compile at all����+( let count = BitCount::<8>::new::<10>();�<���������	��	�	�	�|����
$��P��	��	�	�	�����Z���&# Add a number of bits to our count,����-* returning a new count with a new maximum.�������?< Returns `None` if the new count goes above our new maximum.����t������<���������������*' let count = BitCount::<2>::new::<1>();����HE // adding 2 to 1 and increasing the max to 3 yields a new count of 3����KH assert_eq!(count.checked_add::<3>(2), Some(BitCount::<3>::new::<3>()));����;8 // adding 2 to 1 without increasing the max yields None����0- assert_eq!(count.checked_add::<2>(2), None);�<����\�������	�^�	�	�	�^�����X��'b�<�����Z���.+ Subtracts a number of bits from our count,����-��������0- Returns `None` if the new count goes below 0���� or below our new maximum.����l����<������������*' let count = BitCount::<5>::new::<5>();����30 // subtracting 1 from 5 yields a new count of 4����KH assert_eq!(count.checked_sub::<5>(1), Some(BitCount::<5>::new::<4>()));����'$ // subtracting 6 from 5 yields None����1. assert!(count.checked_sub::<5>(6).is_none());����=: // subtracting 1 with a new maximum of 3 also yields None����0- // because 4 is larger than the maximum of 3����1. assert!(count.checked_sub::<3>(1).is_none());�<����\�������	�^�	�	�	�������|��'��<��������63 Attempt to convert our count to a count with a new���� bit count and new maximum.�������74 Returns `Some(count)` if the updated number of bits����-* is less than or equal to the new maximum.���� Returns `None` if not.����t���<���������������*ΐ���85 // muliplying 5 bits by 2 with a new max of 10 is ok�|�������52     count.try_map::<10, _>(|i| i.checked_mul(2)),����*'     Some(BitCount::<10>::new::<10>()),�4����������=: // multiplying 5 bits by 3 with a new max of 10 overflows����C@ assert_eq!(count.try_map::<10, _>(|i| i.checked_mul(3)), None);�<����<���������	�^�	�	�	�	�	�	������������˗�݀��˗���\�
�	�
�^��$�����a<��ac4���	ܕ�	���	���	�	�	�	�
�^��4ҁ�	ܕ�	���	���	�	�	�	�
�^��˗�������! Returns our maximum bit count����l����<�����Â������+( let count = BitCount::<10>::new::<5>();����  assert_eq!(count.max(), 10);�<ă��������	���	
�	�
$���և?���;8 Returns signed count if our bit count is greater than 0�ބ�l������<�������1. use bitstream_io::{BitCount, SignedBitCount};�…��ʅ+�����MJ assert_eq!(count.signed_count(), Some(SignedBitCount::<10>::new::<5>()));�̆��Ԇ+( let count = BitCount::<10>::new::<0>();����+( assert_eq!(count.signed_count(), None);�<����d��������	���	
�	�
$��ΘW���;8 Masks off the least-significant bits for the given type�����Š41 Returns closure that takes a value and returns a����63 pair of the most-significant and least-significant����41 bits.  Because the least-significant bits cannot���0- be larger than this bit count, that value is����#  returned as a [`Checked`] type.�̌�tԌ���<�������������� // create a bit count of 3��ʍ*' let count = BitCount::<8>::new::<3>();�������*' // create a mask suitable for u8 types����&# let mask = count.mask_lsb::<u8>();�ێ���'$ let (msb, lsb) = mask(0b11011_110);����FC assert_eq!(msb, 0b11011);             // the most-significant bits��ڏGD assert_eq!(lsb.into_value(), 0b110);  // the least-significant bits�������'$ let (msb, lsb) = mask(0b01100_010);��ڐFC assert_eq!(msb, 0b01100);             // the most-significant bits����GD assert_eq!(lsb.into_value(), 0b010);  // the least-significant bits������'$ let (msb, lsb) = mask(0b00000_111);����FC assert_eq!(msb, 0b00000);             // the most-significant bits���GD assert_eq!(lsb.into_value(), 0b111);  // the least-significant bits�<����ȓ�<Г���ܓ��������:7 // a mask with a bit count of 0 puts everything in msb��ǔ:7 let mask = BitCount::<8>::new::<0>().mask_lsb::<u8>();�������&# let (msb, lsb) = mask(0b11111111);����  assert_eq!(msb, 0b11111111);��ޕ$! assert_eq!(lsb.into_value(), 0);�������30 // a mask with a bit count larger than the type��ǖ52 // is restricted to that type's size, if possible����;8 let mask = BitCount::<16>::new::<9>().mask_lsb::<u8>();�����ɗ&����� assert_eq!(msb, 0);����-* assert_eq!(lsb.into_value(), 0b11111111);�<˜��D՘���
���	�	��	�	�	��ޘ��|�
�	�
��$�%'����*�	�	�	�
���������������V�������%������䉙�����(���	���<ÙD���	ܕ�	���	���	�	�	����G���>; Returns this bit count's range for the given unsigned type�Ǟ�lϞ����<��������������?< assert_eq!(BitCount::<9>::new::<0>().range::<u8>(), 0..=0);���A> assert_eq!(BitCount::<9>::new::<1>().range::<u8>(), 0..=0b1);����B? assert_eq!(BitCount::<9>::new::<2>().range::<u8>(), 0..=0b11);���C@ assert_eq!(BitCount::<9>::new::<3>().range::<u8>(), 0..=0b111);����DA assert_eq!(BitCount::<9>::new::<4>().range::<u8>(), 0..=0b1111);����EB assert_eq!(BitCount::<9>::new::<5>().range::<u8>(), 0..=0b11111);��͢FC assert_eq!(BitCount::<9>::new::<6>().range::<u8>(), 0..=0b111111);����GD assert_eq!(BitCount::<9>::new::<7>().range::<u8>(), 0..=0b1111111);���HE assert_eq!(BitCount::<9>::new::<8>().range::<u8>(), 0..=0b11111111);����.+ // a count that exceeds the type's size is���85 // naturally restricted to that type's maximum range����HE assert_eq!(BitCount::<9>::new::<9>().range::<u8>(), 0..=0b11111111);�<���,�������������������	exhausted�m��/�����	��	�	���	������|��
�	�
��$��%'�Ū#��74 Returns minimum value between ourself and bit count����l����Ĩ�<̨���ب��������*' let count = BitCount::<8>::new::<7>();����30 assert_eq!(count.min(6), BitCount::new::<6>());���30 assert_eq!(count.min(8), BitCount::new::<7>());�<����̪�����	�	
�	�
$Ъ�'$֪���@���B? Returns the minimum value of an unsigned int in this bit count���l������<���������������IF assert_eq!(BitCount::<8>::new::<0>().none::<u8>().into_value(), 0b0);����IF assert_eq!(BitCount::<8>::new::<1>().none::<u8>().into_value(), 0b0);��ݮJG assert_eq!(BitCount::<8>::new::<2>().none::<u8>().into_value(), 0b00);����KH assert_eq!(BitCount::<8>::new::<3>().none::<u8>().into_value(), 0b000);����LI assert_eq!(BitCount::<8>::new::<4>().none::<u8>().into_value(), 0b0000);��ͰMJ assert_eq!(BitCount::<8>::new::<5>().none::<u8>().into_value(), 0b00000);����NK assert_eq!(BitCount::<8>::new::<6>().none::<u8>().into_value(), 0b000000);���OL assert_eq!(BitCount::<8>::new::<7>().none::<u8>().into_value(), 0b0000000);��ƲPM assert_eq!(BitCount::<8>::new::<8>().none::<u8>().into_value(), 0b00000000);�<����$ij�����	��	�	�	��ɳ��|̳
�	�
��$ݳ%'���?��B? Returns the maximum value of an unsigned int in this bit count����l����ŵ�<͵���ٵ��������HE assert_eq!(BitCount::<8>::new::<0>().all::<u8>().into_value(), 0b0);��ҶHE assert_eq!(BitCount::<8>::new::<1>().all::<u8>().into_value(), 0b1);����IF assert_eq!(BitCount::<8>::new::<2>().all::<u8>().into_value(), 0b11);����JG assert_eq!(BitCount::<8>::new::<3>().all::<u8>().into_value(), 0b111);����KH assert_eq!(BitCount::<8>::new::<4>().all::<u8>().into_value(), 0b1111);����LI assert_eq!(BitCount::<8>::new::<5>().all::<u8>().into_value(), 0b11111);��ݹMJ assert_eq!(BitCount::<8>::new::<6>().all::<u8>().into_value(), 0b111111);����NK assert_eq!(BitCount::<8>::new::<7>().all::<u8>().into_value(), 0b1111111);����OL assert_eq!(BitCount::<8>::new::<8>().all::<u8>().into_value(), 0b11111111);�<ֻ���������	��	�	�	������|��
�	�
��$��%'���B�
�	�	��t�����	�	���	��Tܾ,��	�	���3��96 Attempts to convert a `u32` bit count to a `BitCount`�������63 Attempting a bit maximum bit count larger than the����2/ largest supported type is a compile-time error����t���<������������ use std::convert::TryInto;�������?< assert_eq!(8u32.try_into(), Ok(BitCount::<8>::new::<8>()));����:7 assert_eq!(9u32.try_into(), Err::<BitCount<8>, _>(9));�<����D����������������������q�aX������	�	
�	�
�'$�����9�
�	�	��t�����	�_�	�����@����������^�^��^��[�^���[����e�S��ޝ�	���	
�	�
$����������Ť��'�<��)h��	�	M����'���96 Builds a bit count where the maximum bits is unknown.����l����<������������KH assert_eq!(BitCount::unknown(5), BitCount::<{ u32::MAX }>::new::<5>());�<����<�����	�	
�	�':����0�
�	�	��t���	��	�����0$�����	�	
�	�
���(�
�	�	��t�����	�	�	�	�	�	�	�	!�����+���41 Builds a signed bit count from a constant number����-* of bits, which must be greater than 0 and���� not be greater than `MAX`.�������/��������(ȁ���"�����t������<�������FC use bitstream_io::{BitReader, BitRead, BigEndian, SignedBitCount};����%����3�����9�����<����?�����9�����XU assert_eq!(r.read_signed_counted::<8, i8>(SignedBitCount::new::<3>()).unwrap(), -1);�<�������ķ������%" use bitstream_io::SignedBitCount;����8߆��������1. let count = SignedBitCount::<8>::new::<10>();�<�������Ĩ������%�����96 // trying to build a count of 0 also fails to compile����0- let count = SignedBitCount::<8>::new::<0>();�<���������	��	�	�	�|��
�	�
�$�����	��	�	�	�����w���&�����-��������?�����t������<�������%��������0- let count = SignedBitCount::<2>::new::<1>();����H���QN assert_eq!(count.checked_add::<3>(2), Some(SignedBitCount::<3>::new::<3>()));����;����0��<����\�������	�^�	�	�	�����
�	�
�^���'��%<�����w���.����-��������0- Returns `None` if the new count goes below 1��������l����<�������%�����0- let count = SignedBitCount::<5>::new::<5>();����3�����QN assert_eq!(count.checked_sub::<5>(1), Some(SignedBitCount::<5>::new::<4>()));����'�����1Œ���=�����0Ǔ���1�����,) // subtracting 5 from 5 also yields None����@= // because SignedBitCount always requires 1 bit for the sign����1. assert!(count.checked_sub::<5>(5).is_none());�<����\�������	�^�	�	�	�����
�	�
�^��'!�%<���������6�������������7���ׂ,) is less than or equal to the new maximum���� and greater than 0.�Ԥ���Ã�t˃�<ރ����%��������0���ф8��|�������5���܅0-     Some(SignedBitCount::<10>::new::<10>()),�4����������=���C��������1. // multiplying 5 bits by 0 results in 0 bits,���-* // which isn't value for a SignedBitCount����>; assert_eq!(count.try_map::<10, _>(|i| Some(i * 0)), None);�<���<���������	�^�	�	�	�	�	�	��������������\�
�	�
�^��$�����F<��FH���	ܕ�	���	���	�	�	�	�
�^�������Ɍ�Ί!О��l����<�������%��ċ��̋1. let count = SignedBitCount::<10>::new::<5>();���� �<����֌�����	ڌ�	
�	�
$ی���*���&# Returns regular unsigned bit count����l����ƍ�<΍���ڍ1��������85 let signed_count = SignedBitCount::<10>::new::<5>();��ՎA> assert_eq!(signed_count.count(), BitCount::<10>::new::<5>());�<����,ʏ�������	Џ�	
�	�
$я���3���" Returns bit count without sign�������30 This value is 1 less than the signed bit count.���l�������<�������1��ґ��ڑ8�����JG assert_eq!(signed_count.unsigned_count(), BitCount::<10>::new::<4>());�<���t���������	���	
�	�
$�����E�ߓ<9 Returns this bit count's range for the given signed type����l�������<”���Δ%��������FC assert_eq!(SignedBitCount::<9>::new::<1>().range::<i8>(), -1..=0);��˕FC assert_eq!(SignedBitCount::<9>::new::<2>().range::<i8>(), -2..=1);����FC assert_eq!(SignedBitCount::<9>::new::<3>().range::<i8>(), -4..=3);���FC assert_eq!(SignedBitCount::<9>::new::<4>().range::<i8>(), -8..=7);����HE assert_eq!(SignedBitCount::<9>::new::<5>().range::<i8>(), -16..=15);����HE assert_eq!(SignedBitCount::<9>::new::<6>().range::<i8>(), -32..=31);��ƘHE assert_eq!(SignedBitCount::<9>::new::<7>().range::<i8>(), -64..=63);����JG assert_eq!(SignedBitCount::<9>::new::<8>().range::<i8>(), -128..=127);���.�����8��ҚJG assert_eq!(SignedBitCount::<9>::new::<9>().range::<i8>(), -128..=127);�<����,���������������������m��/�����	��	�	̛�	������l��
�	�
��$͛%'���?�
�	�	��t�����	�_�	�����@ğ��������^�^��^��[�^���[����e�S��ޝ�	ȟ�	
�	�
$ɟ�ϟ���R�
�	�	��t�����	�	���	ǠT��,���	�	���>D������������������������q�aX��������	�	
�	�
�,�H�
�	�	��t�����	�	���	��T��,���	�	���4D����������������������q�aX������	�	
�	�
�,�����	ܕ�	���	���	�	�	�	�
����������������������q�aX�������6�
�	�	��t���	��	������$�����	�	
�	�
���(�����(���	�_�	�ۨ@ި��������^�^��^��[�^���[����e�S��ޝ�	��	
�	$������%���	��	�ƫ$$ɫ�����	�	
�	error�,Ϋ�۳j�
��
�
�
���������
�
���'���#  Returns our bit count and value�����������
�

�
����$ȴ䮵��� Returns our value�T�������
�

�
����$����%j�
��
�
�
���������
��
!#���4����������
���

�
����$�����+�˶*' An unsigned type with a verified value�|���
�
��
�
�
��t��������������U�˸�������M��MO���N�
�
��
�
�
��tŷ��շ��|ط���
�
���
�
1˷13���G,���������
��
�'�
�
¸�
��
����
D��
�
�
���
$ø�'4ɸ24��d������
���

�
�
��$�����W�
�
��
�
�
��t����ĺ��|Ǻ���
�
���
-��-/t��L���
�
�����X$û����	�����������������������q�aX�����
��
�
��
��	Ȼȭ	<˻
�
�
����	�4ݻ�,��35<��
ܕ�
���
���
�
�
�
�
����	���������W�
�
��
�
�
��t��������|�����
�	�
&��&(���d�������������
�	�
�'�
�
�
���
�������������������L��
�
�
������$���'4����\����Tξuwpr���@�
�
��
�
�
��t��������|�����
�
!��!#���V���<9 Returns our value if it fits in the given number of bits����l�������<�������@= use bitstream_io::{BitCount, CheckedUnsigned, CheckedError};�������+( // a value of 7 fits into a 3 bit count����=: assert!(CheckedUnsigned::<8, u8>::new(3, 0b111).is_ok());�������30 // a value of 8 does not fit into a 3 bit count���� assert!(matches!(����1.     CheckedUnsigned::<8, u8>::new(3, 0b1000),����*'     Err(CheckedError::ExcessiveValue),�<�� ));�������+( // a bit count of 9 is too large for u8���������-*     CheckedUnsigned::<9, _>::new(9, 1u8),����)&     Err(CheckedError::ExcessiveBits),�<����<�������e����������������������q�aX�����
�e�
�
�
����ܺ���������
�
�
�����,���,��?A���
ܕ�
���
���
�
�
�
�
��������������I���B? Returns our value if it fits in the given number of const bits����t������<�������63 use bitstream_io::{CheckedUnsigned, CheckedError};�������+ƨ���EB assert!(CheckedUnsigned::<8, u8>::new_fixed::<3>(0b111).is_ok());�������3Ω��������96     CheckedUnsigned::<8, u8>::new_fixed::<3>(0b1000),����*�<����<���������� ```compile_fail����2/ use bitstream_io::{BitCount, CheckedUnsigned};�������+��������/, // because this is checked at compile-time,����! // it does not compile at all����96 let c = CheckedUnsigned::<16, u8>::new_fixed::<9>(1);�<����L�������
��
�
�
��|��
�
�
����,��#$�����
��
�
�
��K����B��
�
��|�����
��
$�����,$�������
�

�
�_count�4�����g��
�
�
�
�
��|����t�����
�
���
$$��$��T��,���
�
�����>D������������������������q�aX��������
�

�
��
�,�����1���EB An unsigned type with a verified value for a fixed number of bits������
��
�
�
��|��������������U�˸�������M$��MO���G��
��
�
�
��|��������|�����
$�� ���8���JG Returns our checked value if it fits in the given number of const bits����t������<�������;8 use bitstream_io::{CheckedUnsignedFixed, CheckedError};�������1. // a value of 7 fits into a maximum of 3 bits����EB assert!(CheckedUnsignedFixed::<3, u8>::new_fixed(0b111).is_ok());�������96 // a value of 8 does not fit into a maximum of 3 bits���������96     CheckedUnsignedFixed::<3, u8>::new_fixed(0b1000),����*�<����<���������������+( use bitstream_io::CheckedUnsignedFixed;�������+��������/�����!�����85 let c = CheckedUnsignedFixed::<9, u8>::new_fixed(1);�<����L������������������������q�aX�����
�

�
����,��O��
��
�
�
�����U��
��
�
�
��|��������|�����
�
���
�
1$��13���G,���������
��
�'�
�
���
��
����
D��
�
����
$���'4��24���d�������
���

�
���$�����^��
��
�
�
��|��������|�����
�	�
&$��&(����d��������������
�	�
�'�
�
�
���
���������������L��
�
�������$���'4����\����T��\^`b���^��
��
�
�
��|��������|�����
�
���
-$��-/t��L���
�
�����\$������	����������������������q�aX�����
��
�
���
��	��ȭ	<��
�
�����	�4���,��35���)���'$ A signed type with a verified value�l���
�
��
�
�
��t��������������U�˸�������M��MO���J�
�
��
�
�
��t��������l�����
�
���
�
1��13���G,���������
��
�'�
�
���
��
����
D��
�
�
���
$���'4��24��d�������
���

�
�
��$�����S�
�
��
�
�
��t��������l�����
�
���
-��-/t؀L݀�
�
�����X$������	�����������������������q�aX�����
��
�
���
��	��ȭ	<��
�
�
����	�4���,��35<���
ܕ�
���
���
�
�
�
�
����	�������܂S�
�
��
�
�
��t������l����
�	�
&�&(�ă�dǃ������������
�	�
�'�
�
�
���
��ԃ��׃������L��
�
�
������$��'4���\����T��\^`b���<�
�
��
�
�
��t��������l�����
�
!��!#���\���<����l�������<�������DA use bitstream_io::{SignedBitCount, CheckedSigned, CheckedError};�����+( // a value of 3 fits into a 3 bit count����85 assert!(CheckedSigned::<8, _>::new(3, 3i8).is_ok());������30 // a value of 4 does not fit into a 3 bit count���������+(     CheckedSigned::<8, _>::new(3, 4i8),���*�<����������+( // a bit count of 9 is too large for i8��݊�����+(     CheckedSigned::<9, _>::new(9, 1i8),����)��<Ջ��<����������������������������q�aX�����
��
�
�
�������!�����䒌
�
�
�����,���,��@B���
ܕ�
���
���
�
�
�
�
��������������I���B�Ò�t˒�ޒ�<�����41 use bitstream_io::{CheckedSigned, CheckedError};�������+����?< assert!(CheckedSigned::<8, i8>::new_fixed::<3>(3).is_ok());�������3���������2/     CheckedSigned::<8, i8>::new_fixed::<3>(4),����*�<���<��������������0- use bitstream_io::{BitCount, CheckedSigned};�Ԗ��ܖ+��������/���ȗ!����74 let c = CheckedSigned::<16, i8>::new_fixed::<9>(1);�<����L�������
��
�
�
��|ǘ
�
�
����,ؘ#$͘{��
��
�
�
�����N��
�
��|�����
��
$�����2$�������
�

�
���4����s��
�
�
�
�
��|���t�����
�
���
$$�$��T۩,��
�
�����DD������������������������q�aX��������
�

�
��
�,�����/���B? A signed type with a verified value for a fixed number of bits������
��
�
�
��|��������������U�˸�������M$��MO�׬C��
��
�
�
��|ܬ������l����
$� ��8���J����t������<�������IF use bitstream_io::{SignedBitCount, CheckedSignedFixed, CheckedError};�������+�����@= assert!(CheckedSignedFixed::<3, _>::new_fixed(3i8).is_ok());�����3��������İ30     CheckedSignedFixed::<3, _>::new_fixed(4i8),����*�<����<����ñ��˱����)& use bitstream_io::CheckedSignedFixed;�������+��ɲ��Ѳ/�����!�����74 let c = CheckedSignedFixed::<9, _>::new_fixed(1i8);�<���L������������������������q�aX�����
�

�
����,�����
��
�
�
���ٷQ��
��
�
�
��|޷�����l����
�
���
�
1$�13���G,¸�������
��
�'�
�
޸�
��
ȸ��
D˸
�
����
$߸�'4�24���d�������
���

�
���$�����Z��������|����˺��lκ����	�&$��&(����d���������������	��'���ٻ������������ʼ��L�
��������$û�'4ѻ��\���T��\^`b��Z��������|��������l���������-$��-/tҿL׿�������y$������	����������������������q�aX�������������	��ȭ	<��
������	�4���,��35���/���<9 A trait for writable types whose values can be validated�������=: Ordinarily, when writing a value to a stream with a given����96 number of bits, the value must be validated to ensure����+( it will fit within that number of bits.����|�� # Example 1����<�������74 use bitstream_io::{BitWrite, BitWriter, BigEndian};�������5��������74 // writing a value of 2 in 1 bit is always an error����*' // which is checked here at write-time����*' assert!(w.write::<1, u8>(2).is_err());�<����������/, But if the value can be checked beforehand,����0- it doesn't need to be checked at write-time.����|�� # Example 2����<�������HE use bitstream_io::{BitWrite, BitWriter, BigEndian, CheckedUnsigned};�������5��������*' // writing a value of 1 in 1 bit is ok����52 // and we're checking that validity at this stage����EB let value = CheckedUnsigned::<1, u8>::new_fixed::<1>(1).unwrap();�������85 // because we've pre-validated the value beforehand,����/, // it doesn't need to be checked again here����/, // (though the write itself may still fail)����,) assert!(w.write_checked(value).is_ok());�<�������L������,���	��������*����6��+���������H���'$ Write our value to the given stream�,�������������'����������D��
�����$���'4��,.������ The number of written bits�d����������
���$�����'���<9 A trait for readable types whose bit counts can be saved�������52 Because the intent of reading checkable values is����85 to avoid validating their values when being written,����52 implementing the [`Checkable`] trait is required.���������������L�����,����8��+���������|��ԏ	�t�����" Our bit count type for reading�L�������Y���)& Reads our value from the given stream�$������܏���������ϒ���<��
������4���,��-/\�����.+ Big-endian, or most significant bits first�����t��������������������������
�������������t������������D����|��
��
�����4��queue�,����T��^��^`bd����T��������������������������D����|��
������4���K,��?ACE$���ܕ����������������������������&�����������������	�	�	�	�	���	�	�	�	�	�	�	�����������������Vt������������
���\����T����	�����ܕ��������������L����������������
�������������t������������D����|��
��
�����4����\����T���,��b��bdfh����|���������������������������|������������D����|��
�������4����\����T��Y$��Y[]_��������������������������������U�˸����������
��'�����������t�������������L����|��
��
�����'4����\����T��b��bdfh����\����������'���������	��������	L����|��
������'4���K,���,��HJLN�ȕ��˕����������������U�˸����������
��'�����������t���������סL����l��
��
�����'4����\����T���,ؖb�bdfh����t����������������ĝ�������D��
����4����\ԝ��T�46�ݡ�L�������������
������������������D��
��
���4����\����T��CD�CEU�����������ܕ�����������
�������ܕ�����������
��4ϥ�ܕ�����������
�������ܕ�����������
�������ܕ�����������
����4���ܕ�����������
���������������������
������������t¨��Ҩ��ը�<����l��
��
�������GȨGIKM����T���������������[���������[�Ȯ�����D��
��[���4����\����T������MTήMOD���ܕ�����������[�����
��Dη�ܕ�����������[���������\���������������[��'������Ʋ�������סL��
��[���'4����\����Tܼ����MT��MOD���ܕ�����������[������D���ܕ�����������[���������7����\����\����������L��
������)+���5�������\���������L��
������!#���gt����������������������������<����L��
���֡����79;=���t|������֡���'����������	��������D����L��
���֡��
���,��@BDF\�����2/ Little-endian, or least significant bits first��������������������������������
�������������t������������D����|��
��
�����4��ۓ,����T��Z��Z\^`����T��������������������������D����|��
������4���K,��?ACE$���ܕ����������������ė��� �����)�����������������	�	�	�	�	���	�	�	�	�	�	�	�����������������Vt������������
���\����T����	�����ܕ����������������L����������������
�������������t������������D����|��
��
�����4����\����T���,��b��bdfh����|���������������������������|������������D����|��
�������4����\����T��Y$��Y[]_�����������������������������
��'�����������t����������סL����|��
��
�����'4����\����T��Z��Z\^`����\����������'���������	��������	L����|��
������'4���K,���,��HJLN�ӌ��֌������������
��'�����������t����������סL����lĎ
��
�����'4����\����Tō�,�b��bdfh�ߔ�t�����������������������D��
����4����\����T��46����L��������������
�����ә������������DŚ
��
���4˙��\���T��CD��CE�������Ҝ�ܕ�����������
�������ܕ�����������
����4���ܕ�����������
�������ܕ�����������
����ߞ�ܕ�����������
����4���ܕ�����������
�������������������
�������������t�����������<ϡ��l�
��
��������G��GIKM����T���������������[��������Ʋ���������D��
��[���4����\Ȧ��T�����MT��MOD���ܕ�����������[������D���ܕ�����������[�������֯�\ٯ�������������[��'������Ʋ������סL��
��[���'4����\����T����ٰMT�MODǴ�ܕ�����������[������D���ܕ�����������[���������7�ù����\�����ֹ��Lٹ
�����!#���5�������\�����Ϻ��LҺ
����ݺ!#���gt����������������������������<���L��
���֡����79;=���t|������֡���'����������	��������D���L��
���֡��
���,��@BDF�޾�T����������u�u�u�����u��u��u���������������ʿ���������������D�������lϿ�����ٿ��������������������̞��������T��
����������4����\����T��leading_bits�d��max_bits�D�
checked_shift�l��LOILFICF��;?��/<9 A limited unary reader which stops at the given maximum.��0���074 Counts non-`STOP_BIT` values (which must be 0 or 1)���041 until `STOP_BIT`, or until `MAXIMUM` is reached.���1;8 Returns the number of non-`STOP_BIT` bits, or `None` if���1" maximum is reached beforehand.��1�t�1�<�1����1MJ use bitstream_io::{BitReader, BitRead, BigEndian, huffman::LimitedUnary};��2���22/ let data: &[u8] = &[0b001_00000, 0b1111_1111];���33����3&# // get 2 bits until the next 1 bit���3IF assert_eq!(r.read_huffman::<LimitedUnary<1, 5>>().unwrap(), Some(2));���4)& // but 5 bits in a row is our maximum���4FC assert_eq!(r.read_huffman::<LimitedUnary<1, 5>>().unwrap(), None);���5-* // the remaining 8 bits are ok to be read���585 assert_eq!(r.read::<8, u8>().unwrap(), 0b1111_1111);�<�6���6�<�6����6NK use bitstream_io::{BitWriter, BitWrite, BigEndian, huffman::LimitedUnary};��6���65����7A> // writes 2 as a regular unary value which stops at the 1 bit���7<9 w.write_huffman::<LimitedUnary<1, 5>>(Some(2)).unwrap();���852 // writing values beyond the maximum does nothing���8=: w.write_huffman::<LimitedUnary<1, 5>>(Some(10)).unwrap();���9.+ // writes 5, 0 bits (which is our maximum)���996 w.write_huffman::<LimitedUnary<1, 5>>(None).unwrap();���9.+ // write some 1 bits to pad out the stream���:" w.write::<8, u8>(0b1111_1111);��:���:=: assert_eq!(w.into_writer(), &[0b001_00000, 0b1111_1111]);�<�;��d�;�
���������;����;��/D�\�;s���X����PD�;P<�; �;N�
���������;����;��US(�;O�
���������;����;�������\^��������;�
��
�,�;(�;P�
���������;����;����_�ji^`��������^�^��^��[�^���[����e�S��ޝ��;�
��
�,�;���'	�����ć�ڃ��.)���� �[��( �\�����"$������� ��
�,�(!�]����_�"$��������^�^��^��[�^���[����e�S��ޝ�!��
�,����ˎ&�ÌNK For reading non-aligned bits from a stream of bytes in a given endianness.�������?< This will read exactly as many whole bytes needed to return��֍KH the requested number of bits.  It may cache up to a single partial byte����
 but no more.�L֎���	������������T���x�
^
����68:<L��4��9����L��,��9��L��$��9�����<��9����	(5��g���	������������J���X�������258;���������5���
�����,��(6Îh���	����������_��L�_��Z�������_� #&����������^�^��^��[�^���[����e�S��ޝ�6Î�
�����,Î�E���1���KH For reading aligned bytes from a stream of bytes in a given endianness.�ƀ��ʀC@ This only reads aligned values and maintains no internal state.�T�����	�����������D����TŁ��
���z����;=?A�ׁ<ׁ9����	L�4�9����(G��q���	�����������B�����N��ȃ���_��������������^�^��^��[�^���[����e�S��ޝ�G���
�����,���4�Һ��B? An error returned if performing math operations would overflow��������m����y������ [��z��(\ú{�����#%�������\ú�
�,ú(]ʺ|����_�#%��������^�^��^��[�^���[����e�S��ޝ�]ʺ�
�,ʺ�Θ^������������^��E�^�������^���
� ^����^���^��;X^����������������������q�aX����
� ^����^���^��`^�����^���
� ^���_������������_��E�_�������_���
� _����_���_��;X_����������������������q�aX����
� _����_���_��`_�����_���
� _���`������������`��E�`�������`���
� `����`���`��;X`����������������������q�aX����
� `����`���`��``�����`���
� `���a������������a��E�a�������a���
� a����a���a��;Xa����������������������q�aX����
� a����a���a��`a�����a���
� a���b�� ����������b��E�b�������b���
� b����b���b��;Xb����������������������q�aX����
� b����b���b��`b�����b���
� b��̔����EB For counting the number of bits written but generating no output.����l����<�������96 use bitstream_io::{BigEndian, BitWrite, BitsWritten};����:7 let mut writer: BitsWritten<u32> = BitsWritten::new();����(% writer.write_var(1, 0b1u8).unwrap();����)& writer.write_var(2, 0b01u8).unwrap();����,) writer.write_var(5, 0b10111u8).unwrap();����$! assert_eq!(writer.written(), 8);�<����!������������H��B�
 <��$�������8c��}��
�
��pβ-���
��
��KM���
�

�
�����'���E�����l����<�������85 use bitstream_io::{BigEndian, BitWrite, BitCounter};����C@ let mut writer: BitCounter<u32, BigEndian> = BitCounter::new();��׀(�����)����,���ׁ$ϥ<������
use of BitsWritten is preferred����H'+���
����
�	�
�
�
����������T����}���2���
�
2468���$�����
���
�
�����<�����
���
�
��	8y�����
�	�
�
�
������βC���Q�����
��
	�����
�

�
����ܳ�(���j�
�
������+u���
F�
 D��,����
�
��8z���j�
�
��p���5���
��
��SU���
�

�
�����)���j�
�
�������c��i����
 ���4����
�
��8{���j�
�
��p�-���
��
��KM���
�

�
��؄Ӟ,�
�
�
�
�
�
�
�
�
����������
�
�
�
�
X���0����
�
����8����
�
��۟8���
�
x�������
�
��ɠ(x�̠��
�

�
 �ܠ��ǡ/X�ʡ���
�

�
 �֡�' �ܡ���;������
��
�
�
��x���
�
� ��� �������.X������
�

�
 ������������.X������
�

�
 ������������,�
�
�
�
�����
�
�
�
����� ����������
��
��
�
�
���
��x���ϒ�Ʃ�8�ɩ��(���
�
����0�۩J ���JL�����@������������
�
�
��
�
�
�Ϋ�
��p���ϒ�ë�8�����(�̬
�
�
���0�ƫ�' �֫M���MO��׭�(�ڭ������
��
�'�
�
�
����
��x�������@���
�
��� ����'0���A ��AC��Я�H�ӯ��������
�
�
�'�
�
�
����
��p�ݯ������@��
�
�
�� ����'0����' �ʰL��LN��ܱ,�
�
���
�
�����@����������
��
��
�
�
�Ͳ�
�����ϒ�²�8�����(���
�
����0�ŲBP���BD�����H�ô������
��
�'�
�
�
����
����ʹ�����@��
�
��� ����'0���AP�ӴAC��������5�����)���������ŷ�p�ѷ�8��������6��؄�����۸����%������.����̹O������@������^��8�Ի�����8��������7��	؄����������5������*�����!������������0��������5������+����޿A������������0��8�����,���
�
�
�
�����
�
�
�
����� ���������������������������q�aX�����
��
��
�
�
����
��x���ϒ����8�������(���
�
����0���K ���KM[��
��
�
�
������
ܕ�
���
���
�
�
�
������������@������������
�
�
��
�
�
����
��p���ϒ����8�����(���
�
�
���0����(���M���MO����
ܕ�
���
���
�
�
�
�
���������(�����������
��
�'�
�
�
����
��x���������@���
�
��� ����'0���A ���AC���
��
�
�
�������H�������������
�
�
�'�
�
�
����
��p���������@���
�
�
�� ����'0����(���L���LN����,���
�
���
�
�����@����������
��
��
�
�
����
������ϒ����8�����(���
�
����0���BP���BD����
ܕ�
���
���
�
�
�
����������H�����������
��
�'�
�
�
����
������������@���
�
��� ����'0���AP���AC����$,���
�
�
�
�����
�
�
�
����� ���������������������������q�aX�����
��
��
�
�
����
��x���ϒ����8�������(���
�
����0���K ���KM�����@������������
�
�
��
�
�
����
��p���ϒ����8�����(���
�
�
���0����(���M���MO�����(�����������
��
�'�
�
�
����
��x���������@���
�
��� ����'0���A ���AC����
ܕ�
���
���
�
�
�
����������H�������������
�
�
�'�
�
�
����
��p���������@���
�
�
�� ����'0����(���L���LN����
ܕ�
���
���
�
�
�
�
��������',���
�
���
�
�����@����������
��
��
�
�
����
������ϒ����8�����(���
�
����0���BP���BD�����H�����������
��
�'�
�
�
����
������������@���
�
��� ����'0���AP���AC����
ܕ�
���
���
�
�
�
�����������
�
�
�
�
������
�
��щH�׉�
�
���� ����
�
x�������
�
ȅ��8����
�

�
��������(���
�

�
 �����?��
�
�
�
�
�
�������
�
�
�
�
P��@(��@�
�
�
�І�@0��@��
�

�
m��
�
���A#X��A���
�

�
 ��A���B#X��B���
�

�
 ��B���C,h��C���
�

�
�K(��C���D,h��D���
�

�
�K(��E؏Ӟ-�
�
�
�
�
�
�
�������������
�
�
�X���0����
�
����8����
�
��۟8���
�
x�������
�
��ɠ(x�̠��
�

�
 �ܠ��ǡ/X�ʡ���
�

�
 �֡�' �ܡ���;������
��
�
�
��x���
�
� ��� �������.X�������������������;t����
�

� ������������.X������
�

� ������������-����������������� ���������������������������q�aX��������������x���ϒ�Ʃ�8�ɩ��(���
�����0�۩J ���JL�����@�������������
������Ϋ���p���ϒ�ë�8�����(�̬
��
���0�ƫ�' �֫M���MO��׭�(�ڭ���������'���������x�������@���
���� ����'0���A ��AC��Я�H�ӯ���������
��'���������p�ݯ������@��
��
�� ����'0����' �ʰL��LN��ܱ-�����������@�����������������Ͳ�������ϒ�²�8�����(���
�����0�ŲBP���BD�����H�ô���������'�����������ʹ�����@��
���� ����'0���AP�ӴAC��������5�����)���������ŷ�p�ѷ�8��������6��؏�����۸����%������.����̹O������@������^��8�Ի�����8��������7��	؏����������5������*�����!������������0��������5������+����޿A������������0��8�����-������������������� ���������������������������q�aX�����������������x���ϒ����8�������(���
�����0���K ���KMd������������ܕ��������������������@�������������
�����������p���ϒ����8�����(���
��
���0����(���M���MO����ܕ�����������
���������(��������������'���������x���������@���
���� ����'0���A ���AC��������������H��������������
��'���������p���������@���
��
�� ����'0����(���L���LN����-�������������@��������������������������ϒ����8�����(���
�����0���BP���BD����ܕ��������������������H��������������'�������������������@���
���� ����'0���AP���AC����$-������������������� ���������������������������q�aX�����������������x���ϒ����8�������(���
�����0���K ���KM�����@���������Ѝ��
�����������p���ϒ����8�����(���
��
���0����(���M���MO�����(��������������'���������x���������@���
���� ����'0���A ���AC����ܕ��������������������H��������������
��'���������p���������@���
��
�� ����'0����(���L���LN����ܕ�����������
��Γ����'-�������������@�������Ѝ�����������������ϒ����8�����(���
�����0���BP���BD�����H��������������'�������������������@���
���� ����'0���AP���AC����ܕ�������������Γ�������������������щH�׉������ �����x��������Ȑ��8�����
���������(����
� �����?������������������P��@(��@���
�Б�@0��@���
�p������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��EؚӞ.�����������������������X���0���������8�������۟8����x����������ɠ(x�̠���
� �ܠ��ǡ/X�ʡ���
� �֡�' �ܡ���;�����������x���
�� ��� �������.X�������
� ������������.X�������
� ������������.����������������� ���������������������x���ϒ�Ʃ�8�ɩ��(���
�����0�۩J ���JL�����@�������������
������Ϋ���p���ϒ�ë�8����(�̬
��
���0�ƫ�' �֫M���MO��׭�(�ڭ���������'���������x�������@���
���� ����'0���A ��AC��Я�H�ӯ���������
��'���������p�ݯ������@��
��
�� ����'0����' �ʰL��LN��ܱ.�����������@�����������������Ͳ�������ϒ�²�8����(���
�����0�ŲBP���BD�����H�ô���������'�����������ʹ�����@��
���� ����'0���AP�ӴAC��������5�����)���������ŷ�p�ѷ�8��������6��ؚ�����۸����%������.����̹O������@������^��8�Ի�����8��������7��	ؚ����������5������*�����!������������0��������5������+����޿A������������0��8�����.������������������� ���������������������������q�aX�����������������x���ϒ����8�������(���
�����0���K ���KMw������������ܕ�������������˗�������@���������ڵ��
�����������p���ϒ����8�����(���
��
���0����(���M���MO����ܕ�����������
��ϸ�����(��������������'���������x���������@���
���� ����'0���A ���AC��������������H��������������
��'���������p���������@���
��
�� ����'0����(���L���LN����.�������������@�������ڵ�����������������ϒ����8�����(���
�����0���BP���BD����ܕ�������������ϸ�����H��������������'�������������������@���
���� ����'0���AP���AC����$.������������������� ���������������������������q�aX�����������������x���ϒ����8�������(���
�����0���K ���KM�����@�������������
�����������p���ϒ����8�����(���
��
���0����(���M���MO�����(��������������'���������x���������@���
���� ����'0���A ���AC����ܕ��������������������H��������������
��'���������p���������@���
��
�� ����'0����(���L���LN����ܕ�����������
��������'.�������������@��������������������������ϒ����8�����(���
�����0���BP���BD�����H��������������'�������������������@���
���� ����'0���AP���AC����ܕ����������������������������������щH�׉������ �����x��������ț��8�����
���������(����
� �����?������������������P��@(��@�����@0��@���
�y������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��EإӞ/�����������������������X���0���������8�������۟8����x����������ɠ(x�̠���
� �ܠ��ǡ/X�ʡ����
� �֡�' �ܡ���;������������x���
�� ��� �������.X�������������������;t�����
� ������������.X�������
� ������������/����������������� �������١������������x���ϒ�Ʃ�8�ɩ��(���
�����0�۩J ���JL�����@���������١��
������Ϋ���p���ϒ�ë�8�����(�̬
��
���0�ƫ�' �֫M���MO��׭�(�ڭ���������'���������x�������@���
���� ����'0���A ��AC��Я�H�ӯ���������
��'���������p�ݯ������@��
��
�� ����'0����' �ʰL��LN��ܱ/�����������@�������١��������Ͳ�������ϒ�²�8�����(���
�����0�ŲBP���BD�����H�ô���������'�����������ʹ�����@��
���� ����'0���AP�ӴAC�������5�����)���������ŷ�p�ѷ�8��������6��إ�����۸����%������.����̹O������@������^��8�Ի�����8��������7��	إ����������5������*�����!������������0��������5������+����޿A������������0��8�����/������������������� ���������������������������q�aX�����������������x���ϒ����8�������(���
�����0���K ���KM�������������ܕ����������������������@�������������
�����������p���ϒ����8�����(���
��
���0����(���M���MO����ܕ�����������
���������(��������������'���������x���������@���
���� ����'0���A ���AC��������������H��������������
��'���������p���������@���
��
�� ����'0����(���L���LN����/�������������@��������������������������ϒ����8�����(���
�����0���BP���BD����ܕ��������������������H��������������'�������������������@���
���� ����'0���AP���AC����$/������������������� ���������������������������q�aX�����������������x���ϒ����8�������(���
�����0���K ���KM�����@�������������
�����������p���ϒ����8�����(���
��
���0����(���M���MO�����(��������������'���������x���������@���
���� ����'0���A ���AC����ܕ��������������������H��������������
��'���������p���������@���
��
�� ����'0����(���L���LN����ܕ�����������
��������'/�������������@��������������������������ϒ����8�����(���
�����0���BP���BD�����H��������������'�������������������@���
���� ����'0���AP���AC����ܕ����������������������������������щH�׉������ �����x��������Ȧ��8�����
���������(����
� �����?������������������P��@(��@���&��@0��@���
��������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��EذӞ0�����������������������X���0���������8�������۟8����x����������ɠ(x�̠���
� �ܠ��ǡ/X�ʡА��
� �֡�' �ܡ���;���А�������x���
�� ��� �������.X�������������������;t�����
� ������������.X������
� ������������0����������������� ���������������������������q�aX��������������x���ϒ�Ʃ�8�ɩ��(���
�����0�۩J ���JL�����@�������������
������Ϋ���p���ϒ�ë�8���Ӗ(�̬
��
���0�ƫ�' �֫M���MO��׭�(�ڭ���������'���������x�������@���
���� ����'0���A ��AC��Я�H�ӯ���������
��'���������p�ݯ������@��
��
�� ����'0����' �ʰL��LN��ܱ0�����������@�����������������Ͳ�������ϒ�²�8���Ӗ(���
�����0�ŲBP���BD�����H�ô���������'�����������ʹ�����@��
���� ����'0���AP�ӴAC�������5�����)���������ŷ�p�ѷ�8��������6��ذ�����۸����%������.����̹O������@������^��8�Ի�����8��������7��	ذ����������5������*�����!������������0��������5������+����޿A������������0��8�����0������������������� ���������������������������q�aX�����������������x���ϒ����8�������(���
�����0���K ���KM�������������ܕ��������������������@���������ˤ��
�����������p���ϒ����8�����(���
��
���0����(���M���MO����ܕ�����������
���������(��������������'���������x���������@���
���� ����'0���A ���AC$�������������H��������������
��'���������p���������@���
��
�� ����'0����(���L���LN����0�������������@�������ˤ�����������������ϒ����8�����(���
�����0���BP���BD����ܕ��������������������H��������������'�������������������@���
���� ����'0���AP���AC����$0������������������� ���������������������������q�aX�����������������x���ϒ����8�������(���
�����0���K ���KM�����@�������������
�����������p���ϒ����8�����(���
��
���0����(���M���MO�����(��������������'���������x���������@���
���� ����'0���A ���AC����ܕ��������������������H��������������
��'���������p���������@���
��
�� ����'0����(���L���LN����ܕ�����������
��������'0�������������@��������������������������ϒ����8�����(���
�����0���BP���BD�����H��������������'�������������������@���
���� ����'0���AP���AC����ܕ����������������������������������щH�׉������ �����x��������ȱ��8�����
���������(����
� �����?������������������P��@(��@���M�в�@0��@���
��������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��EȻ��1��������������h���@��������X�����
� �������*x������
� �������1X�������
� ����' �������=�������������x���
�� ��� �������1����������������� ���������������������������q�aX���������������x���ϒ����8�����(���
�����0���J ���JL�����@�������������
�����������p���ϒ����8�����(�Հ
��
���0����' ���M���MO��ށ�(�����������'���������x��������@���
���� ����'0���A ��AC��Ճ�H�؃���������
��'���������p�������@���
��
�� ����'0����' �τL��LN���1�����������@�����������������چ�������ϒ�φ�8�����(�Ç
�����0�҆BP���BD��ˈ�H�Έ���������'�����������؈�����@��
���� ����'0���AP�ވAC�������������������щH�׉������ �����x��������ȼ��8�����
���������(����
� �����?������������������P��@(��@�����н�@0��@���
�������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��EȾ��2��������������h���@��������X�����
� �������*x������
� �������1X�������
� ����' �������=�������������x���
�� ��� �������2����������������� ���������������������������q�aX���������������x���ϒ����8�����(���
�����0���J ���JL�����@�������������
�����������p���ϒ����8�����(�Հ
��
���0����' ���M���MO��ށ�(�����������'���������x��������@���
���� ����'0���A ��AC��Ճ�H�؃���������
��'���������p�������@���
��
�� ����'0����' �τL��LN���2�����������@�����������������چ�������ϒ�φ�8�����(�Ç
�����0�҆BP���BD��ˈ�H�Έ���������'�����������؈�����@��
���� ����'0���AP�ވAC�������������������щH�׉������ �����x��������ȿ��8�����
���������(����
� �����?������������������P��@(��@�������@0��@���
��������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��E����3��������������h���@���������X�����
� �������*x������
� �������1X�������
� ����' �������=�������������x���
�� ��� �������3����������������� ���������������������������q�aX���������������x���ϒ����8�����(���
�����0���J ���JL�����@�������������
�����������p���ϒ����8�����(�Հ
��
���0����' ���M���MO��ށ�(�����������'���������x��������@���
���� ����'0���A ��AC��Ճ�H�؃���������
��'���������p�������@���
��
�� ����'0����' �τL��LN���3�����������@�����������������چ�������ϒ�φ�8�����(�Ç
�����0�҆BP���BD��ˈ�H�Έ���������'�����������؈�����@��
���� ����'0���AP�ވAC�������������������щH�׉������ �����x������������8�����
���������(����
� �����?������������������P��@(��@��������@0��@���
�������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��E����4��������������h���@���������X�����
� �������*x������
� �������1X�������
� ����' �������=�������������x���
�� ��� �������4����������������� ���������������������������q�aX���������������x���ϒ����8�����(���
�����0���J ���JL�����@�������������
�����������p���ϒ����8�����(�Հ
��
���0����' ���M���MO��ށ�(�����������'���������x��������@���
���� ����'0���A ��AC��Ճ�H�؃���������
��'���������p�������@���
��
�� ����'0����' �τL��LN���4�����������@�����������������چ�������ϒ�φ�8�����(�Ç
�����0�҆BP���BD��ˈ�H�Έ���������'�����������؈�����@��
���� ����'0���AP�ވAC�������������������щH�׉������ �����x������������8�����
���������(����
� �����?������������������P��@(��@���"����@0��@���
��������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��E����5��������������h���@���������X�����
� �������*x������
� �������1X�������
� ����' �������=�������������x���
�� ��� �������5����������������� ���������������������������q�aX���������������x���ϒ����8�����(���
�����0���J ���JL�����@�������������
�����������p���ϒ����8���Ơ(�Հ
��
���0����' ���M���MO��ށ�(�����������'���������x��������@���
���� ����'0���A ��AC��Ճ�H�؃���������
��'���������p�������@���
��
�� ����'0����' �τL��LN���5�����������@�����������������چ�������ϒ�φ�8���Ơ(�Ç
�����0�҆BP���BD��ˈ�H�Έ���������'�����������؈�����@��
���� ����'0���AP�ވAC�������������������щH�׉������ �����x������������8�����
���������(����
� �����?������������������P��@(��@��������@0��@���
�������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��E���?6�����������������P��@(��@���L����@0��@���
��������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��E���?7�����������������P��@(��@�������@0��@���
�y������A#X��A����
� ��A���B#X��B����
� ��B���C,h��C����
��K(��C���D,h��D����
��K(��E���#���DA A number of bits to be consumed or written, with a known maximum�������@= Although [`BitRead::read`] and [`BitWrite::write`] should be����JG preferred when the number of bits is fixed and known at compile-time -����A> because they can validate the bit count is less than or equal����0- to the type's size in bits at compile-time -����;8 there are many instances where bit count is dynamic and����)& determined by the file format itself.����C@ But when using [`BitRead::read_var`] or [`BitWrite::write_var`]����DA we must pessimistically assume any number of bits as an argument����?< and validate that the number of bits is not larger than the����-* type being read or written on every call.����<�������63 use bitstream_io::{BitRead, BitReader, BigEndian};�������41 let data: &[u8] = &[0b100_0001_1, 0b111_0110_0];����3�����%" // our bit count is a 3 bit value����,�����:7 // that count indicates we need to read 4 bits (0b100)�̳� assert_eq!(count, 4);����! // read the first 4-bit value����96 assert_eq!(r.read_var::<u8>(count).unwrap(), 0b0001);����" // read the second 4-bit value����9�����! // read the third 4-bit value����96 assert_eq!(r.read_var::<u8>(count).unwrap(), 0b0110);�<����������>; In the preceding example, even though we know `count` is a����A> 3 bit value whose maximum value will never be greater than 7,����=: the subsequent `read_var` calls have no way to know that.����OL They must assume `count` could be 9, or `u32::MAX` or any other `u32` value����KH and validate the count is not larger than the `u8` types we're reading.�������>; But we can convert our example to use the `BitCount` type:����<�������@= use bitstream_io::{BitRead, BitReader, BigEndian, BitCount};�������4̽���3�����?< // our bit count is a 3 bit value with a maximum value of 7����1�����:վ���1. assert_eq!(count, BitCount::<7>::new::<4>());����!�����@= assert_eq!(r.read_counted::<7, u8>(count).unwrap(), 0b0001);����"�����@= assert_eq!(r.read_counted::<7, u8>(count).unwrap(), 0b1111);����!�����@= assert_eq!(r.read_counted::<7, u8>(count).unwrap(), 0b0110);�<����������FC Because the [`BitRead::read_counted`] methods know at compile-time����JG that the bit count will be larger than 7, that check can be eliminated����>; simply by taking advantage of information we already know.�������A> Leveraging the `BitCount` type also allows us to reason about����HE bit counts in a more formal way, and use checked permutation methods����<9 to modify them while ensuring they remain constrained by����#  the file format's requirements.�9D���
����t�����<��)h����L��$���� ���	��
����p�����X(���	��
����p���������DF�����������
��
,��(���	��
����p�������_�9EG��������^�^��^��[�^���[����e�S��ޝ�����
��
,���� ���	��
����p�������`�3EG���������������������`���
��
��$���������	��
����p��������(E�LNQS8�]ac���������
��
��H���	��
����p������:>��
����5�����Fuw�������������
��
L�������)���TQ A number of bits to be read or written for signed integers, with a known maximum�������MJ This is closely related to the [`BitCount`] type, but further constrained����IF to have a minimum value of 1 - because signed values require at least���� 1 bit for the sign.�������%" Let's start with a basic example:����<�������6��������4̽���3�����%�����,�����:վ̾������(% // read the first 4-bit signed value����41 assert_eq!(r.read_var::<i8>(count).unwrap(), 1);����)& // read the second 4-bit signed value����52 assert_eq!(r.read_var::<i8>(count).unwrap(), -1);����(% // read the third 4-bit signed value����41 assert_eq!(r.read_var::<i8>(count).unwrap(), 6);�<����������>�����A�����=�����O�����JG and validate the count is not larger than the `i8` types we're reading����?< while also greater than 0 because `i8` requires a sign bit.�������DA But we can convert our example to use the `SignedBitCount` type:�<�������FC use bitstream_io::{BitRead, BitReader, BigEndian, SignedBitCount};�������4̽���3�����?�����1�����0- // convert that count to a signed bit count,����30 // which guarantees its value is greater than 0����.+ let count = count.signed_count().unwrap();����:վ���74 assert_eq!(count, SignedBitCount::<7>::new::<4>());����!�����B? assert_eq!(r.read_signed_counted::<7, i8>(count).unwrap(), 1);����"�����C@ assert_eq!(r.read_signed_counted::<7, i8>(count).unwrap(), -1);����!�����B? assert_eq!(r.read_signed_counted::<7, i8>(count).unwrap(), 6);�<����������MJ Because the [`BitRead::read_signed_counted`] methods know at compile-time����J�����>��������GD Leveraging the `SignedBitCount` type also allows us to reason about����H�����<�����#��<t���
����t����C�.׬�y��� �����$���������D������ ���	��
����p�����v(���	��
����p���������DF�����������
��
,��(���	��
����p�������_�WEG��������^�^��^��[�^���[����e�S��ޝ�����
��
,���� ���	��
����p�������`�QEG����������������������
��
��$���������	��
����p��������3E�LNQS8�]ac���������
��
��H���	��
����p������:>��
����5�����Fuw�������������
��
L���������<9 An error when converting a value to a [`Checked`] struct�>d����.V䚜6>������l��ܘ� Excessive bits for type�>+����?A����t��˧ Excessive value for bits�>,����@B���� ��	���(���	������%'�����������
�,��(���	�����_�%'��������^�^��^��[�^���[����e�S��ޝ�����
�,����ġ���<9 A type for eliminating redundant validation when writing�������DA Normally, when writing a value, not only must the number of bits���2/ must be checked against the type being written����96 (e.g. writing 9 bits from a `u8` is always an error),��߰A> but the value must also be checked against the number of bits����<9 (e.g. writing a value of 2 in 1 bit is always an error).�ޱ���96 But when the value's range can be checked in advance,����74 the write-time check can be skipped through the use��Բ.+ of the [`BitWrite::write_checked`] method.�?<��j����������������U�˸�����)+-/D��,������Dγ,γ���� ���	�j��������������K���Y������(���	�j�������-��+���M���[�����behk�������������
�����,��(���	�j����������_��M�_��[����_�HKNQ����������^�^��^��[�^���[����e�S��ޝ�����
�����,���@���)���41 A fixed number of bits to be consumed or written�������85 Analagous to [`BitCount`], this is a zero-sized type����?< whose value is fixed at compile-time and cannot be changed.����l�������<������������`]     BigEndian, BitRead, BitReader, BitWrite, BitWriter, CheckedUnsignedFixed, FixedBitCount,�4����������0- type FourBits = CheckedUnsignedFixed<4, u8>;�������30 let input: &[u8] = &[0b0001_1111, 0b0110_1001];����41 let mut r = BitReader::endian(input, BigEndian);����ܞ� // read 4, 4-bit values����@= let v1 = r.read_checked::<FourBits>(FixedBitCount).unwrap();����@= let v2 = r.read_checked::<FourBits>(FixedBitCount).unwrap();����@= let v3 = r.read_checked::<FourBits>(FixedBitCount).unwrap();����@= let v4 = r.read_checked::<FourBits>(FixedBitCount).unwrap();�������(% assert_eq!(v1.into_value(), 0b0001);����(% assert_eq!(v2.into_value(), 0b1111);����(% assert_eq!(v3.into_value(), 0b0110);����(% assert_eq!(v4.into_value(), 0b1001);�������+( // write those same values back to disk����5�����! w.write_checked(v1).unwrap();����! w.write_checked(v2).unwrap();����! w.write_checked(v3).unwrap();����! w.write_checked(v4).unwrap();������� // ensure they're the same����2/ assert_eq!(w.into_writer().as_slice(), input);�<����Al�������|�����>o��q��CC����H$�� ���	������x�����<(���	������x���������DF�����������
��,��(���	������x�������_�EG��������^�^��^��[�^���[����e�S��ޝ�����
��,�������/���4������>; Analagous to [`SignedBitCount`], this is a zero-sized type����?����l�������<������������;8     BigEndian, BitRead, BitReader, BitWrite, BitWriter,���0-     CheckedSignedFixed, FixedSignedBitCount,�4����������.+ type FourBits = CheckedSignedFixed<4, i8>;�͟��џ3����4�����ܾ����ڠFC let v1 = r.read_checked::<FourBits>(FixedSignedBitCount).unwrap();����FC let v2 = r.read_checked::<FourBits>(FixedSignedBitCount).unwrap();���FC let v3 = r.read_checked::<FourBits>(FixedSignedBitCount).unwrap();����FC let v4 = r.read_checked::<FourBits>(FixedSignedBitCount).unwrap();�������#  assert_eq!(v1.into_value(), 1);����$! assert_eq!(v2.into_value(), -1);��ã#  assert_eq!(v3.into_value(), 6);���$! assert_eq!(v4.into_value(), -7);�������+�����5����!����!�����!���إ!������������2Ɏ<Ц��D��������|����ӁމX+���C����H$�� ��	������x�����<(��	������x���������DF����������
��,�(��	������x�������_�EG��������^�^��^��[�^���[����e�S��ޝ����
��,���������.��FL�����c��8�v�<)���� ���	���(���	������%'�����������
�,��(���	�����_�%'��������^�^��^��[�^���[����e�S��ޝ�����
�,���Ѽ�����2�Jd����sOa=ل�]�<)���� ���	���(���	������%'�����������
�,��(���	�����_�%'��������^�^��^��[�^���[����e�S��ޝ�����
�,�����Nb��b�L�b�Ub�i[b��_b��gb�vkb��pb�4vb��xb�7}b�m�b���b���b�w�b�&�b�A�b�J�b���b��b���b�b�b�5�b�b�b���b���b��b�w�b�p�b�ƹb���b���b���b���b���b�&�b���b���b���b���b���b�`�b��b�(�b���b���b���b���b���b��b���b�|�b���b���b�
�b��b���b��b���b���b�m�b���b���b���b���b���b��b���b���b��b���b�o�b���b�
�b���b���b���b���b���b�x�b���b���b�9�b���b���b�&�b���b�A�b�҈b���b��b�x�b���b��b��b���b�b��b�Yb�(b��b�fb�b��b��
b���b�Eb��b�b��b��b�`b�Kb�@b���b�,b��b�b��b�&!b���b�K"b�/#b��%b��'b�)b��)b�l*b�Đb��*b�Z+b�B,b��2b�+Vb���b�;Yb�4[b��]b���b�s`b���b�kjb��kb�Inb�pob��tb�zb�~b�1�b�ҋb�}�b��b���b�2�b�Z�b�/�b�D�b�3�b�ΰb�Ͳb�H�b���b�n�b���b�ؽb���b�O�b���b���b���b���b���b���b���b���b�)�b�0�b�"�b�ͧb���b�l�b�0�b���b���b�Q�b�
�b���b�n�b��b���b���b���b�k�b��b���b�Ƚb��b���b���b���b�
�b���b���b���b�(�b���b���b��b�>�b�y�b���b�
�b�`�b�b�b�j�b�X�b���b���b�U�b�o�b��b���b���b���b���b���b���b���b�_�b���b���b�Bb��b��b�]b�b��b�hb��b�śb�Gb��b�,b��b��b�Qb�	b�
b��b�Jb�
b�#
b��b���b�$b�Wb���b�L��b��b��b�&b�g�b���b���b�V�b�t�b�;�b���b���b���b���b���b�"�b��b�1�b���b�t�b���b�F�b���b���b���b��b�^�b���b�>�b��b���b�Y�b���b�~�b��b���b�D�b���b�A�b���b���b�5�b���b���b��b�}�b���b��b�/�b�Q�b���b���b���b���b��b�}�b���b���b���b���b�2�b���b�k�b���b���b��b�ڻb�ķb��b���b���b�!�b�;�b��b���b���b�Ëb�կb���b���b��b�>�b���b�
�b���b���b��b���b���b��b���b���b���b��b�֨b�ܞb��b�7�b�֯b�8�b�k�b���b�E�b��b��b���b�ؔb���b���b���b���b�i�b���b���b���b���b���b���b�ۋb��b�d{b�zb��xb��vb�{tb�Psb�1ob�Rnb��mb��lb�#kb��ib��hb�?gb��eb��cb�)�b���b���b�W�b���b�ڨb�]�b�Ъb���b���b�¬b���b���b���b�I�b���b�ֱb���b���b�ôb���b���b���b���b��b���b��b�&�b�P�b��b���b���b���b���b�j�b���b���b�L��b�T�b��b�\�b��b��b�ҟb�L�b�ܕb��b�L��b�m�b���b�Ѹb�/�b�׏b�&�b���b�ھb�k}b���b��|b��{b���b���b�:zb�Nxb���b��wb�xvb��tb���b���b�(fb���b��eb��db���b���b��bb�3\b���b��[b�
Yb��Wb���b���b��Vb�Ub���b��Sb���b���b��Rb���b���b��Qb���b���b��Pb�kOb���b�Ɩb�|Nb��b���b��Mb���b�̢b�XJb�bIb���b���b��Gb�˼b���b�Eb�WDb��Bb���b���b�#Bb�O@b���b�@?b���b���b�2>b���b���b�=b���b���b�/<b�4;b���b�эb�E:b���b���b��9b��b���b�F6b�P5b�զb���b��3b���b�ްb�/1b�t0b�c/b���b���b���b�&b�	%b�%b�&b�-$b�m#b�t#b�,$b�� b�Lb�Sb�{ b��b��b��b��b��b��b��b�Hb�Jb��b��b�:b�<b��b��b�,b�.b�Eb�sb��b��b��b�
b��b�_�b�"�b�2�b�4�b��b���b���b���b���b�Z�b���b���b���b�)�b�]�b�a�b���b�Q�b���b���b���b���b���b�1�b�]�b���b�I�b���b��b���b��b�G�b�{�b��b���b�o�b��b���b���b���b���b�P�b�|�b���b�h�b��b�8�b�˶b���b�#�b�W�b�[�b���b�K�b��b���b���b���b���b�,�b�X�b���b�D�b�ߣb��b�V�b���b���b��b��b��b�֓b�n�b�1�b�A�b�C�b��b���b��b��b�Ήb�i�b���b��b�4�b�_b��~b��}b��|b��vb��ub��tb�)tb�-sb�crb�3lb�`kb��jb��ib��hb��gb��ab��`b�!`b�U_b�Y^b��]b�_Wb��Vb��Ub��Tb��Sb�%Sb��>b�>b�>b��>b�L=b�R=b�k<b��;b��;b��1b��0b��0b��1b�F0b�L0b�v/b��.b��.b��,b��+b��+b��,b�}'b�G&b�M&b�n'b�b�b�b��b�}b��b��b�pb��b��b��b��b��b�+b�1b��b����������������	�	�	�
�
�
�
�
��`BitWrite::write_var��BitWrite::write_unsigned��2BitWrite::write_checked��]BitWrite::write_bytes�
BitRead::read�SBitRead::read_var��O�@�(�YBitRead::read_signed�BitWrite::write���{���2�ŤBitRead::read_bytes�������BitRead::read_signed_counted�BitRead::read_counted�����]��Y�	�@io::Read��(�BitRead::read_unsigned���g�{��Ť	io::Write���~�����lBitRead::read_count��P��\��BitRead2::read���_���@����{�
Ť��������zBitWrite::write_signed���X�P����BitRead2::read_in�����������������z��������P��������������2�z���������]����V�����������(�Y��crate::read�9crate::read::FromBitStream�crate::write::ToBitStream�crate::write��	�����	������	����	��������	�	�std::str::FromStr��tstd::str��$�Ť�#�����O���$�Ť�#����0���Ť��$�#�(�(��(�@�@�BitRecorder::written_checked��@�����������Ϻ�������������_O������������������������	����������������������I�I�I�H�J��������������������������I�I�I�H�J��������	������O����������������������������I�I�I�H�J�����������	������������������������������������I�I�I�H�J������stop bit must be 0 or 1MAX value must be > 0CMAX should fill some whole number of bits ('0b111', '0b1111', etc.)Cexcessive value for bits read>assertion failed: FIELD_SIZE >= 2 && FIELD_SIZE < U::BITS_SIZE>excessive bits for type read)signed reads need at least 1 bit for sign) excessive value for bits written excessive bits for type written*signed writes need at least 1 bit for sign*booleans require exactly 1 bit.BITS must be less than the type's size in bits.BITS must be <= MAXBITS must be > 0�����������������������������('�����\�+�' ���-�ľW�}�Ն�a�V��,k��)zi��.J*/\!E��S�#��U(�#?�����KL����c�.� ��_ g�ֳ]���r0ORm�1��t�A�؏`m��o���u��G����U�>뤆��߬���=�Fa?��s����x��p��V��=��֛{&8�_z����ݻC
��X3u�>{Z�{��X���s#�gd6
\|O�U�Ȩษ�����e��6����	U��/������g�u'c#��2�l�-K�‚�����" ���J\�%�ӯ�p�(q��*����5R??�R�&�,��r;�:��=]�l�u�?��Ť���/;'�A��H��7ӿ�%)�O�k2��	l��˭j�py�d���Gq�`�5��b֝Y�Ȇ��KΚ'E��Ci��S���b��V�{�T��"@��~Bu������.f�qr����n�l�I��o�h������[���.���ŁY
r���5�g��/�(��b�	^t,�	���a�Mlyyd|��mP��C#�ֽ[I��W�w��4S�uf5��n�d#�T\���]�X�>Y>�tXK:�)�	��i���iiY#�ج&1��޴A��)J2H�.,��W� ��%�|f/�wN�����3'E�E�H=��c��M���8���
B�E-�~�3���>���+
���҈�ڍS";�N
�U%h.q͏<ڠo�N��ۈ�	�h��m������t.�՚_2�6�|r�P�ML~�z@dkث�_�)���=r/1�-����A$��E���1�c7�-i�n`R&�v�����/��H_%A�[@@FF}�{�� �<{7«�P� ��c���Հ�����?�~�M�D��V/�0A��F��/�v|	��;�1�ng�:��U�±N���F��
Z�������b��Ao�YJ����!�78wN ʨ�h8H��J<�#?{�j��#����oa��ϻ��zk�P���TB9%�S�Mj:.��[�V���]t@�_#d�JG�h��
?����_���X/Oۗ84���R�2�[��G�����ҩ��SN��Ug�!M��>aD��w�0#�.~j�u��t��7w�E���t�^�4	"LZ<�/�,$�ڥ�c!�k�M-!�~en�M� ξ�>ig%$RW��P�*(=�GH;R�.U	��b_�F�fc�1�_��p	���f��ɛf��n��[%��i�y�����t�������K���_�ti�� @���5Z�[
��a���|��.j��\�6� x9���:TV��]��Dcȯc7�V���4ۧ��sjn��бRTt82v	wQ�����:Zn!��(��XŲ��\G�q�S4�K�93�!�<K��-�����ICĩ7��Y��k�n�<����Ք�#���[E�� �x^�-��7`�ѻ���'z�����Xqn�Ç:����A���������`K@C���Y�P�����i��(���1��.�:���j���V�����Ņ<����N��o�i��,;��S�������%k���A����㝬�g���;�r�k"#�{��i�:"QIh��]DIX}�G��i)�}�F2 �U;��	stQ�݉������򭰍`�$"jza��<h3k�K2�v.h�E!v9��Qx�2e�WڢK��݁p`%�Cy�0c?YO�H	6n�����х�1�ž�|�'6����1P��+̙�
��:a��)~Zn+�Y2��V]��"=��槳���/7�9co�1��
;��m��pZQ�6m��-�����(鉽����׹\�#�%/����ښ���Ps��4�3f�;�h�>�M��_���wx����WL3�ӡ {8����e���I�_�;��O�n�7�FdTD$�~���u�֜�COrc�U�(�\'�	��-�U��+"l��@�:�7��ܟD�XvT��1=��Z��G@6��m��.�~�y�Vn�n��'1C��?�ʗM��;����k�գ�9\��;����_���5I����n�[����S\���?~�w(�`� �|e��}5�"*G�'A71Ŕ�,�B9/`yȭv%�E�pvO�oTcL��C�5W�w��^79��d
(���y�0�OI|h�E
���Ɍ�'�FwG���z��+��݈eJ�ݎ��]�@�1�U*�p��c��\H=�x�asjI�!��,O��^-���B)�E��ܥ|%;��B��T݂���M{���֣��gG�%�g��1�J`���4�	3�z��c�M($�Ą��E��cXⵛ"�r+���ϣ�O�s��8�u��n��(aϹSc�v�R�.1�e͸������x��\̋���>��T�ed?����5�pn�/�W�y&&��JC�P�b-��mq��gl��eV
]����,�q�s(SϜH����O���v�9��D.�;#�Y8����@}�I���jRk�����K�Q�%oPe�ר�fi�MyQ�t)�t���������S�9g>�a��z�-rny?;c�55/��ʼ�&�������kȷ�>��\��c:P8�b����4srG��l_����._���	K�R�淡,~�XŤ��q�z(�X
ў��pp�' �o)�L÷�]��|���?��
��.�v�!����
Ќ>��G����M�F<I�[�*���,�tvc���f)��
�Jh�z#���C��sñ�Qju�Z0�,tBK�
����|8;2gB�0�B�PqA;��ɃUj�ɭ!���w���%uz
^%�4�Gu%�W�G�x�����[��c�h]X�7��7�y ��Y?�ջ������Ө�?m9Pf�63Z���Ǽ�ZO@p�9D��M�B8"��o.�����R%�����8� a2c��u�_$G�E]�D��4���� �qQ�������<�3K�駯��w�P81���Pk��>�H�y�gՂ��s����D�Sƨ��9�ϋf�y��|����׍�hs(�+շ�.ކ�og/�9��.�І�M�7�s�#:��K*б.�Y�!Z�;a��2{z�	|o<'i�Y�N�	�Gjt����D��Y�07a�O� ��,�T�Y����x���v:�y����s�����U���Q�x�ޓ����ݑ��uUlij.�e�ʪ) W�T ��'���-�j�K1]��sH�N.�٤Ur�5�IJ��3�	��[
�Zj����p�!��d�i�=o��<��_cP��b$n�%��7&�A�������DO���wPG�+�\M~�--9L�yH��V�GV1%r��r,j�M8R`6e�0f������H�80�v;�@�R�w�Ui����KH#A�>�d���vfT9�wd

U8'�}-��˭�x��7���W�L�A��}90���vΫ���9��֙�Z�P�����]%�Ast�.5��m_cgul�Y��U�g��Z
����Ą������Gz�z�K�o������{��ԋNq���S��[�[�=D���ϥ*��3ߵ���x{�'2��gc���~�3|k����9X�f��pH�l8E[����P�C[�Tj�k�׳�P��D$k���q"�o�umv�8�I�h��9#[�C�Ƴ<�Q�o�9�T6��H�p���N�\����1;���7�r.rm�,*υ�ɼ��B�sú\����y �"��^�-���Ng�
��\��tc��5��Vᆹ�0ٰ�6#4VoeA��S��$?���� @Ѝ!�P�"^�8�0�UJ��7#��m�C����Yy�i'�'C�zt�I
�j��cWn��9�"�m'����td�M.��x&�U������PF�r�����e5O�GS����5��T�#��'û��)��;}��>w���Z��=t=V�1]�‹%��]pi��w�n9Lr��e
�xIlv::�)��4��������e�y���Nw+��56@#�|Z}�e3�R|��Z4DC)��'��"!� �'H�3�z�3�*��6PZ��^����t/[nJh���<z�g�j_)�4p
d+�k5U����/��YV�U�TV���e<$�w�O`��+�wT�.v�	��{nb��"�4u��Q�e��q�%��(h�m�P�l��Db�8����A�R����T�|�W+���C����s�Z��:��׻ux����4�Ū�#�S���m"����GG�T�J���ZE쿍Qz�p��p�*�mX8$�=�׉��.��	~��0�(�E�܃@�ٕ艓����ff�N�U�����E,�U`��Z������ˡx�2�M�AT�H
'v�s��۸ �;'�y��`�p�7��,�
4횂nD��E
��.Q���@�<�<z�bvy�K���B+�������S_�R־�D���'�UC9���;8�Le�?���	f#�zk�R!�	C<C�0<�I].=݀԰�c a?6�ށ�;YJ>��c��#a�ŏr'�ؒA��q���V��@~�@�T�1q/M5$(9nf�K!�6�A�F��),�|�IZ�B�����KeQ�I	k����qCsu���40��ۈ2�p���!0��X��Z���,��"=�%tW��qy�5�Y���:z�	��zø.���z�:Wr
��A�'�@<�f{���g�k!�Ky���"~���}�.����*(��l�D-�š�}/v��"&����(Z���iO�Ǎ��z�?0�k��94�\���*n�u%b*�2Q�
�̘0jv�g0�$FIg/����*x�U����8tx�H9��y�o��-�Ό��A�=Iz��k!n/ �Rqs�&����I���9Ab�)J&Z��T->�`,.A]B��剡��{U�
�N28�9�)��3A~y���ѭнFJEE���ܪ-��řLF��\?�4�åa;���yi\�ʻ�qD1���6��}�j(�V�.u����9�Jn!��iX}�A����g�´dn��!8�Q�jØ�(��l�=x=l1����<y��^J[7~C%�c�Oc��vk��&�!�]��&��,�;��s	��ϧ)��J$赖����%2�@�RȄ�t��.������a�]���(G��!X�v9�•��E��!ry��ꈛ����in��l8�����+Ka
��me���u�]C��g�S���I�ד�+*<l��I�b[H��G�������z�Z�*h~`�	�y2�
�:���[^R��RT'�Rs�{E
�E��6�2
i�9��"o�P�������p�f����ǖ�/�)�֊��|����׭`�����n��T�#��-}�����8E
^�}�]!�!Z��-��J(��9�)E�3�s���=�j��P;�&ߘ�ҧ�B��9ͦ�e;�3�O�
��WA`2�/���W���u����\��5�ϧ���w!��(�%������\�eŬt�5�Q/��P&����cʴ-=�
ן��G�|��r|�	[��\�;��������q��\u�B*~�?�5�f<�覎c���^	�2u7��ݜ�B*����Uxծ]�D�a<q9}^���L$�p��B��o���>��Z�8���	�m��B�u���j=�g>�v��Q����s�pJl�[X�΀M#��N����U�O_H8{}�g|�ɔ��+?D�oNG���O�mn��gY����})F+����#0�. �A_�㼢s�~o���q��z%��y|�`�~V��|���B��,<ʳ���� ˦��7"3Gs�j	
��%T_�5b��N���@_TQ��j�7*gN�b&����⸈)=�[�/&�K�٧>��3c�����U�������,!����-����3+������en��9���u���?,��n�I-��%�lUT���l�>�V���b9��y1�6$��hEK���(S��
��N���Z: !T�(`�RC���Q��*A��0H�����G�jQ�o�=x�gLAG$;Y�sv��M�,����o !j�U�ݮH���#���\l��a��O�}��i��\��=�#�<�F�v}s8>l�(��j���Ɇ�G
Q��?S��nY�S:}��↲�����6�&l��n�E�����sa�ȉ��!���3M���7U5��14�˕_7�P��<��Ā��@��`�T�­�.�lo�j~`�}.{ρ�c�G��|�τ��d��-�d���:sJV*ꣀ�x �C�Z�YNS�.X�Ykk�6����t�/�{�Gp��Y�+��I���ǙU�F6]}�k�����*r����O/\�o��r^d��x��P��o�)A8s�u�'�̎���׮��Ok�/�;ӓm��q�:����a���rZJ&�H+0�������1@Bʶ���'����F:���>:<3��݋��7��4y�i�2�uf�?��A�$�C��o`��ذ�����l�Vdh0;�a��6$��(����U��T;	s�(‹>���g��8&��T����|���޼�p<�G�t3��x�G�gDnB,�BDI�~��kkgB�e�6
���h��թ�a<x�\�v��S��m�?\ƈ�'�PF��6��!�_;E�Ŵ;*ț��7[ci�0�>M���:�<(�A*Uԁ
�ɏ�	����,�.�����ۀ6,?�I��5v?.��3N�E+��"�c���
��B
ւ�ݽ�p!D��&�$Y���A�@=�g�j6ŝ5- N��ݱ�-no"ZD�]y��0�W��	������y�ZN��k�K�=c���W=�kZ�|f23g&t)�я�̆*����K���y�ǫ�?w�����t|���ԉ^���Q�%�+Ʈ�}-E4�!�߲���#�FiO�YM��v�4�YQ��8�D�^�d����*#��L.�~���jPw�����E�n)��r�5���gT�.�H���sF�8&:����?,�m��k�9���ӒAp�,�8���C@���G�\7����ӫو�n~ċ[r�yj�=�aj��ZD��Oh;XǗQ�S*�ܠ��s��4�\Am�	VSNpl���dy;v��U組�;)�o}�2��	j�q�������w-��x"<|��Y5;2MrV�3l%����Vh+ԡ�kO
�T
Z}KM8 ����c����$ي/t�J1[F�b���k� C"O	���a�Z-�	ntp�䎵�O~�$�w�:��U���٠���q����~�B�M�9b���T�������\��la�o���w�
�Az[�`׊N9k/�^�k��U_�������	����ą�{"V�c����~�
r�`�L�;l�g�W��>���:�r��A}׌��q0pm�܋�O�e~T
,c��Ǒ׮V�0 ��JW�?��t�¥fV,�jr{1�շ��}����_&� #�b�(���'�#�u�rM�@ ���VS�����@�H�P�,^�:��oKW|��fWq�AH]�ѱ
k���e
>����V!�/%i>�B�݌�k���R��_�c�4k��V��/�J��XH��ڎ�G���ɒm��x.G<�g��ơ��S��L���I~�]�zȞ4��#�tBo��Xq�_���\��=�4 �y�:�U��5�[U�����wif�[�ɧ�ӁA�s۪ڸ�V�I<�/Q���1�;>@kF�p���`���3LZ�3�<�Jx��@DŽ�+3]'�4�k��i@֬,�\�´�r�D���I���ڰ��d���N*���J5�A��[7�Ȳ����D3�!>����$g���r~�<l@h�/��9���.fx���mE�.�T�=c�o�@��M�TסL��i*���x\��GB��~L��D�:��u�>��۩$S�M`����C��	(���)����,��G�@ޢ�JFf�Q���
����Ce�ht�������z�Χ�)��4jl�8��c*��(t�����̺m� �����퍡����������t>m#�'�v��r;/�!b��m$���$8�I�!��.ݻ��aޯ�f*��=4��3���b
|��)FH8�V� p�9JD�c�q�$�*����9���<,+�Ȯ��yGvbl��a�h��rsk���_J�Ӎ���&ÌHO��_#��f����{��)��h���WH-�����s�@:=/\�jG�<ۤ��ߪaa�J���"BU�hG���`#�]/�ܯ�ő�����nC�tx�����uwe��[���VB���t�s=�95Na�U�Z�n/�{�P�d���`�X_R�����~��yH�hv0�
������,O�c��|T����3�t���T��u`,��x<��{z�ѵ4�W�ژ-'Q(�hv�(�ZehKW�6{�-�1��v�%}����f����F�k�Y
#z�*x�ն�k���)a���C��%d��4W�H�JQp`v���/�e&i`���[t,�l�Djј]~wq� ��fp]j�(�	_B�~�|Rʟp�b��'ҧ�*g�#��(˄>�/�D���W[OJ1}���J��;�Wև��5�U"H�.�^(RY�w՜S¥4ϛ�A�����^p ���6r�bc���Ӛ6�>QA���z{�^A��l�"��[ep�C�	_��p����4�6�8�L��TU0��tlV�dp�8�5b-���m�㘤��ҿ��C�>p���5�����y�t�<�ʩv_^\eh#G����_�+�����ϩ�x��>xK�5�����Wiy�r$[W���o������u�\�%=-�΂����r���{9���������u�!�hR�����J��E&~�
���-a�[��6�S,\-˞�/��+f"�tX��eA���R�4x�'SB��hH	����j�dY6ۈ6jc���4P���L��&�t[�¿���=~j�$h�=�3=H��
����;��N�;�T�5!:$��Vl���辩������d�1g�
�вuw�a���G�s�S�5n�uv7�<�h-�N$�]��:c��dI;���A��d�	��LJ�[L|��O�B�6ίB@���G��rψ�d�K�_�@;�޷���P�wq�w�.�;�T��l/��n?�9v�|�_ѕ//����h�����ɛ�['�U��Xw+č@�dD�Jp�V����1W���"����O�2���e	�&�����[����ܹe���h�=�1cL��4iw�@�x�,��##��ٕȄ�"*��&BN�^Uʎ��]�޻��w�y� ����:Xqs,��~�s>a��luX&��3ڦO[��@�ٙ�i�@�K��A脩���B�5f��ҷ�(X�7����
�<�Xwv���1p��n�-'�ݹa~R5z�X����J�D��4.%�4okr>B���{W2zϫj�q'�?!�gZ�!]�B�V2�E�{���ݺ�:��h=���'�jߞ8彻`�r�	�m��JBa�'�F<CF�䣨�s(�0��{F����9uҡ�G���� ��H�Z'yV2�d�4��
�;/2���t�45y��hh��
��#}'�h�ɢ�Y��k�
t�?*T2̥�`,��to:�m
�g��x|[|��.��{��MBy��Ku��	�fQmI�bd��
�8F_0�y� K]�0���!��ncP�(�x�D��g�}�%s�[��9ߜk��$R��dB�-@@�w�����j��]���x��Oi�3&���ߖ�H>L�VL��U=9�R�-�Ϊ��]ńNq��6��sVbjpjҐ���_�.���R��d� Ln#���o��m���x�7�� �
x�I<���Z!��n���f�ӌ�)��k��߇;�,(�;�1��>97Jps#/'��k;���:Ư1�ؿ'��-ĔX�:b,��� U�ˊ���a�����?�>Ma0���;���H��'P\���4'i^�F4Kj)�eR��̑�v�F�t�������3w���H-yz;�f���-���B�f�����z3W�*�D'T%�T_x�u<@�b�p����Ξ�Bs��]ʦ,�6�bZ^}�ü��w*�2u��E�>������կGn3�Ǘv'iC��6�������6 9��a%�e[�1�|�'�sS$�m��
�j��<�6�ՔB1c�:7��v4��|�吱�.]#�{�h�a�x�MQZ G��k�h|��=�����w��{3�2LD�!W��珠��i��Y�`&{�^n�c�F�S�N�
�]�UB	]N���P��;L��	�q�)C��Dپif��7d�s����:%��M>�6Ԃk�ߠ���+M������#�|��s�A�t% #�Jxr������|
�#�=���kA�g�HO�ޝ2]������1f %�����(.�J���r��j��4���87����aIr�<��WH˹?b�&6�Gq��=T�mCK�_�|�_�*R���]?�M�$�|ˀ�ч�Ed�p��4L�0�݅��y�fSB�C�,������<]d�AT���}'��+nu����!�X�57;�?� �kȣ�� ��-X|}�������-���D��y|� �LEs�#���G�����/R92{�q!>�3�6�ߙ���u��)�S����;nOj���r�����=D�lZ9�2�
��x0��*���W'~���_�bŦ�(�`�w����7�;j��\��(7>��f�?(O��I���j�UiS�����
���Ww�ܽ`�b�襶+�"�q�ĸr��J���b�׿/���m�7.�+�v��7?+�����1QU���X�t$��yEf?�̈0�&��=����e0e��s�h�e{��A��^�.��l*�Pk@��4*:�u?���z�'�'���`��3Ka�5KS�~ˋ��ާ^N�ĕ�zW�&����j��T�">ξ�.!�/���z���5��eݧ�?B�6_���M�P%�ţR��B}�Ȯ����MX�Cx-�|��1hV)���}Hd�r�K��e���{�:���fc�1���gш���UJ�=��#�K���̛��&,D]C.`��c�)IXQTysY�3��Z�F9*@��~�#��9�;�?�b��Mw�l�|�r��'�T��#�F�%_C��t>�Z��̋"��j[�n��)�g �pX�id-�.������J��<���:4�3�
�A֑ ��6'J�-e�g*�<�~�ec|���;�V���g�k+�f��G�|����<|��^����@��v����ul�l�MG��+��];��L ��p:ٰ��"��)��ٜRZ�.�u;�2ţ�=��ɒ�q:�ЇJV�w�y��ڣ�E{��Ȫ���u�g��7d���͇�\���2
0�#��������/�K����V���������?���e[-:���T��)9�����0��n����G�f���\�d�h� �Q�7�An�;ߍ�j�ױ�nT�g�3�7�qkt0o�ԱCV���6��E�˯��
~���`:���yy��n �<`�Q~(���Y.�m}GZ��S�$��$�G#�F�O:A�wݒɑX
�^�0}��z����Ma A�7�F��n�;0�|�&tI
p)��&�m���a�]�H��c��5�K��~@��%n��\P�z�����q\��YnU;����d-��{� 
�����wg�ܧ��Ö�j��Y�Ť_�~�|��d�<(
�Ptր�
�ZR'&j@�i��8�����s�5�VI��$-�1��"D�Q3��&P����b���W5��Y^�4LN��
q�N�+c(Iu�0y�n`ome)��xMc�}�`{`�os�Y�Mov��Ӌo�12�R�j�V�����G-X�	A�6���.��w�u>;���{Aa�|,F�K�u�@�<�s	����d�&u���m�ݲ��2��Ht�� RЯ�J�n�jX�h�g�c,�"}$U�a'�c[+��l^�~GW�f��OC�
��[�5\�4�ٓ2���M���u�̳����C[|�<�����|$2��ڬEN�o`��;��x^����	�<k@r5�t�YEO��4BP����R�.sDs�!Qʕ;
�N�xF���ߒ��N��T�;ĵ�X@�]0�z�i��P,��?�AP:E�S����Gz�u�X��Cb�m�u�>g~�	�o�Ԝ�6�}�����WJ2�
�^G~o���e�KJ]2��B�+�pz�5�=Ϟl��[�
ΣѨ^a��]P�\�.߆�G7�kֈ#�	���Oa ������ߜ�`�4���{����������ba���W-�G�������;�A!����~��xR���{��(����"��u�A�j����IƃS-�����n�k�/�*ݲ\t7���R�@v�N�36Rr��0��KC^����Y�M@3r����6tP{I�88��������|�����h�+�q�����Ū�AMJ�1�S�+-�$�֤'X�@��L�K����B�t����;�w�b�	''I8���J���8��Gc���h��]��}F����?Γ,���l�
Au��&�"�jXU8���U�Nl�:0�-���-H3�n�:�Lau��3��8�C'
\�]���p-"����|h]9WysD����2fN,'<+N
$�j���m���<���n>���o|b�ԗ�S��&OH������tlP
+��9��H��cL�Ѽ�l0�f�O�u�\j]�[�j���?�S�K��(���u�ǭ̗�K�!�-�)�=Z�� �T7	X:G������
��ݚv�p�~ߣ�t�}�"�gr`--&��W�ۗ�0�c���d��*Cl��v�wb�a ��\����� ��h6&����C��{C�h^^�=�1"�E,#:�hy2��-+�7��͚p�i��!=(uhjb[�#�rF��C�B�G\�F>5=�l�ox������I
r��ѵ��Ť�m��[��*���Ⴓ��mL���nqS$��~	d2ӁA� �Ya�����H�D��'���E����ֻ�m�A�:8y�g����z�u��'���޾���
b�֌M ίm���^U��V���>mSd.����F��(0<���j��������-�v�Z����%��a�Gז��ᥭ�mֆ��=(�vo��Y�/JiВ�U�Ύ�t�����>4���QF�@�F\s��Yt	�����J��>+���I̟ɝ��>��j3��0���[QY�d5�DC]�>�z/����:�O�[>�9�y��{~(�7��|&���Z�A���F�59�';�. {���j���Kf2��䒀�Z��������E��}R��y�
���������o�I�To���o/�8�S��T�|bAd�s{4(��"�3����j���"D>Qp�㮲ߢ���y���V����n�^h+v���ٝ"rdJ��J�g�;1����}���,j�m��9I����j�X������`=Z��P���1C�{�p���Ȼv�?,%p�i�IIl�X⠄�҈�s�Il����H�)��ݩ��
�n-�n	X<�؍a�:����F~5��|Bi�Q^�`L.�&D�YJ��¨f>z��7xɬ�u��
Y�?3��m�����U:J����*�k�b��e
J쳨���G�ͻ�3��
��bR*<p�`Zw��}9��r��f�1�%\��d�d�.����s�9��s_N��Y@�F>`��
�uQ��a�9*4W���z&3����{z+��L�-Ud7�����E�����,
"�i�EҦ�`ſ�������}�5-*��k�^l!-��=,�^%�_#%�V`��=�E�7e!�{i�%�N!�7_լ�(���DJ'�����'z1ATWڻM%iy��`�FK9��K6HNyF�1�5�V�i�g.9"��k<�T*
���:�ۆ�1�����Jg�o*4�L��(��L��qر�):��0��Z��S�
ͻ�$��CZC�g�$�4��n{�R��ǶKo��E��6�y������s�w�T��_o.R�*9�9���$
@���zI	��uW�X�*#�a>_���	�J{��f��ş�.��h8�%BS2ℶ�]#��fr�\�F;3:T-2r���H̦7c�]r���dN�,��i�E���Ɍ�}��J��QQy����d�:Do��j(օ�����p��	�d�q#��h�P%c#.�=��>�͔[f��	M��!�)�K�rt�<��QdLǝ�]�wM?'�E�w��%-�`���n�H�Ho��k}nR�	�q���%a>�Y��Tf���r�{*yQ
	���'�?4���u̺)�[��촂ӛ�)�Q9���Mr��e*)�[)�vB�~�u�]R��.3,(�b�ר �g(`��4R
�F���
�e"_ �m 
��ݚ��sJr]��t7�|,|m�߉w=V\m�`�Q���6+�c�Ϸ�h;H�8g��/�Jϴ��Z��8E�8J&�K
[{{m=�B�6|0��1��P߃����me������L����w�.#������w�mX����������?�
����ۍ5�c����ih�c5�sl�U8Ɉ�D��Xc
F-���My����Uzz���<�"M�=Ct��k�`'�p
�RX�1�%���
w8�1��gU絀�Io�i�| \�f
�YT+:��'�1�t�Č��q.g�ȰB��i\h!�mү������q���{�������J:� �����I!`j����8l��K�[C�S��84�WE���_�Z|�:���i���q���aM/4�Tk��2c�Iha���|tV�LT��5![Jǝ$̫h�d��zL�2�Ō�5��k��JL�23�~���	[�?�Wp[�=X��S����
(��������O����I�?�ֶ=#�XaA�LRYs��p��~��篺�Ү3��XL��:<Q�a�P�X�L�(K��}�ۻF�}̘F���|]��6�
�հn51��{�ع�ז;��>q�ɛV}�D�a���E�|�;I�t��**��a��;��|���@s	�אTto�ߗ-��H�����E��;��Ÿn�݆�] [���<6��?#��Q�F�帆�?�H�ݺ	�������1���s�{�_q�0�����N����=K:	���R��~�3����b�8�陠�z[8%����#4ۯ+��5BK?�s��W��!� �
��,�'��`�E�O�m�:�@w���D��<�7]Vn�������}� e����Ϳ��:5����3�G�=�,Q{5�N(�,�*�]ٶ0ȃUW�I�Z��OUg�y�W�4�r�#�b�c�"/=Γ;*.5��<��
�^���EVn
1�B˕允�E�/�u�]A�ڝ*0�Q�d{>�Q0�	l��)fR>A��n��{��0V"�71QϤ�q�GsA빽�Z�s��s���G���u��샎]�nrU�C�q���
�g�pRѠ��\��q���8O&���j�E�Qm*N�
��I�J�;T>v�|؜���T�������@����`���fŅ��Up�TH�
�'T�eMce98
]SR����$88����^|��h�|�j���	��6�~}X'
����u�:Cd8�lKdP��V;�D�#a���X}XM��w�#��Ϳr6*����ąȇ�공���H�kGC*Y
�j�i�NP.�fb�A,j�(%";�[MH�d�/��ι���5I�xF��!��C\�J3�/��GRzœ�F���7�l�
I�#՘�k�
�,2<�����7���>�n��t�Ŕ	�M�´�[o�h�3vU�u�Ҟ��g6b���kO�ݿ�u"-����������FB���y[����/a?}+y'�.S�C���A�Rߐr�*r!��K�L�"�$�
����N�����__������o8ʙ>�m"�5��~�DsrW0��r�k���n���r���	����=���|��^�z�[����încRGO��t�[Z���b�n!�&�����O.�!�{(�څ��b.�rm��%l�ISc�d���a�Ĕ���Q��mV�Y��}��8'Cy�1��S�ȑ����y��JIf�20��!4!Q�Ldb����_����ʘ~m�����2�۬5Q��hoe�����}&��D%���`�4~z�.k��.ރM��C���������7Kp�?S��Ug�(���^��w1f���l/A3-X0�X���>�;�Y��cfblM�ػ����ҫj56#��z�Q(�252��y`��fD V���$j�o�P0"d���4���dx�$c̡2�Z�!����a�vw	פ����g��O*�GYS��NQ��mz��@D|r|��5�J����^�Z]�)��\��C�s#z���Ȕ�4���L��=�ڶ�:
�wT��T\��ׇ��"�^�Ya�t�18\��\T��Z�
�S	�������e�w�ֹ��甦�1��gYC��8�0v>�n8;���֪j��$��=��	����OE���z�>���[>�_����Ѳ� �˄NE
.��1�@��X:�~.r֊e�@(z�[ح�d1��F(��2��\r/�c��D�|�(UB���؆�pe��+6�7���>5[ҋ�GP_L,M�bM1��aņwx�Si�R��$J�ϼ
�U�k
�@0U���!w�`8��� )B�����3A��[N*{��1�1��盎|�,����@�<����U�}zh��aaT�Xc�Cq��uS���?�~wξ*�I2������i�D1=�N��JR!Ѩ"�έ0�]�M0��(�x(t���\h����+r8!l؇�N0%ԅ�k9�� C�*G����P������,VW�x'<�l����	��ž��'���Fʊ�8ֳy|M��2��k���]d3�V�6���4�o�Xv��נ$ >r��f�����l]?��bb����/����4�L@����� ��be��IaJ��~b��RI|�[�J�>�o�Q���G��Ƣ_��"�^{�H���p�\� _h#79�h�7BJ\V6oy�/vV&�/"�3Z�����\��Ek���M-+c�茰)�#b���Up�(�<�C��)���J�}�T{�x��v�ͦ)~F͊�
f�~|*� ���,�ť�uŊ��en���}dq��';-���BOs�$XgR089-v
��-�	������^4��^�^SX��bJ�>;����P(��H���<i�t�,<ʌ/ȥ��:�lM�=�q(�n	ۙyk6�ڥ�J��GI�qL��%+S�b��T��K
����&�X?���m��|�}���q�r<���b|��w�8�Z
�˃�����ǟ[	{���,χ�
��@�]�Jl=+6y�9+X"�[�F*	��3I�uEb@����
�3@h�����h�7|b65�E
ߧ��m� sQʉ8xY�LӖARO�������g����k����Wj(\;,H�H����Ha��uU�'� �]m��4��� �8Ȝ��j�&�L�4yì(>�4��J?$ǒB��6!̏p��;���B����ِw'2�,�4i����W!��"=>�kˈ�J��ұmn��Kq9���?WHs�H0�9,����]��L����,٫�|E�13u��r�������nydm�N4��:}��Ҥ�G@;A��^�c[�u�ކ2A�bb.u#���(ё��x�
ka5�'Zr�NĨ��(T!Ņ�9ی��&���)c�@Š�����+�[$a��=-k��;�Pu��JRm�B���9�ذ��̈́Y'dq;��q���(�el:��bF!QU��Fm��T�u�Ow�RL�'n�&)r(t}��T?�ԬOv��&^���z7N�I�:�+����l��	�����\��Y#[�+�@��������$ᬼ�t���0�Iq���X&֐�I��FXߖ<��LM(�"��g" t����R17m՚O����f:^ȉ+fu:E�	ӖZ�^��G�O�!p�8}y�X�x�˶w��!�00���;���v'�o����_����r&��&a�7	����U�&�7�:�g�U^�6ۋ�5O���P��Ζ[x�c��Ӣ��]��>|車S�nz�6�q��Z������=��c'����?�X�6��a����8]1��П�4�ݨ�y��13d�����J��Mq
A/e�vsC�vl۾;]$�5�C�[r(s�*��N��Z��g72|�ه�jI�<A&|�
Ғn��vF�֤�ڹ��4!�,��e��]4lj���'\���oM<�	�F�O��߬RdLfB��Q��$5����N����]��0Mq�=��
��z"�)�&�k5YS�ԒT��6.�pʀ
�A�Âssn�F"�|!$��^'�9�0��X�_l�M��J�N�ĭ��A*���k�E�y��4Z��%����n��_ƎVQk����7qEqk�O���z�D��Q�t7׉c��T��s�ο�|��L����~vk5��NfC�W;��ŇH�pFz�Z0�D)r�w���rڪ�l{���o:��+vT�_b甖�M���t�c�f?\��)��<�`��Q�HR)	y��6C^F�Zjt�ia�+���n<��+)�-��4wpO��F�߽�S]֓��g��e��@<�x�:|:�\X�˚8؊Q�|��	��um�W���a~?9�����"`�zJ��<�x韟�[Y�1��s��;x��H�c�.��AJ��.s݋�c��.x_2���E)<�u�;d������a�ouEY��;����z�AwE�ǀ�!�h�1���qԤ́�sc~�S�U�VqS����/rzQb2�|�"r�uU��wBd����κ��v�f���J���1���~pvg��_7�Xپ#�)u�n��Dx�g�G=����f$c��Y�n:��h%�+%p�P�Nud����%�og�pT�]C%8��6��!!'��)��!�L�2;�G�C�9��H���vR�u�>�a4���w�N��j�E;V梄h��M�^y���2D����=���Ȃ�Se��*��[�1$�-59}��;�����|i��B�v��II�9:�]�ֈ������9�2��h��39���o|��襙`}f��>z�<� ��6�wѐ�"'�4�m�#풥��y�EK#ҟ�z%�XC����[O�޹��%�.����R%�W����+W��w�
,��f�W2��SCPm��n�+^�ng¿��¤�(}�s��ȓ#�	�!��ڥ8���z��S&����ih�uy# �(_	2�qio���Q�X�ɟ�G�ߡ~����Be�A>�/9���

�{�7�X��x�# l�#(yX.��O�j[|�B��>�-v�~ʢwH{���W�"*D!�!/j�������ͺ��=5�=?N��!9el݁Uwz�����BԄ�����x?!��4��*/Τ}�"��,G)ʝ�v����P|0(��`
oqxz��B8��B����q�L���w�t�h��Q��������U���j	���bfcC.�7�Q�j�H��c��r~n���*�Q�J�Ǎj�e�z�/^�y�$����&�ۧ�h�J����/ڬ��/,	9ߧ�:�5�"^����F�~%�`-z�J�cMmv�-�o�ȂG�LSN�MZ~jv(U�v(�ͤgrVS�`mۜ���CG�S��@B���\���a���o����٫�6�'B� r`���Js��2E�£��3��Q�>�G��
�`v cǍe�꺍��Ct��~i�L|��Q��9qƹ!��
��J�+����j"�銑��=1ןGX�;N͡��U�n�i�U?~�"p�mݥ@��K���#���
7�����i�I���AXz�zD��@h��c�DkC���D� I]�'��j��W?����}��byRǗ�[�/�CJ�U#�a��Sz-�;vg�CQA��8�3W��co�엩����{���튶J��rg`!6`������^t��g^��h<Dp��-JH�=��X�#3�6�'��qHx<�"�f4
ϒ����~��"��5N�l��f7b2(�n��4?�9\N�_��_2�EN,��*
m<�	��P9�Ҟ�����Ac�4s���Nn���)���΢{"���W�}�w�z��Ϣ��<y[��_����-�fR�3.�����7�L5���d�0�T'S��R楴����g;�#����ug"n�HG�V?!�{W3��M6_8x@��K[�V����b���aA��v�Sl~6y'\��(��ձ�&��X/<������/��k�UA��SV��S#h��;.��6׸�C}#���Ytz�>��8
�,"�?_&�T��#-�+�p��9�WⰥ����q��2 ]N�V�2�z�f(����g{�n�`�w ��P�Z��@|� �4�f�hIbWy9pm�j0�s�Yɇ���TuxFgnH}�h�ZI�Yq*g/5��
}ls�J��n��mT�Ӻ��F�'a%=G���o���&^a�dÖ�|0�5?�N]}u���͛X]_p��G<����D�1F�cz�����6$T�rk���)����Un�,���s�V;V��5���ʅ�ns�Eq{"Ap���ᘋgo�Wל�B�%�V�v펉<KѪ��sRx�"�X�".zC���D�w�Y����U(O޶iw�o�WE%V(˜�W#U=�FF�7G� J�5`�Xq�5<bT+(گr����'Aէ�6���՛�-^@����K̼=����`I��$�h?�.��B�c�n7���m�&�H�潍�_�/�W2�m����2�B�kD�kW�L���=p&J����2��zb��*ŕ?�V�	��78m��5yZ	�e�ɼ���χƃ1J�	��6�N.PE,:`y6��>cFO�8O�z�v+ͱT>f M4e����"-�Γ,\o�Q��{�p��{����_�����%�
�$�zlK/��0�r�tҐ����׻�u�E�@�mpQ���7W�Q�Iu
ӥ��d�1f�v�gE�
8���Q\
.H[���B�%��2���6,��.#%RȭC�B�u:�L}<Sc�����az��k�)��<c�)"D�V6�wa4���<k'#�!��3�`*h{�F��nI�DI��5�%����8�l�pl�����?��w9����>��B�����K����Fu�����f�&&M,d/�$㭋Tx���c_Z�D��F0h�3e�7�u��D�[]�"w!|�zh:k��ak� ��dA�K����~̸L.|cs]�:'�{*��X	����]ɞ7�˹ٺ����>e�����ّ1|�o�W�VY�n������4���������
h�[ۯ��W���c�W+T1�	������2�W�[��Y1ǻ�m��J���������������w|,!�8I�r���aͨDȭ�M��*��"�-�̴M��Ȉ���\���[������-h�b�b;5�dT��wf��H8��ʵ���v���_C�!���\�P>��|���\,�VZt"/�l{�u��o��UԔ�����rӺ��D���3bz�)�դ�Zq��6�j��rj	O�`��I��|xH4E��n�&Q�*��xsjrT0�3�+��y�D	�k;�7�nJ$�~^Γ,e�CDu�ؙ�AG�*���n�j����^7N��B�&Y��5�-�����kr�^�`
�|��A�|���ɒȊo��
W�΀*�q!�x&B��:g������Q��m���>�O��������H��܀FtKw 
��мH	(G�@�KX�;�R=]|��F7�d�RG�(����&.�˃���``b��d�s����ʋ]�͒4��̧Ŷ��7)&Yy2`�lY����pQ��)�i����r��U�j����Y�X?���@<)�KĨ�t<�PQ�؄"<:"�J$�a��l
m���~]�èI#C�	����Lb}�C��7�VW��>�x\Q(8-\/��q�f,�yc��}i~��{)m��=�~�o�Շ�d�ޑpM��ؑk*���!�a(
�f�	���������x;�>�g��7\������)�߮Od�h�$�C��t����cm�H�>^�f����5Tu����6\Xt�M�i0�2�k���V9	 ���x��7���y"ez��<��Ɔ��'eb`!�qɳw�8�U+9�ϯ�8}c������>p����@q`��y��Mc�_�B��wZ��sG��0�U�f�F}�\3�Z���������`�9�� y��SB�P�X�Ъ�$ݛ?�8O��&z컷%�9����"�q��-�e*�
�DТqeS;��ș��@�(�&Q��b
Mix�. D/�$�IG8�.������<�j�{_nF_��8[�u��~���:�̉��>�G#�q|���g�Fӻ�Ү�=uQ�����
4����ʐ��!�P�����Wg�
r�Q�8�8B���.�tx�<��]��O�!������:'�fVu����s�����)���"ղ�]��v���3�"ZMq��<H��!Kv
#����;�eWw�]�UDd'�kd"�ܐ�Ky��2m��].7=�	������n�CԱ�m?Ҍ��5?��2��M֍��^�L�%�x�<%��@P�%b#gzdȎu������������]4K�qJ$�{q�v�w�v��r)+�'eB^)�h�	S��,�e��H��+w!Q�ut�����Ru	��j	~��k�$��QDN�ˇ�7�������aO�A۲R���_ôT�����ojX���\i��\���$��u��Ӱ}X�E)s1�wb���B�ۣ�H�L���!���>d��
.���ٚӖ�"Oy��u�/:���拫7�����Xإ.W`�"���
߷�>%y�yc�ngq5��]N��o>GLY�=d�����#����,�3���&@���bp�1���,|�:�g�Qح:�p��v��	�v؎f-_'�@CPs�wM�0Fx�xY\_���ϧ������E��@)	.,�d|Z��P�9��5��J�ӓ%�Z1F�*��hGr�����l4���k�靏 Z��7U�n8���f�[i �Pp˘�jy7�������ldș�Jt�K�m����W.w~�	*��s.���~���e3i�t�f�}z7c1%�w^H�7��8{�kT��F�6��z�2��}óV��E14$��H.5�������i���Z[8�x���	�|�3�o�:�xZ�cgbC����7"��>Q���27TT�^�QJ�NҪ�Ȭ�Ssܬw�Gޫħذ��N��R��b_cK��#���Z6�;T���u��gi'?J��B��G��5?q����lO��L�#�f˳EB �m�;޶�P�mKɋ���sͺ_c̀+���S��c^�U�$��Ѥ�_~���UUY:Lcg�6��@q�H�(/��_9׭ո�Re//{��N��+���Bj���O)3N�&�i2'�^H��Aۣ�v��?�L{����8p��
1z&U_�����/����D�!U,���2?��>iw���}n�Z��Z��)3է���8�z�6� ��~ݦ9��/���M_	��}ʩ>�n�X�Ͽ�#zc}�J��l��!i��r`�
�~���T�:�ܪș�����Bq�o�
�m�ovнЭd��H��������������2��X|���{�hG
bݡ��֮3
?œݻ�(y(/��|b)R�����Y��
� a��?�TH�l�&Awja�J��c�1�I2_W�Տ2�̖��M��p5��Me������v^_h��tT�gg���m��LSYƚ&�l���p�_(�H_?���>||]��q���^;QU' ��B
"[�QP�3�4�`a�|oLF�|�����ij�õ�V�f�0�S9�Y���a��E��9�!s*��m�6Z��_�2�1#�����)U�}ȅ��
j��L�Ћ�#��iZd8�EO3��!^�H�~x�!M2�۾G��[ ptx/C7�FP�M��e�����^Z��h���t�[����N��6��3�<w��Qa)~��k�o[�
�NPe6�Q��2,�3}��g�v`�O��-ȥy�o��|��y�7C����+�tg��f768ѡ���]��9�(�'�X��`|t�J� ��(�Pl:<C�{��b�m��H?�qNJ�ğ^w�w����z�$��~��{�qǝ�yy�!��8J��q@"�"�T��zݮֵ��ͯ7{��r����z�J��eL/�Q���E�������i��@3�����d��yY�(�H�E ��^}C�B�i���>%�g���$����l8Q[��ǚ�����S����W%�rŕ:��yƶ���q�η��6O^�#:I�U�x�b��A�6 ��EMx���l��.�|��#�UCU��>,�N�2�LU���0��_8/�
�|�[��G��+E����oY��"kq�oLP-�=lCvyAV�0j��}vQj�J��|%���#)Ğ*��$��Tm&`��%Y�����v�Tj9BQO
��b��nM�����խ}w��O���m�	g�� �A���=��2W[1I@J�T6m7����,C~/#�q}p��LJ�y�u(�7|�(�0hI�������Ch�Y
MZ_�%@��j�F�;?v��fW/K�- �"����-/;h��L�&�锫���`ǍD6�^saX���%+7�8�,3���#�nG�E�]t�\�a�r섉W��W|6D{J����#�K�eA	pU��Oྍe�E��6�	���:�h��r*�2�`w{0��[��%\�N%aA8�ފU>�f�z�vX�fF��6NQ�N9B$"w��tQ�nE��A���6��m
c����)غ�j���f�&�����`����g�B�l��������I�m��[:iV��NF�5����o��pqr	�r��Vqr�l(K�*����_Bm��8T�V��}�L�����B��;:J��R�d�Z��1�F-����e���J���{5.������!�DW������j�G8i��Q6&�����sj�9[��s�܀�-z|r[4 |�#j`O�Qkk�(�z��d̵�8˹ļF{����PjQ���̀[O�m�ۭ;���;|�M/�so�T
�����h
�#Y:\��I���r�q���Yz�Q��}�1����'�O:�;@������u+}q�0��g{/�^��!Y�?�)廻7<��JOLh�V���7�C�$+�Ua�%$�m��#pRLF迪�s
�ʹ~��="4�WM��W���
��*�ؔ�Fa�#%��p��q�ݴ���o]�i���O

��x�63����	!���I2|��<�Ԯ�+J�����)���8* L6W�(q��ï�r�� �H �*��.-�������v��r��x��A/�h
p��Z�r:jA=��=��f�o�d5�}�`e�Y��jh��ns�
N��B��
;����
�&�+�1[T�T�W�W8ZG\�\,_L_v�z5{*�J�{������9���L��[S�'�+�1�T�T�WXQZv\�\E_e_/v({T{C�c�������2�R������W[l��&�+PV���1BT�W#Z.\_Lp��R�a�u�z
�b�n����������Y�,3;�=I�2��&�+$P\���1HT�W)Z4\_Rp��p�a�u�z�h�t������*����e�,9;�=U�>�(-(1(((!('(3(7(9(C(E(�35L:b�(3�
+ǃ�#\
$!'['s
)�+<,.�7�:�F[GtGImI�I�JbK�K�M�MOO0OfO'Q�U#V�[�1_�gFh�#kF%q�v�(x�&}��%*�������h���3��	�A���S7�������+�m��������?���5���������L�s��&������{���;����S���>���:�0�����@�>�������
��
�;��7�@�1	�=��o�����_�<������\�=���6�����<�������l���?�����t�	������>�<�����7���<���L	�
��?���RD>��kemCA �!�"P#�#h$�$m%&�&(�(W)*�*++,r!,�1)2A�3�TU>U�VXdX�X�YbZ�Z�[�\�\
]-^v_�_�_�`�a�a|d�f�f�f�f6g�gKh�h�i�j�k�lkn�oZ%q%ul zf2~�/�!/���g7�U������'�����>��r��0������.���
�����9���3�����C��������8����t� �����c�k����M���_��"�����N���k�/
�[
��
��
��`�����������e����c�[������4�#���0����Z�]+�
�M�����	�
4���
)�1��V���]��d�7r���X<��Q � �!A"�"S#$�$�$M%�%$&�&:'�'6(�()d)�)E*�*	+�+i,-�-�.{/�0"1�1a2�2p3�3~7?:�:�:{;�;q<�<n>�?@~@vAB�B�B*D�D]EF�F~G)H�H�I0JK�K�L�MVN�N?O�O�PgQ�Q'R�RY&SpZ�Z)\G\f\�\]�]�^9_�_Ha.b�e�hGi+jDk�l�m�n/o�o�p"q�qrJv�v�w�x<zv{�{�{$}F~~y���������������*�S�����h���������C������T���X�&����e���@����q���K���5���:������S�����)������	�n	��O�����,������W��*���y�����G�������D������������V���]�-����[����
��
�.�h����c�
��8i	�
�s+�,e-?.=/011R2�3,5$6%78�839
:�:P;\<�=�>&?�?�?|D]G�JUN�NE	O{
P�2R}[�[�`ub�f�jk
k�m�m�n�n�o:p|p�"p�t�viyr|�	|�
}a��c���_�����h�����n�-�l�������������a���J������`��r������s����m�f��������z���F�-���^�������V�a���������'���9�������<������w������k�����������	���1���������&�z�T���}������������U�i�����(�g����������9���!�����R�=�7�����n���g�����h����������/���Z������?��8����j���4�����e�P�D�����l���K�����N��$�����-����������1�����Q�.Jh�Q�����F� u�E	z	�	�
�
vo�
�
9�B��5�-Rq����
��!@��;��$Cb���D�
b�zV%, �  �"F$�$�%�%�&�'�'�(-)�)?*h+D,-�-a.�.�.�/�0�091X1w1�1�1#2u2�2�2?3�3�34w4�4�4�4�4B5�5
6�6�6:7a8=9:�:;�;� <�>'@�@tA�A�B�C�C�DE�E!FJG&H�HgICJ�J�J�KtL�LM:MYMxM�MNWN�N�N!OfO�O�OYPxP�P�P�P$QyQ�QBR�R�R�S�TZU5VaV/W� W+Zu[�[�\*]^�^'_�_\`+ana�bscAd�d�e�e%f�f�g(hhh�h�h�h
iRi�i�i)jnj�j�j?k�k�k�kl#lql�l9m�m'nin?op�p�q�q�r� s�uwwwQx�x�y�z�z�{�{�|�|'~�D� �������Q������6�U�����4�e�����C�����6�U�t������V���b����� �����������m �����Y�3�����l���e�������	�����&��j���e�3��������7�����G�����%�k������]����r���������a���[�(�h�������
�R�����)�n�����?�������9����B�i�E������������4�S�����2�c�����A������3�y��������������}���w�D���������)�n�����E������[������U����^���a�0��7�����1�P�o�����N�����]�����0�O�����8����������������`���������E�����
�a�����1�v�����L������a�����7�|����L?�^�|�����R���L���A�����/�j��=�~�������2���������l���%�Z��������Z�t��������������d���J��&;z�	�'	��x�p��f�7���-Mz"R$�&�+L*Pb��
�1NT�W/Z:\_bXp����3�av�z�n�z������6�i��q|+�,?;�=a�J�n��&�+9GKI�MO!OVP�����
�J���9��
�#k(�+�1TT�W3Z@\%_{f�g�p����j��
����\�
�(�)�*X+:F;WBC4S\�\�a�n
v�z!�t�����	���c���:�������s�2�{�,A;�=�?�j�m�np�p������P�������:���-�����J���P�r���-�����~����������N���Q�e�N���b�v���(�<�D���������#�������c���Q	�
{�>��c
tg�	n�"�'	*�.102	47�:�>�C�E�J�LN�	O�RAV�Y_8af5h_iK	k3n�q�u�z�|�������	�����f�y���w�������~�m�5�_�K��������������Q�{�g�(����	�������m�����m�N�����}�w�l�%�U�l����������P���~���l�������B�����-f	i����xn��?

)))













)










)
)
)
)









&&&





















((&&&&yQ$�&I'(�+*,-�18�:_G�GqI�IL�MEO�OU�Z_g4kQp�uZx�|�7������ʖ�n�ڞަ��խ����U�M�:�w���=�e��b���,�<��(�������Q���4�i���T���P�F�����V�$�p�6�>�z���������������J�k�����`����S���L����R�����
�����U�����T�V���������M�R0�|�
�����h�+	���ge �!�"0$�$6%�%s&v'�(m)4*�*+,]12b2TU(U�U�WPXwX�X�YuZ�Z�[�\�\-]�^�_�_�_�`�ab
f�f�f�f�fhyhfi�i0k�l�mJop�t�y�}���6�ݒ����ե��������8�׻k�9�}��������d���������$�����N������6�����y���"���c���u�'�8����d���������?�k����*�"�1���.�H��������K�9���F��p�sA� �	c�	��	J��
?�G0�'b>���!n��� W"i#�$c%:&P'L(8)�)�*,,.-�-�.�/�0812w2�2�3�3�9D:�:�;:<�<#>?�@�A�B@D�DsE"F�F�G?HI�IFJK�K�L�MlN�NUO�O�P}Q�Q=R�X�Z�[.\L\G]�][^�^�_�`�a	e�g�h�iOjhk�l+nEo�o�p8q�q�u�v�vxvy�z�{�{	|H}�~���׀�0�0�����<�/��=�v���ʉ{���ۊ��Y���j�n���{�V�U�^������������ݞ!�h�����s���,�ɥY�ݨ��A�$�����ƴ�\�'�ֺü����?���-�b�����D������������U�%����$9P��z+�,{-U.S/0G1h2�3B5:6;758�8W91:;f;�=><?DGTJ�M2P7RcZ
`6b7fWjkm�m�oPp]t6vy�{�}��������ֆ��߇����̊���njU�v�&��������ڛ����������l�٥��=�����ߩ����\�5�մ���Z���G������������������
�2�-��>�}��������h�S�*���}���������	�������5�U�&�N��{�f�(���a�����d���Z�@�������D���s�3O�N�����3��	�	�
&�/�"
�
P�Y�L�W�1����&��!�+Ji��\�%��n=D #�$&'(E)W*�+\,�-/�/@1_1~1�1�1{2�23V3�3�3~4�4�4�45Z5�5"6�6R7y8U9$:+;�;�>�@�A�B�C'E9FbG>HI�J�K"MAM`M�M�M]N�N�N8O}O�O`PP�P�P�P<Q�QRZR�R�S�TrUyVGWCZ�[B]5^?_t`�a�b�c�d=fgoh�h�h�h%i�i�i@j�j�jk�k�k�k
l;l�l�lQm�m�nWo3pq	r�r�u�w�x�y�z|}?~\�́�����=�m���:�|�Ѕ�Z���=�\�{���ˇ�n��z��8��������q����������!���>���}����O����^�����<�����/�u�ã�̤�Ϧ����s�o�����ݪ%����@���ʬ������Q���Z���]�,�3�����;�k���8�z�ζ�X����K���߸4��������������ɿ��A����\�����,������m���v���y�H�O���8�W�����T�����/�t���7�g�����P��+���������������]���$�x����H����c�����3�����N�������c��������}�4�����E���������T������A����;�����������+	.-���"�L��`�I#O#R#Y#`#g#n#s#y##�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#X$'V'U)b)o)�+7,�-�-.�7�:�FGGOGWGoG�H�H�HIYIaIiI�I�J�J�J�J^K�KmMqMwM~M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�NO+ObO	Q�U�UV�[�[�[�_�_�g�g�gAh�k�k�k,q4qAqxv�v�x�x�x�}�}�}��Â�����d�m�v���������Đ������c�͗-�m�{�2�;�ٟM�������˧���������%�Z�g������������:����#�0���������������F�W�`�m���� ����������������_�h�u�~�����'�4�`�i�v�����3�@�M���8���+�4��*�g�n�{���:�,�9�������������������(�5����$�1�:��+�.�7�	�i�����K�X�"�)�6��������V�*�7��� �0�������s��� �)�6�����m�z�����f�����,�:�����T�a�n�����������8�6�������0����������6������cp}��8	F	�
�
s|�9�����?L��#1?8�����eV_g=. ; u!|!�!�"�"J#�#�#�#b$�$g%
&�&(�(�(�(D)Q)�)**�*+y+�+�+�+m,�1#2.3;3�T�TU7U�V�VX_X�X�Y�Y]Z�Zx[�[�\�\�\]^(^q_�_�_�`�`}a�a�a�a�a�cdddddd d'd-d3d9d?dEdKdQdWd]dadedidmdqdwd�f�f�f�f�f�f1g�g�g�gFh�h�i�j�k�lfn�oUq�t�tRzZzgzT~a~t�|�������ȐՐT�a�"�+�N�����������¢��������}�������m�z��+�8����m�ڵ�����ͻ������'�������������'�4�������
�-�r�{���y�����=������������t�}���%�2�����������X�a�n�
������n�w���F�O�\�B�K�X�e����������G���P�Y������s�z�����H�����e��)�H�U���������������M�Z�����������������|�����Q�_�y���O�\�A�H�U���������.������*���������>GT�����JW%�ky��G�gt�����r	{	�	�
�
�
�
.������\
i
v
�
#��+��P���X���_��2`m�������R�7�LUb�6 ? L � �!�!�!�!;"�"�"M#$
$$�$�$G%�%&�&�&�&4'�'�'1(�(�(�(�(^)�)�)�)?*�*�*�*+�+�+�+c,-	--�-�-�-�.�.�.^/g/t/Y0b0o0|011�1�1�1[2�2b3k3�3s7x7 :-:::�:�:\;i;v;�;k<�<h>�?@x@dAqABcBpB}B�BDD$D�DAEJEWE�E�EF�F�FbGkGxGH#H�H�H�H�I�I J)J�J�JK�K�K�K�L�L�L�LoM|M6NCNPN�N9O�O�OnP{PNQUQbQ�Q!R�R�R8SESRSPZ]ZjZ�Z�Z
\\$\B\`\�\�\�\y]�]�^3_�_Ca(b{e�enh{h�hAi%j0k=k�l�l�l�m�m�noo)o�o�o�p�p�pqq�qrEv�v�w�w�x�xz*z7zj{q{�{�{}}3~@~_lyt���������
���̃ل���	�����%�L�}�������c�����ċыȌՌ0�=��z�֎A�N���R���!����_�ƒ:�������Ó˓ӓۓ���������!�)�1�9�A�I�Q�Y�a�i�q�y����m�זF���0���5�����Ğ�N���ݟ%�աk�s�����ǤԤS�[�h�����I�p�x���������'�ѯٯ�	�����ưc�k�x���=�E�R�������&���`�h�u��������A����
����������Ĺѹ@���i�q�~�������Q���X�'����V�������(�Y�b����]����3c|��n+h,o,s,w,{,,�,�,�,�,�,�,^-+.8.!/*/7/�/111*1(212>2K2�3�3�3�3555%5�5666777888�8�8 9-9�9�9:�:�:�:I;<<I<V<�=�>�> ?�?�?�?�?JDSDvDNGWG�J�J:NCNPN�N@OuP{R�Z�Zn[x[�[�`�`ob�f�f�j�j�j�jk�m�m�m�n�n�n�o+p4pvp�p�p�t�t�t�v�vYybyW|`|m|�|�}[�P�]�����Y�������b�����Çi�'�\�e�����ۉ������A�N�[�ڋD��������̍Ս�D�M�Z����l�ʏӏ�������m�đ͑ڑ����Q�Z�g�T�a���E�N�q�������c�l�u���@���'�v����5�X���âТt����9�B�O�A�N�[���¥ϥ�Ӧ���������!�ŨҨ3�������é����6��������������
��e�r������ڳ��e���´˴���d�m�z�ɶҶ߶��e�n�{��,������������d�m�z���~���t�B�O���x����������������������P�c����������!��#�0�=�`���������{�������������������������4��������K���)�6��%�2���
������i���T�a�����~�����I�V�c��������������������)���U����������������������+�8�����	���$�1������������e���/�����^�&�/�<�I�)�2�?���������g���8�E�����b�o�|�-�:�G�N�]�l�{���D�n�v�~��������%�+���������������
�/�~���K���
)Eb���K��������
o|�A���o�?	s	�	}
�
oi�
�
�
2�<��.�(@Mk�������o~��:���
5s��<[z��<��[�Ydq5@M���#���� � � �"$$$?$�$s%~%�%�%�&�&�&�&�'�'�'�'�(�(�($)�)�)�)6*G+R+_+#,.,;,�,�,-|-B.M.Z.�.�.�/�/�/s0~0�0�021Q1p1�1�12o2�2�2�2�283}3�3	4p4�4�4�4�4:5�5�56�6�617@8K8X89'949�9�9:�:�:�:
;�;�;�;�<�<�<�>�?�?�? @�@UA`AmA�A�B�B�B�B�C�C�C�C�D�D�DE�E�E�EF)G4GAGHHH�H�H�H^I$J/J<J�J�J�K�K�KUL`LmL�LM3MRMqM�M�MQNtN�N�N�NO_O�O�ORPqP�P�P�PQqQ�Q�Q:R�R�R�S�S�SjTuT�T9UDUQUV!V.VXVWW&W�W�W�W"Z3[>[K[n[�[�\�\�\!]�]�]�]^�^�^�^_�_�_�_S`aa#aeavb�b�bRc]cjc"d-d:d�dqe|e�e�ef�f�f�f�g�g�g!hah�h�h�hiLi�i�i�ij"jgj�j�j8k�k�k�k�klil�l&m1m�m n`no)o6o�opp�p�p�p�q�q�q�q�r�r�rmsxs�s�u�v�v�v�vnw2x=xJx�xiyty�y�yjzuz�z�zd{o{|{�{�|�|�|�|~~~�~�~�~���;��������b�m�z�2�=�J�����/�N���܄.�Q�_�������<���Ȇ/�N�m�������N�����Z�������
��ۋ������Œ������ɍ�����N�Y�f���������ߒP���,���K�V�c���L�W�d���F�Q�^�ŗ}�����ט���ĚϚܚ�����������b���D�O�\���,���ӟ��0�x����3�A�����١�d�����U�����`�k�����ťҥ������e�p�}�B�M�Z���:�E�R�	��!�a��������L�����ϫ�"�g����8�����1������9�H�S�`�$�/�<�����в۲��ȳӳ���������-�L���ڵ,�O�]�������:���Ʒ
�,�q����|���ǹֺ������ʻ������^�i�v���V�a�n�%�0�=�}�����ڿ"�h�������*�>������T�������M���
��U�d�o�|�@�K�X���'������.��������������*�I�h�����H�k�y������V�����)�H�����0�����������
�������������z�������r�}���A�L�Y���������>��������F�Z�����*�p�������1�E������[��������0�u����F�P�Y�u���������K�����E�����-�:�x����&�-�a�h���p�y���������*�0�������������X�e������Q�X������������,�S�m�����	�������������C�P�]�������C�������.4rx�		�	i����q��k���
_�2n���&K�#*18?FMT[bipw~������������������
")07>ELSZaipw~������������������")07>ELSZahow~������������������ '/6=DKRZahov}������������������
")07>ELSZahov~�����������������$+29@GNU\cjry������������������%-4<DKRY`gnu|������������������	'/6=DKRY`gnu|������������������
'.5<CJQX_fmt{������������������")08?GOV^elsz������������������%,4;CJQY`gnu}������������������
!)08?GOV^fmu}����������������� 
   ! ( / 6 = E M T \ d k r z � � � � � � � � � � � � � � � � � � !!!!$!,!4!;!B!J!Q!X!_!g!o!v!}!�!�!�!�!�!�!�!�!�!�!�!�!�!�!�!�!�!""""$","4";"C"K"R"Y"`"h"p"w"~"�"�"�"�"�"�"�"�"�"�"�"�"�"�"�"�"#####%#-#5#<#D#L#S#Z#a#i#q#y#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#$$$$!$($/$6$=$D$K$R$Y$`$g$n$u${$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$%%%%%#%)%/%5%;%A%G%M%S%Y%_%e%k%q%w%}%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%&&
&&&&%&+&1&7&=&C&I&O&U&[&a&g&m&s&y&&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&'	''''!'''-'3'9'?'E'K'Q'W']'c'i'o'u'{'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'(((L#V#]#d#k#v#|#�#�#�#�#�#�#�#�#�#�#�#�#�#�#M$�&E'(W)d)�+&,�,�-�-�18�:IGQG[GtG�H�H[IcImI�I�J�JLtM{M�M�M�M�M�M�M�M�M�M�M�M�M�M0O�O�T�Z�[�[_�_�f�gk�k�k<p.q6q�uzvEx�x�x�|�}�}с��!�������f�o�x���ۏ��|���������X�4�ĞȦ�������������k�\�?�7�$��a��
�z��%�'�����O�����L�Y�b�s����&���������������a�j�{�������)�;�b�k�x���
��5�B�S���>���-�:��0�l�p�����@�.��Z� ���(�����d�����!�*����u��&�������0���4�U���M�m�'�+�J���i���,�=���%�6�������u���"�+�<�����o�|�����l���?���V�c���>�@��������������7���������<����erfo
�
u�����t�AR���������X��Q0 O z!~!�!�"�"�#�#$�$ %�%]&`'�(�(�(F)W)*
**�*+�+�+,X12L203�S�T�T#UyU�VWKXrX�X�Y�YpZ�Zz[�[�\�\�\]^�^�_�_�_�`�`a�a
b�cdddd$d0d6d<dBdHdNdTdZd_dcdgdkdodudf�f�f�f�f�f�f�g�ghdhQi�iksl�m5op�t�yTz\z�}V~Մv�~����!�ʐȒV���$�Ҟ�����������������������o�p� �-�����"���һU��#��g�������������)�N�������t�}���{����������������v����'�8����������Z�c�t�� �����p�|���H�Q�c�D�M�Z�k����������M���R�_����"�x�|�����N��������J�������)���U������O�����������������2���Q�q�F�J�i���5����#����0���������@IZ����L]
+�
�Miv�����t	}	�	�
�
�
4�����^
k
�
)�1�]�(��b�����X	�NW�8 A � �!�!�!A"�"S#$$�$M%$&�&:'�'6(�(�(")�)�)�)�*�*�*�+�+�+i,---�-�-�-�.�.�.`/i/{/[0d0q0�01"1�1�1�1a2�2d3p3�3�9":/:?:�:^;k;�;$<�<
>?�@fA�AeBrB�B	DD*D�DCELE]E�E�EF�F�FdGmG~GH)H�H�H�H�I�I"J0J�J�JK�K�K�K�L�L�L�LqM�M8NENVN�N?O�O�OpP�PSQWQgQ�Q'R�R:SGS�XRZ_ZpZ�Z�[\\)\G\�\�\1]�]E^�^�_�`�a�d}e�gph}h�h�i9j2kRk�l�l�l�mnoo/o�o�o�p�p�p"q�q�u�v�v�wx�x`yz,z�zo{�{�{�{}2}5~~an���Ҁ�������-���߃ۄ&���,����8�`������ljv���ŊƋ�ʌ2�C���C�T��X�	����e�@�����Ǔϓדߓ���������%�-�5�=�E�M�U�]�e�m�u�}�Q�Z����x��j�������Ȟ�S����o�|�m�u����ɤ��U�]�D����٨өr�z������,�ӯۯ�����˰e�m���?�G��������b�j������G����������ƹ��k�s�������:����]�����?�����n�����[���?����
�#:���u+q,u,y,},�,�,�,�,�,�,�,e--.?.#/,/=/0	11111*232@2R2�3�3�3�35
55,5�566$6
77%7888�8�8"9A9�9�9:�:�:�:P;><K<�=�=�>&?�?�?�CLD�FPG>J�J�M<NENP!RMZ�Zs[�_�` b!f�fAj�j�jk�l�m�m�o-p:p�pGt�t v�v�x[y�{Y|b|�}����R���������������ɇ^�l����C�P�����������P�΍׍F�O�`���̏Տ���Ƒϑ����S�\�o�V�ݚG���ěe�n�z�������x�������Ţ֢v���;�D�V�C�P���ĥԥ�զ�����
��'�Ǩר������ɩ���������������g�F�������Ĵд���f�o�˶ԶD�g�p���!�1�������f�o���������D�{�����������������
���������	��(��%�2�g���������}��������������������R���+�=��'��������V�g�����������K�X������������������������������������� �-�?��������&�8���������e�(�1�>�P�+�4��������:�K�����d�q���/�<�N�Q�`�o�~���G�p�x�����!�'�-�����������1���n���.J������I����q~��� �z	�	�
v�
�
9�B�5�BR��-����r���!���u�$Cb���D��
�[fz7BV%��,�� � � �"$$�$u%�%�%�&�&�&�'�'�'�(�(-)�)�)?*I+T+h+%,0,D,�,-�-D.O.�.�/�/�/u0�091X1w1�1�1u2�2�2?3�3�3w4�4�4�4�4B5�5�5
6�6:7B8M8a89)9=9�9�9:�:�:;�;�;�;�<�<�>�?�?�@WAbA�A�B�B�B�C�C�C�D�DE�E�E!F+G6GJGHH&H�H�HgI&J1J�J�K�K�KWLbLM:MYMxM�MWN�N�N!OfO�OYPxP�P�P�P$QyQ�Q�QBR�R�S�S�SlTwT�T;UFUZUV#VaVWW/W�W�W+Z5[@[�[�\�\*]�]�]^�^�^'_�_�_\`
aanaxb�b�bTc_csc$d/d�dse~e%f�f�f�f�g�ghh�h�h�h
i�i�i)jnj�j�j�k�k�kl#lql�l(m9m�min o+o?o�opp�p�p�p�q�q�q�r�r�roszs�u�v�vww4x?x�xkyvy�ylzwz�zf{q{�{�|�|�|~~'~�~�~��D�����d�o���4�?����6�U���4�e�����C���6�U�t������V���Ɉb����� �݋�������ˌ����ҍ������P�[�������Y��!���M�X���N�Y���H�S�Η��������	�ƚњ�����&�����F�Q�e��!�ڟ���7���G����%�k����]����b�����ǥۥ������g�r���D�O���<�G�[���h�����Ū
���ի)�n����������9����B�J�U�i�&�1�E�����Ҳݲ�ʳճ��������4�S���2�c�����A����3�y�Ǹ�~�йغ�������ӻ������`�k���X�c�w�'�2�����¿�)�����E�����������U����^�f�q���B�M�a���0�����7�����������1�P�o���N�����]���0�O�����8����������������������|�����t����C�N���������E���
�a�����1�����L����������7�|�����R�^���������������/�z���(�c�j�/�r�~�����,�2���������Z�����S�����O������.����6���������E�R�������������0tz		)l�������Gp�M� '.5<CJQX_fmt{������������������
&-4;BIPW^fmt{������������������	&-4;BIPW^elt{������������������$,3:AHOW^elsz������������������
&-4;BIPW^els{������������������!(/6=DKRY`gov}������������������
"*19AHOV]dkry�������������������$,3:AHOV]dkry������������������$+29@GNU\cjqx�����������������	&-5<DLS[bipw~�����������������")18@GNV]dkrz�������������������&-5<DLS[cjrz�����������������     % , 3 : B J Q Y a h o w ~ � � � � � � � � � � � � � � � � � !!!!!!)!1!8!?!G!N!U!\!d!l!s!z!�!�!�!�!�!�!�!�!�!�!�!�!�!�!�!�!�!""""!")"1"8"@"H"O"V"]"e"m"t"{"�"�"�"�"�"�"�"�"�"�"�"�"�"�"�"�"�"####"#*#2#9#A#I#P#W#^#f#n#v#}#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#�#$	$$$$%$,$3$:$A$H$O$V$]$d$k$r$x$~$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$�$%%%%% %&%,%2%8%>%D%J%P%V%\%b%h%n%t%z%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%&
&&&&"&(&.&4&:&@&F&L&R&X&^&d&j&p&v&|&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&''''''$'*'0'6'<'B'H'N'T'Z'`'f'l'r'x'~'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'�'((((o����wy�~X92:2���&R'�(_)l)�+3,�-�-.GhGH�H�HI6IzI!J�J�J�J(K�K�M�N	OOYOP�U�U�Um[�[�_�_�g�ghzk�k�p>q8v�v�x�x;}�}r�������������|���+�����F����O�v���� �g���Ƨ:���g���¯"��d�|�u�˹�Z����0�����-�w�����������+��j���
���������	�e����r�-�����1���s��������=�J����������'��x������6�9���r�������������2������!�.����&�	���P�t����U���3���������9�s�4�}���-�����>�}���3�����+�w�����F������5�}����^�k���n�m����������������^�-�����k��mz��	A	�
�
J�e����I�,:�e�P��E1�N�8 +!�!P"�"4#v#�#�#G$�$M%�%�&�'B(�(�()N)�)**q*�*_+�+�+�+G,r12�283%TU2U0V�V�WZX�X@Y�YZZ9[�[\�\�\�]%^�^�_�_x`�`	a�a�a�a�a1f�f�f�f�f�fg\g�g�g,h�h}ioj�k�lMnto/p�t�tzdz~^~5���֋���Ґ�^���F�7���_���4�����I���8�w�Ӱ(�5�Ҳ��M����s�Ż�������ݽ$�T������������1�{����%�.���5���'�f�����q���5���/�����V����k����s������Y���U�b����p�����#���������������-���������$�
�R�C���~�������W�e���g���o�����]�����8�Z�Z�t�	�Y���R����������K��d���'�����G��Q��b�T�"m�Lt��1��q~�V�!	�	
�
�
�
��O��

f
s

�
 |����E���B��Q{�Nj����i��/~_}�I � 1!�!�!�!�"�"#�#
$$a$�$/%�%&u&�&'�'�'(t(�(�(�(L)�)�)�)%*k*�*�*�*/+�+�+?,�,{-�-B.�.
/q/�/l0y0�01�1�1�182�203�3�9*:7:P:�:;f;s;�;P<�<N>�?�?\@AnA�A.BmBzB�B�BD!DlD�DTE�EbF�FGuG�G H�H�HFI�I�I�J�JmK�KQL�L�L6MyM�M@NMN�NO�O5PxPQ_Q�QR{R�R�RBSOSbYZZgZ�Z�Z�[\!\:\X\�\�\�\^]�]r^_�_)a�aFe�e#hxh�h!ij�j:k?l�lm�mln�no&o�o�o3p�p�p�pquq�q�u�v}w�w�x�x�y'z4z�z�{�{�|}�}=~�~iv����������E�ǃ���Dž�Q� �G�&���R���߉����{�΋��Ҍ�:��M����K����6�����h���G���
���j�h�ɖ1������P�����7�~�ş
���+�}�w�Ѥ�e�����0���b���������n�ð(�u����O�|�����#�l��r���T������
�S���	�p�ι���#�{�Żؼ���I���B����N�������	�4���m�=���3.Mf���,�-5.�.4/�/�01'1�1;2H2"3�3�3�45"5�5
66�67�78d8�8�8*9�9�9:�:�:�:;�;F<S<�=�>�>�>a?�?�?7DnD(G{J�MMN�NO[PaR�Z�Z�Z�[�`�`Nb]f�f}j�j�jkrm�mfn�n�n�opep�pt�t]v+y|j|�|�}Aр"�Z�y�8�u���I�~���P���C�����ʉv����#�K�X���*�o�������y�ߍ
�W�Î�P���ݏ�����?���בg����*�d��^����i�z����9���!���$�R����P���͢9�~�ƣ
�L�ܤK�X���̥���ݦ@���ԧ���Ϩ�^�����v����a���0�����ڬ��o�����ҳ��K���ߴw��w���ܶù��.�x��)�q����������1�w���B����
�L������I�����������{�����!�]�q�g���������-�:�X�6�����-�����k�����q���B������{���c���-���&�3���/�y������J����^�����>������S�`�����f�����R�������#�7�-���K�����p��������(�5��������!�.�����z�����G����v���@���9�F���<���������H����B�����"�l�y���7�D���Z�i�x����f�����k���|�������m���4���">Z���1{��ru���:y� ���
]�'	M	�	_
�
�
Q�Vw��
�
{���Jc���c����8{���2[���-V}��5Ts���;jn�J�����d � �"�#$7$�$%�%�%`&�&�&V'�'�'Z(�()�)�)*�*\+�+8,�,-T-�-W.�.�.X/�/)0�0�01J1i1�1�1	2,2�2�2�2�2%3j3�3�34�4�4�4�4&5p5�5{6�67�7U8�819�9:s:�:�:u;�;E<�<�>�?�?@i@�@jA�ABB�B�B8C�C�C<D�D�DtE�E�E�F>G�GH�H�H6I�I9J�J�J:K�KLjL�L�L,MKMjM�M�MNgN}N�N�NOLO�O�O�OjP�P�P�PQRQ�QRpR�R;S�STT�TNU�U+V=V�V#W�W�W�Y�ZH[f[�[L\�\]�]�]^�^�^_�_�_5`�` a3a"b�b�bgc�c7d�de�e�ef�f�fXg�gh1hyh�h�h�h8i[i�i�ijjTj�j�j$kGk�k�k�klUl�lm�mn/n�n3o�opp�pQq�q�qSr�r#s�s�uov�v�vGw�wGx�xy~y�yzz�z{y{�{Q|�|�|�}~�~�~h�����b����w��G�����	�(�G���Ȅ�D�Z������)�n���׆G�f������/���:������������`���2�����4����c�a�P���ג(���)�u��`�~���a�t���[���3���������n�ٚJ���������D�r���Y�ʞ)�u����
�)�b���͠&�<�v���ơ�P�����	�A���٣;�z�g�ϥ@����z���W�i��O����1�y������8�[���ʫ��T���ެ$�G���ϭ�g�ɮ���]�ΰ9����{����}�ݳM������&�E�~�Ƶ�B�X������'�l���շ%�]�����W������\�ǻ7���	�s����k�۾:�M�����ӿ�T�w����� �6�p�����@�c�����9�����$��y���U���$���������i�����#�B�a������^�t�������C�������A�y����s������x���S���%�����'�����V�i�������(�p������<�R������\�~�����'�=�w����G�i������(�b�����2�,�n�����3�m�'�g���7�\����J���J��������q���e���*�b����@�u���[�����$�K�g���������a����������M�Z�������)t��e��V���	D���Y�M����MsS���:��&J'|(Y)f)�++,h-�-�-�F`G�G�H�H�HIrI�I�J�J�J�JsK�M�NOOQO�OwU�U�UH[�[�_�_sg�g�gUk�k�p8qv|v{x�x}�}X���[�	��̌z���b��������9�y��B�p�����L��������K�������^�o�h���
�)�����P���'�F�[������������d������^���z��H�����l������+�v�m�z������7�D����s�����!���r������0�%���U���\���������,���	����(�
��� ������f�����O���-�z��������^�.�o���'�j���!�w���-�o�����q�~���8������/�o�����X�e���e�d����������������o�3�����q��N���gt���;	�
�
.�A�����Cy�
&4�H�$��7��2 !�!3"�"&#R#�#�#>$�$D%�%�&�'(�(�(�(H)�)**c*�*Q+�+�+�+9,^12�223TU)UV�V�WQXxX#Y�Y�YvZ[|[�[�\�\�]^�^�_�_[`�`�`�a�a�a�a
f�f�f�f�f�f�f8g�g�g#h�htibj�k�l@ngop�t�t�y^z�}X~������W�̐��X���.����4�������������q���"�/�IJ��?���ݵW���ڻ���������*������������+�J����
���
����E�����F������)�p���9�����e����W���~���S���O�\�����D�����������������~���������������L����a��������Q�:���J���C�����O�����T�L�f���S���L�����k�����6��V���!�g���*��K��7��N�_�>n��#�kx�+��	�	�
�
�
l�2���`
m
y
�
n�����<���4��Hf�9d����?���M�Ye�C b � �!�!�!w"�"�"�#$$0$�$�$�%�%Y&�&�&p'�'�'f(�(�(�(C)f)�)�)*G*�*�*�*+�+�+1,�,P-�-.�.�.k/�/f0s0�01Z1�1�1*2�23�3�9$:1:G:�:�:`;m;�;G<�<@>�?�?+@�@hA�A
BgBtB�B�BDD^D�DNE�EEF�F�FoG�GHaH�H)I�I�IkJ�JBK�KL�L�LMsM�M:NGN�NOuOPrP�PYQ�Q�Q^R�R�R<SIS6YTZaZ�Z�Z�[\\1\O\h\�\�\U]�]i^_�_a�a)ee�grhhi�i�j4kl�lbm�m^n�no ofo�op�p�p�pqgq�q�u�v`w�w�x�x�y!z.z�z�{�{�|}�}7~�~cp���؀�������1���u�݄���0��>�	���6���ˉ|���^�ȋm�̌݌4�؍���ގE���������7�ґ���ܒ��V�_���(������<����.�u����t��w�M�ˤ�_�}���ި�|�8����^�ݯ�D�����o�{�ױI�Y�����;��l���*���Զ���"����F�ȹ�U���u���ļ����@���9�����E�����������d�4���%D]���,�-/.�../�/^01!1�152B2�2�3�3Y455d566}67~78L8�8�8$9|9�9�9Y:�:�:;�;@<M<�=o>�>�>L?�?�? DVDGdJ�MGNfN�NMPSR~Z�Z�Z�[z`�`EbEf�fej�j�j	kim�mXn�n�n�o�o\p~pht�tFvy�{d|�|�}3À�T�e�*�a���@�j���G��/�����ĉh���؊�E�R���!�L������V�ٍ�Q����B�t�׏�����u�ё;�����^��X�w��Q�t�����������/����8�`�Ǣ�x����F���E�R�c�ƥڥz�צ������m�ɨ	�;�����Y���ժ>�������������i���k����B�m�ִn��q���ֶ����r�Ǻ#�c����[�����q���%���	���F�������,�������Q����R�������W�k�Y���Y���~�'�4�@�����������1�����T����������J���2������� �-���)�H���l������X������������M�Z�����,�����)��������1��k������6�������x�"�/�x����i��(�����O������{���E������3�@���6�U���j����}���<�n�����f�s���1�>���T�c�r�����]�����]���n�������_���&v���5Qn��"W��cQ����s����N{	G	�	V
�
�
B�Gq��
�
lq��DZw��?����u���)G���$Bw��,Kj��h�2d�h�D�_�a�7 � �"�#$$W$�$�%�%3&�&�&)'�'�'-(�(�(e)�)�)�*V+�+2,|,-#-�-Q.r.�.+/�/�/�0�0�0A1`11�12&2|2�2�2�23a3�3�344�4�4�45g5�5r6�6�6�7O8�8+9t9�9F:�:�:H;�;<�<�>d?�?@8@�@dA�AB�B�BC�C�CD�D�DGE�E�E�F8G�GH^H�HI�I3JTJ�J
K�K�KdL�L�L#MBMaM�M�MN^NwN�N�N�NCO�O�O�OaP�P�P�P�PIQ�QRgR�RS�S�SyT�THU�U%V7V�VWfW�W�Y�ZB[N[�[\�\�\b]�]�]X^�^�^\_�_`�`a-a�a�b�bac�c1dRd�d�e�e�eZf�f+g�g�g+hph�h�h�h/iUi�i�i�ijKj�j�jkAk�k�k�klLl�l�l�m�m)n�n-owo	pRp�p$q�q�q&r�r�r|szuBv�v�vw�wAxbx�xxy�y�yyz�z�zs{�{$|�|�|�}~_~�~;����1����q���A�b�����>�w����;�T�����ۅ �e���ц>�]�|���܇&�z�1�������X��3�����������׎]�[�#���������#�D�ԔZ�f�ʕ[�n�ΖU�v������g���A�Ӛ���ěa���l�̝S���#�D����� �Y���Ǡ�6�m������G������8���У$�t�:�ɥ����t���Q�c�¨I����+�p������/�U���ī���K���լ�A���ƭ�^����ȯW���3�|��N�߲�P�׳ ��������<�u����9�R�����ٶ�c���Ϸ�T����@���V��/���
���ܼm��޽e���4�G�����ʿ�K�q������-�g�����7�]�����0�z������s���O����j���
�l���<������9�X�������U�n�������:������8�p����\���r��K���&���������������P�c��������g�������3�I�����
�S�x������4�n�����>�c�����	��Y�����)��e�����#�Y��S���1�H����6���6���������a���U����\�s���,�a���U������B�a�{�������>�����������G�T�k�����Q��U��	B���	0���I=����=m
M���4�=)�-6GMGUGlG�HIHI_IgI~I`J�J,K�K�M�NOO]O�U�U�U�[�[�_�g�g�g h�k�kq2q]v�x�xh}�}��Յ�8�k�t�����l�J����S�x��9���%�z�����ȧa����;���y��_���5�����!�|���������0�7�^��������������|�6�f�^����3�g����������2��=���$�������������&����� ��(��5���U�y���6��������>����������U��'���T���K������7�����G���s�r���#�!�����6��~�`������F��	C	�
�
Xz�$���$�� .<|yJ?]�S# P!o"9#�#L$�$R%�%�&(h(+)�)v*�*d+�+L,3`V`Ya[�]�`ba�a�a�adf�f�f�fg~g1h�h�itj�k�lRnyo�t�t0zXz0~R�z����Ɛ0�
�)�K�W������g���`�������O���ײ��R��������ʻ����Ƽ��y�������	�������*�N�y�U���,���������R�{���������m�/�_�������<�u��M��I�����(���+�W�����@���2����&�!�c��������&�����~���b�����=�\�_�y�1���������g�i�������^E���,�r�Qv��6���v�A	y	O
�
�
��f�6
�
�
�����J��G�V�!Y��������4�(S� = � d!�!"�"!#�#f$�$4%�%&�&�&�&'�'(y(�(Q)�)**�*�*U+D,�,--�-�-b.�.-/e/$0`0�0�1=2�2>3i3�3:U:�:C;�;U<�<S>�?�?a@BA�ATB�BCqDEHE�E�EFyF:GiG�G�H�H]I�I'J�J�J�K�K�L�LMMN�NO�O�OLPQ�QR�R1SZ�Z�[?\]\�\c]�]w^_�_.a]eLh&ijkdl�mqn�n�o\p�pqzq�q�w�xz�|~6Ёނ���N�r�������R�Ŏ���;��m��L������Ζ6������`�������<���ʟ�P�q���Ť1�Y�ħ��U�v��������ׯ�����E�i����C������q�7�f�������
�ȷ��X�ݸ����¹���@�o�ʻ��	�N���G��S������B�`���r�B���Rk���-�.(/�/�01�1/2\3�3�4	5�56�67�7
8�8	9�9�:<�>?u?�?�?GDQDsD>GUG�J�JNAN�NObPhR�Z�Z�[�`Sbtf�j�j�jkwm�m�mkn�n�n�op2pjp�p�p�t�t�tmv�v;y`y1|^|�|�}H؀9�����=�������N�������U���N�c�����̉{����7�ŋ/������Ӎ*�K�ڎU���я��ƐD���ˑ��G�X�/���'�L�n�|�������M�j�s���&�ҝ�o�}��U�����P�ˣ*�@���������T��������{��������~���Y����@�������׳��P�����ɴ�|�%�k�¶жȹ�K�l���v�ջ���N�k���Y�$���`�����������&�_�s�l��������!�]�p���S�������b����������h���2������#�~�������O���A���g�)���������x���%�9�2���}������������������������L����{���E��-���0���������M���%���K�
���*�k�t�|��������#�)�p�������������	� �r���9�
'C_�6�w��`%���b�,	O	�	d
�
�
V�[y��
�
�#���'h����`��7q��2d��:Yx��"���@l?b>�
��
��� � �"�#
$<$�$N%|%�%�&�&�&|'�'�'�(�()�)�)*-+P+�+,,�,�,Y-.K.�.�.�/�/O0|0�01O1n1�1�12.2�2�2�2�2*3o3�3�34�4�4�4�4+5u5�56�6�67&8I8�8%9�9�9�:�:�:�;�;k<�<�>�?�?@n@0A^A�AhB�B�B^C�C�CmD�D�D�E�E�EG2G�GH�H�H;I�I-J�J�JkK�K1L^L�L�L1MPMoM�M�MNlNN�N�NOQO�O�O�OoP�P�P�P
QWQ�Q�QRuR�RtS�SETsTUBU�UV?V�VW�W�W�Y[<[k[�[}\�\]�]�]^�^�^_�_�_:`�`a5a\bb-c[c�c+d�dBeze�ef�f�f~g�gh3h~h�h�h�h=i]i�i�i	jjYj�j�j)kIk�k�k�klZl�lm/m�mn1no'o�op�p�pwq�q�q�r�rIsvs�u�v�v�vLw
x;x�xEyry�y;zsz�zJ{m{�{w|�|�|�}~�~�~���Ҁ
�g���H�k��;���Ã�-�L���̈́�I�\������.�s���نL�k������4�����?��������������X�����e���*�W�c�����ܒ-���z�'�T����U�v�,�O���Y�����Ι���͚p��������I�t�*�M���z�����.�g���Ϡ+�>�{���ˡ�U������F���ޣK�i�|���åq���A�n��K�k� �C���3�~�������=�]���̫	��Y����)�I���ԭ"�l�ٮ��
�.�Q���-�ϱ����ٲ����ѳs������+�J���˵�G�Z������,�q���׷*�b�����g�������ߺ����]���/�g���<�_��.�O�����ؿ�Y�y�����%�;�u�����E�e�����>������&�J�m��I�������������������(�G�f������c�v������H�������F�~������������������y���K�����X�{��J�k�������-�u������A�W������a�������,�B�|����L�k������-�g�����7�7�W�s���������8�z���,�t����i�}���"�+�R�f���U�w����������.�v�����j�����;������M�V�}�����]�����)�P�i���������u�����?���.�j���*2cv�		�	O����^��R����RuU���<�(-�G�I�MFOU�Z_g5kRp�u[x�|��8����������z�������������V�N�;�x���>�f��c���-�=��)�������R���5�j���U���Q�G�����W�q�7�?�{���������������K�l�����a�����T���M����S����������V�����U�W���������N�S1�}�
�����j,
���hf �!�"1$�$7%�%t&w'�(n)5*�*+,c2�U�X�Z.]�_�`fhzhgi�i1k�l�mKo�t�y�}����7������������������9�l�:�~��������e���������%�����O������7�����z���#���d���v�(�9����e�������@�l����+�#�2���/�I���������L�:���G�	�q�tB�!�
d�
��	K��
@�H1(?���"o��� X"j#�$d%;&Q'M(9)�)�*,�,/-�-�.�/�0912x2�2�3�9�;;<�<$>?�@�A�BAD�DtE#F�F�G@HI�IGJK�K�L�MmN�NVO�O�P~Q�Q>R�X�Z�[H]�]\^�^�_�`
e�g�h�iPjik�l,nFo�o�p9q�q�vx�y
|I}�~�1���=�w�������Z���k�o���|�W�����������"�i�������-���Z����B�%���������]�(�����.��������V�&���:Q��|-V.T/0H1i2�3C5;6<768�8_99:g;>>?DGUJ�M3P8RdZ�Z`7b8fXjm�m�oQp^t7vy�{�}���������������������w�'������������������m��>���������]�6��[���H��������
��4�.��?�~��������i�T�+���~��������������6�W�'�O��|�g�)���b�����f���[�A�������E���t�O���4��	�	�
'�0�#
�
Q�Z�M��=������]�&��o>E #�$&'(F)X*�+],�-/�/�1�1�23W3�3�3
5[5�5#6�6S7z8V9%:,;�;�>�@�A�B�C(E:FcG?H�I�J�K�M�M�N�N9O~O�O�P=Q�QR[R�R�S�TsUzVHWDZ\C]6^@_u`�a�b�c�d>fg�h&i�iAj�j�jk<l�l�lRm�m�nXo4pq
r�r�u�w�x�y�z|}@~]�����n���}����[������o���{��9����������r�����������"���?���~�P���_�����=���0�v��������������t���&���A���������R���[���^�-�4��l���{����Y���L�����5��������������B�	�]�����-��� �n���w���z�I�P����������0�u���h�����Q��,���������^�%�y����I��d�����4���O��������������~�5�F���������U���B����<�������,	/�.���#�M��a(	-�G�I�MFO
U�Z_g8kUp�u^x�|�<������̖�|�ܞ���ح���W�O�=�{���A�g��g���0�A��,�������W���9�l���W���T�K�����Z�r�9�B�}���������������L�m�����b�����U���P����U����������W�����W�Y���������R�W4��
�����l.
���ji �!�"3$�$9%�%v&y'�(r)7*�* +,e2�U�X�Z1]�_�`h|hii�i3k�l�mMo�t�y�}���:���Ú��ڥ��������;�n�<����������h���������)�����S������:��������'���f���y�+�=����h�������B�o����-�&�3���0�J���������N�;���J��s�wC�"�e���	O��
B�H1)@���%r��� Z"m#�$e%=&S'N(;)�)�*,�,3-�-�.�/�0=12z2�2�3�;=<�<&>?�@�A�BCD�DxE&F�F�GDH
I�IKJ"K�K�L�MoN�NYO�O�P�Q�QAR�X�ZJ]�]^^�^�_�`e�g�h�iRjlk�l-nIo�o�p;q�q�v!x�y
|L}�~�3���?�z���ފ��[���m�r���}�X���������ߞ#�j�������0�ͥ]���D�'�����˴�a�,�ۺ��/��������W�'���;R��~-Y.U/0L1m2�3G5>6?788�8b9<:j;>??DGWJ�M4P9RfZ`8b:fZjm�m�oRp`t9vy�{�}������؆�����͊���ʌz�)��������ܛ�������q��A���ū��`�7��]���J����������6�.��B����������l�V�-����������
�������9�Y�*�P���i�+���c�����j�C���E�����4��	�	�
'�0�#
�
Q�Z�M������^�&��q@G #�$&	'(H)Z*�+_,�-/�/�1�1�23W3�3�3
5[5�5#6�6U7|8X9':.;�;�>�@�A�B�C*E<FeGAH�I�J�K�M�M�N�N9O~O�O�P=Q�QR[R�R�S�TuU|VJWFZ\E]8^B_w`�a�b�c�d@fg�h&i�iAj�j�jk<l�l�lRm�m�nZo6pqr�r�u�w�x�y�z|}B~_�Ё��n���}�х�[���̇�p��{��;��������t����������$��A�����P���_�����=���0�v�ģ�Ϥ��Ҧ����v�ު&���A���ˬ����R���]���`�/�6��l���{�϶�Y���L����6������Ľ����B�	�]�����-��� �n���y���|�K�R� ���������0�u���h�����R��.�
��������^�%�y����I��d�����4���O������	��������G����������������-	/�#��a(�,xG�I�JbK�M4O�T�U�Z_�f�g#k@p�uIx�|ց&���������h�җ�]�ɞޟͦ��ĭ�p�D�<�)��f�?��5�,�T���Q�x��+����������@���#�X���C���?�5�����E�_�%�-�i�����z����������9�Z���r�O���n���B���;�����A�������q���D�����C�E���������<��A�k�t
�
���y�W�����VT �!�"$�$%%�%b&e'�(\)#*�*+,Q2~U�X�Z]�_�`hhhUi�ikwl�m9o�t�y�}ل��%�̒��מ��ĥ��u����r�'�Z�(�l��������9�S��������������=����y�%�����h�p����R���d��'�����S�������.�Z������ ������7���v�n���:���(���5����_�b0���R����	�
9��
.�6	-����]<��Q � �!F"�"X#$�$�$R%�%)&�&?'�';(')�)�*,n,-�-�.�/�0'1�1f2�2u3�;)<�<>
?�?@�@�A�B/D�DbEF�F�G.H�H�I5JK�K�L�M[N�NDO�O�PlQ�Q,R�XsZ6]�]J^�^�_�`�d�g�h�i>jWk�ln4o�o�p'q�q�v
xey�{7}�~����+�e���ʊ�H����Y��]�&����j�˒E���
�|��n�̞�W���������H�ש�0��ϰ���*���y���öK���չD�ź�����s�������D����(?��j-D.B/	061W2�315)6*7$8�8F9 :U;�=�>+?D�FCJ�MUN�N!P&RRZ}[�_%b&fFj�l�m�o?pLt%v�x�{r|�}������ņ·n�q���������e������t�f��ɛ����ۢ��[���,�ܨΩĪ����w�K�$��I���6������������!�������-�l����������9���!�����W�B�7�����n���l�������������Z�����$�D��=����j���4�����j�U�D�����l���P�����S�I�/�����3�������"��	�	�
|�
�
?�H�;�������K���],3 #F$�$�%&�&�'�(4)F*o+K,-�-a.�.�/�0�1�1�23E3�3�3�4I5�56�6A7h8D9:;�;�>'@�@tA�A�B�C�DE(FQG-H�HnICJ�J�KtLM�M�N�N'OlO�O�P+Q�Q�QIR�R�S�TaUhV6W2Zu[�[�\1]$^._�_c`ua�bzcAd�d�e,f�f�g�hi�i/jtj�j�j*lxl�l@m�mpnFo"p�p�q�r�uw~wQx�x�y�z�{�{}.~
�K� �����Q�\���k����I������]�Јi��'��Ҍٍ�����`�3�������e�՗�����-����l�3�>���M����+�q��d�������������b�̪�۫/�t��������@���I�p�L��"��Z���i����G���:���θ#�׹��ڻ����~��0���K���������\���e���h�7�>��v��������c���V�����?�������������L��g�����7���R�����"���=�����
���������l�4�����������0���
�����|	n���r�O�j�jk)k4klk~k�kDlOlZlmlzlm'm2m�mnnSn^n�n"o-o=oFoYo
uu&u�u�u�u�uKvVvav�v�v'w2w�w�wxIxTx_x�x�xyQy�y�y�y;zFz�z�zzj�j�j�jkk�k�k�k�lmmAmKmUm_mimsm�m�n�nxo�o�o�o�o�o+pnodoJpTp^php�p�p�p@p6pq&q0q:quq�q�qqq�q�qrrGrRr�r�q�q�r�r�r�rs$sss�r�r�s�s�s�s~s�s�s�s�s�s�st
t�s�s(t2t<tttZtdtntPtFtxt�t�t�t�t�t�t�t�t4uzu�u�u�u�u�u�u5v@vpv�v�v=wpw{w�x�x�x�y%z0zQz~z�za)n)�-.�H�H�J�J�[�_�k@q�v�x�}‚����Ð��������$�f���/�����l�������t���3�u����?�L�)�z�8�������4��#�0�W�5���6�/����5���y���`�m���
���������o|��K���: �!�"�#�#�(�(P)
**�+�+:3�V�Y�['^�`�a�f�f�g�gfz`~���Ԑ`���������y�*�7��&����3�	���������1�����m����[�W�d������
������T������Y���������[�T����)����S��V$s���	�
�
��h
u
"��l�aK �!�!�"$$�'�(�(�)�)�*�*�+�+�-�.s/n0{01�1�1,:9:h;u;pAoB|BD#DVE�FwG"H�H�I�J�K�L�L{MBNONzPaQ�RDSQS\ZiZ�Z\#\�\�\�ezh�h<k�l�mo(o�o�p�p�w�x)z6z}?~kx�	�������ЋԌ<�M��� ��Ӥg�������Űw�Q���%�t�����й}�7.6/1)1=2J2�3�35$56678�8,9�9:�:�:H<U<�>�?ON�Z�`�f�jl|\�M�Z������Y�
�ߏ��ّ���f�`�&���Ϣ��N�M�Z�Υߦ�� �Ѩ�����������q�y�޶z�+������y���N���������� �/�<�����������������(�5�1��`�������U�b�����������������*�7����#�0�����;�H�>��D���n�{�9�F�\�k�z�����������{�L���}��pL��� $�%�&�'�(�)^+:,
-Y.�/�0W839:�:�;�<�?lA�B�C�D�E@GH�H;J�KlL�S�TPU-V%W�WJ[�\�]�^�_"a�bic9d�e�f�g5op�p�q�r�s�vIx�y�z{{�|~�~��y�I���������e���+�b�c�]�����ۚ����[�+�ѥ��|�Y�Q� �_�;�
��߳����ɻ��u�m�<�{�W�&������	���������X�9�d�����O�\��������K����ͅ���h����Z�����B����;����9���K�������ߘ/�~�������G����;���֞"�u�ȟ��������������X�2��1��c�5�O�Z���S����I��������G�������د0���ұ̬ԭ,��k���߶8���۸ϳ״0��n����K����غ�;��w����r��������R�$�����Z���/�e��ʁ�K���b�j����������B����b�j����������N� ���t�|������J����w�J���
�̅���g���
�Y�����A����:����8������J���
�ޘ.�}�������F����:���՞!�t�ǟ�������������W�1���0���b�4�N�Y���R����H��������F�����}ׯ/���ѱ�ӭ+���j�ˬ޶7���ڸ�ִ/���m�γ�J�����#�߻:���v�׺�q����J���Q�������Y���.�d�����������i�����a���A������i�����a���M�������{���I��s����v���ED<G�J`PfR�o�tkv9y�}FրC����Ņ���`����R�����:���ܑ0���ْ.�������;���ט&�v�����>����2���Ξ�m���������ܩ�������G�A��������?�����vЯ(���ʱ�̭$�|�_���׶0���Ӹ	�ϴ(���b�ó�C�����ػ3���k�̺�j���
�C���J���~���R����]����y������b������V���:���t���b������V���F���z���t���B��h����k���G���
�Ʌ���d����V�����>�����4���ݒ2������?���
�ۘ*�z������B����6���Ҟ�q�ğ�������������K�E��������C�����zԯ,���α�Э(���c�Ĭ۶4���׸
�Ӵ,���f�dz�G���� �ܻ7���o�к�n����G���N�������V���#�a����}�����
�f������Z���>���x���f������Z���J���~���x���F��l���	�o���M)�-�HxJ�NaO�U�[�_�g�k%qiv�xz}����P���|�R�[�*�����n�����H��������������>�O����������N�v��O��+���&���#��U���2�$�������������)��&�������C������������b����e���T���$����������0�.�����(��{��[��
k�1��-���SN�,& c!|"B#Y$�$_%&�&(<)�)�*�*q+Y,$3sVmYn[^�`ka>h�h�i�j�k�l_n�o�tCz=~e�����=��j���~�u�\�
���[�����	������������a�h�5�����l�����G�����T�,�(�����6���?�����X���@���	�.�v�����3�������k���h���>�&�������r����k-��9�{�Z�?���X	j
�wK
��O��P_*����;$ {!�"�#�$�%�&�'�(^)7*�*Q,�,�-y.D/?0�0�1J2�2Q3�3�;b<�<`>�?SA�A�B~D0E�E�FQG�G�HnIJ�J�K�L^M%N�N'O�O]P3Q�QR�R-Z�Zp]�]�^+_�_;aje]h/ijkwl�mzn�oqp�p�q	r�w�xz�|!~M��������a�����������������������?���(����G������c���D���h�������T�-�	�P�������Y���P����Q��{�K���[t���-/�/�02s3�4�5�6�7�89�9�:<�>~?JDAG�J)NmPsR�Z�`^b�f�j�mvn�oup�t~vLyF|�}S��H�H�Y�`���������<����d�����B�<��7�,�c��������+���p�S���[����������l�1���m�����q�������`�����q������J���t�6�����7�������������������.���X��������w�>C�2g1	�	i
�
[�`��
�
�(�������'��EN���� �#]%�&�'�(�)<+
,�,".�/^0�12�2/3t3�3�305z5�5�6�6589�9�:�;z<�??AwBmC|D�EG�G�HJzK@L�M�M�NOVO�O�OQ\Q�Q$RzR�STT$U�UW�W([�\�]�^�_�`kb<c
dQe�f�g�hBij^j�j�j.k_l�lm�m
no�o�p�q�rXs�vxTyJzY{�|�}�~���W����������3�x�����9���D���������g�t�9�����6�,�;�h��������9���l��������Z���K�����V�����P�"�/�����B��^�����.���'�q���=������������������1�v���g�����r�����l�>�K���^�*�z����J���C����Y�*����������������M������������������Z�g�,�2�z�F����� �f�1������Q��l�����<�C�7��������u�J��������;w��	i]W$��&�+PF��12T�WZ\_<p��B�a�u�z�R�^��v�������I�,#;�=9�"�wK$�&�+�FIL�MOO�O���\�������?�P#(+V1�S}W�Y�[�^bf6gpC�}�4������d7��(d)E*	+�3�9�:B�B�R�[f\�a�n�u�z�+�*�ʼnی܎O�:�m�ר�W�������s+�,�:�=�?�j�m�n�o|pc�_�h�-���‰����J��r�s�����-�^��a���9�<����k���	���������U�i����/����������������llUG��yE	�
o��u+�D�?�b�"�'�)�.�0#24�6�:�>�C�E�J�LN�O�R5V�Y�^+a�e(hRi?k'n�qxu�z�|�����φ����Y�l���j���Ġ��r�a�(�R�?������ͷ��}�D�n�[�������������`���v�a������V�P�E���3�-���������p�)�^�M����^�x���4���h�N�?�'��|~��jE��1sf:�[9������6�F�d�l����^�dgf:�[-������*���:�X�`�x��R�X/29=DKOSW[_cgkosw{���������������/Mlp��������������������
"&*.26=AELZimqx������������ 'CJQcjr��������
 (9@GNRVgk������������				-	5	H	Y	l	t	y	�	�	�	�	�	�	�	�	�	�	�	�	


!
)
1
9
A
I
Q
Y
a
i
q
y
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
	!)19AIQYaiqy�������������
%-5=EJRZ_gl���������������



#
+
3
;
C
K
S
[
c
k
s
{
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
1CGOW_gow�����������������"*2:BFNVg�������������$,19>FNV^fnv~�������������'/7?CKS_s{�����������
"*2:S[bjrz���������$).38=BGLQV[`ejoty~�������������,CUbr�����������%=EX`ez����������&.CKS^ckpu�������������
%:BGaiqv��������������$,4<DLT\dlt|����������������#+3;CKS[ck|�������������$,4<DLT\ains���������������
%-5=EMU]emu}�����������������$,4<fks{������������������!4<RW_glt�����������������
"*27?GOW\dlqy�������������������%-5:BJRZbjrz���������������� 
   " 6 ; N V ^ f n s { � � � � � � � � � � � � !!!!!'!/!7!?!G!O!W!_!g!o!w!!�!�!�!�!�!�!�!�!�!�!�!�!�!�!�!�!""""'"/"7"?"G"O"W"_"g"o"w""�"�"�"�"�"�"�"�"�"�"�"##!#3#;#C#K#S#X#`#h#p#x#�#�#�#�#�#�#�#�#�#�#�#$$$$ $($0$8$J$O$W$_$g$o$w$$�$�$�$�$�$�$�$�$�$�$�$�$�$%%%%,%4%<%D%L%S%[%b%j%�%�%�%�%�%�%�%�%�%�%�%�%�%&&&&'&/&7&>&W&^&f&n&v&~&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&�&'
''''''"'&'*'.'2'6':'>'B'F'J'N'R'V'Z'^'b'f'j'n'r'�'�'�'�'�'�'�'((((%(*(2(7(?(G(O(W(e(m(u(}(�(�(�(�(�(�(�(�(�(�(�(�(�(�(�()
)))")')/)7)?)G)O)W)\)d)l)t)x)�)�)�)�)�)�)�)�)�)�)�)�)�)�)�)�)�)�)�)*****$*,*4*<*A*F*K*S*[*c*h*v*�*�*�*�*�*�*�*�*+++3+F+_+g+z+�+�+�+�+�+�+,,, ,(,D,R,W,\,a,f,k,p,u,z,,�,�,�,�,�,�,�,�,�,-	---0-8-@-H-b-j-r-z-�-�-�-�-�-�-�-�-�-�-�-�-.
.'.0.J.R.h.p.x.�.�.�.�.�.�.�.�.�.�.�.�.////#/(/;/J/]/e/t/|/�/�/�/�/�/�/�/�/�/�/�/�/�/�/0000 0(00040<0D0H0M0\0`0h0p0t0|0�0�0�0�0�0�0�0�0�0�0�0�0�0�0�011111$1,14181@1H1P1U1Y1a1i1m1q1y1}1�1�1�1�1�1�1�1�1�1�1�1�122222'2;2?2G2O2`2h2p2u2y2�2�2�2�2�2�2�2�2�2�2�2�2�233333 3(30383@3[3c3k3o3w33�3�3�3�3�3�3�3�3�3�3�3�3�3�3�3�3�3444$4,44484@4H4P4X4`4d4l4t4|4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�45555#5+535L5T5\5`5h5p5x5}5�5�5�5�5�5�5�5�5�5�5�5�5�5�5�5�5�56666 696A6I6Q6Z6^6w66�6�6�6�6�6�6�6�6�6�6�6�6�6�6�6�6�677777&7.767>7F7N7V7^7f7n7v7~7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�78
8888!8)81898A8I8Q8Y8a8i8q8z8~8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�899999%9-959=9E9M9U9]9e9m9u9}9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9::::!:&:+:0:8:@:H:P:X:`:h:p:x:�:�:�:�:�:�:;;;!;%;-;5;:;?;C;K;S;X;];e;j;o;s;{;�;�;�;�;�;�;�;�;�;�;�;�;�;�;�;<
<<<<&<.<2<:<B<J<[<c<k<s<{<<�<�<�<�<�<�<�<�<�<�<�<�<�<�<�<�<�<====$=)=1=9=A=F=N=V=^=q=y=�=�=�=�=�=�=�=�=�=�=�=�=�=�=>>>>>/>6>>>C>J>Q>U>]>e>m>u>}>�>�>�>�>�>�>�>�>�>�>�>�>�>�>�>�>?	?
???%?-?5?=?A?I?Q?Y?^?c?k?s?{?�?�?�?�?�?�?�?�?�?�?�?�?�?�?�?�?�?�?@
@@@"@*@2@:@?@G@O@W@\@`@h@p@x@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@AAAA#A+A3A;ACAKASAWA_AgAoAwAA�A�A�A�A�A�A�A�A�A�A�A�A�A�A�A�A�ABBBB!B)B.B6B>BFBKBSB[BcBgBoBwBB�B�B�B�B�B�B�B�B�B�B�B�B�B�B�B�B�BC
CCCC&C.C6C>CCCGCOCWC_CgCoCsC{C�C�C�C�C�C�C�C�C�C�C�C�C�C�C�C�C�CDD
DDD%D-D5D=DEDMDUD]DeDiDqDyD�D�D�D�D�D�D�D�D�D�D�D�D�D�D�D�D�D�DE	EEEE%E-E2E:EBEJENEVE^EfEnEvE~E�E�E�E�E�E�E�E�E�E�E�E�E�E�E�E�E�E�EF
FFF!F)F.F6F;FCFKFSF[F_FgFoFwFF�F�F�F�F�F�F�F�F�F�F�F�F�F�F�F�FGGGGG'G/G7G?GGGKGSG[GcGhGmGuG}G�G�G�G�G�G�G�G�G�G�G�G�G�G�G�G�G�G�GHHHH$H,H4H<HDHIHQHYHaHfHjHrHzH�H�H�H�H�H�H�H�H�H�H�H�H�H�H�H�H�H�HI	I
III%I-I5I=IEIMIUI]IaIiIqIyI�I�I�I�I�I�I�I�I�I�I�I�I�I�I�I�I�IJ	JJJJ#J+J3J8J@JHJPJUJ]JeJmJqJyJ�J�J�J�J�J�J�J�J�J�J�J�J�J�J�J�J�J�JKKKK K(K0K8K@KHKMKQKYKaKiKqKyK}K�K�K�K�K�K�K�K�K�K�K�K�K�K�K�K�K�K�KLLLL'L/L7L?LGLOLSL[LcLkLsL{L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�LM	MMM!M%M-M5M=MEMMMUM]MeMmMuM}M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�MNNNN#N'N/N7N?NGNONWN[NcNkNsN{N�N�N�N�N�N�N�N�N�N�N�N�N�N�N�N�N�NOOOOO'O,O4O9OAOIOQOYO]OeOmOuO}O�O�O�O�O�O�O�O�O�O�O�O�O�O�O�O�O�OP
PPP%P)P1P9PAPIPQPUP]PbPjPoPwPP�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�PQQQQ'Q+Q3Q;QCQKQSQ[Q_QgQoQwQQ�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�QRRRRR!R)R1R9RARPRXR`RdRlRqRuR}R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�RSSS&S.S6SFSJSRSWS[ScShSpSuSyS�S�S�S�S�S�S�S�S�S�S�S�S�S�S�S�S�S�S�S�S
T"T'T=TBTGTLTTTYTaToTvT~T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�TUU
UUUU'U,U1U9U>UFU`UeUmUrUzUU�U�U�U�U�U�U�U�U�U�U�U�U�U�U�U�U�UV	VVVV#V)V/V5V;VAVGVMVSVYV_VeVkVqVwV}V�V�V�V�V�V�V�V�V�V�V�V�V�V�V�V�V�V�V�VWWWW W'W.W5W<WCWJWQWXW_WfWmWtW{W�W�W�W�W�W�W�W�W�W�W�W�W�W�W�W�W�W�WXXXXX#X*X1X8X?XFXMXTX[XbXiXpXwX~X�X�X�X�X�X�X�X�X�X�X�X�X�X�X�X�X�X�XY
YYYY&Y-Y4Y;YBYIYPYWY^YeYlYsYzY�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�YZ
ZZZ"Z)Z0Z7Z>ZEZLZSZZZaZhZoZvZ}Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z[	[[[[%[,[3[:[A[H[O[V[][d[k[r[y[�[�[�[�[�[�[�[�[�[�[�[�[�[�[�[�[�[�[�[\\\\!\(\/\6\=\D\K\R\Y\`\g\n\u\|\�\�\�\�\�\�\�\�\�\�\�\�\�\�\�\�\�\�\]]]]]$]+]2]9]@]G]N]U]\]c]j]q]x]]�]�]�]�]�]�]�]�]�]�]�]�]�]�]�]�]�]�]^^^^ ^'^.^5^<^C^J^Q^X^_^f^m^t^{^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^_____#_*_1_8_?_F_M_T_[_b_i_p_w_~_�_�_�_�_�_�_�_�_�_�_�_�_�_�_�_�_�_�_`
````&`-`4`;`B`I`P`W`^`e`l`s`z`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`a
aaa"a)a0a7a>aEaLaSaZaaahaoava}a�a�a�a�a�a�a�a�a�a�a�a�a�a�a�a�a�a�ab	bbbb%b,b3b:bAbHbObVb]bdbkbrbyb�b�b�b�b�b�b�b�b�b�b�b�b�b�b�b�b�b�b�bcccc!c(c/c6c=cDcKcRcYc`cgcncuc|c�c�c�c�c�c�c�c�c�c�c�c�c�c�c�c�c�c�cddddd$d+d2d9d@dGdNdUd\dcdjdqdxdd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�deeee e'e.e5e<eCeJeQeXe_efemete{e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�efffff#f*f1f8f?fFfMfTf[fbfifpfwf~f�f�f�f�f�f�f�f�f�f�f�f�f�f�f�f�f�f�fg
gggg&g-g4g;gBgIgPgWg^geglgsgzg�g�g�g�g�g�g�g�g�g�g�g�g�g�g�g�g�g�g�gh
hhh"h)h0h7h>hEhLhShZhahhhohvh}h�h�h�h�h�h�h�h�h�h�h�h�h�h�h�h�h�h�hi	iiii%i,i3i:iAiHiOiVi]idikiriyi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�ijjjj!j(j/j6jvf:\<������9�I�g�v�~����a�f�&'�+�+;G?GMIQI�M"O�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�#�'�+�/�3�7�;�?�C�G�K�O�S�W�[�`�e�j�o�t�y���������������������������������������������������������������P�Q�R���������QUY]aeimquz��	

�#�#�#�#�#�#u(z((�(�(�+�1�1ZT�T�T�W�WX7ZWZF\�\�\+_K_k_�g�g�g�g�g�g�g�g�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p�p���������������������������������� �%�*�
���
��������������������������������������������� %*/49!
�����^"',16;@EJOT�(�)�*p+u+z++�+�+�+�+�+�+�+�+T;U;V;W;X;Y;Z;YB?CDCICNCSCXC]CbCgClCqCvC{C�C�C�C�C�C�C�C�C�C6S�\�\�\�\�\�\�abbbbbbb�n�n�n�n�nv5v6v7v�z4{Z{[{\{)�I�i�j�z�������Ɔ���8�X�Y��"����"�'����������o�t�y�~���������¡á>�?�������Ʋ˲в��}�~������H�I�J�K��������������������--------- -!-"-#-$-C;�?�?�?�?�?�?�?�?�?�?�?�j�j�m�n!p�p�p�p�p�p�p�p�p����������R�щ��>�?���1�6�������N�O���T�Y�t�����/������������������������ǶR�W�ڻU�Z�i�j�R�r���������������������������������X�]�b�g�l�q�v�{����������������%�����e�W	\	a	�
�
�
��� ����evi��������v{���"�"�"�"�'�'*** *�.�.1111$1<2A2F2K2P2U2.43484=4B4G4L4Q4V47777�:�:�>�>�>�>�C�C�E�E�EF�J�J�L�L�LMMN#N(N-N2N7NPPPP$P)P.P3P8P�R�R�R�REVJV�YZZZ__@aEaJaOa	ff?hDhIhNhShkipiuizii�i]kbkgklkqkvk{k�k�k;n@nEnJn�q�q�u�u�u�u�z�z�|�|�|�|����σԃكރ�����
��������������ˉЉՉډ����n�s�x�}�}�����������{�����������şݠ������Ǣ̢Ѣ֢ۢ��������q�v�?�D�I�N�S�k�p�u�z����U�Z�_�d�i����#����ʹҴ״ܴ�������
���������������������[�`�e�j�o�������������q�v�{�����0�5�:�?�� ��������������$�)�.����	���������������w�|�������������������������������y�~������������y�n�W� ����������������h	�z�A�18�:d��d��G(7,-�-�-D.�.A,/�0/i[�Uz�ʧ*���9���E	�
"0>�a�a�t�����(���^�x���
�q�n~��2�2�N�N�i!j^���@���Ϋ!�\�����=�x����Y���D���/�'�+CGUI�MO'O�P~�����S������#�(�+�1�TXXZ�\l_�g�p/����>&����_Y�(�)�*�+[;^B�C7S�\b�n8v]{k����Z�'�,����ġ@��ղ������%-D;�=�?�j�m�n&p�p������W���։��@���;�ŏ��P���^�u���4������������ȶ\�߻_�k�s���b�����(���������*�����j��f	�
�%��j{n��"�'%*�.)1Z2[4 7;�>�CF�JM<N=P�ROVZ_TafXh�i�kOn�q�u�z�|�����߉������Ƙ��ʟ�����{�X���n�(�	���������t�����D�%��3��������������������~�s�%�\���%�������P���l����B����-m
	�
����F0f���"�_�l����%���}1*��B�5��� �L�x�d����Q�E
�:��W���
��q]��j�����$cH�4P���\���v����,=O����[K��U����N�|��-u��3��{�h���@�#Ga��.z��&g������+��C��7�/�2������6��sS�����b�b�$crate::panic::panic_2015���������]panic_internals���S�R�('�����k��;Z�~J$��u���core_intrinsics�derive_clone_copy����('����80t��U0�����Ј���('����VOH�X��5}����-fmt_helpers_for_derive��_�_�('�����t��K�X��� ������('���5G���K%��-�����+V��-��S�R�('���ZFRuY���(<����j��-���('�����˳mdtD�^}�J���-��-���('������^sX�����=���Z��-��-�generic_assert_internals����('���
p�ls�z��O������?���('����2G?��XEmatches�
̺���|Z��}s�('����^��7��p�������-��-���-���('���9D�y\L�,�U3����b��('���G��oq�����t6��-��-���-���('����Nh\��R�!<�����-���('����Zu��R���ަ���Z���('�����NW>��$~?$�����-��-���('���I�edD�5��-V��C=
��-��S�R�('�����ܪ�> ����=G��-��-���-���('����I�'�D��-���������-��S�R�('���y�
��5�X�����('����~ٳ;S��'<��\��-���('���1��1IҐ����z���('���ÿ�(g̥~D$���-��-���('�����g�\hpr�.��������-��-���-���('���*��M9P�{���@����-��-���-���('����׃�A���-b�+����-��S�R�('���fƞ+QށZ����@A��-��-���-���('������_3��O����'��('�������P�4	���-��-�_�_�('���3�	��:b�>�w��-��-�_�_�('���&�Y�Y��4����%��-��-���-���('���
�T������-������Z��-��S�R�('���B��*'��c��-�����=���-��S�R�('����^1p�����޽����-��-���-���('���0W2�ڇ���W�͋$���K��('���{X%��a/�9���O\��-����('���{�q��}��-��v��=x��-��S�R�('���TݮA�,�J��-�����@���-��S�R�('���!���v����@)���-��-���-���('���{Ə�j�.�����1��-��-���-���('����)m�����U2�������('���B���U,����@���-��-���-���('���j"D��/tj��-��-���('���+��KW�����2l���('���~n��<X�ut>�{z��-��-���('���kuf��G/a��-��C���}s�('���g�uiq�dz����)���-��-���-���('���A��DW�����-�������
��-��S�R�('�����ȧ
׌�W���"��('���f�T7��l��9ތe�f\��-	derive_eq������('�����.�?+������=�	��-��-���-���('���ᱵ8O.M���/���('����o��p��U.����`��('����̍��"�
��-`�'�@�0��-��S�R�('����j�L�ؗ�O����
��('�����u2^��������
��-��-���-���('������m.��~$�����-��-���('���HU�Dd�~>$����-��-���('�����滌��o�O�����
��('����(d��)��-H̸��
��}s�('�����'G��pt�W���"���('����S\�ў��92�u�=���-�`�`�('����d?3H���-&���~��}s�('�����nOf�j����=D��-��-���-���('����B�y��?��-�����@���-��S�R�('�������Mk����-���������-��S�R�('�����~���������R���('���c⁃|Z ��U1�������('���݊�۝�8��-�����%U��-��S�R�('���H
��:̈����+�
��-��-���-���('���As]*qW���,������
��-��-���-���('�����.5u�.��-R��>=��-��S�R�('���%h���z��-�����=I��-��S�R�('���L�>8��"��������('���W����T\W�O����[��('����"�
�
���-k�<��E���-��S�R�('���]�]���.�W��"	��('���	�Ʋ+�\��9��s��-��-�_�_�('���^1�a�7�j��-��q��t~��-��S�R�('���{�����!1������('����}��1���-^�#�@)���-��S�R�('���[i9V��<��-����=��-��S�R�('���_�U��,f�:����������('�����p�=� )��-���������-��S�R�('�����k��.	���-w�S��=���-��S�R�('���~q�+;.����2\���('���
�����,�����5��-��-���-���('���a+,Q7G�/�����w��-��-���-���('����|�����W��� ���('����	 =�Ёt9���-��-���('�����=��7�A�vA��-��-�_�_�('����?j���Hb��ʴ@O��-��-���-���('����I���4��-���������-��S�R�('�������2�:���n���('���a�]��C��<z����-����('�������1[d��U,�������('���o��t�=�}�F�o���-��-�_�_�('���3�����-̌>���}s�('���I����V�/��������-��-���-���('����N�\������-i�8��=��-��S�R�('������3�A�~9$�����-��-���('������O���x���n4u��-��-���-���('�����w�������-��m��@���-��S�R�('����1aW�Z���ئF���('���ҙ*^��w�tA�zT��-��-���('����ߤ������C=P��-��-���-���('�����h�
֟�	A���-��-�_�_�('������}��#�:���i���('���zbU�i���-L���a��}s�('���j�`A�ڎ#��-������}s�('���ᳵW%����-������Z��-��S�R�('���o�n���O���;��('����1�t�`���<$�q
��-��-�����('����7���*��-����n4���-��S�R�('���&���2[nr���b��-��-�_�_�('���o���O�%tF�t���-��-���('���"��CUWe�U/������('����l��������E���-��-���-���('����k�j��#l���i4��-��-���-���('����TpZγ���O��������('���ԣ�3�~A$��4��-��-���('����Z1�"�5����@���-��-���-���('�����qf�s�O�������('���]�b�ԋt	z�^��-��-���('���7}q�X���-�����=Y��-��S�R�('�����Ǫh��:���:	���('������x�	����-t�N޽����-��S�R�('���d�ԨZK%��O������('�����U�D��<W�P��-�`�`�('���3C�҄�S�t�����-��-���('������L���j~F$��E��-��-���('�����"|�u�����=���-��-���-���('���&e�h�p
���/��-��-�_�_�('���N�p8g���-������<��-��S�R�('���/T���@��������('���0q|�Ug�U5������('���޹�4a�����-��i��@���-��S�R�('���߹��7f����@��-��-���-���('���7
N�����>=N��-��-���-���('����}z#��-��������-��-���-���('�����rR�$P~	$����-��-���('������%�h\��-�����@��-��S�R�('����I�<›��:�������('���"O������O������('�������T1�$�X���"w��('������y����<̕���-��-�_�_�('����v[Ӑ�0���-��}�i4���-��S�R�('�����x���G~$�;���-��-���('���[��mS�Q���������('����.)�����-���ʴ@� ��-��S�R�('����듚4{tF��-��-���('������X�w������e���('���~n��#r��O��������('��������X��������('�����{������;����('����{h��]�o�-��������-��-���-���('����0]�u&�J�z0!��-��-�_�_�('���̓�\���촺����('�����0�����0�����o ��-��-���-���('����@�e�o)��-r�J��)�"��-��S�R�('���xj���b��X�، �!��('���V8�:Mlt<	�M!��-��-���('���zӸޥ����-������I#��-��S�R�('��������N�[����5�!��-��-���-���('���k_����%���-e�0��=�#��-��S�R�('���F$�������V ���('�����J��i��U4�����#��('���q@�)?����-~�e���X$��-��S�R�('���������a��?���#��-��-�_�_�('���i�l�0�����@�"��-��-���-���('�����j�ߣ4�U-����e$��('���7Ŗ٭N�1���*b��('������툩�tJ�~�#��-��-���('���~�)N5����0������#��-��-���-���('���J �����7b�b���('�����Z�`*�����5�#��-��-���-���('���n�1����X��� %��('���#��'oJB~<$��&��-��-���('���=������0�)<��
%��-���('�����F�Dx1�D��%��-��-�_�_�('���k͆)��8���=	%��-��-���-���('�����x4O��M����=H%��-��-���-���('���L��vl̬�O�����.%��('���S�����$����=�%��-��-���-���('�����0D���!�샳N$���('���5�m�a�At?^�\&��-��-���('����<vTh{��������it������b��r���R����`w���e��������^�~k�V�
���Z�ts�('���{�8�U�\e�%g�0�ts�('���S!�S0��" �]�ts�('���Wr���5���
���ts�('���qw�fR��L����ts�('������6�e���g���ts�('������(��h����ts�('���\�B6##���ԱA�ts�('���������:��o�ts�('���� lv|j������ts�('���3O4�7����ts�('���:��5�g6�M���ts�('���GX#�����$�(�ts�('���х��X2<���W�ts�('�����z?����1���ts�('���@k����υ��ts�('���N]�f+&+�+����ts�('����W�,~�������ts�('���-���0٩��HI�?�ts�('����>��T���&�m�ts�('���Dwt����K����ts�('�������e�x��C����ts�('���w_��V��G����ts�('���{����";���&�ts�('���J5,],`]��#�T�ts�('�����F�G�������ts�('���[�7�,��@���ts�('���ߘzܨ�>�����ts�('�����“��&�*�
�ts�('�����U�R�y;�E��;�ts�('����7��ֹ�)�B��i�ts�('����u8
��p������ts�('����蚛����ݸ��ts�('�����.aϰ�j�=7���ts�('��������uI�����#�ts�('����k�m���G�Q�ts�('������l����ts�('����׵�[��B���ts�('����c���,�˔�k�j�jjj&j�i*�lk�j��j�j}j.j�iq�Hi)l:�bk#k
�Yjj�iQ�,il�k>kk�<j�i~�Qi"j�i�l�k�k�j�j>��i�ktk5k�j�jnj*j�i�ixi?iz��kZkG��jUj��iei��k~k9k��j7j�i�i�i��k�k��j�jajj�iZ�5il$�Gkk�j�jEj��iZiߔ�kpk0k�j�jf��i�i4�l�k�kUkk��Pj	jϔ`i(i�k�kxk`��jwj.��i|iLi-l�k�kfk'k�j�jfjj�i�ini0il�k�kBkk�j�j@j�i��Ui2l�k�kkk+k�j�jU��i�isi:il�k�kQkL��jKjj�i�i��k�kڔ�j�jrj2j�iu�Ci$l�k�k^kB��j]jjՔii�kLkk�jl��i�i�i���k�k7lH����ÃJxbu:r:o�����:�F��|wDt�po������7�<��~l{yv�r�o)�p������(��}z�w�t4q�m��Y��p�	�u|�v�sph�=�ݍ��)�`���-~�zx�qrn{���ψ���
��|�v���pA�����[~j��x?�yr�n��7�J�y�W�y�8�V}Jm"� ���6�����<OyPv"s�o�͐ߙH���&����}�z���taqn���s�m�r����C|�y���s˖[l|�8���h�(��P�0{wx�u�q�n���������7��&}
�[w��pm�ގߋ�̈́o��{�x�u�ryo�������Æ��V��}Mz�w�t���mܒ��=���6�j���{�y�vXsKp���<�v���������zT�'u�q:nE�ƚ���΁ܛ�|�yʘ	t�lёz�&�͇e�B��~��Kl_�(���gx�uirio�'���i�u�}Kwtt�p��Ύϋ&�U�Z��~�{?y@v�r�oX�����	����F��}=z�w�tQq�m̒w�-���&��3|�v�s;p��l�����X�~���K~�z:x�q�n��ь�҅'�(��|w���pf���'�2��~���x]��r*o��`�o���u���V�}�m@�I���`�����euyuvHs
p�����r�їP�ؕ~�z�u�q*n5������������u|�y���s��l��j�1���G�,�o�\{�x�u*r�n̛�ϙۉ6�i��F},��w�$q:m8����/�����,�{�xvs�o���͍8��؂{��}rz�w�t��m���c���b������{�y�v~sqp��-�Z��������� {r�Ru�qbnk��:�*������|z�4tm����D�����_��~����ODHT ������|����u��r������O��߬R*	P�X�Ъ�����`��mx�u<@�b_&� #��nR�	�q*|���@s��V9	 ����@~�@�Epʀ
�A3	n#����Y�P�����}� e�̈0�m�n��(.�:���j��z�	�U�J��QQ��mP��E�'P\���	������
̺m� ���;�A!���,�Ӗ�"Oyh����#0�.�bb.u#���v�?,%p�i�ی��&����1�ؿ'��!T�(`�R��b��nMAݜ�B*����7|�(�0hK���	!�����#�%/������t�/�{�#P���1C��>�Q0�	l��G�t3��xD���40��NUr�5�I�PF��6��!M���7�r.��H�80�v�=4��3��^�:��o����:Ư��n �<`��E��;���DsrW0����!�00��	��_7�X�s	�?��A�$�9�p��B��o�2��SCPm��	bWy9pm�6
��k�E�y�:	 J�5`�XX
�Ҥ�G@;A�;���H��.PE,:`y6q
��@�(&��O)3N��4�L@���z|r[4 |���78wN ʨ{�܋�O�e~���[O�޹�	U���Q�x�5�=?N���	�]��O�8�0�T'S
E,�U`�*��7�C�pFz�Z0�DF	B��wZ���2��\r/P�%��]pi���I~�]�z�����^p �N���Ma A���wb�a ��o<��_cP���py�d���2#�b�c�"/� ��fp]A�uEb@��l�Vdh0;�<k��i@֬��yj�=��*Y
�j�i��yGvbl��]4lj���'	�u�;d���d	�Q�%oPe�B�[ep�C�S���Up�(�gr`--k�R�.sDsͱT>f M4t
�vR�u�>܁	`b��d�s��
ȥy�o��|	¨f>z���R=]|���
FgnH}�h9
����~��"
/#�q}p��I��Z�P���@�H�P�,�-K�‚���$@�RȄ�t��ښ���Ps��a���|����-}������τ��d�h��
��#}�|��.��{��ذ�����r�����Ht�� R����}�`e��A�؏`m�T2̥�`,��ܯ�ő�����Qz�p��!�ҿ��CZ*(��l�]��^Z����[i �Ppˇ��͚p�iv���A�@=�]{�p���Ȼ�����O/(�Ξ�Bs	QdLǝ�]�%k�`'�p
�UL3�ӡ {8�)��<�`��M	3�4�`a��'E�E�T�����p�$�]��:c��N���@_�s#/'��k;��JC�P�b7���s�pJl��B�+�pz�K�o������<��
ȱ ����%쳨���G���r��f���4iw�@�x�6PZ���z���5�}�K�u�@�<��e�ɼ���n
�u��'�������$��#-�+�p�-
��lO��Lة:�+�����=����`I�_
A�|���ɒ�
r��0��6���� ��H�.,��WPq.g�ȰB�]�޼�p<CLU���0��3Q���̀[�n�M� ξ�saX���%+U�u��Ӱ}Xb���\�P>�

�Ptր��Ȟ4��#��<Q�a�P�X~����ۀ6,US*�ܠ���c�}�`{�}X'
������Rߐr���v���3�>�{�� l�׮V�0 �en��9��u+}q�0儖��/�(�A�D�a��9�y��{~��q#��h��<%��@PL&i`���[>_o.R�*9
�9��ֹ�}���Z��@|�4
n��t�Ŕ�V��=��֛��������(/��_9��������l
m���~�
_�%@��j�N�J5�A����թ�a<Inb��"�`�Q���6>M<�	�F)	�{E
�E�W[OJ1}�H8'�}-Ĵ�bb���~�o�Q��…^a��]P!#����;�A?����_���p���N����dA�K�
��;�����B�Pqd���aA� 
j�ɭ!�f��5��k�q���'Aէ[
�̴M��ȶ
�f����Ǩ���a�Z�;ߍ�j��kT��F�
�U�k
Z}�F2 �U;����o !j����m"���)�g �pX��p-"���Sz
^%�4�ho�P0"d�*�n��'1C^�y�$���	*)�[)�vB3�F�'a%=>
��Vh+ԡ�tlP
+��9]���d-��{�Eq{"Ap�L
d�h�$�C���Bq�o��h��r*`��2�B�f
��3A��^���6���	''I8���E� x9�����F:���5�6 9���YnU;�Е�C[|�<���M��>aD�U(�#?���ed?���4�^'�9�06	��x?!��	Q��9qƹ�	1��"D�Q3���H�D񏰅W�"*D!�!�	vg�CQA��	��5?q��e��IaJ��W�H�JQp`<�6��@q�H��f768ѡ�	�M�´��fW/K�-Pv`�O��-zk�R!�	=r��Vqrt�4�YQ�s��
Z���w#�|Z}�<���Z!���
�]�U#���Y�M8v��&^������8]1��	\�N%aA8�c� ��c���n�ڥ�c!�k�|��d�<(�#��f������gшވZjt�ia�+P	!`j��cY��"kq�o7-��mq��8��:Zn!����Ť�m��[~��`�p�7�0��en���@�mpQ�~
�E)s1�wc����t����	stQ���t��7w�E����Ww�ܽbV�w�y���:A�wݒ�<�f{���Y�^��w1f� F"�|!$�5	�@<�x�:V	��1@B3��"��)���/rzQbl	FB���y�t�h��Q��	���!�a(
�
+�"�q��d(T!�9��eR����r��x��A��uQ��a�9�L���w��	//������_�2�1#�|0��1��E4wpO��FS	��H?�qNJT�rk���)G
�6��z��*#�a>_X�6��a�	q�=��
/	\�a�Y(G��!X����Tf���r,�P������rX�@��L�A��[�1$��	Ó�3���>X��7&�A���.�˃���`�
�k�ߠ��+��Z�A��%�9����"">�G#�q|�/��s���;A	pU��O�]����1P�����Ө�?mo%�g��1�J&� 
����:�r��A}׮��+W��w�	ȭ�M�
��l��!i��"[�QP��"ղ�]�=��ʵ��ؼ
��Y�n:w	�R�淡,~QYM��vr@;�޷����-'�ݹa~R�Ɉ�D��XcPj�E�Qm*���7W�Q�I
��9�!s*���	j�q�����׍�h��Q�7�An��F!QU��F�D-�š�}^�]�@�1�U�{z�ѵ40�4P���LvbM1��aņWBe�A>��	e����"u
bp�1��u����A�RXvT��1=����&�!�]�>iw���}���s�@:	d2ӁA��0o�ԱCV��r;/�!b�0<���j��sñ�Qju`������ߒk�����*r'q���aM/jS�C���A�0�c���dm��C���#��z�Q(�&���I���oU�C�q��$ >r��f�|��d�ޑpM�
-�������ؑk*�
�����oj_m
c���j�]!�!Z���]�H��c��S\���
z��+��݈0�W��	b8i��Q6&�ۆ�1���#j`O�Qkk��ĭ��A*�9	�I���rϑ�	~��0%
8���Q\
�
��u���?�$ǒB��6!��ߡ~����	T�^�QJ�TV���e�3�7�qkt�χ�
��@���D���'9EҦ�`����������
Q���27T��s	������o|b��Z+3]'�4��A�LRYszj�(�	_B��%-�'&|�
Ғn#	lZ9�2�
W*��&BN�T�_b�J	���b����;�r�k���������	��6�Np
��k�)ȉ
<k@r5��\T��Z�=��g�B�ln;�h�>���;����^�4	"LZ��g���$$Hd�r�K��i\h!�m�^2�|�"r�um	�ֶ=#�XayC�g�$�4�*n�u%b*�dOi�3&����x{�'2���"�m'����;�,(�;��,j�(%";���+r8!n�}�"���	�<c�)"D��
�Mj:.���P%c#.�=� �c��.x_b	Rm�1��t����2�۬w��{3�2L_�c�4k��p�8�5b-�X(`��4R
7|��5�J�31�1���`��%�.���	Q�8�8B��6��P;�&߳��Y5;2Mr���c�1�I2���#�nW�JW�?��t���q@"�"6�A�H�LӖARO��k� C"O	��FdTD$�����D�SƁX��Cb�m�gYC��B C�*G���q�WJ2���bJ�>;�ڠo�N���]�
�N2t8�%BS2��S��T�|b�|�(UB��R�Z'yV2���z�:Wr
�Wy�9+X"�[�n+�Y2�����(Z��`%s�[��9����\��	����\�߷
 y��SB��UCU��1��WA`2�/�1[F�b��F�fc�1����g6b���d'�kd"��CNP.�fb�A��"��g" t�����l8Q%�-no"`x��p����pqr	�s(���u�ǭcb|��w�8���˭�x��7��~�y�Vn-��x"<|���{"V��B�~�|RʟC�t�}�"�j��~Bu�9�E��}R��)r�w��G	�#�u�rM����(}�s��	��y"e($�Ą��E)#��N�������6r�bc�O��s�5��7���R�4u�ކ2A��\�o��r^d)B8��B���	��J���1q	�|��r|��8$�=�׉#��x��P�*b���B��d��ï�r���>,�N�2�2/v��"&�_�q�����!�L�2;~	HO�ޝ2]3��q���VD:J��R�z����R1���#���
7�	,+�Ȯ���v�9��D.=6_���M��<z�bvy5f*��K�
����|b�'��"!���G��rψ�^Uʎ��]�l1����<�!�߲���p����M�Z|��^���ŤF��C�B�Gy/��ʼ�&�I���r0O
c�Cq��uSe�>��B���
׭ո�Re/�ͻ�3��
�������"`�[	�h8H��J<|������a\6�Q��2,�gN�b&����-���DL[7�Ȳ���j���r��U�}��byR�	��y �"���zL�2��pj[|�B��	.U	��b_��������Q�
C�{��b�m������K�M{����$I2|��<�O�A۲R�]��@3���{{m=�B�6D������_�/Q���R??�R�)x�7�����39��졐	i�=o�③�N��R���w����z��*��"�-�
����r&�
	�m�#풥��	J�����&�,��r;�*Mov����ti�� �,�\�´����9���.�����ba)����b�xV���b9���|�r��'�$g���r~����V�����2E�£��	�� Z��7U�%;��B��"$?����WH-����n����1cL��;��s	��ό�=K:	�5O�GS�m��
�j��b��V7�,�
41c��#a�B��a���o�	��.s݋a	�`&{�^n!�P��;%�T��#���ns�
������E����o6�`�w ��P3
���7"3G��w�0#�.�Ū�#�S��?#��Q��dx�$c̡,�#��'û����X�#3�6
���7)&Y�
�3�*������*#�uq�N�+c(I�����-�fR
&�i2'󯎹����,C~H���q0pm�K/��0�r�{
�o�12�R���JL�23�r7��v4��7�8�,3�V�_2�6�|ra��y�7C��
n��!8�Qփ4�K�93���@�:�7�
i�9�Хk�/�;ӓm..�T�=c�o����>��Z�Q��?S��m��9I�X}�A���,.A]B��r��s�A�t.�Z4DC)����D3��F�%_C��t�Z��8E�8JB��l/A3-X!zJ��<�x�\	]�èI#C��
z��<��b_cK��#�ފU>�f�d�l(K�*u�f��OC�
'�@CPs�wz �H �aϹSc�v/(˜�W#U=V
&�k5YS�1	d#�T\��I����\��l�g��7\���v���_C�!�
��_ôT^cgbC������e3i��:���fc�1���bfcC.�	$̫h�d�o%��i�y�����i��(���%k����]�[�j���a��încRD>Qp�㮷����qCsuMQϤ�q�Gs�|�'�sS$�GO��t�[Z�U�VqS��k	A/e�vsC	�;�w�b�D{�x��v����~pvgr	k��)zi�*��xsjr�
�.�tx�<�7�F�v}s8>�2��}óV���m�����
k����A脩���B��J��>����_�Z
�˃����H���sF�{h�����ɓ���i���Z�҈�ڍS";Z~���`:���M���dLfB��+	_W�Տ2����4��+��#����rv'iC��6�v9�•��E�����C@��Uwz������	�6jc��uv?.��3W1���s�{���r���{hM��C�81���P~��٠����m����W.��!��C\��^�f����5wN�����3S���j���"�JR!Ѩ"�j(օ�����];���g/5��
};
J��3���mT�Ӻ�=
�������E0�����2��"�3��B�i���>%#�w�ֹ��@��\��c:PLW+���C��J����/��	���;|��+���S�֮������in��,��##���UA��SV�&
��=�#�<
��j��]���W5��Y�A��������4�3f�� �'H�3�z@v�N�36R53��8�C'
Q�����#�|-�[�
ΣѨ �ͺ��=�	�c�F�S�N"�~^Γ,�
��t���`!�qɳw��6��sVb��z��S&ޤ	�a�h��4ۧ��sjn��Z
������x �C�Z �k�n����_����H=��c��Uv�����	t�J� �sG��0���
�3@h���jQ�o��H��cL�^>�����+����`c����~��E��S�#����������ǟ��|f/�R�R��~�Z�[
��>:<3���6ױ�nT�g�ҟ�z%�	 �A_���ߜk��$R�<+N
$�jW \�f
�YTZ�D���3�
��-�����@��v�����nq����=D�V��#4۝"�J$�a��
�	���Oa$A֑ ��6���D� I�	Q�؄"<:�
t@�_#d���<k'#�!�
J\�%�ӯ&̈́Y'dq;�?~�w(�`���s(�0�_լ�(���k!n/ �m�$ي/t�J��>Ma0����X@�]0�z�կGn3�ǗT0�3�+��
��E14$����y1�6$���a��6$�=����8txi�g��7d�Ų�s�#:��K���T�;ĵ�J���8��F�D��<�7]����+?D�o�z��@D|r28;2gB�0c�6ίB@Ȋ"M�=Ct��Tu�:Cd8���G#�F�O�zœ�F����� )B���]�)��J$赍�<�3K��|�]ńNq��p�P�Nuy	4u��Q�e���бRTt8�;�@�R�w���A*Uԁ
R��X|��aj��ZD���h��]DIX����]4K�Ph��aaT�XdV6�wa4���
ISc�d���F7�d�RG�
��G�f������gT�.z�	�Gjt���TQ��j�7*��6�&l���Ö�j��Y��H	6n�����7Kp�?S�}dq��'�1���qԤ�i	��q�ݤX�t$��kw!Q�ut�W�~��xR�-���nydm��a��z�-rGAd�s{4(��c��|T��,�W�}���L.�~���v,�"}$U��].=݀԰�?=-�΂��g��x����q�%��(h,d/�$㭗
e*�
�DТ$�h6&����q��GG�T�\����1;��������	�אTto��j��4��8 ��,�T�Y���i��\	��#��愸[����ܜ����j�.%�4o���ܟD��]?�M�$�?�U�Z%G�@ޢ�JF�����ą��/�9���Y��}��sú\���̏p��;���T�������>��۩$S��V;�D�#��(ё��x��"o�P������N�E;V梄hׄ	 V���$j�)��R楴��
������q�/
�;�T�ď^����t/2<��������o�����e�Y1ǻ�m�
�L��TU0V������g�´d����z�D?	�-ĔX����@DŽ��פ����g/� �˄NEJ�n��T�#��A��d�	�Z�� �T7fd�p��4L�A/�Jϴ��A�$��Ѥ�tҐ����|
��T?�ԬO���Q�t7�@	o��UԔ���
)�i�����
�9��5�h���t�[�s
�ʹ~��������\�[MH�d�/��}������kO
�T
Z�П�4�	���e��6����`�$"j��$��Tm&=��� ��b��[��촂�0�6���4�oz�S�ȑ�87����a9���v�Tj?Q�t)�t�D���8�v.u����9���n��_�<	��NQ��m1������O��&�t[�w[����P�����E�����me������G3c�����U�A��H��.8������;�Il������������Kc'����?�	����@?����Tux8
�_�����y
+��L�-�u��E�>
�N]}u��B
u
ӥ��d؀
���	U�� ������w�
��B}�Ȯ��@)	.,~��6�
�հ�&�m���a�Q��$5�,	�9[��s���e0e�o�������	�VB���t#�DJ'���7|b65�E�2���E)<c	QY�d5�D� �;'�y/B$"w��g��j�UiS`\�F>5=�zv0�
��*h~`�	��U��V��������!�z��+f"�tXp%�_#%�V���0V"�71��D'T%�T_�#�)u�nt	q�5<bY
,��.#%R�
<w��Qaw~�	*�njs(�+շׅ�V!�/%i���0���;�1�ngt#��2�l�#��X3u�>�i�2�uf8����5��T�U��5�[U�և��5�UJ�u;�2ţ���TB9%�S��s=�95Na$��9�;�?��_h#79�h���jy7������M>�6�*�T�">ξ{���>e��
���Z6�;�ɼ��B��$�5�C�[	}&��D%���|E�13�tx/C7�FP��;8�Le�;TWڻM%i�3��XL��:}w�RL�'n��׳�P��D���G�O�!p	��[^R���ҩ��SN������Ru	�X��7U5��:'�fVu��:w�o�WE%VU
(��XŲİ�jXU8�LJ���ZE� =�kZ�|fg�q��\u�B�_^\eh^p5��Me��\N�_��_
�݁p`%�C��y|�`�~V�:�Lau��Py��`�FK�`���fŅ��m_cgulý1��gU�XMZ~jv�	V�3l%������m���X�؆�pe��S���kr�^��
�LEs�#N�d�&u�����z�AwE��g	ZD�]y��a�q��z%�����yy������y��JqJ$�{Q�J��|%��;S$��~��4Z��%��;	�W�w��4SG��0���[�b����_��{5.�~��|0�5?A
�_�/�Wd
׻�u�E�}
�ݑ��uUl���g���p�䎵�O�F�p���`��m��B�u��jpjҐ����CJ�U#��	�J�ӓ%�Z�@��%n�P%�ţR��(�H�E !z�J��eL/�6ۋ�5O�	kkgB�e�G�
ן��G�j�V����������e�?������s��g��e�U	�	��um�Y	%T_�5b��	����]ɢ
�����i��$+�Uaœ��/��k%
���߬���/�l{�u���
`��=�E���w���%ugk�b��e
J�
�вuw����	����=#�f˳EB �(y(/��|��_;E�Ŵ;NKW|��f�ij.�eŘ���\��Ek��q���^;�:��׻ux�rm��%l�
�Db�8��Ū�>�ߢ���y�d����%�oz	 a��?��:��U�����Ņ<����.�$r{1�շ��V;V��5��J

�����h
�1�B˕关��[���.�>�����%2َ�VS��������['�U�ϔ�>xK�5��b��ѵ��},�ť�uŊ��s�h�e{�p��V�����H�������J��E&lw+��56@E��ܥ|!n�E�����<�C��)����g�u'c"k6�ڥ�J�bz�)�դ��
�^�L�%�xK8�EO3�����ޭe��H��+V�`=Z�����U組��;-���B�wM?'�E�w&��m��.2��k���x�@�����o|��襙`�	\_���ϧ|,�3��s����UzRC���Q����"��u�/0�X���>�"m��T�u�O��������1"�o�umv�T���u�����8�u�-�����խB_���5I!�,��e�&	��6�2�@FF}kʶ���'�4H8�V�
K����BBz���<�S��4�6�8U��tlV�dW?���	f#�<
��B
ւZ g�ֳ]@���5��W�y&&�68�b���M�����J�!��d¡M8R`6e���.����\�'�v�*���
��\�+�T݂���#��S_�R�8���GWysD��U�5f���������͊�
f��ì(>�4�9Pf�63Zp���X&֐�d����	��NfC�D	��2D����	�*g�#��(E��&�$Y\��R%��u��B�v�Ռ	
�ZR'&j@�8
�,"�?_+
��)J2O��c*��(�L��%+S��&�T��,
LJ�y�u(Jd�d�.����If�20��!���1��.���6#4Voe���m�6Z���78ml
��q�:��/(�el:��b���>��T3�c a?6��@�;T>v�|��S��@B�	�&@���tF<CF��fSB�C�,�C�AP:E�S�]��}F��H^���EVn
��y�EK#�	CvyAV�09F�;?v�Oi�@�K����řLF��yj���Kf2��H��!Kv
@6
\|O�U�ϣ�O�s,Q/��P&���i�n`R&�vh4���QF乛���T���]d�AT��E�
�'T�eM�y�/vV&�/�|:�\X�˚W	grVS�`�	�@�KX�;��
�2��M֍�J1�%\���\�]��R��]��L���6C^F�O	D]C.`�༌��&^a�d�@
��H�L��e�z��c�M(ny?;c�55HI@J�T6m7G��8T�Vw23g&th^��!Y�?�C[�Tj�k�G7�kֈ##t,�l�D?Q��mV�
�E�pvO��\G�q�S��ݽ�p!D[`�os�Y���eŬt�5Ľf�O�u�\j`>�-v�~�	<�Xwv����R�4x�'Sr
�N�xF�����Ct��~�	���=p&Jh
��E�|�;I��
1z&U�����~vk5C	j��}vQj:�`ǍD6�^T�Tx���
a�[��6�Sn+-�$�֤'@����4��[������
�a�����?����a�vw	.��f�&�l�F-���|�d1��F(�OYkk�6��"�v؎f-_yJ{��f���S��&OH[�<���v��M�,�L�"�$��4���� �zAu��&�"K�t�����<� ��6�w�	�;���v'�	j�õ�V�f�x�\�v��J
����&�X��3�<�Jx�n7���mb
�XŤ��q�R`L.�&D��n������
���N��o���:���"^����F��	¿���x�a;���yi{'�{*��X�
��3ߵ�����g�Fӻ0�F�帆�?��&�H�潍c
��q�f,��
\�ʻ�qD|,��n�I-�<�g��ơ��*4W���z��}�ۻF�}����f�&&M�
��m���_�/�����_�bŦ�(ZN��j��	O�z�v+s
ݨ�y��13	ԒT��6.�2	l�����?��
��mֆ����A���6��i�*�]ٶ0ȫ��<�6��η��6O^+�uW�X
�}'��+Fu��	�fQm��zk�P��n�HG�V?!
x;�>��
,��f�W�	��M���tK	=����f$cv	�if��7d(!>������b
|��)F	�I��FX��
��x�63��bݡ��֮3�
����Ce�z�vX�fF�e��]#��fr1���6��}NG���O��}�I���jR@��c���f����F�7�����7�څ��b.	�Ug�!�F_��8,Awja�J��.v�	��{�FtKw 
�
��
w8�Wmn��gY���.������R%�W���	�:��U�u�b�	^B?�V�	�k
d�1g��̗�K�!d_~���������������c!�DW�����h����6�'B��	�����w�U��+"l���%b#gzdM=~j�$h�yb�׿/���f��=1ןG�	=��2W[1F��3w�����z3W�*�:4�3�
���Ȕ�4��7�8�3W���	h;H�8g��@�S�9g>�F1��>97Jp���g;�#�
;.��6׸�(
�FF�7G�W
I��5�%��
Zq��6�j��
���@��N��Y@�F�kr>B���9#[�C�Ƴ��E]�D�yV2�E�{��:�@w���ؙ�AG�*�
W��>�x\�
���I�?x��^}C�"j�&�L�4y��J��Mq
	j��L�������O�2����!�P���4����N�����R���A��S�������T�|�kD�kW�Lg
��9X�f��AG$;Y�sOs�$XgR��r$[W�d�d�Z��1{�ğ^w�d���`�X_'�2�`w{a���b�n!�1�c7�-g�M��e����"BU�hG��>ig%$��Yy�i'�'�I
�j�����!�h�h	�r~n����	��Up�TH�<i�t�,<����ug"
��+�tg���ِw'2��,VW�x'<s�[N*{��_��y|� Mjј]~wq�@)廻7<����Z��G@6��5W�w���ޓ��뀖�����G��m�7.�+�gۯ��W��
DN�ˇ�7�[Gu%�W�GiH.5���������0������4��
�g�p�Ќ>��GY
ka5�'Z��Ɍ�'�FO���wPG���Dx�g�Gu	�z�'�'��u�޻��w�y����W-�*��'���-��&a�7	�	̦7c�]r��Z�� 	 N��ݱ_���W%�(��ҧ�B�U�x�b�-��B�����6��3��A�'�@X�Ssܬw吠U��wBn	x-�|��1����׹\�*ț��7[O��O*�GYS0��" ���%���Wiyc*~�?�5��tx�����!؜����UJ��7#���T\��ׇ:�w�z��Ϣ
[�V���]�c1%�w^H�P�wq�w�.�hV)���}��G������)غ�j�ko)�L÷�]U�j�H��c��	W;��ŇH�E	Oh;XǗQކ��kȷ�>K#���C�_;l�g�W���f�[�ɧ�����LJ�[��:
�wT�9��z�Χ�)�p�b��'ҧDq:�ЇJ�|ˀ�ч�E@���G�O�4��̧��
�x��7�
�����sj��="4�WM����j=�g>�.H[���Bڃ
ec|�����)C��D�'b��T��K���&�ۧ�h�	Ɔ��'ebL����w�H0jv�g0f��ڰ��d��8;����D{"���W�}
��V�GV1�a���G�s�������ްW��!� �Vn��������]��0M.	��pp�' �T�
����N��&���������������l����	�t1f�v�gE��
q�v�w�vR�s����:%)������9��Qx�2�f�?(^y��^J�R��d� L�������;�Z|�:�ho����_		��-�	��� �
x�I�����
h�[�
����ʐ3�
(��v�[o�h�3�sQʉ8xY���&��,���qio����	c�)IX�B��G�Nq���S�C�zt���ٕ艓'f<�覎�����ijØ�(����� ��H�g*�<�~���!=(uhw�,
"�i��b�ר �g68'Cy�1�%�
�$�zlz
tQ�nE�hҷ�(X�7��茰)�#b��*�ؔ��Fa�#%��p�i��P,��?� ��-X|}J�.3,(�5+)�-��R	��/�����t�18\�<3k�K2�v�f7b2(�n	
�	��6�~�Ir�<��W:�l�=x=�s���=�j�=�3=H��z�o�)A8s�+I���AXz�	#pRLF迪��l�I��<
�Jh�z^% #�Jxr�/p��-JH�=
����MX�C�Q{5�N(�,�&ÌHO��_�3��Q�>��	���pQ���
��a�V��,���?WHs����<y[��_
	[��\�;����x\��G��u�\�%f�M��_����!w�`8��\��cX�*��%d��4;� �|e��}�B�f���OUg�y���<l@h�/�5�V�i�g�����ih�cN� �kȣ�I�pH�l8E�^A��l�"�R��w�mX��Jl�ox��{?���m������ih�u�	@3r���9@�F\s���&)r(t}��# l�#�	?~�"p�m��	���w�P}XM��w�#���3A~y���v��yH�h)�'��qHx<
�2�z�f(1
[8�x��|6D{J�[a���X}��!����
XGq�`�53̘F���|]��7��8{��S��84f�܀�-�Y��jh��5z�X��������{��ԋ�]#�{�h�a�ɏ�	S�!0��X�PGc���h��G�U�Ύ�t��/j�����ݳ	
�g��x|[�0�-���Ny'\��(��"
wf��H8�
�����
42o�:�xZ�����H����
fblM�ػ�$��w!��(�Ȫ���u�¥4ϛ�A�M������Ք0��(�x(tl,\-˞�/o'�jߞ8彼 �8Ȝ����!!'��)�}	튶J��r�	ƶ���q�*8�.�����*��ڥ8���	c�U�(��9Lr���GޫħذءP�"^�8�0����ܪ-�x��i���iJ��XH����I���Ǚ%������(AT�H
'-u��G��q����~�t������Vl���辩~|�吱�.��{��(��.����x���ŏr'�ؒAC�8�I�h����{�T��"@8t,�	���C;�V���g�hEK���(�����z��ڹ��4%	�3�����x��H�c_	u�̳����r�NĨ���~�
���-m����2�i
�O������
p����@qeS;��ș%�\H=�x�a������2�5Q��hoe���aͨD�
��Y�X?�
��{�hG
�\����� �p��!^�H�~�n	X<�؍a��g^��h<D
�5I�xF��ɒm��x.G��m$���$8\�d�h� �@��X:�L��|����

����;�{�;1�������⸈)���m�㘤�Y��h=��哻�=c���Wf��Ug�(��`�b�襶c�.��AJ`	�VQk���=	{����8p���cm�H�>�������ip�*�mX"������J:ak��>�H�y!�)�K#�e���h�=���n���r������ϵ�NҪ�Ȭ�N�U�����)/����!��׮��O-tBo��Xq��������O�w�MG��+§�*A��0H��Z���,Q|oLF�|�	(���)�Y�/JiВ��y�D	��
7�l�
I�#��m�	g�D���3�t-�y�
����>w���e
�xIlv����e�y�?�I��5V'\���o(	�-�)�=e���	�L��	�q&�ߒ��N�u��)�SS�ߗ-��������az�
�}���� p�9JD}KM8 ����M-!�~e��A�6 ��E.iiY#��M�5!:$��}7ӿ�%)�O/�j��$��E��4'i^�`��%Y��>@�������Xqs,��~���u"-����sH�N.�٤�����/R9Pci�0�>MP�R�.1�e�0�_q�0�����0�Iq���F�59�'���5yZ	m
�A�:8y�g�|,!�8I�r�
�to:�m��)��;}���T;	s?�L��=�ڶ8���@<)�K�
[�+�@������B)� �".zC���R
횂nD�2$��E��f�c�G��|B��hH	��seQ�I	kL��$J�ϼY��мH	(G�
P�mKɋ����	M��"�[��G��+5y�0�OI|hQ�HR)	yN	m��LSY��0�S9�Y��@0U��[|�o�W�VY�
eWw�]�UDB�M�^y��	'eB^)�T��JBa�'��l���dy;v���j�dY6�tc���f)��]�k+�f��G��v^_h��t�	��i���L%ԅ�k9��p��=-k��;�y2`�lY��
�F��nI�D�
_��p	���p�(q��'tW��qy�5SD�a<q9}^�&tI
p)���e���u�]�/�h
p��M�0Fx�xY{a�Mlyyd|D��Gz�z���6tP{I�8:@���zI	����})F+��s#z���6�8}y�X	��s��������ŁY
r?��V�I<���z"�)�0	�ȓ#�	�!�	�����i��	�`�r�	�m��3.�����
%������\�7���>��~��{)m��
J�Ӎ����_����ѲIY��;���f	*
m<�	��
��������	�|�3��b)R�����0��[��%b�Ao�YJy*б.�Y������ّ1�
co�엩��	�kO�����b֝Y��48F_0�y� ��J��ұ�}�G��i)���z7N�I��g72|�ه�!	Zj����p�ʌ/ȥ��:��ͦ)~F��k2��	l�0סL��i*��4���{'k�9����~P߃����FE�˯��
�"�5��~��P��<����G�C�9�	�j"�銑�	yc��}i�
��]��9�(
��������Ȩษ��y ��Y?m2{z�	|o�cWn��9���S���I�ך��篺�Ү|C}#���Y)
�7�˹ٺ��
��"~���}[G-X�	A����D��Y�0�H�H������Io�i�|Y�v:�y���~���	[s�sa�ȉ��ξ*�I2�gt�<�ʩv]G������+�U�n�i�U�	D/�$�IG)��ι����:�̉��.��#��iZd��ht�������H9��y�j��8˹ļ�ձ�&��X/#
(�n	ۙy��n���f�3�6�ߙ��R��T��)9��0}��z��252��y`'M`���o��m������	�h^I�bd��
���ZI�Yq*:
F��),I�=��ɒ�'�h�ɢ��b�8�陠����d��yY �����y�\N�
��I�J�R�����~(45y��h�����ICĴ��kA�g�2*����5(F{����Pj� r`���Js�	[��@�ٙ��A;��ɃUeD�w�Y��S
��/�)�֩�:a��)~Z��p���Rqs�&�n��p��~{��{����x
<ۤ��ߪ��e	�&���f:^�	aa�J���z[8%����4��*/κ	s.���~��r`�
�~��G��������?�
���L�WE���_gdJ��J�g�oqxz�ݿ	������v�(�Zeh3--9L�yH��ĕ�zW�y"�3Z��������0��>`��
���V���nY�S:}��˭j1�gՂ��s�[	{���,�O.�!�{(ls�J��n<
���s#�gdk�Y
#z�*8"�E,#:�htrZJ&�H+1����'z������'z1A�9Ab�)J&Zp�t��**��sRx�"�XQ
����,����8�z�6��c�.�
�#:I�,χƃ1J�o
 a2c�wX&��3ڦO�]d3�Vy�Ϳr6*�M���8��VZ�r:jA=���7�;j��\Wj(\;,��(‹>���@C]�>�z/�gi'?J�Ѧw�
�Az[̤��eA��q+���Bj�ѭнFJEEw�4srG��lN���Fʊ�v�|�IZ�J�A�=Iz��l����K���j�F4Kj)��9BQO
�@RW��P�*(���pZQ�6m��x�MQZ G��ٜRZ�.���&P�Е���UJ�=���:TV��]����W����:sJV*��!Qʕ;�{*yQ
	�-F<I�[�*�[��5![JǝngZ�!]�B߸��"�^�Ya;8؊Q�|�X	��3�`*h{�
\,�VZt"�
�Ch�Y
MZM�1F�cz��E
T9�wd

U�0h�3e�7Қ
нЭd��H����gG�%�#Y:\��wx�Si�RXq���Yz�Q���l*r��l�
J��J�n�jX�5�sl�U8OL ��p:ٰ�h�+�q���=���Mr��e2��S�nz�6	4E��n�&Q�
�+fu:E�	̑�v�F�jPw���w���w*�2�H-yz;��(�Pl:<��I�m��[p.�m}GZ�t�f�}z7�z(�X
ўS(yX.��O��	��m���>�
�ٕȄ�"������
�a���Jg���W�ژ-1ߧ�:�5��	b�(���'�;�Y��c#�g����k�c^�U�A�j����0S��
���z�g�j_)
[��ǚ�&4 �y�:��=/\�jG���\P�z������^�Z]�4��|���?V��l8������׭`�����!�hR����k�dD�Jp�H�)��ݩ�ίm���^���Ky��2D��Wg�
r�5N���Z: ����ҫj56%*�Q�J���	�Qح:�pw�Y��
���#)Ğ*�<a�o��ף&����j��z�q��Z��	���T�:����x�����j�-��J(���s�9��s_��Xv��נ{[�V����b
�G<����DD
�T��zݮl�(��j����n�j���
Ȋo��
W��
��?�ʗM)c�@Š����,���s�I
QA���z{�Q"w!|�zh�
�W���
���#?{�j�}��#���� ����:����*�����KΚ'E5�h�|�j�����<KѪ��P
���rӺ��
I|�[�J�>����s�Z��~.r֊e�M�j�e�z�/�	A빽�Z��h�	S��,�U���ݺ�:� 
��ݚ��:��"=�%R[����/a��zb��*ŕj
�e���J��}�Pu��JRm�Gr�����l��V]��"=�N4��:}��_�����/���3}��g�՘�k�
�,��(����U>�m�C����-�v�Z����U���j	��	Ho��k})r��U�j���
n�Z��Z������:�<(Q���z�Z�*�=��	���F�䒀�Z���8O&�����B���9������j�G��Ԯ�+��9���$
%}����6��	KPQTysY�=>�kˈ���������x�˶w	�Y���:T.#����I�#����o~�L�(K����/;'�-������̛��&,�=�GH;R���*x�Uh�'���E���a��;�ȉ�'� �]�mn��Kq9���7"��>���h%�+%x	g��8&��TA��'�?.?}+y'�.���r)+�SN�E+��X��,�tv\y2��-+�7u~`�}.{ρ6���.��w�K]�0���q��-�#ˡx�2�M�,�`��3Ka�vKW�6{�-4X�57;�?HE��6�y`׊N9k/Υ+6�7���T��
;��m��N�;�T|�\�F;3:8�0v>�nC�r<��ԮQ���@�<4II�9:�]�	^H��Aۣ����c�DkC��	�9�)E�3��ڣ�E{���6HNyF�1��e�CDu��
��dI;������D�!U���X/Oۗ8��v��Q���_�*R���>q�s(SϜ;*0�Q�d{�8�U+9��c�W+T1�
* L6W�(q�Gp��Y�+$��
Y�?3�"�^{�H���^7N�
g`!6`�
!Z�;a����I�b[H��B1c�:�4p
d+�k'J�-eٞ �Ya������^�c[�����Ac�4
����g{�n2
:k��ak� �
�?�Wp[�=t�7qEqk�O>	�"�r+��+�A�s۪��s��s���G���u����=x�gLʢwH{��ϱ	~�3|k����.�|��#0[x�c��Ӣ	g�k!�Ky�Z�~���u��>���[>H�(�z��d̈J3�/��GR��&Q��b'?\ƈ�'�L4���k���I�!��.U�ˊ����@��K��	�{W3��M6
��拫7�jY��k��ԉ^���Qm�Q���E��H�kGC�H_%A�[@j&��W�ۗ�l�>�͔[f!ع�ז;����K�[C�e�I�_�;����r�k����[�[�=��n�+^��	�{��)����6$F
��ᘋgoM
��J��;�WI�\���$�aMx���l�/e�WڢK��uwe��[��"x�ն�k�99��K���Ci��S�6ZO@p�9rT-2r���H�>p���5[�c��D�QP|0(��`
�	V������7xɬ�u��w9����
)3է���:�O�[>�۾G��[ p�y����d���槳����`��;��x	d�4��
�������v�������>i0�2�k��*r!��K��"�c���Y��������������oC#�ֽ[I�F�,!�����O�m�ۭ;�(9nf�K!�G�<{7«�Pm`K@C�����n~ċ[r�?�S�K��b����o]��^�z�[������;nOT[nJh���<	���n�k�2�>q�ɛV}�a4���w��	���vΫ�Ƹa��ϻ�>5[ҋ�GU���ӫو����ֻ�m���N��ݗz@dkث�_cu��D�[]�
6�	���:_�Ą��������ݻC
r�D���I����*������+�[$a���x0��*�X��H����-59}��;�	)~��k�o���#�K�e\"#�{���	X:G����g�<�j�{_n+
]����,�:X�7��7�l(���z�?0�k�b�2
0�#δ�b$n�%�KH#A�>�C��{C�r����K̼^
Tu����	e
>����.9"��k<���%�+Ʈn^79��d
�ž��'�u�2�W�[��
6
���h�H�S#h��'
T�gg�����zD��@h�	��J?�2Q�
�̘e>�Z��̋���ul�l����l�>��!9el݁�	G��
�`v�	���K��۔
±N���Fvi��,;��ƚ&�l��cP�(��TH�l�&�=������o����Z0�,tBa�/�v|	�s~|*� ��������$88����]%�A�(U�v(�ͤ�	::�)��4���+*<l��bR*<p���B��,<ʳ�t7�|,|m�<�
��,�'�����M-+c�C<C�0<�I>���/,	9�	��}�1����m��4������[�5\�9�T6��H�%8��6�|	�C��7�V�
UUY:Lcg���=,�^��c�f?\��L	$ݛ?�8O ȭC�B�u�
J�D��4�c_Z�D��F�
5�"*G�'A
�o>GLY�p+���I̟ɟ�r��J���e�UW�I�Z��oTcL��C�P�ML~�b��U�Nl�:M2�EN,��
2v	wQ����c��T��sA	;5�dT��
�¥fV,�j�߉w=V\m�=x��\̋�2V�1]����94�\���c��X�_l�M7	c�Iha���l[��c�h]k��Mc�_�y�yc�nn����ff�(8{}�g|�����k�h|���h�g�c���4jl�8�,��i�E� �4�f�hI5
���n<��Q	���q\��%r��r,jʫ����t|��l4���u̺)/Ĩ�t<�P�
�+�wT,��x<�/b��Mw�l���&z컷!���{����	ž�|�'6��y��|���B��~L���ο�|��LB	�:5���ר��3LZ��t���C����,٫�i�L|���	�`�w��[��Ɇ�G

�����<D;0�|������|��B�����.f:�}���,j����҈�s�u�]A�ڝ���wg�ܧ���gc�������p�\� ��<��LM(��D�:��u��B�����KK�qr����n;4�ٓ2���G�\7����?Γ,�I{Aa�|,F�
�S	���>-�Γ,\ov
:�L}<Sc�
<�/�,$�����,O+5�=Ϟl�W�4�r�������__����8�l�p�
	����Lb}�
� ��%�QȎu���N�H���	u�'�̎�,��]ʦ,�6
�5�K��~�m�ݲ��2����޾��绋�q���{�`�;#�Y8>�x�D��g�����P(�jI�<A"	����~̸L�
=d���q/�*ݲ\t3�(�E�܃@&��
��ݚhg�
��\����E
����7`�ѻ
r�`�L��\'�	��-��71Ŕ�,�B�ջ���n�.j��\�6�Ѽ�l0�_|tV�LT�mRѠ��\����공��&3����{z�)�я�̆*i�Ha��uU�Ui���ð1�t�Č��\�(��L������Ǽ�q���@�<��bv��?�L����B��;y��I��|xH�
����ldȉ�ș����͇�\���2u7���(�7��|&ާ�o�Ԝ�6Y�w՜SL] [���<6���5N�l��
7�F��n���Wל�BN
�`
�|���
��v��	x��Jt�Kʊ>�B�݌�k��>||]����ߜ�`&��|�����<o*4�L���r�5�yJ�+����	�(����&�
��)���<;����
���k��߇��9�W�.
4���R���1��v�5|�}���q�%��2���6�
$k���q�RX�1�%�V�s>a��lu���nC� �S��L������|��4!Q�Ld��{F�����OE���zG1�-����Ae9����i�Pk@��4s�rt�<��$U�F6]}�&�H�ݺ	�'Q(�h23�G�=�,��m�P�l��rڪ�l{�H	��B�c�a
s�j	
����+Ka
��m�ce98
]SR������y2�
�:����q������J���
X���\i�`��|$2�~b��R�[E���5U����/ ��_����e�	��[
Ÿ�Z��=t=��k�Ke�+M�,:b,��� ������K1QU���j&��=��n�IIl�X���YJ���sjI�!���n{�R��|
�#�=�1VI��$-���e"_ �m9sJr]��;�('�����J�}�T�qر�):089-v
�r(s�*��N	�Ap�,�8�P_L,M�VH0�9,���T�1q/M5$F!��
���	�j�K1]�������!���3M��"�f4
ϒ
�}�5-*���#zc}�J�̖��M����i��8����Q(8-\/�
�ϯ�8}c��`�9��x�!M2��:��=]�l+G�E�]t�X��4?�9

_8x@��K
H_?���/;h��L�&R�*��.-�װ�
B�E-�~WU�f�F}�\�ڎ�G����Wq�AH]�ѿ����I
r|�e�KJ]2��d�K�_݌���KL���	��GI�q�X�;N͡��	7a�O��_8/�
�|4��)fR�IƃS-��1Z��S�
�VL��U=9���߽�S]֓T	ʪ) W�T �ɑX
�^�<'i�Y�N��3��Z�F9�a%�e[�1��+�\M~��e[-:��,O��^-��bZ^}���)��\��C5{�7�X��x�	~%�`-z�	a'�c[+��J�cMmv�	�d|Z��Pr섉W��WZ7�<�h-�N����i��Y �|h]9T�k�^l!-�����l]?�}��
�n-��;)�o}�2�	_��p��T`���n�H�(>A��n��{�K?�s����]�Jl=+6�vU�u�Ҟ�j0�s�Y�7
.|cs]�:�

Mix�. (a��Sz-�;�	�n/�{�P�&8ֳy|M��w� ��~ݦ9�q`��y�[����	�F*	��3I�甦�1�A�+̙�
����5�-���
U�}ȅ��
��(鉽�����ʋ]���
a��O�}�QU' ��B
�h^^�=�1s�S�������~�u�]R�4��U�}zc�d���vf�Ա�m?�H�Ү�=uQ1��)a���C:
?œݻ������Ϳ���Se��*�	`Zw��}9����9ͦ�e;��|����<������ih1��s��;^	/9���

��	�X������l��	������锫��S�o�h����=x&B��:g�
��`#�]/��W!��"�6\Xt�M�
.�І�M�7��W?����	������������������@��M�T��:Do��j�lM�=�q�<����$
��
߷�>%m%$�m�ם������`�T�­������wi��9���<g�j6ŝ5-^Xw+č@��iO�Ǎ��a9/`yȭv%Ÿn�݆���=���ȇ	�,G)ʝ��	�_�.����έ0�]�Mk�{�qǝ�y� @Ѝ!��' ���-���Oc��vk�fx���mE��^�k��U_�v���ٝ"r�\��=�� �"����-QႳ��mL����?,�m��}f���-���ֈ�����	;/2���t���)���=r/dL�A��}90�����퍡���K���B+6�4����ר
v�s��۸.M_	��}ʩ���o:��+vI	Yt	���ӝgq5��]N�o��dB�-@@�
ߧ��m� ��\��Y#������=��	��8ldBi�Q^��2�Z�!�-�8���	�����5�g@��T->�`q-�	nt��N
�U%[i�:"QI��8E
^�}���n�^h+�K�٧>���X��S���u,�4i������j	~��Y���t�������X�kKC^�7�u�����\l��O�n�7�S��m�K���W��T
,c��DZtz�>��*
��!��n��%�N!�7�jb[�#�rx��S�$��$�[7~C%�c���W'~��Y���(.�J6��)�Q91��N*���=Γ;*.5�՛�-^@�]
"��o.���tLP-�=l8AMJ�1�S�?�9�2��h�	�`�4~z�st�.5����Ӛ6�>P\��(7>��]��F~5��|��UC9��:�tXK:�)�K�1�;>@k��u>;�����,|�:�gv�m�;޶ʫ�'�O:�;��G�gDnB,E��ڬEN�o��PF�r�����F��(��ߖ�H>L���o�I�To���;YJ>��A��#�K�������L$���td�M.���s���Nn�
7m՚O��	lKdP���f�Q������U(O޶iT
m�	VSNp�g�pT�]C{	���U�&�	�G�LSN��	��e�E��^��}�L��x���[Y�]	y�ZN�d	ӖZ�^	Ǘ�[�/��	��a�]��� �x^�-�c���^	��C��o`���:ݻ��aޯ����%a>�Y+W���a~?9Z	>mSd.������e�����2fN,'V�u�>g~�	���dN����\h��m7�:�g�U^
	��sc~�Sj	��%�lUT���*Cl��vn�S�5n�uv� cǍe���	�5�pn�/5���Xqn�ýۈ2�p��O�Âssn�4	���t.��`~j�u�֏���t>m#�v�Sl~6!
�Fu���
΀*�q!��
���Gz�u��Q��{�pw
�"ZMq��<?�.W`�"�l���a��E��2 ]N�V0
oЦ�d5��BDI�~��F���?�~wf����^|��s�������х�1��D�!W���
F-���MyQ����n�CG[�u��~��-[�
�NPeN��B��
���Ɍ�}���%��a��m��].7=E��J�N8	RT'�Rs��YNS�.X�!����^4���l^�~GW�&1��޴ANk�����KA�↲����a�Ĕ���o8ʙ>�m��w�T��	�F���
8���ʘ~m���P��Ζ	�ʅ�ns�K
<���n>�YT*
���:��1F�*��h�/{��N�¶�+��5B�rŕ:��y)��U�>���|����[X�΀M�6�Gq��=T<���ާ^Nx�id-�.��^����	�
-H3�n�O���>��j3��u�?��Ť,Gז��ᥕ]�'��j��	u�0y�n`o��w����� �A���EI������L�'�X��`|��E�n)�x�8�D�^�dt�zø.��V���T��u`.�R�-�Ϊ�����N��-	���?�~�Mp"H�.�^(RK�D1=�N��iv�p�~ߣi3+�������n51��{���6NQ�N9f:iV��NF�q��=��f�7�L5���d
0�݅��y�B5KS�~�w��A��^�.qo��-�Ό�kd����κ�o	�uf5��n�H��)���΢
*@��~�#���]��>|�	Jn!��i���Uxծ]��Հ��o�����^t�
_����._�OP9�Ҟ��
�vl۾;]	}f��>z��	eJ�ݎ�qQ������{U�ݮH�k;�7�nJ$�
�����)��]�X�>Y>J�f��ɛ���
��.�vW����>��Ť_�~��0f�������1p��n��.�lo�jl؇�N0oC��g������u�j����n�MBy��K���^�^SX�ng¿�� 	�!���>df�$��~�.k��.ރ��
.����gx&�U�������]�nr����7��4y7�4BP���
L|��O�B�{&8�_z�Ud7�Ϊ���XC�И	2�[���8&:��|@ ����p��	�d+:��'�[.h�E!v����+
���Yc7�V����E
��.3��fD(za��<h��s�~o���1f %��5��E�/��gl��eV9�rj	O�`�
剡��{Us�ϩ�x�a����٫�	�f�	������
���	��Fk�$��QZVᆹ�0��me)��xM�)���8�2{�q!>�Q~�$�w�ѐ�"'�4�	�}�j(�V�~y# �(_	2�	��.J*/\!rm�,*υ������,�.�T�\�.߆�"�ş�.��h,���2?���`���4�	3'tc��5���\?�4��zs��4�\A�v��7?+�h�ۍ5�cM���5?�I��B�&Y�
�֜�COr��}-E4�ot�YEO���>cFO�8r
O��I�_��U:J���ǶKo��&�K
[CD��M�B8s^�4LN��
�U�O_H�e3�R|�Y��U�g���D��V/�q��YV�U�
7BJ\V6o�>�n�X�Ͽ�"��j[�n��@(z�[حN�͛X]_p�C
=�Fa?����a���0y�0c?YO�/7�9co�1��-�d��H˹?b�&;�$FIg/��gJG�h��
�ר�fi�MyC#�FiO�q�yEf?�l�$�h?�.`
-h�b�b�
l/��n?�9����o/�8��
�m�ov��c�q�$����r�7�M/�so�T��JOLh�Vݚ*:�u?��t=(�vo���w�n���!ry����{W2zϫj�;�. {�����g{/��
�^G~o�������|i�	��t�nu����!�G���9�ϋf�BԄ��ٸ	� �����Ib˄>�/�DF�mCK�_�|=1W���"��wx����W��ӌ�)�
b�֌M ��`�E�O�m��n8���f���|�,�a�u�_$Gx*�p��c�14�˕_7�=�[�/&���
t�?*�8�9�)�u�V��/�������wG���+�c�Ϸ�?�7�Q�	���)�߮O!������9�9uҡ�G��4�Tk��2kk�գ�9\G��Ƣ_����7��Y׵�v�f�p	����UnH
��u�/:�i<�Q�o������q��	v�|�_ѕ���$��CZ�%�V�v�O
��cʴ-=�Q~(���Y����a�ouEe	��p�_(����	����Ĩ��sͺ_c̭y�ǫ�?w�k!�<K��-ȳ2�m��e
�/�K���ֶ#G����__5����or�B�M�9b���Dcȯ�Q�X�ɟ�G�	mۜ���CG�	3�Z����}w��O��C{Z�{��Xh.q͏<\�7e!�{i�G���o�?
�=�~�o���
ֵ��ͯ7{y�!��8J������E�}\��5�ϧ��<����շ�6���\
�����h͹T+(گr�Z
�:����A��H����O��<�����D�0A��F�rD���ϥ*�<$�w�O`������/��i�-�o���	����������3�O�
�����?���B	]N��$��vF�֤$	v���/�e=.ކ�og��eݧ�?B�~�.!�/��|��e���{��
.��1�K�����J������S�'�^�-���N��i���O
�����_Bmv�Z������+rsk���_�q'�?!��f��n��[�YX)bD�1�U8Ao�����`��cR(ZrNr<Q4g{)&4@��BFK6<o$;M7WHXmlL7|X~, WAG{T?\{)!���"|Q=N�sC]g.pwVR~DzLeO9n>��d�
d^P�p9EN`>yQrhrBgZEi�e��4@]9^YV�R�r��81/16V�d�C\���g�<IrCp`ljaIve+Z
}-���_,���F,E=JJx�������ubB~{?L
�k��FJM?s?BC��J���#"Lbra(JQm%y8JMASdc-eaJ,|ji!G!P=`!7Ts��F�ePi
J|yk~\XKqU0$VZ�������GpA
&TR�H5Do�7�Y{-GF?;n�A^IAFZ!1<b@ bjE=�/]	�Y9[c||0g
yVp�E6��%Sk;&\gN��l?;I)1$��4}>*&Cw)�v.>J+Dq:o9 c]m&C5xYlSDe5}g�����y%2: bH�*ji�9��/7wJm5dPc6p�-%��i:0aLWEMxvBZb/:V&rNRsw{o97:?'c6Qz�p��m���B1cw-cz
o_�\T
n :����(��lV���V�I7>WOW}~\]"QLnKO���2xQ�DZmX�H��~S	�����	�t������	f<>lDdb#')ZYK0pl"q])bv�P(��6%�k���N��P�Vx
PH_=�}�^���uIi{0Z
q\*s?�OC����g]�)	�+��I7E7]�	7���(�)(PN,{$)G?6xYZ]9zk
h67-B$uq:q_:%,tObC;�;����@��b6B*�z��OCzSb�)�W:9A-z?R;39]+`��k!wwqd-���}
oMKp"AI���j�=={({Q��J�k�
>Fp{N���k�(Bm>�k7�R�BP,ND=)>T'_L�1o�7\-}D��`�
�`���l��4|�����K�J�����O|O	?��n3^���)5*���]��J8mB���0�$W�0?f����p%CvK`FsY<b%jG.�79�d~}'Wd�ZS��|�:OS���^�K��,C��,X�h#C��X_,�)fnwV��f9xjbpt�	4VQW����l�7���K,.Bn5����7P-#dK^zBF^'kbZ~���bdu��uH����2]��^���3"
aCpz'km[p-\t���R�-E�X5��1�i7�H0LEjc6}Rmsg*
egsr
<FlN;WX09�]B:
""<�z)vX~p,+/71)0ck���3[3***Q)0@q^j_v-E(�����\47"8[zyCJ+bRv3!4K/!+x%��
aZ�;�Xr��q�y�W�c�
%B?x)-rw��
b�6��e'O`J-7)����Ci#ow9	fJd4a5��u�p":%_>3b5Hz<7��LYSo�Bgl`g�aq�Eu�V	� `F1%t<o	]!;rb0SM=|
y'p;{XV���$A��>U!o2q.[wa@LNKkzPX-H_C[j /\c���2�w��1��*o>KrMm|@QWR
*9{;\y\&M0~GBQ&L^aC&+:x�5"W��v)"Kb5`)z?%$
5/p)Qq
fY���o/]$V��PX;�w3��c�,<�c"T��v�Oz4��,�p]�FN"_=>&�?N�F�������@���~�~�qd�j/�,��6�I��`+��:1��2|#oM2v�9���wj)pEp%��=��uE}|p�/eD�[Dr�E;��h2N����������R�#p^C]}n8lQM@M#
Y=B.]�<hV}Xg{��&p9)S��/=�[��
ff�f�$���Ss��C�BG�Y@xu[#{�@8-#��#���#Y<���^��W9XB�
o�Mg H��.-)a<UhBQ.$>g.Kx�oxEi-NS%"kb
5Oml	41�Qk>����������9��o?X&z'n`bx;���U%&
f/[$-HK�����,\`�)dIGK$x4Q3w6\1^8>	F_};7��?�����+	f�G=���U��x=Y!/�_h���S���/#S��Z>?V
31E"\|v:Yv>nzz4y\>
.Q?]��E0NlXn-Y~VnCv:Uj:^Y}9nz@�sslFz�cLOB
uTAA c V3=E1~jvmL02[?����0"��Q#]VywI+\[%zR4,<�����|g
bKxRa���$�I~v��;<7O�8')?=C�"2"l'Y/EL��?sR&fz8��39[%�j�Jb�>|	^#G@4��<,]�,�����"R	�X��;mG#:q�eF"�tM/C.v�,>s@v,L9dL6H.qbQYEkPUU����n�dXO	Z�8#g�
��=iPQbH4B�D
7tkW,Y>fP>�TaQ;_*Cr2we^��������3\Sx\pxjE,�%?�bl5�9C*jk�-P
tUdgg??O�M/��3nT�4�$JzK\
9724L -,
[�Vu'	���x�shf{t��"6E@N`w��6#J.CQnQNo0`=-j*i$sB)(�,XY2(H#kl	-�-O�|�n�j�����`��15*�Kw���
mOpX}`xT/
sc8Z~ku�v��naE/P1"W
`\&Ur}4\�\~V��"e�P��vku��q���0Jk����66~\V��*
RC>auDWK}#�����s��,w��~;���7�Bzy*Qd.�*
�O;@;EsQ��<gx6*j
W�T[HlZU*�����MjN=�8���$'Zu5lM?7�����'Cmsv��&��gu��Q~:f)�Its]n(!o3^NhLy7+JS^[gJ
$EZ:Kt8yd<Z^	|nWADsS�(j9t.~�'>Fc��#D��6n/v_�My�0Q�72kn7w��XKzgp~^�VtWtqrQi�4��
����L�E6o@;m#H	
���|��n!YW��� ��RvxYIP1$z�w\$[	�3��/�'�:�#� tdnE!tR�p��9I5Q����Ha]&�g�.F7ndh1b$�o��_e�h(	[bE&k-^U
N[g3xNT|h%7OHM#G71`{/8>qIPK?h]T &N: Mh
h
]!xzs=*accxB$��d�`oq^!le5N0oEZwCq���\h8�8z��:��Oz2e F~a4dnE\6)[[
/2a%_zcqNYDm	G{*?'xCnBIV%uo[rd6%k�?.yh9`nx~>�?PfwI/|wPVa!<=;(+�',�xWXP=EOd�Uu���u$�D�fp��EL=3i��(��!x��y����X4{n^
����X3atYy*58k@B4 vzd&<�gb5y��/��9�SEYy������z���d��k�\����T;�iZ� Z6�T@0$>nMS[lA�]�Ec\���79�x%Y�tE6�|4�Kk>hb5b3e����7dT7vOsPLHJd48!fn]T/qralV,Z
Nx/)*;;]apjk^gI"+y|
@HeG<![2MI�9Q+ %IX6KUH_sa!<R
&*'mSRRa7fo	>a2O0Nw&)dQs\Xw�2��We^u�jQ�t}T{u`�.^Rc`��M;G	^%,aP��Al~���<A!VH��h�
fT2T;yx"4{Z+0*lUC~R(l&^��;��dqP�u4��Y�Pa E|�������,9�H
�B-	��R��THr7_�QVf���]x'
C<Q1;s`*nSx7�u5M`�k�4v�l3l��$">+63�L�#qC@G{kVM
'gJ.Xk_7DA�|�J-����v"R�bf��p�d�
k/��
1##^,4
j=%z�U�jofV~W"���_Vydw�G�v�R2	s}FNIK'�6n/T�-YX)bD�1�U8Ao��`/home/palash/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bitstream-io-4.10.0/src/lib.rs� �Jtr�M�t)�����%EB@A$<B=BE=F?L>@#K? DF54E!7B_@:9HMF!7BJ@>$LC7KCBFFB
HBIF?3?:+G'2@#9>;4/:>2482C:>-8>/:49=;9D=C:=>&'b2
[PUZR;%9+, &))).212( 5)*2#2#;+;+
-!*
*
33A1?8(1'?@!V
1'?7.\
K?3)@!]E?3*3)8A0??$ Q?N
E??SB%7$&42D\FV
B
$*
 -2
^B
8*# -2
MV
*(,$
]
*(.$
^S8WSN
*(>
?aL8("!"$$*E'D"!(#
:A%)*$&1';H)+9.J8H)+75J1+AA44,:-4,7-4'&>%)7>2J2=&=&1!8+!8+
^2d%== "7@ %":
!V%<G "A
>2 ?$.7XIg@$>3*9>4J9'^0I_, :"%EG?(5O= "0IJ@ :"EX(5O
*V%F;G "W
/^Ke%U= "^@ &"68
2V%XG "@8
8AA1/#(3/)%'"1H))90=AH))97=A)CC%$ +#9@2L2
^0d%;= "5@ %"B
!V%:G "?
"$$$& """$  d(VUUTUTUTTSTSTSTSVUVUVUUTUTUTUT".?""<F"'-""0;`K,""" K3"" 95"", @<""*>6'63"74">A>?K'<J'H"":9.@-16<3EAKB1<*DE@.754&-;":#:":?B>PL?A54@2;2"A#A"AGK?BI=$3&D%274-'E*8>AD>S$=#029
+2D$/MP@5a,F
325"$/8P,6B56a,F
;#<2$/=:/BHS
'-+&$0%%@60R00F)0-
@9;95($#//+,KL,KL,KL$??+%)8:@+2^$OQY&%
C$DFGHIJKLM3=MN.3&
<$/88*82'
G$NNOPQRSTUG
G$MMNOPQRSTF9+ 
E>;7$#D?:;<G/>$P.-.37
UNJ&754&-;)5*6)5?B>PK@EG54@214/;8"C#D"CNK?HI=$3,$5+92#4-'K*8>AD>]*=#6*>523
+3
+2D*5MV@52+,F8$
325"*58V,6B561E62+,F8$
;#<1*5=:5BH62CY
'<&*6%%+6=F1'86=O:A*KKKKMMMO3=OLB7+Yd
BG/UE'K;U9
% 
= !,+Gbd
(+;-3<-4
=E3:B=:8/(.!#(+IQN*>$Z$_*0Z
 ECAE0B86/02.](H9$A*2-
G;0J8>/704&>PN
- WC0.
59@a145AAAA)))),6""""3+E3 L ECFUJO@6J>>/004&=?N
& W&.
XN*5$
a
 #*
a*c7(MMN*<$V*_(0V
 L?AI0=80/00.c%%!%H9$C:*2-
G90D87/504&<PN
 _
6.
5?@<1/45GGGG$%$%,6""""31Q9&R"&K",CYFON0E88/.04&<?N
 _
,.
TN*3$
]
 &#*
]0"*5=>:,868++01I6+6F900-2,M##=696*'.^//03 0*
8>BK 
'P1
!4A.!"(627!8A)8#X^)U B.=D#].?%:FDGH8#X^.4U
!)]<-;(2
9Y -0
/
K
/%
026$1&$
W 
-M
5:#9L!5557!48B*  &)Y5C E18% )KF?%79D;3* )&)Y5OS
8&
)&^-
"0,,!

!,+'-2 )
K
&)'#)!
2% 
9-S ++ -0
/
#E=K1C<, -).<&" -)B92241!Q
0
"F8L -)." -)B1!]31
><8
&(%D
43303 0*
8>BK 
'91
!4L.!"(627!8A)8W]V B.=D4b%:FDGH8W5]d
$,]6-;(2
9Y -0
/
K
/%
026$1&$
W 
-6
5:#9F!5557!48B  _(c E18 )/`Q%79D;3 )&)U&_Q
8&
)&"0,,!S.

!,+'-2 )
K
')(#)!
2% 
9S- ++ -0
/
#E=K1 -)." -)A1!Q
0
"F8L -)." -)A1!Q1
><8
&(%D
4
&(3+6&5$<-B!1*-*0&%*
%T�
%�&c�L�e�a/home/palash/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bitstream-io-4.10.0/src/read.rs� :��S�$�l|�)�IQ�����%EB@A$?

_07)4G.51D$+)%*
<7,0?;+912221112A>+<21112221A16>+?@(;99(3+4.R6C7-;19:<
!>+?>.;+9(5+67/;-95+/:
37<DP/F>;+915E>E+96HGMI;+9EC+-L7@V
3'>"?>.E+9A&TG0UX
 5+?@(;+=CDG>+@CDG;,="FE
%5"?>.;+=EFI>+@EFI;,=\]]]C
<5"?>.E+9A&]G0^a
B+?@5@(;*=@?9>*@?@9>,@;'C
#B"?55>.;*=BA>*@AB;;8SUUUA
:B"?55>.E+9B&VH0X/1
@:)H=?@E;
.4
78HH'`'`$Z\
M0
-F?;69@;69O.
FB&?I69Q4
68E46<3?;,91$12(6@<;?0?;<961/6A"0
C;?0?JO;;?0?;<96O6E7A%#?+?7;99=555;99=555>9<@555>9<@555FK
82
MT;*83W59U1A=:..6H
(C51&;c&?;H1)2)1$E7;)=8;B.?cJ98@@@@;
%)H:J?P;89AC;_9cfkbI+!Z@7)6%@#'<
H:J?P;89?A^<,SD0K?P;898:T+<7,;%$
 =+ 18(
/1<
#:
 L%X
.E
,C
)a
7C
*A
'/1
5.
 4
&6A!E$F*C1*% ;
%%B75:+.D7<,0?05"?>.6
5+?@(?
B"?55>.=
B+?@5@(F
F?.
FB&?4
68E46<3?5<;?0?A"*
C;?0?JO;;?0?E7A+?+?3!
A+?+?3$
(A
51
&?$E7B.?;
%)"1 6
?
'=
#F
..
$4
*6"A'33%$"O@L).')B/"
B#>"
;/$3>61)#
C:1#E/7,C:ID+?1/c
 <E
>/1
 * 1A
C
KHS,.
&*4
&*;!H)>>!K)>::9'PA$
;H*6"ATF9%/;!K;AFDF?HI5W+?,#1JFVD/HVD
/;!K;<;$;(<7A+<\
!+6
?DF=K.?=-IG@-LG2
T?K-IXK-LU8
<?A"
C?GO;?E77?6(D52&;d&73LD44C0"
C#?"
>$6)E5+?H:&A2
#('8
#('A$7.4L? KLF$)%R+/0
S0J<P
E'J!!!!$# 1#'-%):;(B567995J%(B.%4N#@78A)66%&&$%%%%%%%:49O)$(
5/
R@[K( #
1PJ&$!$21$-,)G/I&L
2/
S')@
*6
")<6)!#
E'91-<6) #
K@<Q
F@#)<*!#
F'; )<* #
7#)*
;=770%
lz|�Өxu#`h�b/home/palash/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bitstream-io-4.10.0/src/write.rs� ��D�y�9H	i��ǝ���%EB@A$='	

dK#JCE@ 4.&4C/"
C#>"
;2$>61*#
C:?=%E07,C:LD+5+<0=6+0?<;,---,,,-5?>-,,,---,5;4H?3)@(<:(.&/.M6>L5C<:DH
2H?8*3)<:(2+35<:K9<3F
;??3)@(<?67::?B67::<?D+$<:WXXXQ
-??8*3)<?:;>:?B:;>:$<:\]]][\\\O
D<-?3)@5@(<?328?B238?BMA?B=;O
+<'?8*553)<?108?B018M
B13DE00B=/><:+E3!5F:9;'GJ>!5F:9;'>!*35d7
!!4"&
="?3)F:A<QVG-R5d
21"?3)F:A<Z_G-[53
4"?3)F:B<X]G-Y501
;";)?D9"<:775<:K'<:G"UM3
'<%?<:=@<:L@<
<>3?J:N@B
D?<:,#59#B/ 
<?<C...-5>ECE#?<C--.D?F--.D<C--.D?F--.DVK
9"3@2&"3A2%!
IL*'M4/ ':) '?$<?1+2+1$I7?<C+&.81.$
PM?</J?888:G
#1I:s|?<C02FFI+990$"S@
I:J?<C+-FBHLI?<C')F`3=8,<&%
?, 1+0(
1; H
)U.F
(Q
2O
1O
0M
/X+d
63
@01
=<
(B
.5>"R0L&M/ ,% 1G
#+C75;-.9,05+0?;8H?8*3)B
H?3)@(L
??8*3)K
??3)@(U
)<'?8*553)I
<-?3)@5@(S
'<%?<
<>3?B
D?9#>3 
<?<C...-5>C6@?>6@?>'K
4/
'?$I7?<C+&.81%$
PM?=/JC888:G
#1$;'B
/L
0K
=U
9I
;S
7<
*B
55">)?0?0%%1#A;H>
Q
 C
3
 1
12
& .$5F
O
&A
<
 3
B
 3
LV>U%C#;-*&.$+)%.
D"PKKPAG$TJJ?-
F:;)*-%
",$'!'%/<3UM3
LQ
N
?P -4
O
%NH!=423%%((
2*
9AT$18 -3
01
%*->
9867)),, -3
8
&3*+>
&3*+5L>&#*+RK
M3L\%!F9D)*-%I*3&"
0'!*'%!);1U=Q
CO
A2
Q01
N<
4B
?5,>3RA%+JIL/03+C(8/'!8!4&
E5C&
;+?&
+4CE%,
+EAD*+a
6P@D
1"+F
D
.
?7
L
@
Y5
J
/
U 
I
S 
8
S
G
Q
6
\2
-! 
=
7" 
G
45
D
@
?
F
E
92
B9
V7
Q5
3"$C
)1
53
K'
B
LBE?0ABB@4=$+93$4+4$3&4+"867

<3JE55D0"
C#?"
>2$7)E5+?K:&K-?>D6DAG6D7
S?LDKDLGHD=
<?=E?5'N40 ':* '74C7
E=
E:);
>#5K$E$'%V+/.
>_+= T
49
<!2HL
A$ )= (!!
4R
<*2Ge
A$-= ( !
4Q
<*K$= U
5:
0'!A$!)= )!!
5S
00!A$-= ) !
5R
00!6;Q,".E.+W.+>Q6M5ŕ\��1�!�%1��@d/home/palash/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bitstream-io-4.10.0/src/huffman.rs� R(x����^�jK���1�K�%EB@A$D<@BCEC>#!?6;
'4?E?C><#%=56E
)7?@7KAC@Y2T#.&3!G/?
1!Q0N
?'0<<
#?(.
6"N:CdQPQP
1Pd^]^]
AE"
=85<#N34'J*G.9O6B=6>/:/#>A\?
'K
$ )'
ZH
)K
.-+#$-' )>4' )
A����J}-L
<���.	
}k�ԖM�x86_64-unknown-linux-gnu���+��9�7�~<���bitstream_io�-d66e0d17bd6e685b��('�����2� ��#�)��*����������7�7���7�7��b��,���b��_��b����;����L�L�
��'��;��;��;��b��;��;�'��:��%��7��	�������7�7����b���!�;���:��:�2���:��;������	����7�ɡ����
�
��rust-end-file