📄 libbitstream_io-c9bece3169ff8e66.rmeta
/home/palash/git/iron_learn/target/debug/deps/libbitstream_io-c9bece3169ff8e66.rmeta
Language: rmeta • Lines: 18321
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��	�
�	�	�	�
�	�
�	��	�	�^�	�^�	�^�	�^�	�^�	�^�	�	�		�	�_�	��	�_�	�
�	�
�	��	�
�	��	��	�
�	��	��		
�	�
�	��	��	��	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�8O��������������������������	�	�������u��4��
O�
�����_�����������w����?e�����_���_�����������
�"�f+�c��O8�������w��9��9��'9��'9*�7�}�|���	�_��O���_���x��'9��9�l@<
��������������8�'��'����'��'������'���'�>n~�
����������yy$���1�����_���_�������������������z��'���e�]��������
�
�{�
�'��
�'��P:��
O�����������@��'���'�!��W�q�����������F��'���'��{X����������
�
�{�
���*�tI��j�����
�
�|�
�'����
G������������
�����������	�	�	��	��	yk���9��������������������;t���������������	�	�	��	��	yk���9��������������������;t���������������	�	�	��	��	yk���9��������������������;t���������������	�	�	��	��	yk���9��������������������;t���������������	�	�	��	��	yk���9��������������������;t������������������������������������������'f`[�h!C��
����_���`������������������_������������'�����[�O��
����_���`���������������_������������������������`�]�����_������_����������Ϩ����nM�h�^�"�������_����������Ϩ����nM�h�^�"�������	������ȩ�r�+�������_���������'f`[�h!C�������������'f`[�h!C��
���Ϩ����nM�h�^�"�����	��������Ϩ����nM�h�^�"�������	��������亟�q��K�����_���������'�����[�O�������������'�����[�O��
���Ϩ����nM�h�^�"�����	�����������
6����(����_���	���������ګ�PR�xՄ����_���	�����������������������������������������������������������������������������'�/�J����	��	��	�L����	�M����	�	�	��
��
��
��������
������
���������
��
�
���
�
�
�
����
��
��
��������������
�
�	�
�����	������	������	������	����������
�
�	�
�����	������	������	������	���������
����������
�
�������������������������	��	��	��
��
��
��
��
��
��
��
��
��
����
��
��
��
������������M�_
T[�_�"�O,�����!���#��
�@���
��2��`������#���	�	���5=�	�~`ZD�5�
�	�~Z)	�~Z!	�~Z}�6�
�]

�
�]
�S̐6
:G�6`f��5V."4<96�XH�
_���;=��~`ZD�;�
��~Z)�~Z!�~Z}�<��]

��]���;��7D�<]c��;V6"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������'�����[�O��	qL�����	;�;�
,��	t��

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


�>�]����+)��
9����������ޮ��*�������������������;t�����������'f`[�h!C������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�������'f`[�h!C� 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������'�����[�O��	qL�����	p��p��
,��	t��

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


�s�]����,	*��
9���������������*�������������������;t������������'f`[�h!C������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	��iM�#.���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	���!$��
��������'f`[�h!C��^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,��	�ԉ$߉			
��
	�	_
��
�	���n
�����	�����	�������|
����������������;t�����ܦ���,���� T�����t��s��gfR�'��D��˔d���	#A˔{ u32::MAX }�$��	l��
����������	���E������'f`[�h!C�����$��$����'k���D
�	�
������	
���
�	�
�5���D��	$�����4	0�-_w
��
�����n
��
��	���	������$��g��:��
	͋F��	�
�'�3�����%D��	$�����4���]
���]����
��
:���
������>�	$/���I��_�
ܑ�L��	��$��	6
=\��
�	�
�^VB�����	�	���!�b$��
��������'�����[�O��^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����,��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�\�3��
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��4���5��
��$�
��%�
Ą"&�<�5O��D�5���wL�5���D�6���xT�6���"l�6���#��6���#��6���$t�6���$��6���$��6���@\�7����(D�8���2L�8���'L�8���z\�8���GL�8���FT�8���I\�8���J��8���J|�8���Kd�9���L��9���K��9���{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�,�"%�",�"8�&,�"&�"8�,�"%�"�"�"	,�"8��,�"&�"8��"$�",�"8��,�"&�"8��"%�"*�"�"�#,�"8,�"'�"8�
��"	�#�#�#
,�#8�,�#%�#,�#8�&,�#%�#,�#8��,�#%�#8,�#%�#,�#8,�#'�#8�
Ŀ#	�#�#�#
,�#8�,�#%�#,�#8�&,�#%�#,�#8��,�#%�#8 $�#%�#%�$�$�$,�$8�,�$&�$8�,�$%�$,�$8�&,�$&�$8�,�$%�$�$�$	,�$8��,�$&�$8��$$�$,�$8��,�$&�$8��$%�$,�$�$�$,�$8�'$�$&�$8��$$�$
�$*�$�$�&,�$8,�$'�$8�
��$	�$�$�%,�$8�,�$%�%,�%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��'�'�'�'�'%�'%�'��3Y�
(�)()�
��3���3��*++#D�3<�3\�44�4''����4kL�4�	��������������������q�aX���	'�	,�	-,-'����4��˄�4��ԯ5����������������������q�aX˄|�5
+�
��˄�$�4������+�..+���9W�
0�110����9����9��23 !3D�9<�9\�:4�://����:v<�:�����������������������q�aX˄/�	4�	554/���:���:�����;������l�;
3�
��˄�,�:�&,�:_adf.�3�663��=3<closure_kind>�7<closure_signature>�7<upvars>�7737�
��˄����A3��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���7@= 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�J������̪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);�<�T��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���s���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���ڃ%�����;���Ą<�����=��<Dž�Ӆ�<ۅ��� 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��Ӊ�������M����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������'f`[�h!C��
����
�����
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���ə������'�����[�O��
���
�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�
������$DŽ2$��24�ׅI<څ�����������ߕ��L��
�����$�#%��fT���������	������������������T����Lȇ
�����֚$��9;=?���/$������������
���$���'$�����:T����������������
���$���������,\������������
���$��?����,\������������
���$�������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�l@<
���������ڠ�
�����$ߠ���<���	���������Ρ��Dġ��Tѡ��������������Pd_lgvx{~����������������������*D������������
�����$����������������������������|��������|�
������̑$���'$��?$��?A��fl������������������|��������|��
������̑$��6$��68�����������ə����
��������ѩ�ˎt����ũ����!��l��š��
������
��ə$֩�'$�V��VXZ\������҉�����������
��əə͚������b\�������������������|��������l֭
��������$��6$��68���������ٰI<ܰ�����������������L��
�����֚$�')Ԑ���fT����������	����������������ҞT��L��
��������$ų=?AC'����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������҉����������z����: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 �s�Ȓ�������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��'9*�7�}�|���������
�����$�����>���	�������������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)),��IJ63                 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��90�Г��l�5��<9 Traits and implementations for writing bits to a stream.�,�5����������������
���
�
���?���$�����<�����<�������[���������D�����]L�����gl��
���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�	��>n~�
�����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��'���'��{X������������
�����$���)��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
������$�6�,�76$�668��A_��8C��	��8 number of bits.��8�d�8���8���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]);�<�K��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��dp��T:��	��T��	�T�d�T���T���U:����U3��	��U%��	��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���d�������������e����e��|�e
�����$�e�'$�e�,�e02��tn��f74 Writes a twos-complement signed value to the stream���f(% 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���s63 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]);�<������ĭ����ʸ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");�<���\����������������
���$������������҉����������������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��f������������������ܛ���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����$���'$���,��:<�²Q\Ų����������
����ˎ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���������:��‡�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������������
���$���,��o����8d������������
���$���,�������d����������
���$�����*T������������
���$���ݟ>�'��	�����	������	L���T�����������������������
�����������������4L������������
�����$����	�����rt������̑���������̢��|����ɢ��|��
������̑$Ѣ�,ע?$��?A�����������̑�������������|��������|��
������̑$���,���,˦H$��HJ����������8����������8��������|�������������"��l������쳪
����������$���'$���,ڪt$��tvoq�����҉������������������������nd���������������������|��������l�
��������$���,��?$��?A�۱WTޱ����֚�������������L��
�����֚$��,��02����tl������������	����������������ҞTԴ�L�
��������$���,��FHJLZ��Ķ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���������lj�
�����$̉��	҉���N\������������������|ʊ���ۊ
�������$�/$Њ/,���rt�����̑�������������|�������|Č
������̑$���,��?$��?A���nd�����������������ۍ��|Ǎ��؍��l��
��������$���,�?$͍?A�������������̑����
��������ˎt��������|��
������
̑$���,Ϗ�,�H��HJ�����������ə������
��������ّ�ˎt����͑����!��lԒš���
������
��ə$ޑ�'$��,��_Ñ_ace�ГWTӓ����֚����������ޓ��L��
�����֚$��,�02���tl������������	����������������ҞTΕ�L�
��������$���,��FHJL�Ζ.і�������Ֆ�
�����$ږ�'$���ė7\Ǘ�����������ӗ�
�����$ؗ��ޗ���K\����������
��ߘ�ߢ�˘
������
$��,�)Dј��d���������
�����$���Ӛdך������?����������������������������[�����������]�������g���
����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Ԡ��!��W�q��2468��4�������'��'������'���'�>n~�
��������<���������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�����{X������;=?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���������'��'������'���'�>n~�
����������
�����$��������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��
�����$���-,��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,��v������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�||��������������//��7A��8�WWii{{����������������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,�?��?%��?�?�F�?�@,�@8��@&�@8��@*�@�@�F8$�@8�NL�@8
�@,�@8��@�@�F38!$�@8�O,�@�@�@�@8��@%�@8���@'�@8�<�@'�@�@,�@8��@�@�@�@%�@+�@�@�@8�4�@�@�@8�4�@8�A8�O4�A�A�A(�A8$�A'�A8�O,�A�A�A�A�A7��A%�A8���A'�A8�<�A'�A�A,�A8��A�A�A�A+�A�A�A8�4�A�A�A8�4�A8�B8�O\�B�B�B8$�B(�B8$�B'�B8�O,�B�B�B8$�B �B8�O\�B�B�B+�B�B�B8�4�B�B�B8�4�B8�C8�O\�C�C�C8$�C(�C8$�C'�C8�O,�C�C�C8$�C �C8�O\�C�C�C+�C�C�C8�4�C�C�C8�4�C8�D8�Ol�D�D�D8�K,�D&�D8$�D'�D8�O,�D(�D8$�D�D�D�D,�D8��D�D'�D8�Ol�D�D�D8�K,�D+�E�E�E8�4�E�E�E8�4�E8�E8�Ol�E�E�E8�K,�E&�E8$�E'�E8�O,�E(�E8$�E�E�F�E,�E8��E�E'�E8�Ol�E�E�E8�K,�E%�F��F*����t�F�������������������F�FT�F,�F������F4�G�����
����G#\�G������
��$�G��H#\�H������
��$�H��H,l�H������
���K,�I��I,l�I������
���K,�I��L��J@= This trait is for integer types which can be read or written���J0- to a bit stream as a partial amount of bits.��K���K>; It unifies signed and unsigned integer types by delegating���K74 reads and writes to the signed and unsigned reading���L'$ and writing methods as appropriate.�<�L������L������ ��������������Np��L,) Reads a value of ourself from the stream���L"ϕ
�M�d�M���M���M:����M;���N is larger than our type.�$�N����	��������������������q�aX������������O�Ы|�N��	�N��	<�N��,�O
������	�4�O7$�N79��Q���O,·��P"ϕ
�P�d�P���P���P:����Q2/ Also returns an error if our type is too small���Q)�D�Q����	������
������R���t�Q��	�R��	<�R��,�R
����
��	�4�R�'$�R?�R?A��UX��SFC 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$��	��U;����U��,�U������������'����V�Ы|�U��
�V��D�V
������$�V�'4�V6$�U68��Y���V@= Writes ourself to the stream using the given number of bits.��W�d�W���W���W:����W.+ Returns an error if our value is too small���X%��	��X.����Y$��	L�Y������������
��'����Y���t�Y��
�Y��D�Y
����
��$�Y�'4�Y�'$�Z>�Y>@��\��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�a
������$�a�'4�a6T�`68��g��aRO Reading and writing booleans as `Integer` requires the number of bits to be 1.��b���bA> This is more useful when combined with the fixed array target���b$! for reading blocks of bit flags.��c�l�c��<�c���c6��c���c#����d struct Flags {���d
     a: bool,���d
     b: bool,���d
     c: bool,���d
     d: bool,�,�d���d���d%" let data: &[u8] = &[0b1011_0000];���e3����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();���gEB assert_eq!(flags, Flags { a: true, b: false, c: true, d: true });�<�g���������������hp$�h��������������h��|�h���h��<�h��,�i
�����4�h:$�h:<p����������j�D�j����������
������j��
t�j���j��<�k��,�k
��
���4�j4�j46��mW,�m����������'����n���|�mǛ�mٛD�m
����$�n�'4�n2$�m24�����������o�L�o����������
��'����p���t�oǛ�oٛD�o
��
��$�o�'4�o3�o35��rJ���
�������r���r��<�r���$�r���<�r��������������d$�rdf��sp$�s�����������������������q�aX������������s��|�s�����sO��<�s����,�t
��������4�sV$�sMO�t����҉��������������������u�D�u����������
������v�ˎt�u���v��<�v��,�v
�����
���4�v�,�vE�uEG�w����҉����������
����������xW,�x�����'������'����y��|�x�����x���D�x
�������$�y�'4�yM$�xDF�y����҉��������������������z�L�z������������
��'����z�ˎt�z���z��D�z
�����
��$�z�'4�z�,�{D�zDF�{����҉����������
����������|P���
�������|���|���T�|��$�|��<�|��������F$�|FH��|�D�|��������������}����|���}��<�}��,�}
��������4�}=T�}=?�~����҉����������������4�����҉������������������xL�������������'����������������D��
�������$���'4��@T�@B������҉��������������������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�������Ľ���������lDŽ������|܄����������������l��������Ԕ���������l�����������Ϻ�����ͅ����Ѻ��lڅ����������l������Ĉ��������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�Oij�	ˉ̉ω,͉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�׋+����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�������������8�'4�� ñ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�<��³-ij8�,ų$ʳ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�<LJχ-ч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����ŠNJ8$Ê%�\��<����	��������D������<��O����(Dʎ�����glԎ�
���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�����������������Ϩ����nM�h�^�"��̑����
�	�'�	��	�	�	�	�����t�������������L���|��
�	���
��̑�'4����\Ա��T���,��n��nprt���������������Ϩ����nM�h�^�"��������
�	�'�	��	�	�	�	�����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>();�<��������	��	�	�	Ы|����
$��3��	��	�	�	�����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);�<���\�������	�^�	�	�	�^�����;��'E�<�����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());�<���\�������	�^�	�	�	�������_��'i�<��������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);�<dz�$������	��	�	�	������|��
�	�
��$��%'���?���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�����	���	
�	�
$�����ܑ�������'f`[�h!C��	�	0����'���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��<���\�������	�^�	�	�	�����
�	�
�^n��'x�%<�����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>());�<Ǐ�,���������	���	
�	�
$�����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������Ϩ����nM�h�^�"����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������
��
�
�
�|��
�
�
����,��#$��R��
��
�
�
�������B��
�
��|�����
��
$�����,$�������
�

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

�
��
�,�����1���EB An unsigned type with a verified value for a fixed number of bits������
��
�
�
��|��������Ϩ����nM�h�^�"����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�����
�

�
����,�����
��
�
�
�����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��������Ϩ����nM�h�^�"����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};�����DŽ+( // 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��ڨ��
��
�
�
��|��������Ϩ����nM�h�^�"����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[]_P�������������������������Ϩ����nM�h�^�"��������
��'�����������t�������������L����|��
��
�����'4����\����T��b��bdfh����\�����������'���������	��������	L����|��
������'4���K,���,��HJLN����̟�����������Ϩ����nM�h�^�"��������
��'�����������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\�����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��3?��'<9 A limited unary reader which stops at the given maximum.��'���(74 Counts non-`STOP_BIT` values (which must be 0 or 1)���(41 until `STOP_BIT`, or until `MAXIMUM` is reached.���(;8 Returns the number of non-`STOP_BIT` bits, or `None` if���)" maximum is reached beforehand.��)�t�)ɗ<�)���)MJ use bitstream_io::{BitReader, BitRead, BigEndian, huffman::LimitedUnary};��*���*2/ let data: &[u8] = &[0b001_00000, 0b1111_1111];���*3����+&# // get 2 bits until the next 1 bit���+IF assert_eq!(r.read_huffman::<LimitedUnary<1, 5>>().unwrap(), Some(2));���,)& // but 5 bits in a row is our maximum���,FC assert_eq!(r.read_huffman::<LimitedUnary<1, 5>>().unwrap(), None);���--* // the remaining 8 bits are ok to be read���-85 assert_eq!(r.read::<8, u8>().unwrap(), 0b1111_1111);�<�-��-�<�-���-NK use bitstream_io::{BitWriter, BitWrite, BigEndian, huffman::LimitedUnary};��.���.5����/A> // writes 2 as a regular unary value which stops at the 1 bit���/<9 w.write_huffman::<LimitedUnary<1, 5>>(Some(2)).unwrap();���052 // writing values beyond the maximum does nothing���0=: w.write_huffman::<LimitedUnary<1, 5>>(Some(10)).unwrap();���0.+ // writes 5, 0 bits (which is our maximum)���196 w.write_huffman::<LimitedUnary<1, 5>>(None).unwrap();���1.+ // write some 1 bits to pad out the stream���2" w.write::<8, u8>(0b1111_1111);��2���2=: assert_eq!(w.into_writer(), &[0b001_00000, 0b1111_1111]);�<�2�d�3�
���������3����3����4��
O��X����PD�3P<�3 �3N�
���������3����3��US(�3O�
���������3����3�������\^��������3�
��
�,�3(�3P�
���������3����3����_�ji^`��������^�^��^��[�^���[����e�S������3�
��
�,�3���'	��������?e��.)���� �[��( �\�����"$������� ��
�,�(!�]����_�"$��������^�^��^��[�^���[����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ˏ��*�7�}�|����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ڂ���l@<
�����;=?A��<�9����	L��4��9����(G��q���	�����������B�����N�������_��������������^�^��^��[�^���[����e�S�����G���
�����,���4�ͺ��B? An error returned if performing math operations would overflow�B���y$���1��yj����� [��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);�<���!�������������e�]��� <��$�������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�����P:��
O�
�
2468���$�����
К�
�
�����<�����
К�
�
��	8y�����
�	�
�
�
��������C���Q�����
��
	�����
�

�
�������(&��j�
�
Ҏ�����*�tI���
 D��,����
�
��8z���j�
�
Ҏp���5���
��
��SU���
�

�
�����)��j�
�
Ҏ�������
G���
 ��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 ���ACt��
��
�
�
�������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��@(��@�
�
�
�І�A0��A��
�

�
P��
�
���B#X��B���
�

�
 ��B���C#X��C���
�

�
 ��C���D,h��D���
�

�
�K(��D���E,h��E���
�

�
�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 ���KMG���������������҉����������������@�������������
�����������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��@(��@�����Б�A0��A���
�S������B#X��B���
� ��B���C#X��C���
� ��C���D,h��D���
��K(��D���E,h��E���
��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 ���KMZ���������������҉������������������@�������������
�����������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��@(��@������A0��A���
�\������B#X��B����
� ��B���C#X��C����
� ��C���D,h��D����
��K(��D���E,h��E����
��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��@(��@���	��A0��A���
�o������B#X��B����
� ��B���C#X��C����
� ��C���D,h��D����
��K(��D���E,h��E����
��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��@(��@���0�в�A0��A���
��������B#X��B����
� ��B���C#X��C����
� ��C���D,h��D����
��K(��D���E,h��E����
��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�LJۼ(��
�����0���BP��BD�����H�������������'������������Ǜ���ٛ@���
���� �‰�'0�؉AP���AC��ۉ�����������������H�������Š �Ȋ��x������ȼ��8�����
����������(�����
� ������@������������������P��@(��@�����н�A0��A���
��������B#X��B����
� ��B���C#X��C����
� ��C���D,h��D����
��K(��D���E,h��E����
��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�LJ��(��
�����0���BP��BD�����H�������������'������������Ǜ���ٛ@���
���� �‰�'0�؉AP���AC��ۉ�����������������H�������Š �Ȋ��x������ȿ��8�����
����������(�����
� ������@������������������P��@(��@��������A0��A���
�e������B#X��B����
� ��B���C#X��C����
� ��C���D,h��D����
��K(��D���E,h��E����
��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�LJ��(��
�����0���BP��BD�����H�������������'������������Ǜ���ٛ@���
���� �‰�'0�؉AP���AC��ۉ�����������������H�������Š �Ȋ��x����������8�����
����������(�����
� ������@������������������P��@(��@��������A0��A���
��������B#X��B����
� ��B���C#X��C����
� ��C���D,h��D����
��K(��D���E,h��E����
��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�LJ��(��
�����0���BP��BD�����H�������������'������������Ǜ���ٛ@���
���� �‰�'0�؉AP���AC��ۉ�����������������H�������Š �Ȋ��x����������8�����
����������(�����
� ������@������������������P��@(��@�������A0��A���
�k������B#X��B���
� ��B���C#X��C���
� ��C���D,h��D���
��K(��D���E,h��E���
��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�LJ��(��
�����0���BP��BD�����H�������������'������������Ǜ���ٛ@���
���� �‰�'0�؉AP���AC��ۉ�����������������H�������Š �Ȋ��x����������8�����
����������(�����
� ������@������������������P��@(��@��������A0��A���
��������B#X��B����
� ��B���C#X��C����
� ��C���D,h��D����
��K(��D���E,h��E����
��K(��E���@6�����������������P��@(��@���/����A0��A���
��������B#X��Bߡ��
� ��B���C#X��Cߡ��
� ��C���D,h��Dߡ��
��K(��D���E,h��Eߡ��
��K(��E���@7�����������������P��@(��@��������A0��A���
�\������B#X��Bʥ��
� ��B���C#X��Cʥ��
� ��C���D,h��Dʥ��
��K(��D���E,h��Eʥ��
��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����f`[�h!C����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������[�O��� �����$���������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٣���`�]�������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�����Ҏ��������nM�h�^�"��)+-/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�������|�����r�+���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�գ�����|���亟�q��K��C����H$� ���	������x����<(���	������x��������DF�����������
��,��(�£	������x������_�EG��������^�^��^��[�^���[����e�S������£�
��,£��������.�FL����
6����(�<)���� ���	���(���	������%'�����������
�,��(���	�����_�%'��������^�^��^��[�^���[����e�S���������
�,���Ѽ�����2��Jd�����PR�xՄ�<)���� ���	���(���	������%'�����������
�,��(���	�����_�%'��������^�^��^��[�^���[����e�S���������
�,�����HE��E�L�E�]OE�GUE�yYE�eaE�TeE��jE�pE�zrE�wE�K|E�gE�׆E�U�E��E��E�(�E���E��E���E�@�E��E�@�E���E���E���E�U�E�N�E���E���E���E�^�E�g�E���E��E���E���E���E�b�E�~�E�>�E���E��E���E���E���E���E�o�E���E�ݻE�Z�E���E���E���E���E���E���E���E�s�E�K�E�`�E���E���E���E���E���E���E���E���E���E�M�E�n�E���E���E���E�a�E���E���E�V�E���E�n�E��E���E�e�E��E���E��E���E���E���E�V�E���E���E���E���E���E�s�E�7�E��E�u�E�D�E���E��E��E���E�#E��E��E��
E��E�>E�)E�E���E�
E��E��E��E�E���E�)E�
E��E��!E��"E��#E�J$E�ّE��$E�8%E� &E��,E�	PE���E�SE�UE��WE���E�QZE���E�IdE��eE�'hE�NiE��nE��sE��wE�E���E�[�E���E�ՔE��E�8�E�
�E�"�E��E���E���E�&�E���E�L�E���E���E���E�-�E���E���E���E���E���E���E���E���E��E��E��E�ȧE���E�J�E��E���E�t�E�/�E���E���E�L�E���E���E���E���E�I�E���E�y�E�ýE���E���E���E���E���E���E���E���E��E���E���E���E��E�W�E���E���E�>�E�@�E�H�E�6�E���E���E�3�E�M�E���E���E���E���E���E���E���E�a�E�=�E���E�k�E� �E���E���E�;�E���E���E�F�E���E���E�%�E���E�
E�fE��E�/E��E��E�pE�(E��E��E�UE���E��E��	E���E�L��E�E�hE���E���E�V�E��E���E���E���E�N�E�3�E�'�E�X�E���E���E���E���E���E���E�a�E���E���E�1�E�T�E�v�E���E�"�E���E��E�@�E���E�0�E���E�r�E�İE���E�6�E���E���E�U�E���E���E�@�E���E���E�K�E�{�E���E���E��E�k�E���E���E���E���E���E�+�E���E���E���E�G�E���E���E���E�R�E�I�E�3�E�]�E�f�E�ȇE���E���E���E�m�E�ދE��E�D�E�ԍE�f�E�V�E���E��E�y�E�ҕE��E���E�ߟE�j�E�P�E�h�E���E�٧E�R�E���E�K�E���E���E���E���E�ڗE�͵E���E�\�E���E���E�G�E��E�-�E���E�.�E�؎E���E�
�E�-�E� �E��E���E�J�E�a�E��yE��xE��vE�luE��rE��qE��mE��lE�lE�<kE��iE�9hE��fE��eE��cE�EbE���E���E�ܥE���E��E���E���E���E��E�ͬE��E���E���E�ѯE���E��E���E�[�E�δE��E�g�E�d�E���E���E�z�E�ܻE���E���E���E�s�E���E���E��E��E�ֽE��E���E�L��E�àE�T�E�
�E���E���E�L��E�ԕE���E�LХE�e�E���E���E�'�E�ϏE��E���E���E�c}E���E��|E��{E���E���E�2zE�FxE���E��wE�pvE��tE��E���E� fE���E��eE��dE�ʸE��E��bE�+\E���E��[E�YE��WE���E���E��VE�UE���E��SE���E���E��RE���E���E�zQE���E���E��PE�cOE���E���E�tNE���E�ҚE��ME���E���E�PJE�ZIE��E���E��GE���E�ιE�
EE�ODE��BE���E���E�BE�G@E���E�8?E���E���E�*>E���E���E��<E���E���E�'<E�,;E���E���E�=:E���E���E��9E�ĖE��E�?6E�I5E���E�أE��3E���E���E�(1E�m0E�\/E��E���E�ȼE�&E�%E�	%E��%E�&$E�f#E�m#E�%$E� E�EE�LE�t E��E��E��E��E��E��E��E�AE�CE��E��E�3E�5E��E��E�%E�'E�>E�lE��E��E��E�E��E�X�E��E�+�E�-�E���E���E���E���E���E�S�E���E���E���E�"�E�V�E�Z�E���E�J�E���E���E���E���E���E�*�E�V�E���E�B�E���E��E���E��E�@�E�t�E�x�E���E�h�E��E���E���E���E���E�I�E�u�E���E�a�E���E�1�E�ĶE��E��E�P�E�T�E���E�D�E�ݭE���E���E���E���E�%�E�Q�E�{�E�=�E�أE�
�E�O�E�|�E���E�ۘE�ߗE��E�ϓE�g�E�*�E�:�E�<�E�
�E���E�ۋE��E�ljE�b�E���E��E�-�E�XE��~E��}E��|E��vE��uE��tE�"tE�&sE�\rE�,lE�YkE��jE��iE��hE��gE��aE��`E�`E�N_E�R^E��]E�XWE��VE��UE��TE��SE�SE��>E��=E�>E��>E�E=E�K=E�d<E��;E��;E��1E��0E��0E��1E�?0E�E0E�o/E��.E��.E��,E��+E��+E��,E�v'E�@&E�F&E�g'E��E�E�E��E�vE��E��E�iE��E��E��E��E��E�$E�*E��E����������������	�	�	�	�
�
�
�
��`���2BitRead::read_count�BitRead::read_counted�\����]BitRead2::read�io::Read�BitRead::read_unsigned�_BitRead::read_signed�BitRead::read_signed_counted��O	io::Write�BitRead::read_bytes��@�(�YBitWrite::write_signed��2��{����X��BitRead2::read_in���������Ϩ�]�����Y�	�@�(�BitWrite::write_unsigned�������{��BitRead::read_var������Ϩ�P�@�BitWrite::write_var����������{�

BitRead::read���V���zϨ��PBitWrite::write_checked�BitWrite::write����������BitWrite::write_bytes���S���z�P��������������������������2�z����]��l������g����������Y�(��~���	crate::read::FromBitStream��crate::read�crate::write::ToBitStream�crate::write���	����9�	�����	�����	������	�std::str��0�$���std::str::FromStr��#���$��O���t�����#��$���������#�(�(��(�@�@�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����������������������������ˮ�,?x��?��9�g�^�9K�ŃG�;~X�!w�'�]�&����*����gk��M��m�� i�g�ek�P=�u�W��V��Di�.��
�0�@�I�a�2w2#�9N
�u�Ӈ���eI�$S-���Q�,���M��w��o�T�E�uG�rb*]��Hx���`��S<}��������c{
a��H��՛b�"M3�����8F�ߪ�o+�9��k�B��K�,y��H���r>��AP?V#�S���s01ec�|1�V��=j����6|<��+�IK�	���A݀Fc�l��?�f,��^"���������K��2��R�k���C̨���vmB��c�֩��-M��.�=��@X�����=�Ǹ�`1u�ێ�ڟ��ؔ�L8Eyfn~�k��#�U���Ԩ�%B
ϳn4�h�	:���H�ʖ���o�����q�ѯ�=��M׏�����lID���<��n�'
�-�]��6Gk����{"h�IH�).a�lŏܥ��{b�o����)��R���S��y���q7�8I}0�d��
mD+�x�Ȳ�`��"�]��T�\�G�$pb��)<�H����`�bb����}��}��1���	g��&��>ǰm��Y}r��mi0�ݬz&϶$>rA�����%T�( E��/g&e����]��+�����Z:
f�u8f���3tZ�EFurY�e�	�ǘ�{_�����
j̖Ur��V�|�d���f]��R�~u���%"\�_�E�&#z�k�+Es��rk�N��'���L���6����>`[��GY>�a��w�d�ψq9�PrHC}�kU�'�4�8rZȏ<������+Y�����K�&q[��Q}����k)��^��W+��g�h�X�N���j�)�Ϗj�:E����N��f}�T�^VGRD��U��.�	�tF'��
j�m�~%=�q����y,���%��<t��OJ��������guH��(��M6
��ټQ,T�Oܰ��,"e2w�z�ધ�<�N������
j9q�awz�s�U^ȣxjf�8���œ��w�
xp݂��r���QgY�u䱸l@ڴgs�)nt�Ѕ�5#E$�MR��:iؒ�;�G�@킭~�H�$�;ܺ[0���#���j�4&/~-�Q���3c�b��������'LV�Ù�`��/_�>�Lo�(�Զ=������F�zU����Ū���d/���E|�	.�$fM	���,��Y����EXv��
*?�V�j==�_�pe�GP�Y��d'h����ϭ�T�գ�H��d)L�ٿ,���yԳ�A��El<1��)�8���7o�u��Л:�Y2�m ��_K��������˿3.Sc2'��f���"��h�r6{������Ҽ��T�{����L�����̹*G�:�_ Ai��MZ���fȃ�:��Oo?ŤY'H�Þ�G�l@�S��f�{�J����(��X�{P�(�$�_<⻼^>��T	Y}�~f�_GE{�~�/L@�B_[�ZAB�<N�0��{JD�?�E��R]�G�Oȵ��۟��i^���v>��s��yKy����Y��#{�v�L�|^
!�s�H�&��;��^�W���L �}y2�q^[��}m(��'��iWȳ�
���k���J"��zgm����AIIekp.�JΕ���.f�A�=���}���K.�M������T��b~�)�+=$�,�2����u�ļF`yã��n�"Kا��M���~��ſ׋3��\�S�R8>�o��1e��Gu�8�g��uh����SqN�������޶K�=� �Ei8�#���;��#���w{9�i��<����K	���+լ�f��O��Ao�r9�u�q��K��,�����p/2
#��1E�k�ˬlZ��п(<�<…�
��]�#K�������8�G��
��oR��%�NE��fa�Ď�����'�T_�h�/����یK㾱�,�_~��pɁ%͊���dHD�F��:sVNaK[�� �bD���^&�E0*�/�1=�WAQ�׉CXu�v"�Q,G���N�z�զjIίG¢�I���f��ͭe�����]��&]��̪姑'&��- 
HW�:\�.��17U�6����…�"0��u�
ӱ���r%ai�`���Z��-w�W���I�h=�
�NR��鑇$��4�;�e&�����O68߆��6��S��W��g���
r�1
6�9�R��X|��=�b̬s�'��G�$)q	i
���D�A�5�*�l�Lh�Z�K� Qr)N��,���U���qş۠S���$#\B?�+�-U3���{l�"4nj���)UK�6���o���R*����4&�ʧ�;�2�������lD?�\�"lvG���+Qϩ82�q����fՃ��	IB��XC������ƚ���=��}x5\J������75r���+0�t�U�ֳgw������?-Ҡ�偃�@c�A���>`GM�NQs�,C�������1�4<R��S�7ꁼz�ġ�-?Z8�&��C\nuQ�fh�5�@Y�~;hi_Y��|X�&P�h
�Y]Q�Z��&���g�8OXE�|���O�����&5GZ2
��#��
q���y�ں��#��6�n����/h�@Q|E>�휏93�9�|�w�V'�/��d�&!��0+ZS*|��'^4ӫ-�(��M��]��դXgˉ��lL��w�]N]����ˇ�[Rb�����g5��Vn���d�R�����^���9=Xv�$vKi���O*+4�6��@�aUptD8k��;0����Wx�q� �ܕ,U%�ȫ@���s?�qDmw��5�]����>.�Ԛr��3��F�F��1G$E|��:�JX��{�d�S�~���@��>�Jor��L����;<�c#_�'"'�j�K�/:�a�@����5����������ʞ�丨B��hG8ԫ�@6�g5�T��ˆF!$;[I��M�2}b,��#*Q�����������=!�%�;�m�֨���z�[|_f���OnU�J[9��:��T�|��g�'������*n`$��,/A��ɍ٫<
�P����R:�X:@��m8D�4�=ƑVt��딵��Az�/�:�-)5.LU5@�:z�r�t��a�]u�U��
ݷ`��	��S�����73�s��T�b��'�5�h�,��mFU^d%ʳU��_�F�p,_
���	��Z\@;���i��'գ!q��{pάK���!�#��T�m��E����6 ��2c�ǣy���WA7��u�&Z��5�td�*�FT=s�4��s��*5c�|L�^O�Y���y��x��/�G��s|5�pAT��g�i��J���kt�\m+�b>�8'��g�+�z��.������Ə �^X�������;v�U#3R�o4?i�����J���z����9<����*�����MA�afPи䦢��>8!~�5�_am��0����b�uz[S��OW�~�R �_1ط�N��3'�)�`}�R:��S��w�Ƿ�h�a$P��+hK~�}� n'
`��(�v
y_�e,z/"*��D�:�ˣ��/PL�{@6ȒAѓK����}��2��x��躐�	:���n淇s��s��ݸK���]ق�Z��ZǝJ@i��.��l]Pc�vİJ�8>g�ڕ���qQ �tX�q��2�?1�`$� �>�mW
�!+�s�J��=r�f�!���n���漇5��h.��F*���x�/���V4����\ͻw�8Q�'�o^�4	j�̞J�w�ΐi���Nff(Q�o��X�=�&Q��D�1b>9n]�X]���'%�m"���t3�4a9>b��z�m���7�t��r���W�h���p
m�߀�y�Y	9�5�U��%b(�n/9k�jd���4�=Z�N���V)�|�:���^G[�|	$���g�i�Dc^
��_����+�B2o:E�/�r�e�D��u��?ң��&Z��1a�wݗ+Inv���ˍ���X^���11p[�}�c�.y����|�'u'��f����IY�^��Ȫ�dK���5�������C�k<C9QW]r��aV���"����!�ط������s$t�
O*'�r&%��T�"5>���Aɘ���K^��3'�
i�����#)�Y������9o�����p�s]˗�.yv��u�
�f���3��2�+O�!�����I0NDC�i��i��Q9s�5�v>D:g�5��� ��}�w���k<���# �������}U{��l��/�f��BH�z�����_^�O������C�ދR(�@Aw��x$G�i�Έ1��?a0�z�C�z6Jp�!ݖK�����s�K+dJ�:�2��$���H��mE�}�۴���-�_�9�z.�B��hڄ�����
I>>{��ԬU^�Q�1ߧ^�f�~ܑ1��
ͮ�U�Ǜ7�}��;Q�[�^o�y��
��(p��͡�l�?�X3����z/y>����-Al< 	1�ςґ��-YK�XV�U�.���~�汞	�
z�Yu�l�o��d"���A���q�J��"�7�И�'���pC�(ᗛ�,�$�e�Wg�<��+�/edH�d
�n�uw����x
��*�;SB0��Ȟ��5�.�����hf�a�6M`S;�^8�aDֵ��bp�`iٞ\�|{Nri�˾'���yLϦ�cJO|q������~��/
c�g�XWgC���,O%�8_s�\N;r����! Q;�Xa/�=I�m-¼{$���ӕ�~�dry��&ts�	h$�]u�G�t2�
M�	�
N�D��g��@j�9m4Z�:V���T�)J��s��p%�s�WU�|b$�Ŏ�x�}�v�l���k{���olY�hE)��x��|�o��!��t������E劥���M_�/�Tj~˴*��{,��N+����nuS, D��?�P��Ϫ�e'����`۠�i��Fǖ,���T�Sw���L�Eg(���V���q��o�|hI;��#��)fI�r$A"����՞ȱ�I�w������r�%�B-�T�lI��'�)�9�ڣx&�Us�h.���s'}�Я�[,IZ�2��1�	W�}�$v�$3���g�����!
�8����_Yi~�ehϿ ��в �.�l#\�@�|��� �p�I$޼�qŷF�>Mx�dzI�Cbe� �����e����KA[Nf���&�ϗc��|u^�� �<�j���j��}� �&A`E'ªC1O��fR_��wR>�aO95���YɈ*K���ی����\�V$��TQ�^�sg�RY�K��ay�X��%[�h!��
�m&m�$��p��`g>��CG�-.��C�r�q�BxFSa�h����@�ϳ���5̖�$t�;�dG5u�2��U|�,�.�_��)�yk�Su?r+����P�l��&s�W�d�h�� �:�/n��|~Uy���V���Bޫ�$]Q��B3	p���Ƈ��/�
K��R��<h�J�&���.v#�����L�G�P%���`����g5�K��c�r�V��Ro��4iLn���D[�o�}���@��NN1#�g��VU䳐z�b�x��U<���!f��S6:��7n��ͭl=�v�����C�}���6��x����ʒ�6�<��"���@�?t}(9KU<�݊�pޯg�K%�e]��O�~;�
�l}�1b/p�P���O��CJ�z�PL�� }a��(x^��㣫�s���~;�)����J@�i�su�f������V
=bPS�������=��ҏ�&��R&���@�
���	X���K�H��5A����;(��6���	:�]��o�ʟ#���^�2�1��ak�b�������
#[����q��Q��/^��G��N3��+V#]�Έw��S/��%�a��а����-��J����g`��4
6�*���\��l4�ʢ9��+��|��L�eԩ������/I�*�c�hn���J�l3�T��H�x֢��VjP6/��LBzC�z`�/�%8�}���u���<��of�]s���o�4$��1!`;�f��s���]-��r�:���f�\x�e��!�'�)Ê�3$T���20�B`�l�Igo����nk3_����*�dX�}�7��������$}H3�ܚH%pg/����:�{^�·l���vfm���j�̜�$�Sd;Y�;�
_��Pt
��^�?-	�g�<�sg�,������h�����G�ԕ�ě9�nw�ې�G�<YB�J9 ��.�")���,3����t"���O�rh5Γ��Y��J�ݨ+Dg���E�.�n<�1���ud�ɵ�&������]X4o8���]�[���}��\#��2��0�Q�2St̮zI�'�	�R\���y�p�D��6Aא��"�]���N[�]��(�h!�vYFR9��i4�.�38�{V�A�-wCj0�=b��%�Q>Q%e'#a�}���se�H>8㧻,L�GzÁDNa��{,S��M��^�R|�	��.i���SOf��h�0p�S�T;O��BP���n����M�׳V�!a �����Z]e�^�A�Q��^=\�#�A"�rbF	��=�؅��8��z���N9|Q���
�ӴB�
B��6H?�����&UDV���¹�H�(��B�t�q��AbQOs~��g��"��f0^��P7�3͝�/Q��cZ�ZV��Ka�av��܈z�;�]:j�أ��!Q�W�2�/ߕ��D1ho���Z=�00�{x��e�Uaj��X"\�|�zf�,��3V�1}{�kX�C�Ǐ
ҿ_��a�W`������ �Ֆ�4�=S�{��n/�H�|�C��zkVZ��շLao@����&$�C�����y�W��S��K�!��ɑ�73�sn�%������sEDH�T
��K�h��Ķ�w�p"i�4��#9��#]�qf'"r܊�!���U]��€�F[)~_=��5��dŦ��k���,��F�
+MC�C�n_j/
�������$Oхe�u�w��=B�j��
H(��Ҍ
�^���Z���Nn����w�jl�Nk��g����^��05aI�/D‚�q)"R�����f�_���E����p������lb��p�a|&���F4����<�z���]'Y枡g=B�.�״��ř�2�Ul�M�$w�JS;����_�f�@���j=��7���èe3��e�4�h	�OUW1�c�� j��&�k%�9���#Z�G�F�ѓM�-�w�ݥ���@M�=�"ӆ�ϙgJR��Kl����S�4�PO�S��y��!m  hI�ծH5��Ww���|T����|���]�E����S�el�Z�G��CT76��p�6]��T�2*��crr��L��
�馗�g�G�a�$Ne�[Y�����cWX�v�I�y#,d����/���[�uG�A�A"����u	nuQvT�ʉ�⋎�o��ٽ�r)�N:bA3TOFMF���JvA�`c����}�̓o�4��0�XiG�P�]��7Iu�1 7�k5z�b��1K�}1�(ٶ�HM�t�z��}WU�����M��ly����vzBy��8G��n:��vRJ�����Ю��{��4����E�#�J�x��0vH���^��F�CR����������q�k�uH�)lɎt*߽�6���5��\bm��;0���f����H�8�OxC�8:����r|j1m���Q��[��xd�ᯟ��t7�d�r-V!�})ؒ����~�1��#��֏w�� ��ڎ�y�-�h�)�,�rZ
���@�.���)#�[����Q����%}ywU����ybj^�M����p/�����s�ΐYc�s(���0��ABU�v�L$�X�t�i,U��r�Y���,�r[	*����=)���L!8�o��&	���
4�V:�
v6�8���ʧ�~��ُ%����v2���P�}�B$�U*�1O�kK]=w��iG"����?8Ф���ٍP�<�l���be7`�fD���4""������?�����d��	l����r�{�
4w��/N ��|o9!��f ��v�EU׳�n'�]
����{�2<+��e��ͮ�������CI~E��hۇ��y��#Ց,/�)l�������®�o�Jt�v�f�����H����t�g0���ڝ[g�1)=�)��zU�y�)S�0�B��QD��Nr�]���眽���S"���P�O�f��M1�]e�¬Q@�\��%pK5��K�q�h��O#e�r�w%�
�����[�?�0�Z���	KΤ �8I;\+h�ٶ�B�hu��{YP"��u^krV�א)�����p4�TN�};1����,o�{��=\^_�.c����'�DL�)HZ�{�0h	���t��+JS�R@��j~*�*E��67݆'.�D^�i����-��o�b|Ǧ�z@���,�:�P�3�E��	�7�8` �sa�iM�|}�d&����vd`�hj
2C��*��2���}���X�w���ҁ�������n���8J�#Lnk��ڳޢ�mB%a��\*@l��N(}��톜�#d��8ѺBF�r̢��8���dRh��/u+��R5�G��n�k�((��j�w�N˩�&�IpRE2׏�Z����ڣ׫kN��xa�:�o�l�AÆ��K],��]�=&X@�2rF�^DѱDll��b}��aM��4��	P�;L)^Ԏ�Q4gV�]�?��BYgvG���x�bA�(fLD�YG�fe������%y��v���������D��p�J��\��d���:�&���(��d��D�jsP���K�I�_�E�,IB�a&e�W��w�T=F�C�oxL�\'M�,��[����/�+S��yB�qR����f�:X�Dt���@V6.��Вlz��.�5���+�3>�>�p��6"[�i%}|�YI�FD�Z�Ca�\���dU�e��,D����2����IP4��O!����Pw<w��V�h��Lx6�~����߿�b���гc�&�m�٥�v[�O8���7q3񂸜|^�9����ꊩ.�^<_[/�n�}aŘ|t&C�~(& ����G���6�m��vے)
FW�OLK�r����G�>�`\�]��8�B���oQ���������!�>ϼ���C3�"��~?�>�^���`HB�^x���wd9"�}�Ou��>'7H9���q���Dśگ��z�ob��RV'�%Ho�W�$���`��$��ñ�wҹ���=�����^�̃	�PK�����$��HX���z����mb_�P ��Wh��qh��W,�F ��y��=�����-'�G�u4Tdm
�B>�т�G��L$(Y7ԢI֊6���X3�x���6�y�6�dl���]�A�]gK��+�L��#�����?*/��E�a{pU�^�;`6�B�몜���aA��D�K|�w�i�Eg�2�W��o�n!*�X�#kv��f��=�Ǫ����������)Ns$*�w>J��,j��l�FnX��P	/�Vo�Q�Mf� J��w��t���8�eY�`��&F��O1���,�/���'$��gʺ�'gJ�_�3�$'n1�F��=t}j%S6�UC7�*�a��]8Ԇ�zyq���SjHLY U�E�_�ɋF�U�����~�H��?V�Wm�-��v�㭌��.�Mht�׉�ε�֭�-�21S�롻V�^��t����8F�àL��?�S]|���	"~r�� ف<��[��}�h�.�5�:)��g�g$f�8�Xb�x|gM�Um�"6�&Z���H�9�
N֑Sِ�����U����Aݴ�4
��q?W�q��yU���R��'�0���r�䈶�!��e��Z��R�Z�� �L�w�m��q��}�,#�ʞD'���D�!��X�9*a�*�͎��Q��xѶ���S��_�w��^[�6�{���lWK�d�p�;.��B��2�kWX��_ G/̘�֑�7�8�2��"�����p!�0�	�Xnm�Ãza��9�b]����D�z~{lm��/��իQ9U���^��ɐ5��9�u�Q1�� C�4;`�I3d����zz��p�@-:��jb�}���	ta��`*(�֬W!D�sڒITi=�{��#6A5~
�t�/c<K��&^����8��T�`�R���v=�J�E�/����*��ǶI���okl�_�HS�z���?�͛��nƑ�fC��"��E<��x��8sv�zxs��B��'C�w崌�܍�Ta��l^T�l����H1����1�t����@��eACN���.(Kʬ؂�ӣ�2>��tɟ�;�}�-[s[�.����B���,�,�摒��X`"���#�O�(�O�"�>������h6�M�������w���^��~/;p͡є�4�\����ހ2&�vT�E	���3pJ34H/MZG�~%�:�
M��G�!Z�ZMټ��O@�l@�U`����#�6���s2�trBA*��w�}Kj.���3={�ܭm�u�c�؟t���b%%噾1�e�Z���P�mˀq��a�܅C��
]�ģO�i5R�dI|�C�F�F�1���mH�Bd[�1óhiO3i�Ӡx玆ּC��i%v�����it��g��_�Q�+8�3OA!y�|v�X�B�	�@��?���O}�H��?�L6�e�ؒZh�{z�w�L�m~Y���;��_;e��,��!��К���c�/*����u���_M��e��Da��|!)O)9�!�J����O��n6T��K�t0��Q!�{v����J��	<0��&t��ڝ<3C6+3����@om��2�������Ie4���vُ�
��%�����d�����S֓bǏ�P�͜˴VM���/�<���-.�CVF��"Q��.���������
�z���CUd[�(P�j�S;����օ��x�/���H�}��5ǃ�3�H�U;��	UD�1&F
�
��ֈIo�l͑jD t�hY�����Ts�>V��9��*�`Ѧ���o��^M<��p(����.Ơ?������O���=�XDA�ɛt������oX*�v�atR�������vPf����3Rb�Z�R!�5�W-	ܘ��C��N*J�M;�����@�c[��u�.�[�s�
K����@���X���"b��Z�d/覈݁Y��=�4{lCnd�@�����/�)��{-�ֻ��
0^z��!������S��w���A���S��SUBmN�]��"���h���Lr������*�#��c%t��5�15:
�קQ%��&��ѹ�"Hv@�Ҡ;��>;��O��@�KJ�HB�
�U�wa�.��JzIˤ��x��h��^��������c*=�n��K�#��h��^seF�}�
2�����;
�l⳥kd�?�/��5���Y7��PF:-�V�s����r�]�&�%퉈iY�K�3/+�����H�[E�����m��8^,�$ݙkn��2q�h��e�Y����zl&M���?�)ڗ,��k�ά��Z�f\��Ҁ�Ib,����,0�����K��8�_4���%C�n]q�@f
z�г�!�)|���<�+/����ۨw����޸��Rx.f��%��V�fL�D|Ll�hF�K��%�����s拋���6�%�-Cڼ��h�47���Ϗ%�0@ޅj	�NB4u�&���opFP�"��a+��|��`P��x��w���s�q�&Dx	Ḧ���&�O� �g(C�G�5��q�D:/���0Ow�3E��.���í��<eTw���u��� �G�)E�$^j��<i��kV�Ḍ�3r��Gol��;�zŐ��>+���C�
	���Ľ�ϚЉpӾ���^08��[����d9�$דLgF��zg6E�@$P�3^�L�$���r�,;���!v�#=5W��!��Q��oϕ�S�XuB��&��rd`�v�����eKM�����X�� =���͂����:A+�!H@�,/��9�+=��|�)m͞�\�]�9�#�Z��g�������VRO���<�2�܃D��R���u^���1�����(ρ�]Hů��.�
��PrZ�DO�˖񙗳"4��*��^���e�Q3��I6b����d�s�u���-uj���Ua>��V�N�����&�HE�S��w��6�@��{�\b�zeFB��]��v��H�~�7c��
��� �&����'����1�
���hc�Rm
���>vU޾�O���S����Tr��,��j�+�ޜE!(j��ķ�x�42����{`M�`�gr��M���+>�y�Wyh;�e(��"
)�>=�%�Uj�3�D���,b��̧{U������n�Ԝ��	�Q�Q������9Ԛ;<���.�5�D|��!k�)}��'s-���G�O[B
��
�hq"�>g蕬�KG�'��Kh�Q6
�Q�����z@Q<la/i&�Fg�_i������Yq���U��F^��a��x�o�i����cb��u8����tN&��@A�tX���`y)�=����F�L�t��8x�����(@s^`�e�5,�k�(</�"��1�z���PV�����&B��\�/+U��B�����@�H�~6} ����{�8m�>����a�M
"�`(�֐
�vj��u�`�0e"�	#C��r�hhJ^�<�Y�v�[�jRO��r��n��i	�����Q�2�>�4����M����y?�e�QbA8CHƖ�6K����7���6�&;81��e��Qs?D��̛#���������]�:�S�%>.�����!�x9t�`o��4�7���<DP��-s�BЫi��\}e[�<���07�杞i�Ԧ,g��1|�o͒�Qh�4�'�{��Z�5��d��0*r�%�MH�@���$�z� %ҋ/��>�(Q��L���ҟ�쪕���߂	��X�In�Y>��Uަ���-�w�V�{�8��p�l�u��|<kD"��J���t�2�N*.�=�	�>�'���&���8�q5���w�ۦe��zJ\�m����j#�i��Iŝ!n+w���B �`�&�	�>7,��fG��J:�m�.�hjYq�͑{CrG \tˇ���"X��6�x$�a䂎`�$byx��*k�:���Kd)I�x=�R'�y������ǩ�%g�P��1����B��_����u
G�%G�/�(uBVS�`�A���F�
��b4�"�̾e$Bds�	RPk踅��Hh_�@gr���4�ɿ."��^�ʉ�נ�GYYϰh%�)�-6��a%p~�b�-�A���P�v�[�D��צ���s��ζywL�g�n�wk�"<$,	Bm���������RA��k5�I��)�V(z�Й��V܄�8����h�`�zEP�AZ⌹��Cp���h�Fd3
Z��h�X̷��ܓ����+�;��A�ٸ���$�֌�ס�*(J&�%&�P>A��.� �H�ڹ�/�
�ߤ����5�Z$�t�`18��Ð#ik3mk�*��R'ϩ�5/7�E����RQ���������F�6�j/Y�V1S�A�e�����hۇq�%�kE�����'rS<#F�<G�g_�'�hY��h.b����'ra���T�'�ɪ������n+�
u�H#�~&�昅ʊ��b�~<��:���Gƙ������MM@ZD$�{B�s�I�$j�[7�r�������kh��gL�7V�o
Xճ%��^�1*�E��%9񸡔L�n��5L%�3����_;zy�c��zp������4׫��\a��|�(�%�/0`�<#�%
p<�l��N�s�ja6@qw��ʋ9�_�B�L�{<�ئ
�s�݀�=�Xw�����ѡZ���Y�U��J}�H����ed�B+���H�s9�A��%�<��ĺ���b=L#���qo���q�m/2Em�"^��q���Q:���;`����g�AfR:�|'��m�ܹ��`�8�;��X����t����w�r���<��r�IԶ����B4b����k̉yW!�BЖ��#��uS���cK�i��o�1́~�(5 ���a����U�CvRs�V��y���f�v�H����o%R�y�i�Yk5�NDS�"(
W��*�tr��
�.�)�T^��v�-�GK�0�J���T�f+<���k��:��<T�ž��P%,���Z�r�1�2?�5m$
��D��O5kO�i��o�̡�q�)�_}���
�8��{K�اIa�������ĵ����6MclT?IK��*
~0�^�[���'�8-���}M|����>�rһ�>��;��#ë0�����*G|i�7���/�!�յgV�b�w����^c��B�����"�ZC�X�߆_^��]q�o��3w�`g^u溚)S+TN�m�����1�����625��|�du�F4s�2h���y�T��k�
�� �*'7�v�x]�r��X
=O���w!Ň��|~���qxP GB��gp,��_௑��2y���G�k<���*�Ŏo�Z��j�n�v)��p�mt�P�ʘ(��<`�I�|i��jt�����s�j�{ﲻO��
�= 7�F-�f�h���
O�fC�"�1�+K��z�`�ɢg�P�����,��i~�q��V�t;<���L�>�d�Z�c�qF$}�P�����E�=>L���a���˱��	i��Q#����iv����g�bf?��s�ٽ��N)��ٜXY��qܖ��*�0@�Hn?��d��Q��o����{|4d��Mvcg�LƩ_�d�s90E�Pafdz�Q���y�7�l)N�����W��Г�`r�
�p�;v�:E�gU&��+�l-�������Z�v=�s�����+L�,ҫ�Dy�t9�~��I�OE�;dJ��X����;q|�o����@+��	>+��k�Y��$������4��#j�S���`��hKm��%�JY����k��+������U`*=q�O(l=*6q���iSIN�����.{)�2y���g���vg7��x�f�#�YI6d��6���o[L�gU4�# �0�����Q��/�X1�y*���l�Tu�[�1V��`$�����vu�>�f�[�ۇ��������-�~�W���8yKA���rB����&QL�,u���QY�#����h����N��� �l�������uZ���Ӧ`�������XS���k�2�}�q0��O�.��LUQz�@�׆9?���u�?RK��>���G��~��������h�G`t�����V�5������ޚ��^C�5_/�YTzdR��#�c��V�=��:�k_ͷ���!("�!�ߘ�`ݞ1
:�+
�����ň7���5�k��LK�jXd�߉��W�h�4v���j[���i�������!�EJ�1S4�8Q��6��4����kY��O��W�@������|S/'�w�a9|D�E��_r��Ff���+R��#w��#"�ud�����Rm���	g�I���^3�l26�ꃋ�ݚd����y!�Ŀ�$6�/M��]�x�B!L<s`,���M������$���1(l�(�aSa͘�B����d����tQ��YӺܰ����#I�^��Ɔ
(�Ӭf�)�c�v��q�!v|�4�<9y�Ҝ<g��\	M�^{O-�v�z���Ko���~,���q�M|�䪑���`L�B�J�MDJ�E�Yػ��@��{<+�5(��u���?�a��e��z&x@ GV	��tl�O6`��WI�7�J+�T��Y �:\f�Q�{�O��R߈1�ILq��m�ȸE!6i���z���+^��k�@��0������u�e���G��~Z�>��:���f���M��!����C����Qsc\���Tb�؞��g��1-�z��}gtS�TYE�b�� �p
B�~d/��N9���vO�lJ��iH��M�e�%����!S�x̙�oWc�U	ѶT�*2��ZUy��J�����͘�|���9óL��+�������V�޴��
u�:��!k4���X��*5NJ{/�Zv�a�\��Cu)}�!�_Y���A�~?ʹ�2{��a���П��q����Q3Gp
�7X���������t�2[=j��^,���̕��?8����adJ�2`Q��E@��O����"ن�}MVS��T�0*�+��m���3-��1"'���2g��r�6�*I�����طz?��甓�Tc�
œ����S�
���������(�x�9�H��T�u�ׯa��ع�Jr�rǹH�JZP�x���\��1����D��q�8t<��k.e�&�ů�2���1kG���Q����s�{wB�yJ��	�!�����I�Mqy����k�6ևx[�Ϗ�q� 9��>��"�]��9�鑚N�
�z~K��Kw���G����9QNU/k�_k�h�$-
��\�����ӊ�7���q�i4�o,�WӳFx�Tw���F���+o���8GLo���T����z$�b�0mX�П:-�P����#ܥ�(��`�y!�;��K�1l[� ��E�*�.ͳ�Nn�+`$�[�!Ȓ����8�Z��y���\)祅@�� ��ABSèAO\@��+J#0N�,Z������wA�Y�KG�3Z��x��$t���9�������C���ܒ�0�#h�J�7���]����R>��{	3����1F�A���	�C��(3�Uj[����|$����Y��)s���}r�4����zv+��c����}î�}7y�K�N���S9��^B?��4�����uZ��=F��>?��1�\���
{���4"l��#�i�L\���E5��걥l�D�
aSNg�R�L����¢a�%[/��ؤ�lph�5���հ5��c\3
�ྑ�'N�R�J�K���f�[�G�Ɯ��yAPM��,q�+h5'���|�\�南��O��ф��A؍�Kqa������nM5zz�tl�)N�k�����쩏b�M�,�&�QA 82ҫ���T5���^�e���w��џ�P#����,�"�s����) W'�K�9�(\\����+�ʟX���;�"�7b@l�Y�G�5yԊ8?$Gm,�'�AS���|�(H�YF_�,6׃Q!�9��U��qF�u� k�؉h�"��o��[J@(t��A��v%BU��|��-��8_x��o=�H7��nxʒ ��Q�,��mL]�nj�ƪ�!Ui����yԓ�i��M�s��s��[S�P"0�Lb	4
�O�)�l1e~i��n��$��j@|Z�X_��2n8X�B��U`	�t'ޛ	�۳4�5�:Cj�vTポ��x�@�i챐��h:�er»ah�ϕ:��/�E����t�tR�^j��nEN#���{�]�?F�d��$f}.0���t������lP%S��9W@�� 1�%f.[�P�W� S���NY�D������-��<U�EA���.���#�D]Ѕ���mB�M�o$��0Ӡ�v�A�����H�{�=5��� �ˠ	*���qI�N��:
z=9�֌w�xZ��QB͵�G+�yH���(̼�7["�}û�P���˳����7w�1����`����i����,�Jm R69���

����>ذA����o���se=3��hYҙ��]/t���#��krx��|ys�,�`��$8�������6��eD<Ԛ����!��R��a9��ET������>�V��_���/�^O�pn8��E���B�7LNp���t$-l���r�V�8Q��+�8���y{@x{=.M�#����X��@K+��M~w��'��!��v�\,B�
���|���/�SQܝ�V�n�m�d�7̈́xdZq�\7�g^2�>�ƘQ�_z�w ��}����1�nbHf������m�,S$�_}[ڶŶ��$
���d+�|��t��V9W�)���e!�H���w�-�����U/�j��*�T��d#"Z2�а!�άG�-�Yd�H����\���s��3@wf2.4����/XV~�i�0`����%�C$�s�л�SA� �pӔ�޶��>67[n��S��q�.�BɳR�[Vl�I?�:��h�k��Z�w%����Gs3�tSFnϠ㮪ٰ��x�K#��͝7���L�����)(�7��6�������:)�~+��Z�"����RO�V��V �?�E
_��\�n��퀡}��N
~n�F��i��p������q{x9�f�D���"�����q^�`!.���|^�Й�[�Nפ��Sڮ���l��3;�b�^�q#܇�Qd�i�F ��6,��&��J�:�܃W�NB�Yd5�D������V�&���.�䰱��I��s2Q����²^�T
��!�憔:ſ/���*ԛ�s�ל�p�QI�8[�w]p��Q`Hzvgu�S{�
!�^=�_����z��$�q����s��p1�]4�+�(S�%E{�*�De\͝�_���R���Y�o�Nop�+~�B�ț�@D/'����L���o�ԓ^Ɩ
�Bs�I��a>#��*]ZRl2y<�K�ްt)��̲�P�|� TC
2ͅ^J/�*@�7ڍw�9x����N���HS�sih{m�%��Vؾ����؆ڌ��o+O}r��[g��11�a$��r�pچ�eŒ�Y���O�V��@���{UΦ�^����vޭ�'�+"áz��L�_�-)���d4u\qS"�P^"��
�1�F�^g�ӻ���$������j�U�����Fhf[m��<�
EP�MEA���*l��>?4�,/�uh��G�
��%JW��� О��ţD9ǻM�a�3�|�՚��Y}aA�N_�g��|YIƾ.F�ۏ��2ZRo,W�_��q{]�3n[�щ����&�ϵ�Ξ��D��@��@�u���\��HjH�+��E�N�6!�rv�[O���s�U
H2��N���xt�"�c���d~(��D&���oF��$�O�8��z�H\�B��-���$�zR��
ͬ
��t�����
_8Ab�(g��\�����ڿ	���h����<*]�������\()Q��i4WE�it�rCš�IߝU��h���)O�~��M����J^/� ��c�O��2U�'����5���E��7�U^C�ߦ��zݼ0֣Y{����Fر�
�
A��
ֹ�s���u)�Z�-yi�T<c�ҏ=d�^ �����膻|I	�;	�-�x�p%y�p��$e����)��ޜ4�fN�u���`�}{��%���is�;@�&�{A�_���M~46S���,b��F��ZK�fHo��,j�5[؂����D����:o����1�.NZ]���z��gį�C��3͝�1�>����|�?+燊
,s!��,ʈ����j��b��F��J�"c+�y�̗񃮇y;�#����P-z�M��q�5h��������n��:���c�)_�����j���=���Y��%t�Q{~��vN���n��j��4�Q[�+#yR�,+�GKT���^H�D��)�d>ʿ�@���T�l>�+�!%���"`lK{�\L]}ƥ�0φ/�Z�����a�Ӏ8�K$�?������ŨӠm��Q#u&���lꍀm�hս�SU7^T|]�1�J����-C!�rf�n5@�
���;
ڠ�:�GA��q+L�{&&�)�&����>ab�n@e"��8��?��D����޸�q��t��8���o�0]\���uÿ�b����*|����0E�r�A����8����'@w
j�y��/��s�S��O6���h[��b�kP\J��ԟ-J[չ���&a��0����ɍ6�B�V^��e���W��H�
� Gy��)��ñ/ī�(��OΝ���̤�i*�e ���n��:�1��5.�#G=�W0 
�Z��VH2W�8G�:��8��m�	*x�CtP�!.Ǚ�堋���K]��>?C*�X@��:��ʶ	i�����uw��cD���ܾ$��|�ᴮ���'�'�۶U,����*G��xXs�J�y�*�(*���'PLV��"�8�-.ɘ%kVa\�o��V-@N	���岺zؔӶ�7�h{����ZG���1ާu&�a�q���0��-������S:��1d�c+4hV��N���F��	�Y+���+�xF����Ռ�ٟRgb{dC01L�8�ܑ�z?�L�}m�"�p��x���FEw<�j�7�w2���3�6���^��0�u��W��&�V�|Ap���$����N������j�$��g(�W4r���_G�gE���Ő�4Kڤ�f[��;�یu]�
CE$AVD���P6��ϐ~����!4NzK���s5)7T�Yc���$�b�6�P�$n�&]��W3U4jZ�_~�
-��ʈ%�G�%])��A�'�Rr\���ǻ��r�;<9�5+n�Խ�!"���}�d��YCAH���D_�L:6:L��H���
�)�N+)E^��귯��;�(F6ܡq֔t�����$�nMo�$�$���Ku���h{s�a��A܌l$C��r��(��Uar����ut�g�>�R�CHI&ê�1ƋN@3�3T����]e ����@G|�AG�8���"x�De	k��e{/6,
~l>h�! �p��QR�����x�;_�T����������% ���
e�@�Uh��8��z�Ӓ/�� �*���׷0��p���l�	`~��+U�z���M�մ+U���%�:b�M���w1�]��%�p#���ª~�"�ܒʒ5��'X��a;S�|(�ET�_t8䣐��@D��}�%.O[-�D����SѮ�k���Je��w�����A�����{��,4�����8�^3Y,L�Є0{	���4I �e��d�B��2�y��:��0�;h�'�8Q�9�����U?��C�J�$�����.<:�Os�a�����|�t6h��
!-;n���+'�6��-��l��E�oe̍_�.���2����t����?�C������~�d|h�����P�A�	D��Or`���? u�3"�Ze�B}I�.{d)���b���@����%Ot���Vg@On�j63�W��6�m�SW1����+V`*I0�Ek�]7��?��v��=h�,�I¡��aT
v�~�����0

�B��Ő�ޛM&rR�S�=�\�Lp偕� K�_�P����':x�2�L��^��G��׀I8�}A��.L�Tò3��2���Vu��{�7��)^oV)B�h���񖇀j(�����m�6���G��g�r<A9V"ڿ=�� 5O�͏��{�����.���cmA�϶���F��K1z�rōN$}����O�Sl��&⬿�
L�����
��[�қ˭֌L;����g�;�j\�u��jͅ�c����&#D@��9{y���QQזFU-�iV��P	�'���豲���S�o���{� 
�/�~>\��1��2K'm�_�ԩ:2s<�t�Oܟ7U`�JT��&����k�8���'�qY�*�=��7D��4s��c�j��\�2�b}��B�6	=Bwr�D"Kr_��+��%�A{��`D �=�"�9),?��Pf^pj,�����NY�Z���� A���V�jp��=Ыs���s����nvv�qV*��Ҥ�e�����Lc��;*w�o���%��zoυykA'mJk��Laz<��V�g�n�%��ӗ���l��T�=���٪IR�@�t~r�3J��Ia(|%�Y)`徬K������b��uh5�#����Û�Ib�1a�_L������!�A�a��R�Qg��s1����D��kk�n[LB����6}����ĺ,��}Lj/!�)��0#��Hul$	�o�!���D;��"�
�)��R�X�Ϸ�̖�ko��Lu�����mrf�y
��Gן�bJ)?Ĵ=���o������*q�M�s��r�t���l�"�M�	3&�����SO��~.Oa�r~b�vA�'\�R1�o`/W#)�P�$�~���ӝ��`'D~�QO�:a�'<�����נ ������-���[���x/O�ր���w��G�/�dL�Mk@1去y�����Gx��F�զ'����9c]���$0�K��8O��^�`>J�W��-����Q�/m$�M��E��,.��9Ee���v.'��ioJQL���ȷk� #��=��ͫ�`ͳ���4[��*���.�hR��A��4�	u�%Tɪ�s�K��9���epA6g
�h/_�s�jB#+�6'U/D��X��9P��F2u���L;�u�Ly��R/��6�t��G��{]���*޴���w;K��]5�`���Y���������	�GR"��~P[|��Zm.�:��϶3&�k��:����><���������W{�ɰ�vE�2~�,�&?�����2�����y�g�=�3�"�m)���8e.[���CV�1�)�ei��ְ����:t��4�f���8���؆�x���$�l�	7�~���N���MmK� W/sD�%�]o!Mjl�g>��T�M	��x�8�+@5<{���'����ZJ���m��Uu����wЎ���ʪX�ܷ��:�z1�>��t�����S掿���jw�uE/3i�Q����������'�v�|C���N�C�&�PN��.�F��4}<;eMu0M+����L��9�PƋ�]�����VJ��؄�{(���o�1��\ ��i8V��6Ƶ�1�.�s/�_�*9�>�FN�M��������j�(_�����������W(|0�C��j�:�F�"�����s�!=f̷�Q����w�#������~�����N#'Q!b.o�����舽[��`�U{Y�1�k驅3%���'�������k��^:��n�w�d��h���GDA�z���]Q�Lb��	
񐟈�L�.K���~��������O����-$4>�8jv#�e[���T�o�v��_��#���Z�N|S�d5�]�
ImCcc��}��U�_���мȭ��;�><�Q�� 0
�i(�����vt��	H9��h:"�����Jd�8�	L���6$Vik��7嫐[�wh	/ۖx�E�ha`�rtp��tU&?�XZQ��y7��V�M�0��/��K�8�UkO;(�|PIkr��֚�?�~�qvF�$��,���z�9��.�V���&�S�$��҉@8���-��x�\犧K:�E�8|�ȝ{ӓ?����6�5���dg��Fz^}Z
�䵸�Y���`�n�Y��x��Qʡ�h,B��l���UR�����ڭ�EM,<'���J<нBAf�H�ހP�w�d�"���?B�����Ȫ�����ش>5��F]q�����O��n��^0�S!���,����!��J�Q�o��6�پvm����?�u��}hR�NQ�M�Ӱ�:��╈�3�TUL����ģ�vg_*R�S+$��U`O�aYߢ=m��%�n�p���5�bt咖]��������j��F-&�-�B��fЯkH��V��	��A>C����䑾y�@Z<)ۄݡi���pO�jesį}x~��!��|��_1��K����Z��x���K�N�6m�h�8�,@����4N��I�z_�
�����<Ʌ/��Z�h���\�v��sS�.�&�$TV�4�-���?�C�c9j�I
��#���Q})���r���揯FJ�7r�y�Xɽ)��"�>�{w���N�Φ�6S��V/
��D#f֞L����(�����=��|;�.g��ڃ@�=-?�"��p,�{_|7}E��+�\
�۾*p�j"\_�CP׌ȶ��eo>2�;�U$o�[(d��������':D������b��Lދն��:}���y�pp�:��
���I��A
�bz9L&7E�?���L��㰭�K��	����^�bʳ1(6��\kKoF�#>@�Y��$ܨ�^PN�z���κ��y��@�*yF�F���7��P������s�U�>U)@�eCW55�Y���R�$̑�`6��M 	��u�D{�ɚUt���0��R�Ls���{��/u�u�_X]%�.�M�Ƴ�7��m�r+���y�5ۭ�`E.X<���MI�sB�eM�"U���|*m���(}������:�10_r"��ҝ!��1��*�D�փ��KҔ�^�=��l�ax��3&��K�8�Ã8��вr����r,�(ɠ�����a��K=�T=F��V@����%��x���rK�8������~�[��1%þ/�gIq�G6oG��7�/�ou���W�\sP�ȣ�F�1V2���s�����W
2I7������~=��W����_�`�@eI�ﲉEP<�[��IG$�AV��
���n��2��ŠF�A:_S�Ϸ����Y��b=A(�Kͻ���t����v��ʭnH�&Q�?���6P`��{V	�8
l����C!9��A����D�[J&cEi�IcNu�4,L�4.��C)���"'D�.g�&)A�����q�����B���h���&�y��O�d*�w�8�;��9[p#=�a�
\�t|C2�3)� �X5�����=�RJL/l_zjF;��$�J���C���l���?X���U�5�� Ϻ.#H�c�
J��D��pf�����V��F��
�÷��DJ0}��xQ��p)��ʰ�%Z��=���V�[�]�֫Փ��UǢ����h���Q���YMq_��C5oƾM��[�U2�]�de,����2-�,���e@eO�<G�ʞ[���
��ν(��})#�*}f4ԅ%e�!mO���"�F`kԛ.m��&��}]�-�}eʈ2�!#���ӂ�I�jǑ�d��a0�ԁ\�?6}�.���]K�Z������,G�e��I��p5�?P��
�/�G�\��i�Wp��r�,���7O��z���pP��ו����A��Q�/�i=c|BB����Jq�H'(� �QI�4���f\�f�����8��f{��:3m3uZ�V,#�"5`T?��4f�`Vm�)�2�-�ֶqp�9\ji&Ӭ��=qfq�_K�:(��|.�D��m]�a5�����}�����-Px ,K���x��}�y!�<M���*>],�F~���׋��l�)@yp�|�f���l��M�,1�3TN˻Ƥ�^� HK�_�M�z=然���=���Z�Q��s��ẉb�q/Y��5���*�p���/��4j���d�y΋s�I6��,3�s��7�z�cf���I�
��տ �+ԮIZԽ9����Z`K�7�L�q�'%�2�����t1å����5��cl,�P���}�#Ы�l�:>}lA���B�A��~;j`&�l��+�_rH��!Z���Չ�A��yBY���D�T٣���X�Z�f�L巵�n\�`�F�y&U+�+9NuN�Q�QT%VaV
Y*Y�o�tuz(zY}i��������-�g
�T���&l+�+hN�N�Q�Q/TTV�V#YCY
pu2u!zAzr}�����0���l��
8U��h&D+�I4��m+ N�QTV�X*j��0�[�o�t�y@}L���d���������:
�&5�7����n&J+J:��s+&N�QTV�X0j��N�[�o�t�yF}R���j��������F
�&5�7����e s w ] c g m y }  � � :3F\�(-a
%E�]#�
#�&�&�
({+�+�-K7:�@9ARA�BKCdC�D@E�E�G�G�H�HIDI�'J�O�#O�U�1Y�a$b�#e$%kip�(rz&w�|*�������F����_	����17���p���	�K�t�n���c�������������*�Q����������Y�x��g���1��������^������������
��
������	����M�n���=��������:��w����d����k���J����v���R���|�k�����������������������o�*�_���
�0
"��IC�K!m.�F�K�� �!�"5#�#y$�$]%�%P!&�+,�-�N�NOwP�QBRkRqS@ThTiU�V�V�VXTY{Y�Y�Zm[�[Z^`�`�`�`a�a)b�byckd�e�fIhoi8%k�%nJ tD2xl/�/���E7�3������'���^����P��0�����������
���������l�s�!������j������R�����l�A�I�����+���=����j���,���I�
�9
��
��
���>�������n���C�]�w�A�9���������h����v�8�����;�	�p���]���+�e��m���h��	�	�	�	4
���
;��B�P���6�j/���1�e�+� � !�!"n"�"B#�##$�$�$�%G&�&�'�(Y)`*+�+?,�,N-�-\14�4�4Y5�5O6�6L8�9�9\:T;�;`<�<>t>;?�?�@\AB�ByCD�D�E�FaG4H�HI�I`JEK�KL�L7&MNT�TV%VDV�V]W�WpXY�Y&[\l_lb%c	d"e�f�gfh
i�i�jk}k�k(p�p�q�rtTu�u�uw$x\yWz�z�z�{�|�}�}�~����1�n���F�m�������!���^���2���6��l���C����c���O���)�������������1�x������d��	�L	���-�h���
������5������W�����%���d�����"���d���q�����7���>������<����
��
��I��t�D�����
J	c
��T%}&F' ()�)+3,�-
/012�23�3�415=6�7�89�9�9]>>A�D6H�H&	I\
Jb2L^U�U�ZV\`�d�d
erg�gmh�h�ij]j�"j�nxpGsPv�	v�
w?y�}�}�~�~�����{������/����L���-�����j�6���^���3�P�K���/�S�����4����c�������{�����$���6�����"�?�4���u�%������������k���E�.�m����;�����3�W������O�Z������&�����$������-�E�j�-�����e���N�v������N�������o���9���������b�V���#���-������ �A��i�}�+����.�m���^���H�R��������K���������_�S��� ���������$���!�z���5���H�_�~�������B�_�{�����?���*���"�?�]�����6Nm����.�'\�e��X�Q�����$	z	��?0Z�n��i��
q����<�Z����rMyM I��H; E !z!I"�"�#�$_%�%�&'C'(�(F)�)�)�)�)+*p*�*�*G+�+�+,],�,�,-!-A-�-�-W.�.E/�/�0�1Y243`3.4� 4*7t8�8�9*:;�;'<�<\=+>n>�?s@AA�A�B�B%C�C�D(EhE�E�E�E
FRF�F�F)GnG�G�G?H�H�H�HI#IqI�I9J�J�J&K�K�L�M�N�N|OI PxR�S4TUwUjVGWtW@X�XxY�Y�Z�[�\]�]E^r^@_`u`�`�`�`aZa�a�a"bvb�bcFc�c�cd1dPdpd�de�eftf�f�ghh7ij>jk� knRo�o�pq�q�rs�s9tuKutvPwx�xmy�yz�z�{|E|d|�|�|�|/}�}�}~K~�~�~�����N�������F�m�I�������� ���3������������������-�V�2��s�O�����������'�F�e������c�����-�r�����E�d�����M����(����������u��������Z�����"�v����F�������8�����M�������a�<�h�6��C�b�������-�����I������a������i����D� ����������������.�v���
�>������b������T�����i�������}�X���R��_�~������I����� �e�����6�}�����0�����9�`�<������������+�J�����)�Z�����8�~����E�����#�i�����0������T��?������A�������������G�|���*=������@������������r�����T���>�������8�X�	����8���6�����&�O��%e'�(g��"	<	\	�	�	�
�
#z��"�#t&P+�EJ@��
y+,N�Q
TV�X�[6j��l�-�[�o�t�yL}X���p����J���R
]%�& 5�7������v&R+A)C�G�H�H4J��d�x
�(����}�
}I"�%}+2N�QTVYY`_anjl���H��
��	�	r�x:�
�"�#i$6%�3$55<�<M�U�V�[�h�o�t�yR}`�������|�A����������T��\
�&"5�7�9�d�g�hj�j�}�~���	��������{�������������{���B�����H�R������&�������:������v������`���Y�p�����������G_��3�]����
�Z�U�	�Y% V"#'S)}*i	,Q/@3�6<8>C5E_FK	H�J�NBRTW�YR^�`�a�	c�fj�m�ru�y|<}(	��������������
�����������Y�H��:�&�����������u�d�,�V�B����������������-�������r�����2�k�����������������J�����
���z�P�S��4	N	�	�
�
�

)))













)










)
)
)
)









&&&





















((&&&&��#0&�&�'+�+�,*1�75:=AgAOCyC�E�G#I�I�N�T�X�`e/j�o8r�v�{��ωp����L���������ۨ_�3�+��U�n��C���@�g�
�������o���/�}��G���2���.�$�t���4��N���X�y�}�i���������(�I���a�>���]�1���*���z�0�������`���3�����2�4�����������+�����0����Zc�u��	h�F
}	�����EC��w�Q T!�"K#$�$�$�%;+�+@,�M�NOmObQ.RUR�R�SST�T�U�V�VW�XgY�Y�Y�Zr[�[�_�`�`�`�`�aWbDc�ceffvg(i�i�n�s�w�~v������Ƙ���ߤ٧d�������I��[�����}���B��������������,�����h������W�_����A���S�������B�b��������I��������s��&���e�]���)��~�$�����N�����Q������s���A{���(��~�%	
�
�
�
@�t��L���5G{A .!*"#�#�$�%]&'�'�(o)v*+�+U,�,d-�-�3"4�4�56�68�8�:�;v<>�>Q?@�@rAB�B�C$D�D�E�FwGJH�H3I�IvJ[K�KL�RbT�UV*V%W�W9X�XwY}Z[�^�a�b�c-dFe�f	h#i�i�jk�k�oop�p�qTswt�u�u�u&wsx�y�z�z�z|}�}�}
���T�����Y�����م7�t�H�L���Y�4�3�<�����k��]���������F���ՙQ�o�
���7���ƣ������������:��������ۺ �|��C�����%�j���e�����~�6�������1���[%�&\'6(4)�)(+I,�-#/012�2834�4G5z7�79�=�@5DyGJLDT�Y\`8d�d�f�g�i1j;np�r�u�w�x�|~�~$�-�ЁE���a����Ćt�8�f�E�ӎA�(�͔�����:����'�U�j���;���-�������#�Q�;������e�ҵ�V��߽=���Z��[���{�d�����/��d�&�����x�9���C����6�W�A��D�����t���^�����u�6���&�����@�����H���0������G�d�����R�=���'�D��������E�s�|o��2�;	R�~
5� s�n�x���T�r	����ea`S] �!�"�#�$�%[')(�)�)�)�)C*�*
+^+�+�+.,�,�,	-(-Y-�-�-o./�/�0�1q2x3F4B7�8B:5;?<t=�>�?�@�A=CDoE�E�E�E%F�F�F@G�G�GH�H�H�H
I;I�I�IQJ�J>KL�L�M�N�O�RLT�U�V�W�X�Y�Z�[]�^X_�`�`�`*ara�a9b�b�bc]c�cd8dWd�d�d+e�e7f�f�g�hOiVj$k n�oqrsQtcu�vhw�xz�zL|k|�|�|}�}�}~b~�~�~�����f���.�ǁ^���a�0�7���������3�E�n�J�����ʖ.�M�l����i�����D���ϚL�|�›�e��@��������ۢ��*�r���9���Ҥ�]�ڥ
�P������Ψ��y���N�J�i��������Ǯ�`����h���ް,���5�\�8���ܶط���F����U����3�y���&�l����ü�ƾ����j�f������������7�|����������H���Q�x�T�#�*������2�b���/�q���
�O����\�����:����G�����%�k�c���T�����������������0�*�(������'�g�����k�����I�/���,�x{�z�		o	�	�
�
6�>�"�"�"�"�"�"�"�"�"�"#	####!#'#-#3#9#>#E#L#R#Y#�#�&�&�(�(�(w+�+g-t-�-F7:�@%A-A5AMA�B�B�B�B7C?CGC_CfDsD�D�D<E�EKGOGUG\GcGiGoGsGwG{GG�G�G�G�G�G�G�G�H�H	I@I�JtO�O�O�U�U�U�Y�Y�a�a�ab�e�e�e
kkkVpcp�r�r�r_wgwtw�|�|����B�K�T�a�k�������b�o�|�A����K�Y�����+�o�x�����]�j�x�������8�E�o�h���]�ݹ�����������������������$�5�>�K���������������������}���=�F�S�\�e�r���>�G�T�a�������+������	�����E�L�Y����
�����������������������������������	�����G�h���)�6����|�������4���q����������Q�^���������K�X�e���D�����
��q���2�?�L���w�e��������������������������{�����j�s��������������y�����AN[i�$��QZ�����
�
*
�
�
�
�
o|p}�C4=�ESZgly(���@�E�� �!�"�"�""#/#�#�#�#s$�$W%�%�%�%K&�+,--�N�N�NOePrP�Q=RdR_SlS;TbTVUcU�V�V�V�V�WXOYvY�Y�Z�Z[[h[~[�[�[�]�]�]�]�]�]�]�]^^^^^#^)^/^5^;^?^C^G^K^O^U^a`n`{`�`�`�`axa�a�a$b�btcfd�e�fDhki3k�n�n0t8tEt2x?xRZg���������2�?��	�,�b�k�{�������v������[�d�m���K�X���	��ϬݬK���Ư�����õѵߵ¶϶������������ͼ������������P�Y�f�W�`�m��j�y���������R�[�d���������w���6�?�L���������L�U�e�$�-�:� �)�6�C�����������%���.�7���������Q�X�e���&�����C����&�3�e�n�{�����������+�8�������z���������Z�h���/�=�W�q�-�:��&�3��������������b����������c�p��%�2�����������(�5������j���I�W�����%�ER_�|��PYfbkx����fs�:GTb�~��		�	�	�	.
���
6z��=|�>K�ly�{���0���~*3@c*�s|����+���_�%��� � � !�!�!"h"�"�"�"<#�#�#�#$m$z$�$�$�%�%�%A&�&�&�&�'�'�'h(q(~(<)E)R)7*@*M*Z*�*�*�+�+�+9,�,@-I-�-Q1V1�344�4�4:5G5T5�5I6�6F8�9�9V:B;O;�;A<N<[<�<�=�=>n>?(?5?�?�?�?�@�@@AIAVA�AB�B�B�BfCsC�CD�D�D�D�E�E�E�F�F�F�FMGZGH!H.H�HI�I�ILJYJ,K3K@K�K�K�L�LM#M0M.T;THT�T�T�U�UV V>V�V�V�VWW�WjXY�Y![\Y_f_LbYbfbcdeepfwf�f�g�g`h�h�hi�i�i`jmjzj�j�jwk�k#p~p�q�q�r�r�sttHuOu�u�u�v�vxx=yJyWyRz�z�z�{�{�|�|�}�}�~�~��Հ܀�*�[�h�u���A�h��������������X����,���͉0�����f�ދ=��������������������ɍэٍ�����������'�/�7�?�G�O�W�_���K���$��������������,�s������I�Q�^�������1�9�F�̡ԡ�'�N�V�c�����������ĩ�������A�I�V�y��#�0�Ĭ̬٬������>�F�S�ʯ�������ֱޱ�_�ղݲ����������J�R�_�ϵl�����2���9������7�|�����	�:�C���n�>�����
D]���O%I&P&T&X&\&`&d&h&l&p&t&x&?'(()))�)�*�*�*+	,,,,,z-�-�-�-�.�.�./�/�/�/�/�0�0�0�1�1�1�2�233�3�3�3�4�4�4*56*676�7�8�89r99�9�9+>4>W>/A8A|D�DH$H1H�H!IVJ\L�T�TOUYU�U�Z�ZP\l`y`�d�d�d�d�dlg�g�ghh�h�h�ijjWj�j�j~n�n�niprp7s@s5v>vKv�v�w9y�}�}�}�}�~�~�~������u�������
�)�߂��G�������(��������d��#�0�������L�Y����!�.�J�9�F�����(�3�@�M�����������.�������͓��]�����Ôߔ��_�h�u�Ė͖ږ�������›ϛ0����������������9�!�.�����Y�b�o�� ���ߡ�����
���ۣ������O�X�e�����?����(�^�g������5������Ȯ� �-�.�Q�����ɲm�z�۳2�;�H�:�G�T�����ȵ�̶ٶ¼�����ƿ�����(�>�@�I�V�c���(�����_���G�L�U�b�o�h�q�~�����������������$�-�:�G���	������������j���4���a�j�w���j�s�����[�;�D�Q���������'���������������� �-�:�������c�w�%������
��'� �)�6�C�f�c�l�y���=�J�W�\�e�r��4�A���*�M����|���F���s�|�����v������X�8�A�N����������
�������z��������������������������l�r�x���%�,�3����C�Z�|�������#�0�=�Z�v������.�=���
��(������:�W���������0Hk����'�!U�_��Q�K���{	u	����9�
�
+T���\i���Wd���j����4���R��������Q\i.9Fp,7D�@Q\i�����?�2�  < � � 
!q!)"4"A"�"�#�#�#p${$�$@%K%X%�%�&�&�&':'�'�'(�(�(�(?))�)�)�)$*j*�*�*�*,+@+�+�+,V,�,�,�,-9-�-�-D.O.�.>/~/�0�0�0i1t1�182C2P23 3-3W3
44%4�4�4�4!728=8J8m8�8�9�9�9!:�:�:�:;�;�;�;<�<�<�<S=>>#>e>v?�?�?R@]@j@"A-A:A�AqB|B�B�BC�C�C�C�D�D�D!EaE�E�E�EFLF�F�F�FG"GgG�G�G8H�H�H�H�HIiI�I&J1J�J�JK�K�K�K�L�L�L�M�M�McNnN{N�N[OfOsO*P5PBPoR�S�S�S�S+T�T�TUnU&V1V>VaV'W2W?WkW!X,X9X�XXYcYpY�Y�Z�Z�Z�[�[�[o\z\�\�\�]�]�]=^i^_*_7_�_�_`n`�`�`�`aSa�a�abb[bob�b�b?c�c�cd*dIdhd�dese~efmf�fkgvg�gGhRh_hi!i.i�i�ij5j�j�jk�k�k�k�moo(oKo�op�p�p�p�q�q�q�q�r�r�r�r�s�s�s0t�t�tuBuSv^vkv/w:wGw�w
xx�xNyYyfy�y�y�z�z�z{�{�{�{>|]|||�|�|)}{}�}�}�}�}D~�~�~|����F���������=�L�W�d�(�3�@�����ԅ߅��̆׆������������	�,���a�l�y���������Ӎ������ݎ�������ʐՐ�$�5�@�M���)�����j�0�;�H���ە������a�l�y��� �?�^�}�Ř�]�����͙�&�k�����>�]����E������������������ʟ������Ѡ������V�a�n���͢��S������[�o�����?���̥�0�~�Ӧ;�F���������q�|���@�K�X��(�5�_�� �-�����<�[�z����'�y��������B���ͯ�Z�y����a�ɱԱ�#�.�;���
��δٴ�����õ��������r�}���ʷ��'�o����*�8�w���й�[�����L����W�b�������ɽ������\�g�t�9�D�Q�{�1�<�I����X�w�������C���������^�����/�v�����(�}�����0�?�J�W��&�3������������	����������������$�C�����#�F�T�������1�w����1�?�~������b������*�i�}����M�������������9�?�������������z�������@�s�z�����$��������3�9�w�}�����������������k���������O����9�y�������1�V���������1��������%�4���������?H{���\c���!_e����	5	Z	�	�	
�
�
�
!s�FMT[bipw~������������������



!
(
/
6
=
E
L
S
Z
a
h
o
v
}
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
 '.6=DKRY`hov}������������������
&-4<CJQX_fmt|������������������ (/7>ELSZahov}������������������#*18?GNU\cjqx�����������������$+29@GNU]dkrz������������������	%,3:AHOV^elt|������������������	%,3:AIPW^elt{������������������	 '.5<DKRY`gov}�����������������	 '/6>ELT[bjry������������������	%,3:AHOW_fnv}�����������������$+3;BIPW_gnu|�����������������
 (/6=EMT\cjrz�����������������&.5=ELT\cjrz�����������������	'/6>FMU]dks{������������������!(/6=DKRY`gnu|��������������������	!'-39?EKQW]ciou{����������������������#)/5;AGMSY_ekqw}���������������������
%+17=CIOU[agmsy��������������������� 	    ! ' - 3 9 ? E K Q W �"�"�"�"�"�"�"######$#*#0#6#B#I#O#V#�#,&�&�'�(�(+�+n,i-v-'1�72:'A/A9ARA�B�B9CACKCdChDuD�ERGYG`GlGqGuGyG}G�G�G�G�G�G�G�GI�I�N�T�U�U�X�Y�`�a�d�e�ejkkwoXp#r�r�rovawiw�{�|�~���r�D�M�V�f�����Z�d�q���ܔ6������q�m�_���z�Ũ����I�:�����?�߹�X���������-�����*�7�@�Q�����������������������?�H�Y�^�g�x���@�I�V�g������ �1�����������J�N�^�������8����������B���c����g���S��������������3���+�K��	�(���G���
��w���������S�d��	������M�Z�k���J����v�4�A���������m��������������������}�����l�u����������{���CPDM�S_����	R�
0
�
�
x�q�r��6��/-X\{n����a��; >!�"�"�"$#5#�#�#�#y$�$�%�%�%6+�+*,-�M�N�NOWOgP]Q)RPRyRaS�SNTuTXU�U�V�V�V�V�W�XbY�Y�Y�Z�Z][m[�[�]�]�]�]�]^^^^ ^&^,^2^8^=^A^E^I^M^S^�_c`p``�`�`�`za�a�aBb/c�c�dQfagi�iln�s2t:t�w4x�~T\a����������4������d�p�؛������x�����ɤ]�f�çM�N����n�ٮ�����3�Ķ���E�����߹�y�g�p��,�������R�[���Y�b���m����������T�]�j���������y���8�A�R���������N�Z�l�&�/�A�"�+�8�I�����������+���0�=��������V�Z�j���,���]�����(���g�p����3�������-���������|���������]������/�O�$�(�G���������h����������e�v��'�8�����������*�;�����	�p���]���+GTe�~��R[mdmz���h�<Ih��	�	�
���
;�~�@^n�}�6���,5j�u~��1��e+ � !�!"�"�"#�#�#�#o$|$�$�%�%�%G&�&�&�&�'�'�'j(s(�(>)G)Y)9*B*O*`*�*+�+�+�+?,�,B-N-�-�34
44�4<5I5z56�6�7�8�:D;�;C<P<`<�=�=>t>!?*?;?�?�?�?�@�@BAKA\A�AB�B�B�BhCyCDD�D�D�D�E�E�E�F�F�F�FOGaGH#H4H�HI�I�INJ`J1K5KEK�KL�LM%M�R0T=TNT�T}U�U�UV%V�V�VWxW#X�XaYgZ|[�^[_�aNb[b�b�cde0eufyf�f�g�g�h�h
i�i�ibjoj�jk}k�ojp�p�q�q�r>s�s
tttMu�u�u�u�vwx]x?yLy�y�z�z�z�{�{�|}�}�}�~�
�ڀ��>�]�|�w���T�{�����Å���!�^�!�2�‰6���l�C��������������ō͍Սݍ��������#�+�3�;�C�K�S�[�/�8���V�͑H����������1�x���M�Z�K�S���������3�;�"�Ρ֡����P�X������
�������������C�K���%�Ƭάެ�����@�H�ϯ����%�ر�ײ߲�������L�T�����ֺ�f���>����� �e���O�����<�h� ���������~��V%R&V&Z&^&b&f&j&n&r&v&&F'( ()
))�)�*�*++,,!,3,|-�-�-�-�.�.�.
/�/�/�/0�0�01�1�12�2�23"3�3�3�3�4�4�4156,6u7�7�89t9�9�=->�@1AD~DcGH&H�IL.T�TTU�Y�Z\`n`"d�d�d�d�f�g�g�ijj�j%n�n�okp�r9s�u7v@vjw�x�|�}�}�}�~�~�������/������܃K��������%�������N�^��#�3�P�;���/�5�B���������+���������Ȕ��a�j�Ɩϖ�
��$�ěԛ����������	��"�?�#�e���[�d�u��%�������ݣ�����Q�Z�ͧ������`�m�	���;�6������"�������ϲo��4�=�O�<�I�����͵�ζQ�����ɽ8���D����E�B�K�X�j���e�N�N�W�d�v�j�s�����������������&�/�<�N����������c�l�y���l�u�b�=�F�#������-������������� ��"�/�A�����+�����.�"�+�8�m�e�n�{���?�L�^�^�g�t���6�H�����u�~�����x���_�:�C� ��������������|�������������<���������n�t�z�'�.�5����~�����%�2�B�_�{���"�1�?�
��*�����"�?���������	m��.�\�e�X�����$	N���z
�
�
0���^n��Yi��q����<��Z�������S^r0;y.9M�IS^��H�;� E � � z!+"6"�"�#�#�#r$}$�$B%M%�%�&�&C'�'�'(�(�(�)�)�)�)+*�*�*G+�+�+,�,�,-!-A-�-�-F.W.�.�/�0�0�0k1v1�1:2E2Y23"3`344.4�4�4*748?8�8�9�9*:�:�:;�;�;'<�<�<\=
>>n>x?�?�?T@_@s@$A/A�AsB~B%C�C�C�C�D�DhE�E�E�E
F�F�F)GnG�G�G�H�H�HI#IqI�I(J9J�J&K�K�K�K�L�L�L�M�M�MeNpN�N]OhO|O,P7PxR�S�S4T�T�TwU(V3VjV)W4WtW#X.X�XZYeY�Y�Z�Z�Z�[�[�[q\|\]�]�]r^!_,_@_�_�_�`�`�`aZa�a"bvb�bcFc�cd1dPdpd�deue�ef�fmgxg�gIhThhhi#i7i�ij>j�j�jk�k�knoo�o�p�pq�q�q�q�r�rs�s�s9t�t�tKuUv`vtv1w<wPwxx�xPy[yz�z�z�z�{�{E|d|�|�|�|�}�}~K~�~�~�����N�������F�N�Y�m�*�5�I�����օ��Άن�����������c�n������܍����������̐א-�7�B�V���2���s�2�=��������c�n�'�F�e���̘c����-�r���E�d�����M����	��(��������ӟ����ڠ������X�c���Ԣ��Z��"�v����F�ӥ�8���ۦ=���������s�~���B�M�a��*�h��"�6���C�b����������I���ԯa���ư�i�˱�%�0�D��� �д۴�����������Ķt��ѷ��.�v�
�>���׹�b���T�����Y�������ҽ������^�i�}�;�F���3�>�R��
�_�~���������� �e�����}�����0�����9�A�L�`��(�<������������������������+�J���)�Z�����8�~��E�����#�i���0������T�^�������;�A���������|�����u�����|�������5�y����������������������e�{���X���������������(�6�������A}��^ev��ag���\	�	�
�
#�JQX_fmt{������������������
	



%
,
3
:
B
I
P
W
^
e
l
s
z
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
$+3:AHOV]elsz������������������#*19@GNU\cjqy������������������%,4;BIPW^elsz������������������ '.5<DKRY`gnu|������������������!(/6=DKRZahow~������������������
")07>ELS[biqy�������������������
")07>FMT[biqx������������������
$+29AHOV]dlsz������������������$,3;BIQX_gov~������������������
")07>ELT\cksz�����������������!(08?FMT\dkry������������������%,3:BJQY`gow~�����������������
#+2:BIQY`gow~�����������������$,3;CJRZahpx�����������������	%,3:AHOV]dkry��������������������$*06<BHNTZ`flrx~��������������������� &,28>DJPV\bhntz����������������������
"(.4:@FLRX^djpv|���������������������      $ * 0 6 < B H N T Z M����Ustx934
8C&�&(�(�()+�+-q-~-�@FA�A�B�B�BCXC�CpD}D�DE}E�G�H�H�H7I�IaO}O�OKU�U}Y�Yia�a�aXe�e�jkp`p~r�rwqwP|�|l��܆^���Z���	�l�y�$����-�T������E������g�E��������B�Z�S����8�����_����U�c���l�����	���H�������g�������C�����P��o������Q�^��������(�t���_��������V���������x�P���e����������������������������.�R�s���3����f��������Q��[����s����[����j���	�U�b���$��������[�����<�I���L�K�����������������������x���<����}�����z�����I�������KXd����(��C���
��'
z
�
�
�

�Cy.z�#�,��	d.vT��%�+�h �! "�"�"�",#�#�#�#O$�$=%�%�%�%%&P+�+�,-N�NOPoPwQ8R_RSiS�S]TU`U�U�V�V�WX�XqY�YVZ�Z�Ze[z[�[�[`k`x`�`�`�`�`:a�a�a
bqb[cMd�e}f+hRi
j�n�n�sBt�w<xd����_�����<�ڔ$��x�=��������'����U�������ج+�����Q�����̵ڵ��̶���2��������������Y�������c��j��D�v���O������
�y���4�����I�����Q���b���7���3�@�����N������~�������������b��������w������0�!�x�\���������5�C���E���M�����;�c����8�8�R���7���0�����f�����)���B����p���%�m���/�����@�����2������K���*�R�����k�O\�4��c�u��u�-p|�DQ]��Z����	�	�	#
�
rp
 ��/Y��,H��v�G����
\�=[�'q���r�����?�
}�S � � j!�!�!R"�"�"�"*#h#�#�#$I$w$�$�$
%�%�%&�&Y'�' ({(�(O)�)J*W*�*�*d+�+�+,�,-�-�344.4�4�4D5Q5�5.6�6,8v9�9::�:L;�;<K<X<�<�<�=�=J>�>2?�?@@�@�@SA�A�AjB�B$CpC�CtD�DKE�E/F�F�FGWG�GH+HwH�HoIJVJ�J=K�K�KYL�L�L M-M@S8TET�T�T�U�U�UV6VjV�V�V<W�WPX�X�Y[�[$_c_bVbcb�b�c�def�f]g�gJh�h�hiai�ijjjwj�j�jSk�k�oyp[q�q�r�r�stt�t�u�u�v�v�wx�xGyTy�y�z�z�{�{�|�|#}�}p~�~��/���%��e�0����c���Y���g���φ�ć+���Ј)���ʉ������F���%����u�H�F��������s�.���՘�\����f�	�[�U����C���ޡТ�`�@���ըf���ߩL����S�q�߫-�Z�֬���J��P���2�������1����N�����d��\��������*���#�����/�t���{������N����
.G���&�'(�()�)y*�*+�+,),-�-�-t.�.//�/�/�0�0�1�1E2�2�23�3�3�3f4�4�4�4�5'646�7e8�8�8B9|9�9>O>	A\D�G.HxH�H<JBLwT�T�T�UxZ�Z/\>`v`^d�d�d�dSg�gGhuh�h�i�iFjsj]n�n;p	s�uHv�v�wyp}�}�}�~�~��
����������Ă�/�q������x������J�Dž-�[����V����+�B���C����%���=�J�x���Q�����g���ȓ�>���הo��r���זf���њ���̛�[���*�����ԝ�1��+�����"�l�ؠ�e����	�Ģ
�T����~�����(�b�a����Ы �D���ݬ-�ŭ_�Ů�*��I�|�Ʋ2�w����E�մD�Q��ŵܵ��ֶk�[����R������#�5���S�`����%�o�������$���_�l��{���������{�������7�D��������
�\���@����{��t����}���<���N�����g�����$�������N����������*�7�������F�q���{������$���3�@�^��v�����G�T���o�|���>���'�E�����^���(���#����� �����9���K�����[������o�����1�����I���������e�����I�������;�T�k���������-�:�R�o�������+�:�~����%�����
��2�O�������m���(BZ��t�	�/�A��3�8Y�k��]	b	i���+�
�
�
#L���8f��3az������� j�2��S�,�f�CU�A��f��j�!�*�
   � !S!�!>"Q"@#�#$�$�$U%�%:&�&�&'�'(v(�(!)O)�)�)�)*V*y*�*�*"+8+r+�+�+B,e,�,�,-2-s-�-.�./M/:0�01~1�1M2�2*3<3�3"4�4�4�6�7G8e8�8L9�9:�:�:;�;�;<�<�<5=�= >3>"?�?�?g@�@7A�AB�B�BC�C�CXD�DE1EyE�E�E�E8F[F�F�FGGTG�G�G$HGH�H�H�HIUI�IJgJ�J�J�K�KaL�L<M�MNxN�NOpO�O?P=R,S�S�ST�TUPU�U;VYV�V<WOW�W6X�XYmY�YoZ�ZI[�[%\�\�\i]�]^M^�^4_�_`P`~`�`�`a=a�a�abbQbgb�b�b+cqc�cd#dBdad�d�dNe�eMf|fg�g�g\h�h+i�ijj�jkpk�k�m�n%oCo�o)p�p�plq�q�qbr�r�rfs�st�t�tu�uhv�vDw�wx`x�xcy�y�ydz�z5{�{�{|V|u|�|�|}8}�}�}�}�}1~v~�~$����2�|�ހ��݁���a�҃=�����������Q��������$�u��v�ŒN���ˍD�����H������ߐ��J���&�����B�۔E�����F����v�—�8�W�v������s���Ùٙ�X�����V���ܛ&���ǜ�������h�ǟ:�����<����k�~�Ƣ��=�������Q�g����+�q�����j����U�B��������U�Ȫ2�D�ʫ*������T�s���˭�6�����߮��/�t�����"�r�����B����в8�������V���ҵX���(������� �Y���ĸ�3�m������G������8���л2�q�^�ƽ7����q��N�`���F����(�p�������/�R��������K������>������^�������T���0�����r�����t���D��������<�u�����9�O��������c�����$�:�t�����	�N������%�_�u�����9��y����������t���;�����(�b����������"�[���������w�����S�����1���
�1�q��������E����������)�b�������"�1�v���������7j�@���
C����	/	I	�	�	g
�
�
�
a�.1&�&�'�(�(+�+�,k-x-�@>A�A�B�B�B�BPC�CjDwD�D�DQE�G�H�H�H/I�IUOwO�O&U�UdY�YQa�a�a3e�e�jk�oZpYr�r�vkw6|�|9����X�n�@����f�s��W��� �N�˖��͙*�{�����a�)�|�w���ߪ<�M�F�����s����.����$�9���_���������B�������<���X���&�����J���i���	�T�K�X��������"�f���Q���������P���������j�3���:���w�����
����������������������D�e���-����X���z�����<��M����H�����U����M�����O�\����|�����
�M�����6�C���C�B�m���������������������M��������w�����O�����,�}�����ER^y��������
��!
W
�
�
�
~&st�������^p0���"�_ �!�!�"�"�"&#j#�#�#A$�$/%_%�%�%&<+�+�,-�M�NO�OiPcQ/RVRScS�STT�TZU�U�V�V�W�W�XhY�Y9Z�Z�Z_[t[�[�[�_e`r`�`�`�`�`a|a�abhbRc@d�etfhEi�i�n�n�s<t�w6x�~^���5���݌6�����r����؟������p���O����
���Ҭ�a���5�����ƵԵi�ƶ����������������	�(�c�������]���d���#�p���$��������N����{���C�����5���\���1�}�-�:�����"�������p���u���������\�����i���c�������*���r�?���j�����/����(�~�!�����-�]�����2�*�D���1���*�w���I��������4�����E����g���)�p��������,�r�����=����L�����]�IV�	��]�o|�J�jv�>KW��L����	�	�	
�
dg
��&D��B��p���m��+�7C�!@����U��h����o�7 � � N!�!�!D"p"�"�"!#D#�#�#�#%$q$~$�$�$�%�%&|&.'�'�'u(�(I)�)D*Q*�*�*8+�+�+,�,�,-�344%4�4�4>5K5�5%6�68h9�9	:�:F;�;�;E<R<�<�<�=�=<>�>,?p?#@�@�@MA�A�A?B�BCjC�CID�D E�E�E�F�F�FQG�GH%HiH�HSI�IPJ�J7KvK�K<L�L�LM'MS2T?TsT�T�U�U�UV-VFV�V�V3W�WGX�X�Y�Z�[_]_�aPb]b�b�c�de�e{f@g�g<hhh�h�hDi�i�idjqj�j�jEk�k�opp>q�qkr�r}s�stxt�u�uzv�v�wx�xAyNy�y�z�zq{�{�|�|}�}S~�~�������_��y���Z���<���K��������������#�h�ĉ�m��������w���g�4�=����x��j����̘�S����R�ߜU�+���ȟ=�[�ء���Z����Ϩ<���ǩ"���ܪM�Y���'�7�Ьf����ƮJ�h������_���f��$���ij3�ִV�u�����ܺ!��������&�k���r�������E����
%>���&�'(v()�)?*�*+i+,#,�,�-�-:.�.�.E/�/�/^0�0_1�1-2�2�23]3�3�3:4�4�4�4�5!6.6{7P8�8�8-9v9�9>7>�@ED�G(HGH�H.J4L_T�T�ToU[Z�Z&\&`p`Fd�d�d�dJgtg9hoh�h�i�i=j_jFn�n$p�r�uBvav�wyS}�}�}x~�~�~�����̀}�܁������&�N������o�����<���'�8����P���‡%�9���=�\�É���7�D�U���9���ŏP���“Փ5�e�Δf��l�}�і]������j�ƛ�8������������(�Ȟ%�k����f����W��������#����R�����\�I���֨���0�����$���<���Ю$��1�Y����q����?���>�K�\���ӵs�жW�>�����>���z����/���M�Z�����>�����������Y�f���u�����J���	�R������1�>����e�����+��������J���n�{���w������H�g���O������`�����"�������
�z�$�1�w������k��m���_�����-�:�F���p�}���A�N���i�v���8���!�-�c���-�����\����������������E�d���C������C������~������������C�����'���������2�N�e�����s���'�4�I�f�������%�4�o�����������)�F�c�����^���<T��e����)�8��$�)S�b��N�S	T����"�
�
�
Ca���$`v���[q���y���a�)�&����`�=O�;�
�`l�=���v  z !"!�!8"K"#�#�#$�$O%p%
&�&�&'x'�'I(�(�(I)�)�)�)*M*s*�*�*+/+i+�+�+9,_,�,�,
-)-j-�-.�./G/
0�0�0x1�1G2�2$363�34e4�4�6�7A8M8�89�9�9b:�:�:X;�;�;\<�<=�=>->�>�?�?a@�@1ARA�A�B�B�BZC�C+D�D�D+EpE�E�E�E/FUF�F�F�FGKG�G�GHAH�H�H�HILI�I�I^J�J�J[K�K4L�LM�M�MrN�N�NjO�O9P7R�R�S�S�SlT�TU�U5VAV�V6WIW�W0XQX�XgYzYBZ�Z[�[�[~\�\<]�]�]G^�^._x_�_`x`�`�`�`4a|a�a�abHb^b�b�b"chc�c�cd9dXd�d�d7e�eDfvf�fzg�gVh�h%iqijjsj�jCk�k�m�no+oco�o�p�p?q�q�q5r�r�r9s�s�sqt�t
u�ubv�v>w�wx/x�x]y~y�y7z�z{�{�{|M|l|�|�|}2}�}�}�}�}(~m~�~�~����)�s�ǀ~�ԁ�̂[���7����R����T�ۆ$�����p���D�ދp���!�������������ÏS�ِ���D��� �j�����?�`�������p����/�N�m�����j�����Й
�O���ښ�M���ӛ�q������`��;���
��������ߡe�x���ܢ��4�|������H�^���ݤ"�h���ۥ�a�����O�������ɩO���,�>���$�m���K�j���­
�0�����֮�&�k������i����9���ݱ��2�|��W�ݴ)���̵+���������ٷ���P������-�d�z�����>�������/�}�ǻ�k�1���
����k���H�Z���@����"�g�������&�L��������B������8������U�������N���*�s���E�����G�����������3�l�����0�I��������Z������4�k������E�������V�l�����0�v�e�����	�p���d����~����N������������G���������X�����C�y���!����(�h��������?���������� �?��������+�f���������.V��,�}��/����
	)	C	�	�	W
�
�
�

Q��(G-A+A3AJA�B�B&C=CEC\C>D�D
E�E�G�H�H�H;IeOO�O~U�U�Y{a�a�a�ate�e�jk;p�r�rFweww|���I�R�����J�(����1�V�������X�v�����?�c�ĩ�^�W�ϳ=�¹��d�ݼ��Z�����p�����<���������������Z��D�<�c����E�����y���d������������}�g������������������������3�W�x����k������u�`�������3������2���)��������`���%���Q�P�����������������\���>�q���������`���$f��!��6X�z�
�
�
�
�
�
ZW(;�1�.Mz*�0�m �!F"	#�#T$�$B%�%*&�,>P>S?U�WvZ@[|[�[�[B`�`�`�`�`\abvb`cRd�e�f0hWi�n�nt6tx0XɅ|������)�5�i�]���E�}�>�b�k���-�ڪ��ڬ0���ï_�������εܵ��ڷW�º������^������,�W�3�^�
�i���o���0�Y�b�������K�
�=���_����S���+���'���w����	�5����������������A�l�s������c���\�v�@�e����:�=�W��������}���E�G�������<���#���`���
���P���/�T�����p��T�W-i���D~_�_����	�	�	(
wu
%�4u�7���^������a1`�vBz����D���a � � � �!�!W"�"/#�#$f$�$3%"&�&�&�&y'�'@(o()C)*>*�*�+,�,-G-�-�334�4!5�536�618{9�9?: ;�;2<�<�<O>�>&?�?�?�?W@AGA�A�B�B;C�CD�D�DkE�EbF�F+G�G|H�H}I�I*J�J�K�KpLM�S�T�UV;V�VAW�WUX�X�Y[;_*bc�c�dBf|gOh�hxi:j�j�jXk�k{q�r�s�v�wy�{�|�~�,�P�y����ɇ0�������ŠK�Ë*�����z��������x�>�����ژ�a����.�O�z����7���ҡ3�T�]���ר�����w���#�G�v���!���ʬέ��O��D���`������ܱ6���۲y�����i� �P������/���(���4�y�����#�A���S�#���3L����'�(	)�)�*�*�+,=-�-�.�.�/�/�0�0�1�1m2�2�3�4�5y8�8V9�9�9(>2>T>A6AlD�D�G"H}H�HCJIL�T�T�U�Z4\U`ud�d�d�dXg�g�gLhwh�h�i�ijKj~j�jmn�n�nKppps>sv<v�v�w&y�}�}�}�~�~�~��������������ɂ�4����}�фO�ۅ!�x���(�����G������������}���u�����ʓ��
�C�������ܔt� �f���˖k��������x���S���6������?�`��j�ɡ��ۢY�̣���E�V����ޫ�%�O�e������2�ʭs������N�����I�ij#�9����������r�
���%�7��G���t�������)��S�8�o�����������+��������a���E������C�h�4�q���A��B���������w��������K�s������������'�c�2�j��#�c�����J�����c���-���U�z�@�}���>��?����r�����Z�-�w����������]�p�v����*�1����@�V�m��������W�t��������������7�T���r���-D\��y��1�F��8�=[�p��b	g	t��0�
(Q�C��>������%o��7����]�-Z�7W5�7Z����&�/� " � � X!"2"S"z#�#K$y$%I%�%`&�&�& '�'�'�(�(&)Q)�)�)�)*[*{*�*�*'+=+w+�+,G,g,�,�,-7-x-�-/.M.�.#/O/s0�0D1r12A2�23>3�34�4�4�68;8j8�8}9�9:�:�:;�;�;<�<�<:=�=>5>\??-@[@�@+A�ABBzB�BC�C�C~D�DE3E~E�E�E�E=F]F�F�F	GGYG�G�G)HIH�H�H�HIZI�IJ/JlJ�J�J�K�K�L�LbM�M4NlN�NAOdOP3P?RfS�S�S	T�T�TUUV/V^V�V0WQWX*X�X4YaY�Y�Z�Zz[�[K\x\�\�]�]$^O^_(_�_�_U`�`�`�`	aBa�a�abbVblb�b�b0cvc�c	d(dGdfd�d�d^e|e�eRf~fQgtg"hPh�hi�i�ij�j�j�k�k�m�noHo�oZp�p�p�q�q�q�r�r�r�s�st�t�tu9v\v
w8w�wxexyWy�y�y�z�z[{�{�{|[|z|�|�|}:}�}�}�}�}6~{~�~&����7���������2�U��1�ӄ���݅����Նw�����׊��)�z�<�j�njt���Ѝj���Îy�������Ӑ���>������G��9�����w���=�j�Ǘ�=�\�{������x���șޙ�]�����[����+�����ɜ���������`�����m���2�_���ˢ�	�B�������V�l����0�v����!�o���&�D�W�{���L�z��I��&�F���������Y�x���Э�8��������4�y����$�w�����G���ұ�	�,�ڳ���״|���Ե����N�{�����%�^���Ƹ"�5�r���¹�L������=���ջB�`�s�����h���8�e�
�B�b��:���	�*�u�������4�T�������P����� �@������c������%�H���$���������������j������"�A�z�����>�Q�������#�h�����)�<�y������S������'�d�z�����>�������������*�=�������y�����]�����-�o�x��������������/�7�h�{����������������X���������6����6�v�������$�G������.����{�������<Fw��Ma����Pc����	1	K	�	�	l
�
�
�
f�3�'�,hAzC�G$I�N�T�X�`e0j�o9r�v�{����q�����X�����������`�4�,��V�o��D���A�h��������p���0�~��H���3���/�%�u���5�O���Y�z�~�j���������)�J���b�?���^�2���+���{�1�������a���4�����3�5�����������,�����1����[d�v��	i�H

�����FD��x�R U!�"L#$�$�$�%A,nO�R�TW�Y�Z�_�aXbEc�cegfwg)i�n�s�w�~w����������������e������J��\�����~���C��������������-�����i������X�`����B���T�������C��������J�����	���t�
�'���f�^���*���%�����O�����R� �����t���B|���)���&	
�
�
�u�M���6H|B /!+"#�#�$�%^&
'�'�(p)w*+�+V,�,e-�3�56�68�8�:�;w<>�>R?@�@sAB�B�C%D�D�E�FxGKH�H4I�IwJ\K�KL�ReT�U&W�W:X�XxY~Z�^�a�b�c.dGe�f
h$i�i�jk�k�p�q`s�u'wx�z|�}U�������8�u�I�M���Z�5�����l���^����G�����p����8����� ������������;����}��f������7����2��]'7(5)�))+J,�-$/012�2@34H5�79�=�@6DzGJLET�T�Y\`9d�f�g�i2j<np�r�u�w�x�|~%.���F����b����u�g�F���B�)�����;�����V���<�.��������R�������f�����[�]���|�e�����1��e�'�����y�:���D��8�Y�B��E�����u���_�����v�7���'�����A�����I���2������S�>����������F�t�}	p��3�<	S�
�#��U�s
����fbaT^ �!�"�#�$�%\'*(�)D*+_+�+�+/,Z-�-�-p.	/�/�0�1r2y3G4C79C:6;@<u=�>�?�@�A>CD�E&F�FAG�G�GH<I�I�IRJ�J?KL�L�M�N�O�RMT�U�V�W�X�Y�Z�[]�^Y_+asa:b�b�bc^c�d�d,e�e8f�f�g�hPiWj%k!n�o qrsRtdu�viw�xz�z�|}�}~c~�~�~�g���/���_���b�1�8����������4�F�o�K��������������E�����}����f��A��������+�s�:������^��Q�����������z���O�������a���������-���6�]�9�����G���V�����4�z�'�m��������������k������8�}��������I���R�y�U�$�+���c���r����P���]�����;���H�����&�l�d�U�������������1�+�)�����(�����l���J�0���-�y|�{�
	p	�	�
�
7��'�,lA~C�G$I�N�T�X�`e3j�o<r�v�{��҉t�����Z���������ߨb�5�-��Y�r��E���E�k�����
���t���5����J���5���2�)�w���8�P�� �[�}���m���������*�K���e�@���`�3���.���~�3�������b���5�����5�7�����������0�����5����]f�x��	k�J
�����HG��z�T W!�"P#$�$�$�%C,qO�R�TW�Y�Z�aZbGc�ceifyg+i�n�s�w�~y������ʘ����ܧh�����L��_��������F��������������1�����l������]�c����D���W�	������F������� �M��������u��(���i�_���,����(�����Q�����U�!����u���C~���-��� �&	
�
�
�v�P���8K}C 1!,"#�#�$�%b&'�'�(u)z*+�+X,�,g-�56�68�8�:�;y<!>�>V?@�@vA"B�B�C)DE�E�F|GMH�H7I�I{J^K�KL�RfT(W�W<X�XzY�Z�^�a�b�c0dJe�fh'i�i�jk�k�p�qcs�u*w�x�z|�}X�����܅9�v�K�P���[�6�����m��_����H���יs����;�ʣ��"�����������?�
���~��g�������8����3��_':(6)*-+N,�-(/0 12�2C34K5�7 9�=�@8D}GJLGT�Y\`;d�f�g�i3j>np�r�u�w�x�|~&/�ҁF����d��Ȇw�j�J�׎E�*����>����Y���>�1�������T������j����]�`���|�h�����3��f�)�����{�;���F��;�[�B� �H�����x���a�����x�8���)�������K����U�@������F�t�}	p��3�<	���U�s����hd cV` �!�"�#�$�%^',(�)D*+_+�+�+/,Z-�-�-p.	/�/�0�1t2{3I4E79E:8;B<w=�>�?�@�A@CD�E&F�FAG�G�GH<I�I�IRJ�JAKL�L�M�N�O�ROT�U�V�W�X�Y�Z�[]�^[_+asa:b�b�bc^c�d�d-e�e8f�f�g�hRiYj'k#n�o"qrsTtfu�vkw�xz�z�|}�}~c~�~�~�g���/�ȁa���d�3�:���������6�H�q�M�����͖������E���К}�Û�g��C�����á+�s�:���Ӥ�^��Q�������Ѩ��|���Q����Ȯ�a������߰-���8�_�;�
��߶G���V����4�z�'�m����Ƽ��ɾ����m������8�}��������I���T�{�W�&�-���c���r����P���]�����;���H�����&�l�V�����������2�-�*�����l�L�2��z|p	�	7��'r,VAhC�D@E�GI�N�O�T�X�`�aej{o'rsv�{w���_���F����;�������r���ʨN�"�����D��]��
�2���/�V���	�������^�}��l��6���!�����c���#�=���G�h�l�X������������8���P�-���L��� �|����i����p���O���"�{���!�#�r���������������������I�R�d��	W�5
�������42���f�@ C!�":#$~$�$�%/,\O~RzT�V�Y�Z�aFb3c�c�dUfegipn�s�w�~e��������ݛ��ΤȧS�s�ޮP��8��J��~�l�u��1�������������o������W����q�F�N�����0���B����o���1��������8�����������b��������T�L�������m����{�=�����@��u���b���0j��r���m�	�	���
�c���;�o/��$�6�j�0� � !�!"#�#�$�%L&�&�'�(^)e*+�+D,�,S-56�6�7�8�9�9�:�;e<
>y>@?�?�@aAB�B~CD�D�E�FfG9H�H"I�IeJJK�K
L�RQTW}W(X�XfYlZ�^�a�b�cd5e�f�gi�i�jk�k�p�qCs�uwbx�z�{�}	C�����ȅ&��c�7�҉;��q��H���#����Z�ёL����5�|�ę^�����&��������������W�ӯ��)������"���d�k���T�����m�%�����	 ��K'%(#)�)+8,�-/
012�2'3465�7�89�=�@$DhG6H�HJL3T^U�Y\`'d�f�g�i j*np�r�uPvow�x�|�}�����4�	��P����c�U�K�4�Ž��0����)�ٛ��D�z�*�����ҧŨ��r�@���Բ��T����νI�J�o�-�j���S�{������S�������o���9���������g�V���(���2���%�F��0����3�r���c���M�R��������K���������d�S���%����������|�7������A�,���
o��4�b�k�^���!�*	����C�a���y�TP��OBL !�!�"�#�$_%�%�&J'(�(�)2*�*M+�+�+,H-�-�-^.�.�/�0�1`2g35417t8�8�91:$;.<�<c=u>�?z@AA�A�B,C�C�D�EF�F/GtG�G�G*IxI�I@J�J-KL�L�M�N�OR�S;TU~UqV{W@X�X�Y�Z�[�\]�]y^G_`aaa(b|b�bcLcwd�de�e&f�f�goh>iEjknRo�o�pqrs�s@tRu{vWwx�xmy	z�z�{�|�|�}~Q~�~�~�U������M�t�P��&����3�����������"�4�]�9��z�O��������Ә���3�x���k�����T��/��ڟ����a�(�|����L���?����������h�o�=������
�O���گ��Ͱ�p�$�K�'�����˶5�}�D���ݹ"�h��[�������ٽ������Y������&�k���������7���@�g�C�����Q���`�����>���K�����)�o�6������Z�C�����������������}���Z�8���g�i�^	�	�
%��j�jkkkOkak�k'l2l=lPl]l�l
mm�m�m�m6nAn�noo o)o<o�t�t	u�u�u�u�u.v9vDv�v�v
wwiw�w�w,x7xBx�x�x�x4y~y�y�yz)zwz�z]j�j�j�j�j�jnk�k�k�l�l�l$m.m8mBmLmVm�m�n�n[oeoooyo�o�opQoGo-p7pApKp�p�p�p#pp�p	qqqXqcq�q�p�p�q�q�q�q*r5r�r�q�q�r�r�r�r�rsVs�r�russ�sksas�s�s�s�s�s�s�s�s�s�stttt�s=tGtQt3t)t[tetot�t�t�t�t�t�tu]uhusu~u�u�u�uv#vSv�v�v wSw^w�x�x�x�yzz4zazlz�(�(s-�-�B�BrDD�U�Y�ekbp�rsw�|��`���n�{�i����D���
�����J���������R�q��S�`����*��X�������������5�����
���]����W�d�>�K��������������������MZ��)
�
{|�fx���"�".#�#�#�%�%-qPkSbUX�Zg[m`z`�a�aDt>xf����>�z�������W����������e�l�x��������K���d�9�5�B�����������d���2�z�����7���������9�2��������o�1�����4����Q^�ew��rFS��Jx�?)������!�"�"�#�#y$�$�%�%�'}(Q)L*Y*�*�+�+
44F5S5N;M<Z<�=>4?�@UAB�BrC�D�E�F�FYG H-HXJ?K�L"M/M:TGT�T�UV�V�Ve_Xbebe�f�g�hi�iljyj�q�rtt�vxIyVy�{�|�~�g��������+�̉���]���E��b���é��U�/�ج�R�������^�()�*
+,+,�-�-�./�/�/�0�1�2
3�3�3�4�4)666�8~90H�T�Zx`�dJv�}�������/���X�-�E�'�?�L�����t�ٖ�Λ�������-���n���������d���Ǯ,�Ȳy�G�F�S�ǵض����U�b��'�a�n�}���������9�F����v����P���&���������,�9������&�5�B�x���I�V�q�~�@�)�������M���	�����������������/�<�-�<��'���������
��h�c���hECh� 	!@"�#�$W%�&(�(�0�1O2,3$4�4I8�9�:�;�<">�?i@9A�B�C�D�K�L�MzNrOAP�SU=V>W8XoY�Z�[�\�]6_`�g^h-i
jk�k'o�p�q�r�s�tjvFwxey�z�{c�?�������x��������L�(���G���x����ɟ����m�����W�4�,���:���µ����Ƚ��s�P�H��V�2��������������������$�3�
���.��������ΈK����=���ՌҐ%�x�ȑ�q�ƒ�r�.�Γ��ܔ�˜�a�ޚ��ڛ*��Ν�m����X����Ң����t�ǩժ���ޤ�;����|�F��2�=���6������B�n�����K�v�g�������������N�l�¶�����������Q�y�ӽ.���ѿ��û���Z�����U���������5��m���=̤��H�����d�.���E�Mѥ�~�������%���c�E�M֨�~�������1��i�W�_�������-�����Z�-��������͈J����<���Ԍѐ$�w�Ǒ�p�Œ�q�͓��-�۔����`�ݚ��ٛ)�~�͝�l����W����Ѣ����s�ƩԪ�����:�����{�E��1�<���5������A�m�����J�u������~�������f�M��������������k�P���ҽ-���п�»�x�Y�����T�����-���4Ó�l���<̣��G�}���c�������LѤ�����D���$�}�b���L֧����D���0ُ�h���^���,���V�����Y���&>AjDAJGL�iknIps�w$y&������x�ƈC����5���͌ʐ�p����i����g�Ó~��Ԕ���	�Y�֚��ћ!�w�Ɲ�e�����P�����ʢ��l���ͪ���i�*����:�f�����C�n������q�������_�B������y�������d�E���˽&���ɿ�����q�N�����Mų���&���-Ì�a���5̜��@�v���\�������Eѝ�����9����v�W���E֠�����9���)و�]���W۾�%���K�����N���*������|�ʈG����9���ьΐ!�t�Ñ�m����k�Ǔ��"�ؔ���
�]�ښ��՛%�{�ʝ�i����T�����΢���p�éѪ���m�.����>�j�����G�r������u�������c�F������}�������h�I���Ͻ*���Ϳ����u�R�����Qŷ���*���1Ð�e���9̠��D�z���`�������Iѡ�����=���!�z�[���I֤�����=���-ٌ�a���[���)���O�����R����(W-�BVD�H?ImO�U�Y�a�ekGp�rXw�|�.���Z�0�9����g�L�p���&�g�`���������y��-���������l�,�T���-���	����r����3�������t�����������������`���!���t�����i�����@�����C���2����i�����^�]����������s�Y���q�9��I��
�
�
gh1,�
AZ 7�=�z �!#�#a$�$O%7&-QPKSLU�W�ZI[b�bmc_d�e�f=hdi�n!txC�������H�p�\�S�:�����9�n�����j�����������?�F������J�����]�%���s�2�
��������������6���������T������v�i���I���F�`���������P�����I����s����Y���8���y�k6H�U)�l��	-
�~
.=��s�Y����p �!`"<#$�$/&�&�'W(")*�*�+(,�,/-�-�5@6�6>8�91;�;�<\>?�?h@/A�A�BLC�C�D�E}F<GH�HI�I;JK�K�K�LT�TNW�WbX	Y�Y[H_;b
c�c�dUf�gXh�iOj�jek�k�q�r�s�v�w+y�{�|�~�?�c�����������������������������%�l�����A���"���F�p�����2����.�y�����9���1�����2���\�,���<U���'�(�)�*�+T-�.�/�0�1z2�2�3�4�5�8_9+>"AoD
HNJTL�T�Z?\d`�dcgWh�iVj~n\p*s$v�w1y�}�~�������9� ���\�;���'������N���z���(�j���y�������������%�\���������������&�K�����������V�C������������������E�"�6����h�O��{�����g�B���������������~��K�=�B�u�g
	l	9*t�<��l<!�F���� "�#Z$+%o&�'�(*`*,+|+�+,L,}-�-:.�.(/�0S1#2�24�4'8�9�:�;�<�=k?<@
AQB�C�D�EBFG^G�G�G.H_I�IJqJ�J�K�LqMCNPOPuS�TVWXCY�Z�[Z\�]_�_Ga�a[b�b�b5c{c�d�diefWf`g1hi�i�j�koip�q�r�s�tHvw�w.y�zj{�|}�};~�~�~<���������A������������K���y�����*��������L�������b���������0���������o�|�A�G���[�����5�{�&�t���1���[�+���
��������9�~���	����L������������]�c���w����Q���B�����M���w�G��&�����9��U�����%����h���4��������y��������(�m���~����X���i�����C�������l�8��������c�A�)�������
���	q
k8Y&5+�I$��]+N�Q�S�U�Xj�� �[�o�t�y0}<�ʃT�r��Ӹ��*
�&5�7��p���#*&+�@�B�E�G�H�H�I����:���k���v.�!]%4+�M[Q�S�U�X�[�_a�i!�[�����	�	�
�B�n"B##$�$�-�3�4�;�<�L{UDVz[fh�ort�y	}�������-��K���ͨ5�d������T%}&�4s7�9�drgmh�i]j�}�~�{�����L���6�����S�ӓc�{���6����������.���ήW��Z�O�6�-������i�}�:���%�����L�c�����������a���:R��'�Q�L�x
^��
�M I"'F)p*],E/43�6�;+>�B(ERF?H�J�N5RGWxYE^u`�a�ctfj�m�ru�y|/}�����������������u�����M�<��-��۱ʵ������i�X��I�6�������������\����������K���z��D�������v�������c�����<���<�������S�)t�,��&	@	�	�
�
~Q`�3�U����������
RM�����������
E`�3�Uz�������w�
FA�������������
/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�0�0�011111"1*121:1?1C1K1S1W1[1c1g1o1s1z1�1�1�1�1�1�1�1�1�1�1�1�12	22%2)21292J2R2Z2_2c2k2s2{2�2�2�2�2�2�2�2�2�2�2�2�2�2�23
333"3*3E3M3U3Y3a3i3q3v3z3�3�3�3�3�3�3�3�3�3�3�3�3�3�3�3�3�3444"4*424:4B4J4N4V4^4f4n4v4{44�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�4�45
55565>5F5J5R5Z5b5g5k5s5{5�5�5�5�5�5�5�5�5�5�5�5�5�5�5�5�5�56
6#6+636;6D6H6a6i6q6y6�6�6�6�6�6�6�6�6�6�6�6�6�6�6�6�6�6�67777 7(70787@7H7P7X7`7h7p7u7z77�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�7�788888#8+838;8C8K8S8[8d8h8p8x8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�8�89999'9/979?9G9O9W9_9g9o9w99�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9�9:::::":*:2:::B:J:R:Z:b:j:{:�:�:�:�:�:�:;;;;;$;);-;5;=;B;G;O;T;Y;];e;m;r;w;;�;�;�;�;�;�;�;�;�;�;�;�;�;�;<<<<<$<,<4<E<M<U<]<e<i<q<y<�<�<�<�<�<�<�<�<�<�<�<�<�<�<�<�<�<�<====#=+=0=8=@=H=[=c=k=p=x==�=�=�=�=�=�=�=�=�=�=�=�=�=>>> >(>->4>;>?>G>O>W>_>g>o>w>>�>�>�>�>�>�>�>�>�>�>�>�>�>�>�>�>�>????'?+?3?;?C?H?M?U?]?e?j?r?z?�?�?�?�?�?�?�?�?�?�?�?�?�?�?�?�?�?�?@@@@$@)@1@9@A@F@J@R@Z@b@j@r@z@@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@�@A
AAA%A-A5A=AAAIAQAYAaAiAqAyA�A�A�A�A�A�A�A�A�A�A�A�A�A�A�A�A�A�ABBBB B(B0B5B=BEBMBQBYBaBiBnBvB~B�B�B�B�B�B�B�B�B�B�B�B�B�B�B�B�B�BCCCC C(C-C1C9CACICQCYC]CeCjCrCwCC�C�C�C�C�C�C�C�C�C�C�C�C�C�C�C�C�CDDDD'D/D7D?DGDODSD[DcDkDsD{D�D�D�D�D�D�D�D�D�D�D�D�D�D�D�D�D�D�D�DEEEE$E,E4E8E@EHEPEXE`EhEpExE�E�E�E�E�E�E�E�E�E�E�E�E�E�E�E�E�E�E�EFFFF F%F-F5F=FEFIFQFYFaFiFqFyF�F�F�F�F�F�F�F�F�F�F�F�F�F�F�F�F�FG	GGG!G)G1G5G=GEGMGRGWG_GgGoGtG|G�G�G�G�G�G�G�G�G�G�G�G�G�G�G�G�G�G�GHHHH&H.H3H;HCHKHPHTH\HdHlHtH|H�H�H�H�H�H�H�H�H�H�H�H�H�H�H�H�H�H�H�HIIII'I/I7I?IGIKISI[IcIkIsI{I�I�I�I�I�I�I�I�I�I�I�I�I�I�I�I�I�IJJ
JJJ"J*J2J:J?JGJOJWJ[JcJkJsJxJ�J�J�J�J�J�J�J�J�J�J�J�J�J�J�J�J�J�JK
KKK"K*K2K7K;KCKKKSK[KcKgKoKtK|K�K�K�K�K�K�K�K�K�K�K�K�K�K�K�K�K�KL	LLL!L)L1L9L=LELMLUL]LeLmLqLyL�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�L�LMMMMM'M/M7M?MGMOMWM_MgMoMsM{M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�M�MN
NNN!N)N1N9NANENMNUN]NeNmNuN}N�N�N�N�N�N�N�N�N�N�N�N�N�N�N�N�N�NO	OOOO#O+O3O;OCOGOOOWO_OgOoOwO{O�O�O�O�O�O�O�O�O�O�O�O�O�O�O�O�O�OPPPP#P+P3P;P?PGPLPTPYPaPiPqPyP}P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�P�PQ	QQQQ%Q-Q5Q=QEQIQQQYQaQiQqQuQ}Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�QRRRR#R+R:RBRJRNRVR[R_RgRlRtRyR}R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�R�RSS S0S4S<SASESMSRSZS_ScSkSpSxS|S�S�S�S�S�S�S�S�S�S�S�S�S�S�S�S�S�STT'T,T1T6T>TCTKTYT`ThTpTxT}T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�T�TU	UUUU#U(U0UJUOUWU\UdUiUnUvU{U�U�U�U�U�U�U�U�U�U�U�U�U�U�U�U�U�UVV
VVVV%V+V1V7V=VCVIVOVUV[VaVgVmVsVyVV�V�V�V�V�V�V�V�V�V�V�V�V�V�V�V�V�V�VW
WWWW&W-W4W;WBWIWPWWW^WeWlWsWzW�W�W�W�W�W�W�W�W�W�W�W�W�W�W�W�W�W�W�WX
XXX"X)X0X7X>XEXLXSXZXaXhXoXvX}X�X�X�X�X�X�X�X�X�X�X�X�X�X�X�X�X�X�XY	YYYY%Y,Y3Y:YAYHYOYVY]YdYkYrYyY�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�Y�YZZZZ!Z(Z/Z6Z=ZDZKZRZYZ`ZgZnZuZ|Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z�Z[[[[[$[+[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^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^�^_
___"_)_0_7_>_E_L_S_Z_a_h_o_v_}_�_�_�_�_�_�_�_�_�_�_�_�_�_�_�_�_�_�_`	````%`,`3`:`A`H`O`V`]`d`k`r`y`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`�`aaaa!a(a/a6a=aDaKaRaYa`aganaua|a�a�a�a�a�a�a�a�a�a�a�a�a�a�a�a�a�a�abbbbb$b+b2b9b@bGbNbUb\bcbjbqbxbb�b�b�b�b�b�b�b�b�b�b�b�b�b�b�b�b�b�bcccc c'c.c5c<cCcJcQcXc_cfcmctc{c�c�c�c�c�c�c�c�c�c�c�c�c�c�c�c�c�c�cddddd#d*d1d8d?dFdMdTd[dbdidpdwd~d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�de
eeee&e-e4e;eBeIePeWe^eeeleseze�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�ef
fff"f)f0f7f>fEfLfSfZfafhfofvf}f�f�f�f�f�f�f�f�f�f�f�f�f�f�f�f�f�f�fg	gggg%g,g3g:gAgHgOgVg]gdgkgrgyg�g�g�g�g�g�g�g�g�g�g�g�g�g�g�g�g�g�g�ghhhh!h(h/h6h=hDhKhRhYh`hghnhuh|h�h�h�h�h�h�h�h�h�h�h�h�h�h�h�h�h�h�hiiiii$i+i2i9i@iGiNiUi\icijiqixii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�ijjjjT`�3�U����������
UP�������������
x&�&T+r+AA+C/C�GI`JaJbJcJdJeJfJgJhJiJjJkJlJmJnJoJpJqJrJsJtJuJvJwJxJyJzJ{J|J}J����	�
�����!�%�)�-�1�5�9�>�C�H�M�R�W���������������������������������������������������������������.�/�0���������/�3�7�;�?�C�G�K�O�S�X�]�������������������S"X"]"b"g"�%�+�+8NtN�N�Q�Q�QT5T$V`V�V	Y)YIYoapaqarasatauava�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j�j��������������������������������������������������������������������������������f�k�p�u�z�������������������������
��	xyz�z<��
#(-2�"�#k$N%S%X%]%b%g%l%q%v%{%�%�%253545556575857<="='=,=1=6=;=@=E=J=O=T=Y=^=c=h=m=r=w=|=�=�=M�V�V�V�V�V�V�[�[�[�[�[�[�[�[�h�h�h�h�h�oppp�tu8u9u:uz'zGzHzX}x}y}h���ʀˀ���6�7�������������܏ݏޏߏ��M�R�W�\�a�f�����������������������²Dz^�_�`�a�b�)�*�+�,�~������������f
�
�
�
�
�&�&�&�&�&�&�&�&''''''$5�9�9�9�9�9�9�9�9�9�9�9�d�d�g�hj�j�j�j�j�j�j�j�}�~�~����������ք���	�������������–����}�����F�K�СաѣL�M�T����������(�������������<�����������������
����!������������������������������b��r�������a����9>C���chm������(-27<AFKP����]b %*) . ^"c"h"m"'','])b)g)l)q)�*�*�*�*�*�*{,�,�,�,�,�,�,�,�,Y/^/c/h/D3I3�6777<<@>E>J>O>	CC?EDEIENESEkFpFuFzFF�F]HbHgHlHqHvH{H�H�H�J�JKK�N�NJRORTRYRXW]W�Y�Y�Y�YV^[^�`�`�`�`�`�a�a�a�a�a�a�c�c�c�c�c�c�c�c�c�f�f�f�f"j'j�m�m�m�m�r�ru"u'u,u�y�y|!|&|+|0|H}M}R}W}\}a}:?DINSX]b��"�'�������ʼnʉʎώ���	��ȕ͕����
��*�/�4�9�>�C����#�(�Ӝ؜ݜ���à��������������£ǣ̣ѣ����������a�f�k�p�L�Q���$�)�.�F�K�P�U�Z�_�0�5�:�?�D��������ڵߵ����������Ըٸ޸������úȺͺҺ}�������h�m�6�;�@�E�J�b�g�l�q�v�{�L�Q�V�[�`����������������������������	�������������������������/���������m�
��������L�����RU�P	�	�+1�76:B��E����� }$U%&&WD&/'�,'
0(JU�OX���������h#��
�[�[�nܬůе޵�g�<�V����a��j�h̓�*?+�F!Gbnb�}�}�����n�����7������S���>���)�|��&s+!A3C�G�HI~J\�����1���b����l"�%�+�N�Q6T�VJYwa�j
�����	�	�	{�{=7�"�#l$�%95<<�=M�V�[�hp;uIzz}̀8��
��k��������̲c����
'%5�7�9�d�g�hj�j�}�~���	�$�����ۄ���
�������Ö�����P�ڡ֣N�Y�����-�������=���&��v����g� �Y�w�������Gf��H�r����U�g/3 r"1'v)�*�,m/N37<T>CXE�F�HK�N^RbW�Y`^�`�a�c�f,j�m�r1u�y5|f}g,�
�ωԎ�ҕ�H�-��Ƞ��֣��u�V�3�d�I������׺��r�O���e������������4�������r���2�r��	�����������Q������z�WZ�4	U	�	�
�0f���"�_�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�����E�E�$crate::panic::panic_2015���������]panic_internals���S�Rˮ�,?xS����b9�~J$��u���core_intrinsics�derive_clone_copy���ˮ�,?xqE2r
%���U0��������ˮ�,?x�Ky�����}����-fmt_helpers_for_derive��_�_ˮ�,?x�j������X��� �����ˮ�,?x������{���-�����+Vѐ-��S�Rˮ�,?x!�='�?x��(<����j��-��ˮ�,?x"�҃I�=tDJB}�J���-��-��ˮ�,?x0�B�5������=���Z��-ѐ-�generic_assert_internals���ˮ�,?x��aE����O������?��ˮ�,?x�������matches�
�����|Z��}sˮ�,?x�G�pEs!�������-ѐ-�ה-��ˮ�,?x�I�D��9�U3����b�ˮ�,?x�}���;?����t6��-ѐ-�ה-��ˮ�,?x�ৱӰo��!<�����-��ˮ�,?x���d��$�첣���Z��ˮ�,?x0��h��~?$����-��-��ˮ�,?xO�}�ڨ�1��-V��;=
ѐ-��S�Rˮ�,?x`d��	�|����=G��-ѐ-�ה-��ˮ�,?xՋS��	�]��-�������ѐ-��S�Rˮ�,?xV�����X�����ˮ�,?x��TE�i���'<��\��-��ˮ�,?x��g������z��ˮ�,?xfOF���K>~D$����-��-��ˮ�,?x�}DZ�>�.��������-ѐ-�ה-��ˮ�,?x�(8Lpa����@����-ѐ-�ה-��ˮ�,?x�C1K�$'C��-b�+��ѐ-��S�Rˮ�,?x4�ZM��������@A��-ѐ-�ה-��ˮ�,?x;��e`�`�O����'�ˮ�,?xwl��ro�������-��-�_�_ˮ�,?x-����\]'�>)[��-��-�_�_ˮ�,?x��8$���n����%��-ѐ-�ה-��ˮ�,?x�6�Hcݔ
��-������Zѐ-��S�Rˮ�,?x���Cu�>��-�����=�ѐ-��S�Rˮ�,?x��L�N}����ٽ����-ѐ-�ה-��ˮ�,?x"�n�$6���W���$����K�ˮ�,?xU��v�F�J�9gl��O\��-���ˮ�,?xY+��Rf����-��v��=xѐ-��S�Rˮ�,?x��!�!N����-����@�ѐ-��S�Rˮ�,?x"���!����@)���-ѐ-�ה-��ˮ�,?x�����M��.�����1��-ѐ-�ה-��ˮ�,?x�E2��|X�U2������ˮ�,?x<�i��
�����@���-ѐ-�ה-��ˮ�,?x.��e��t���-��-��ˮ�,?x�Ճ�Cb�����2l��ˮ�,?x_�f0�d�t>Q_z��-��-��ˮ�,?xd�Ag5S%�ĕ-��;���}sˮ�,?x钶�8�u���)���-ѐ-�ה-��ˮ�,?x@�.������-�������
ѐ-��S�Rˮ�,?x�0C\��W�Ջ"�ˮ�,?x�������9Tpe�f\��-	derive_eq�����ˮ�,?x'X��.������=�	��-ѐ-�ה-��ˮ�,?x�2�	���/��ˮ�,?x񹌼�魲�U.���`�ˮ�,?xsS��m@g��-`�'�@�0ѐ-��S�Rˮ�,?x�8?X�eZ*�O����
�ˮ�,?xUR�|DE�������
��-ѐ-�ה-��ˮ�,?x�tR�^�
~$�����-��-��ˮ�,?x%�?�h~>$�����-��-��ˮ�,?xS���<���O�����
�ˮ�,?x7u*jq,�_ĕ-Ȟ��
��}sˮ�,?xM�*U:��7�W���"��ˮ�,?xο�
WN5�9�su�=���-�`�`ˮ�,?x<�o��W�kĕ-&���~��}sˮ�,?x��e�� �����=D��-ѐ-�ה-��ˮ�,?x�y�S����-�����@�ѐ-��S�Rˮ�,?x�gU���J��-�������ѐ-��S�Rˮ�,?x�+)�������R��ˮ�,?x�������U1������ˮ�,?xr��d��u@��-�����%Uѐ-��S�Rˮ�,?x�&[�������+�
��-ѐ-�ה-��ˮ�,?x�M�r�7�,������
��-ѐ-�ה-��ˮ�,?xX��цf�m��-R��5=ѐ-��S�Rˮ�,?xt���+�/��-�����=Iѐ-��S�Rˮ�,?x@MB�a�19�������ˮ�,?x���0�Y�O����[�ˮ�,?x*
m�Q\!��-k�<��E�ѐ-��S�Rˮ�,?x��/�K�7�W���"	�ˮ�,?x�좃wŒ��9xs��-��-�_�_ˮ�,?x�m�tu3f���-��q��t~ѐ-��S�Rˮ�,?x���iͲ�������ˮ�,?xP�U������-^�#�@)�ѐ-��S�Rˮ�,?x�|Sh}óQ��-���ŗ=ѐ-��S�Rˮ�,?xM�O���}�:���������ˮ�,?xX��2dl����-�������ѐ-��S�Rˮ�,?x�$����"j��-w�S��=�ѐ-��S�Rˮ�,?xq�K�\�����2\��ˮ�,?x�
H�"�f�,�����5��-ѐ-�ה-��ˮ�,?xV���#(m��/�����w��-ѐ-�ה-��ˮ�,?x�vxM9ܧ�W�� ��ˮ�,?xS�����
t9�{��-��-��ˮ�,?x�͈+�!�AHZA��-��-�_�_ˮ�,?x�1`R�xb�����@O��-ѐ-�ה-��ˮ�,?x�J������-�������ѐ-��S�Rˮ�,?x@CmD�ݲ�:���n��ˮ�,?x�sc�����<�k���-���ˮ�,?x���"/N��U,�����ˮ�,?xs��*���F$S���-��-�_�_ˮ�,?x#��f�=*ĕ-��5���}sˮ�,?x�xjP��/��������-ѐ-�ה-��ˮ�,?xM�SM�VbV��-i�8��=ѐ-��S�Rˮ�,?x;�3��A�~9$�����-��-��ˮ�,?x�t��̙�����n4u��-ѐ-�ה-��ˮ�,?x-5w&ݱN}��-��m��@�ѐ-��S�Rˮ�,?x�h&ՙv�C�쬣F��ˮ�,?x�5����tA>^T��-��-��ˮ�,?x�}�@�5����;=P��-ѐ-�ה-��ˮ�,?x����j>@��	�����-��-�_�_ˮ�,?xͨ��s��#�:���i��ˮ�,?x�I>5u�Tĕ-L�͗a��}sˮ�,?x?ns0J�Jĕ-������}sˮ�,?x�êew���-������Zѐ-��S�Rˮ�,?xR�tE`��O��;�ˮ�,?x��L��#9�<�pq
��-��-����ˮ�,?x���{�b���-����n4�ѐ-��S�Rˮ�,?x����3�^���b��-��-�_�_ˮ�,?xMl�a�6��tFX���-��-��ˮ�,?x��Jn;�C��U/����ˮ�,?x�d�f�<Y����E���-ѐ-�ה-��ˮ�,?x�␮x\���i4��-ѐ-�ה-��ˮ�,?x2�Tq�c�O�������ˮ�,?x��o50~�\~A$��4��-��-��ˮ�,?x,�[H4�R����@���-ѐ-�ה-��ˮ�,?xq�1�#��O������ˮ�,?xld���t	��^��-��-��ˮ�,?x�U�p淩��-�����=Yѐ-��S�Rˮ�,?x����/
@�:���:	��ˮ�,?x�	Ƶ��>��-t�Nٽ��ѐ-��S�Rˮ�,?x.��􁱡��O�ˍ��ˮ�,?x)��PD=�<�tP��-�`�`ˮ�,?x���>O�a�t�����-��-��ˮ�,?x��d�B�~F$��E��-��-��ˮ�,?x���ׄn5����=���-ѐ-�ה-��ˮ�,?x`�I������/��-��-�_�_ˮ�,?x���7����-������<ѐ-��S�Rˮ�,?x���s���������ˮ�,?x\�N����U5�����ˮ�,?x��쳡�����-��i��@�ѐ-��S�Rˮ�,?x^k6㡩A����@��-ѐ-�ה-��ˮ�,?x������8���5=N��-ѐ-�ה-��ˮ�,?x�4�n����-��������-ѐ-�ה-��ˮ�,?x�
H���ϕ~	$����-��-��ˮ�,?x�t!-n]���-�����@ѐ-��S�Rˮ�,?x7�<]��:�:������ˮ�,?x�� �95���O�����ˮ�,?xG�L�׌���X���"w�ˮ�,?xў�qg���<By���-��-�_�_ˮ�,?x�r���Xtm��-��}�i4�ѐ-��S�Rˮ�,?x��؟�m~$�3���-��-��ˮ�,?xU#illQǧ�������ˮ�,?x��H�\͜��-�����@� ѐ-��S�Rˮ�,?x�8{m6��t����-��-��ˮ�,?x�E�yFYq�����e��ˮ�,?x�P�WY{��O�������ˮ�,?x9�y�_�L�������ˮ�,?x�䵲��a���2���ˮ�,?x~4
ƸOBo�-��������-ѐ-�ה-��ˮ�,?x�f���{���J	^0!��-��-�_�_ˮ�,?x�
e��(���쯺���ˮ�,?xwöL�6g��0�����o ��-ѐ-�ה-��ˮ�,?x�+u�3����-r�J�)�"ѐ-��S�Rˮ�,?x������'��X��� �!�ˮ�,?x!����$�t<}M!��-��-��ˮ�,?x� �d߫���-������I#ѐ-��S�Rˮ�,?x�(�^E�K����5�!��-ѐ-�ה-��ˮ�,?x�+ou�^.��-e�0��=�#ѐ-��S�Rˮ�,?xuhE~��������V ��ˮ�,?xN�]���}��U4�����#�ˮ�,?x�NNjB�!���-~�e���X$ѐ-��S�Rˮ�,?x��d�#��?
s�#��-��-�_�_ˮ�,?x�+�טJ������@�"��-ѐ-�ה-��ˮ�,?x������0�U-���e$�ˮ�,?x��3CNӝ���*E�ˮ�,?x�I=�.O��tJ,b�#��-��-��ˮ�,?x�7�8?T�0������#��-ѐ-�ה-��ˮ�,?x����V�E�E��ˮ�,?x��Z�`*�����5�#��-ѐ-�ה-��ˮ�,?x�<�{�M�X�� %�ˮ�,?x}�l9�Z_~<$��&��-��-��ˮ�,?xv��^��*��)<��
%��-��ˮ�,?x��5@8O�Dbf�%��-��-�_�_ˮ�,?xWZ[�x���ŗ=	%��-ѐ-�ה-��ˮ�,?x�L>CJJ����=H%��-ѐ-�ה-��ˮ�,?x���N Y�O�����.%�ˮ�,?xk��������=�%��-ѐ-�ה-��ˮ�,?x�B�͠�a��ׯN$��ˮ�,?x��O�q�$�t?�w\&��-��-��ˮ�,?x0-�22��o��������it������b��r���R����`w���e��������^�~k�V�
Ј��Z�tsˮ�,?x��!���%J�0�tsˮ�,?xu����U�"�]�tsˮ�,?x���f�����
���tsˮ�,?x!Jk���*�Lx���tsˮ�,?x
�h�<��B��J���tsˮ�,?xU4�d�D���c��tsˮ�,?x�[S��Q�����A�tsˮ�,?xA��ih���:��o�tsˮ�,?x��B�U��!������tsˮ�,?xh�*Dd���׌��tsˮ�,?x�������0���tsˮ�,?x��i�����$��(�tsˮ�,?x	2o&�l�����W�tsˮ�,?xI�H#� fg�����tsˮ�,?x�
��D������tsˮ�,?x��[������+ת��tsˮ�,?xђ��� �������tsˮ�,?x��I������H��?�tsˮ�,?x0�5���w�&��m�tsˮ�,?x��;>�`a��KM���tsˮ�,?x)�\�#�"�CD���tsˮ�,?x[:�駢����tsˮ�,?xm�j�9���ӿ&�tsˮ�,?xB��'J���#ԢT�tsˮ�,?x`��S�t�9������tsˮ�,?xA�z��8��@����tsˮ�,?x9�
���������tsˮ�,?x6�<B��kc�*ɩ
�tsˮ�,?x��`Oj{D��Ep�;�tsˮ�,?x��,��G^�B�i�tsˮ�,?x��Sz�v���ޔ��tsˮ�,?x��Q�)��&������tsˮ�,?x�i-V.tn�=���tsˮ�,?xpNe���������#�tsˮ�,?x~s&Q2ZX�G��Q�tsˮ�,?x�t�Ӥ�����tsˮ�,?x�C�$�Q9��%���tsˮ�,?x�����p�G�FsF-F�E�E�p�G�F�FJq�E�F@F�E�E4qE�G�p%G�F�pF�E�Eq�D�GEGG�F�p�E�EAqE�E^E�p�G�G�p�F�FSFqE�G7G�F�F}F1F�E�EmE;EE=q]GG
q\FF�pUE(E�p�GAG�F�pDF�E�EzECE�p�GkG�p�FkF$F�E�Eq�D�G�p
G�F�FNFF�pLEE�ptG3G�F�FwF)q�EgE�p�G�GXGG�F�pF�E�p#E�D�G}G;G#q�F:F�pqE?EE�G�GfG)G�F�FfF)F�E�EZE1E�D�G�GIGG�F�FIFF�EEqE�G�GoG.G�F�FoFq�EbE6E�D�G�GSGGqWFF�E�EQE�p�GyG�p�F�F5F�E�E8qE�G�GaG!GqaF F�E�p,ENGG�F�F/q�EvEGE�p�G�G�Gn�i�f�_
T%Q�M�J}o�k�h�d	b�X�RP|L2nsjtg�c�_�\�Z/W�T�QvNkK�o3lBi�eHb�^�[RY�UZSGP�L[Iqnk�g3d�`8[�WHRQO�K+pm�iEf�b#_�\�YyV�SWM5J>ooh�doa�]�wHX�RHsDLg[c�_�qZ-viTt<N�JNq�k
i<es<^�wY
I�v�jEu�c\``r�ZUR�N�K�q�l�ufvs�^~q�YEV�t�P$M�I�n[v6h0t5ab]g[X~U^t�O�rH?m�i�f+c�r�\w�V:TcQ�M�Jpwksure�a�]�[�X�uS�s�L�H�m�j�g�s�`2r�Z]W�T�Q�N<K�oalpi�e�bu^\�YV�SyP�r�I�nJkh`d�`-]Bw�WHUwROLYp�l�u9g�bQ_N\�v�Vu�P�M�Io�v�h�d�a�]�w�X�U�t�O�H�m=j�t�c(`rVZnmH"n�i�f�_*TSQ,N,K�o�k�h,e8b�XS7P�Lan�j�g�c`]�ZMWUR�N�KpQl`i�evb�^	\pYVxSiPM}I�n:k�gPd�`W[�WgR�O�KIp/m�itfcA_�\Z�V�SuM~Jmo�h�d�a�]�wpX�RfslL)g�c�_�qFZKv�T tfN�Jnq#l2ibe8se^xBYKIwkcu#d�`~r([8U8RO�K�q�l�u5f�s_�q�YiV�t�PGM�I�nyv_hNt_a�]�[8X�U}t�O�rrH^m-j�fKc
s�\2wWYT�Q�M�J�w�k�u�e�a,^�[	Y�uJS�s�L�H�m�j�g�s�`Pr�Z|W�T�Q�N[K�o�l�i�e�b�^>\�Y5V�S�P�r�I�nok&h�d%aR]`w�WnU�RAO4L~p�lvdg�bv_t\�v�V5uQ�M%J.o�v�h�d�a�]�w�X�U�t�O�H�mcju�cL`"r�Z�m��ODHT ����%"\�_�_������h��j�y��/���	��#����j��F-�p��`g>�	ta��`*@��NN���J@��h�ٶ�B�/��.�
��� �p�I�}MVS��Tֻ��
0^�V`*I0�E�
�>U)@��@��?�^X�In�Y>~�o$������Q���se�H?�����%ͳ�NnNx�CtP�!
T����]eS
&^�����X:@���/2Em�"^�m�����1:׃Q!�9י*���
��׷0��a
3)� �XN����!�ط�…�"0����! Q;_�\�V$��T����"`lK�	H#�~&�������'@w
�	Q��p)�[�}�#�,��N+��w�8�,@����M�-�w���E�/��Z=�00�{d�%�/0`��g��s1����
��B3	p��є�4�\�=�G�5����#��6�nR���h6�M9��$8����\�]�9�#�	s��3@w
	#���;��#��\N;r�^�is�;@뤩	�
�/�G�y�9),?���
p5�?P�xP�MEA���k	�20�B`�l�g=B�.٘���<DP��n-s�BЫio�ɋF�U��]u�G�te��opFP�"��T�lI��'��z6Jp�!*`�zEP�A�W!�BЖ�s90E�Pak�i�F ��0	į�C��3�	�q+L�{�	��ټQ,T~�¬Q@�\'JS�R@��;��!S�x����GDA�z�y��^PN�z��u��W��&'
H�&Q�?�<T��Y �:�N�,Z��V�A��~���Z\@;��>9n]�X]���=\^_�6�i�0`���
	�7U`�JT�
՛b�"M�z$�b�0mG9���epA6%�Q�Mf� J��@�Uh��8^
��VjP6/���k����v�l�n,�Jm R��D��p�J�l�! �p��QY
Q �tX��ht�׉�#{�v�L���K�t0��m��]�x�B!���Vu�ޤ
|Ǧ�z@��@����{`M�,��9�PƋ]��ڃ@�=�^ �����	\)祅@��R	�!��2�Г�`r�o=��5��dŀc�s(���0�s'}�Я��ϚЉpӾ��# �0㐌��?�����
�����pD��?�P�yA��.� �H��^"����'JW��� Оo	��1��*�o���%�
cl,�P����( E��/gS�%>.����k�MH�@��x��>+���C�'U/D��X�(�e�Y������Y�������p��#ë0��.N�����W�n��W�@����ܒ�0�#\2��N���x�	���˱��	^><������7�|�o��!�r]�A�]��(ɠ���� ��z���Q��
ݷ`���P%,���Z$�q���B	r�:�����*�`Ѧ�k��+��=�����-�����0

�
^X�������aV���"
Hh_�@g�1����`�����ɐ5��J^/� ��	������s$8��T�`�R�(��`�JJ�w�ΐi���MmK� W/F\�v���Hv@�Ҡ;��O3i�Ӡx�W����Pw�[�?�0�Z,�`(�֐
�YN֑Sِ��ʉ�נ�����`۠�{�z����P�W� S����;0���gv2���P�}�,�:�P�3A����p43j���=��	�����e�gw���<���0��
��"x�DV
�-�(Z�n]q�@f
�u���`��	V6.��В|\qS"�P^"d	{�8��p�l�Ȫ�����������p�s�D��pf�W=�Ǹ�`1/5ۭ�`EHZ�{�0h9"~r�� ف�������qF$}�P��[c\3
�ྑz�iV��P	��
�~>\��1�
���q�iAb�vA.X<���M���/��~˴*��{v�Q>Q%=&Dx	Ḧ�1�ILq�����
�h�X�� ʈ2�!#�p;��A�����q�m� ��ABSS7y�K�N�j<�Q�� 0��	
�{P�3^�L��Ot���Vg�
s�q���r�1�2àL��?��X���"b�yԳ�A���N��� �l�M�s��s���r%ai���K�&q[�l��d�&!��Wd~(��D�	�N)���c&�E0*�/�EM,<'����H�).a?q�D:/����^���11p��s2Q��7	���t3�4a�r���4�ɥ6��,3�s�8���7q3����>8!~���H�9�
�
4�V:���[7�r�����=qfq���AP?V�ja6@qw��v�\,B�
�E'ªC1O����ּC��iX�m��E�գO[-�D���o
�:�GA��	��mH�BU��h,B��l���N*J�M;�J<нBAf����_M��h��<�N���V�N���fdz�Q��l,�&�QA �	��S�ؖ�(�aSa͘���#�U���3��Ua>��~�W����g�XW[�GP�Y��g�>�R�CP
<��[��}�մ+U��e
���u^��`��/_�>���%��^�1*��I��a>#M	�AbQOsY�%�:b�Mf
����d�s�1e~i�딫^�4	j�̞��=B�j��
�z@Q<la/iA�5�k��L�$Vik��7�\��i�Wpz�s��p1�]C	����tQ����+Inv������w�j��S��y���Cm�Ãza��
��}�y!�<��V�|Ap(
L�� }a��n�}aŘ�6���o,�گ��z��p�a|�Y�K��ay��G��~����؅��8PkG���Q�/���a]�'s-���G;v��q�!v|���l�ax}lA���B�a ����Kp������$���1(l�x��w����א)�2�s9�A����B�ț�@DI	�|� Q	��6K����e��۟��i�f�]s���o‚�q)"�w��џ�P�^�Q�1ߧ5]p��Q`H>	z_�
�������.�����|:
�קQ%�V�޴��
u��'��!���������c{��<U�EA�2*��cr����Z�Q���s�'��G� =\�#�A"N8�	L���6��:��!k4�����ѡZ�U`O�aY߿����T���o͒�Qh�tk_ͷ��ͯy<�K�ްO	IK�	���A$=r�f�!����-Cڼ��h��b��1K��%%噾1�eN�S掿���S?�E��R��Q9U���^5 ���a��"������z�ġ�D'�+"áz�a	�a��A܌L
=f̷�Q�l-?�"��p,��P���O��n������!��ɑ�7u�XY��qܖd�jǑ�d�rk�ά��Z��m��q����,IB�a&eshR��A��!� ��Q�,���#Ց,//̘�֑�7�a0�ԁ\s
��_������9�u�Q1��'����#��Kh�Q6
?��^c��B�33����1F�`L�8�ܑ�z 
�(F6ܡq�G
�'�qY��
�7�L�q�'���S��w��!
�8��������k��hۇ��yY�����T��.F�ۏu	�v"�Q,G�4$��1!`wa�.��J��K��$_j/
�����@���j=��4�h	�2I7���.����Q��x�����(@M��3V�1}{h�,0���������4�5���dg�����4W�_��q{]w	�	�GR"�2~����!43
�v��_��S"��$�܅C��
Q�rbF	��=O�+�\
�۾��b���г��9N
�u�
g���
r�1Tc�
œ�"1�
���h$�R���Y�G	�W`���k$���r�,����B ��mrf�y
�
��'���L˾'���W�
�0�@��f�:z���A������~����}Ԩ�%B
�4H(��Ҍ
�y�t9�~�vY}r�O��� �l�0*r�%w$A"���Lj/!�)�
?1�`$� ���|	$��������'rS<�ѶT�*2��t�\m+�b>�L�ٿ,������-�_�0|ys�,�`�5NJ{/�Zv
���-��El<1��)� �}y2�q�����3Rb���i4�9/��5��ټ+4�6��@e7���6�&;f��4��#}�wd9"�}�-��1"'���4"l�pٍP�<�l�m�~%=�q�xm
�B>�Ѵ��u�?R�;�"�7b@l��A�A"���zeFB��]�͑{CrG ����^C�5��IpRE2׏X�vYFR9�8���y;�#�	2���3�6%
h�,�I¡��
_�ԩ:2s<�
�ZJ���M��LBzC#E$�MR��\�|{Nri�Vk�n[LB��
%g�P��1�J�2`Q��t|C2�MD��U��.u���VRO>�d�Z�c�Z��*]ZRl2N	��2ZRo,v	��f0^��[E��_r����X`"��6�1V2���,���dRhS�Cbe� ���u^krV�1���vmB��+�hKm��%����mB�M��(p���;6q���:z�r�t��v�atR�����*�tr���t�tR�^�f�\x�e���':x�2��
9�z.�1��vzBy�a��|�(���O}�H�_�S�~�r�{l�"4�*@�t~r�3�
1�ςґ�@��������+Dg���E)t�Ѕ�5�͝7���L�	���؆�x�C��&��rd`�S]|���	��H\�B���	٣���X߷v�H����o�OLK�r�֗��Jr�rǹ(@��:���
�B����d�N�]��"���Lp偕� K�
�偃�@c>����R:�����=)�A�a��R�Q�
SW1����+�
C)���"Dd�ᯟ��t��'N�R�J{i�Q�����U���¢a�v�,�����p��?8Ф���zIˤ��x���ª~�"��i
��3c�b�����g�r<A�
�A�'�Rr\<
|j1m���Q���s����n�"K��
6�9�R��اIa��$Ki���O*dob��RV'��t����	ԩ�������it�rC‘	#*Q�����z/"*��D��$}H3�ܚMF���Jv��B��2�kz��!����!�J���k�'\�R1����²^�8	ۨw���������B4bȒ����8�P��Ao�r9��x�Ȳ�F�`�ɢg�U{=.M�#���������\
t)��̲�PP	=���͂��
K��R���� 9��>�7�)��R��B.����B��4M�=�"ӆ����t�2�N�\tˇ���D�sڒIT�it��g�ZY���R�+��Z�"��	�A
�bz9�������NzK�4
5�bt咖]�&�-�B���r)N��,�%��w�r��l$C��rM
�r�%�B-��8��?��	j��\�2�b�
�A�����H���:
�������	(</�"��P��ҝ!�?��BYe���ed�F��	�
Φ�6S���ߤ�����8` �sa�C��n���	J��Ia�
�u�
ӱ��P%����q_��C5ob5GZ2
��#O�O��
�= PR�Ls��gb{dC01
CvRs�V� �pӔ�	�����H��i��Q#��_���#�6F��p��&	���s�U�."��^���K�3/+�`$������M��!����%�p#��h
� �&���"����'�T_�D�[J&cEiA��)#�[�Gy��)����	�/�+S��x}�,#���uZ�V,#�"�?��4���l�WA7��u��QbA8CH�d�)�9�ڈF��:sVX��a;S�k
/�i=c|B(|0�C�i&Q��D�1b�k�+Es��a��]�E����#F�<G�g_��- 
HW����Gs3�	��_G�gE-
�x�K#��	�V-@N	
�P�O�f�%��l]Pc�v��`P���A���P�v����UR��H�ހP�w��+�-U3��)��OnU�J[�S6�UC�6���X3�x�(uBVS�`�r�y�Xɽ��}�-[s[�3*���\�����[S�P�%kVa\�o�
WX��_ Ga�6M`S;�S7�*�a��]�p~�b�-����Or`ڊ
�T��d#"Z	Ҕ�^�=
O�fC�"S���U�5T���hۇ�ۄݡi�����J�l3�TM��m�� �<��n�';V�n�m���O�Sl��&�
�n�p����.�[�s�
K���}gtS�T���nuS, x�9=Xv�$vc�#��uS��	%R�y�e2w�z�઀�awz�s���k{���o�3={�ܭK@��{�\b%�A{��
V@����%#���s2G��e���W�	Q�M�Ӱ�Z�5��d�vd�y΋s�I�+MC�C�n������@�w��S/���.���í��!*�X�#kv��U?��C�J|

�-�]<7[n��S��	��6 ���zjF;��$Q��!f��S6�z/y>��>;�f��s�	��@��>�s$E|��:pl����C!?ş۠S��'�# ����� ���(��1�.�s/�c̜�$�Sd;�㣫�s���h����SqN��%�a�����?*/��E��Ff���+R���&	�����������u�G��
��o�$��ñ�wҨ��귯��;F
s���s���
���w�#��m�r����r,�_1ط�N�����(��d�o�
�s����8ѺBFQ�����|�f�8��ׅ�&Z��5̧-��v�㭌���HS�sihV	�_�.���2�
��κ��y�6|<��+�#�0����b�d[�1óhiV(P�j�S;�:���c��	sP�ȣ�F+s�4��s���֣Y{����	zvgu�S{�?	�}�̓o��l@�S��rh5Γ�'�5.�#G=�	�J���C�RV��
��4R5�G��n�Uh!��
�Nפ��Sڮ,	=5W��!��{$���ӕ�b��M��]�[���V�B�yJ��1�����s�!k���?�C���7�z�cf������S:�
'ra���T���vTポ��J��X���x[�}�c�.���T�Sw�}�����8��'�����u����{|hKM�������SOE�O���S��'q�o��3w�78�;��X�[�ۇ����3'�)��9Ee���v.��S9��^Bkk�jd���4�#��2��0�0��̕��?8P����#ܥIgJ�_�3�$����C�[v+��c��h���n���?�C�ʆ
�S!���,��L��㰭�d*�w�8�J�o�i���F�4j������6P`�=��K	�����E��	�7�B��v�E$�a䂎�y����4K�jXd쭵�)S+TN�9�	�tFv���^��*n`$��{��ԬU43����=��,j�������759��N[�6Nf���&��6]��T��͑jD t�h��iG"����IԶ��3$T�����t�2<0��&t��pF�d������R*���-���*ԛ�;	e��,D�ք%E{�*�DeE	�3.S��@�.��R�S+$�ʾ`�I3d���S�4�PO����5����ň7����!�x9t�l9��:��T���:t��A�R8>�o���%�C$�	���E��7�	&���F4���Y�KG�3ZX~n�F��i%	��lID��:��{JD��$w�JS�I�7�J+��,+�GKT���	�8�K$�	|(�ET�_l
B��QD�!޸��Rx���CUd[�~/���V4���M�׳V�!J�=�XDAϏ�^O�Y��ҫ.�hjYq�߉��W�h���$#\B?(&B��\�/+S���|^�9���NB�Yd5�3	�g(�W4r�,
�11�a$��[	��,b��F�	�J�"c+�	)���d4uc	uw��cD��
CE$AVD��1
�pޯg�K�:)��g�g$�)Q��i4WE�	�!Z��ɴ�n\�`�F��d��
mD+�E?�5m$
���p�mt�PK��T�o�a`�rtp���aUptD8kf'�G�u4Td�vj��u�`Z��w���QL�,u��Ҙ��krx������t$-l�I�.{d)��
�񖇀j(�
/O�ր������$Oх�������q���鑇$�g�i�Dc^�DJ0}��xZ+�5(��u��$t�;�dG5�&s�W�d�h����^��0�&
�Ҽ��T���>Mx�dzI��47���Ϗ��8�g��u���n�Ԝ�5^�W���L�C��r�hh\��ʊ��b��ud������\���dU����ݚd���������-�|^�Й�[�+	�
N�D�gA�����qF��ţD9�p	Y���D�T��
��b4�HI&ê�1Q
��j�$�+
 �QI�4����x��$t�Y�����y	|h�����
Q�9����{
Bwr�D"K�
IG$�A3�U�.���~B}��}��1�L&϶$>rQ��G�ԕ� �7��m�*���.� ���L�Y�&����*��6����>`d/��6�t,�!��X��olY�hp�$TV�4�-�ٸ���$�ֽ�>.�Ԛrm���$�)
y�)S�0� �|~���qxD����D�+*��Ҥ�e�
U2�]�ded��a+��|�����,�$�eJB��hڄ��2���Y��b=8@�Y��$����q��t���	�$v�$3����*޴�.n���d�Ra��@A�tX�Ir&%��T��2�>�4��aj����"&����vE�)fI�r�0�J���T�vfm���j���6��4���?��甓�!H��T�u&U����yb�Uj[����c��6���	$������g	�'����5�	;n���+'�
����t���
M_�/�Tjum&m�$��������d�v[����d9����K����Z�x ,K���x��t��r�������wXE�|���OMsEDH�T
�x�H���r>��[��x��W��w�t� C�4;南��O����t�������#�D]������ut�O
m��Uu��N�]�����^��l���?XSƾM��[�cS��SUBm�.Ǚ�堋
�"�
�)��
:E�gU&�qjw�uE/3T]�a5�����-P��>vU޾&9�5�U���Oo?ŤY���#��������U�
5.LU5@��%[/��ؤw��s�U
H�	��K�����
T=F��"��? u�3�
���w!Ň�C��\ ��iao`/W#)�����!�˵�e�%������"�lzI�'�	�2]��(�h!7����)UK�+j~*�*E��< �g(C�=$�,�2� �ܕ,U%�ih�,��m��i,U���u���-uj�[���'�8*0Ow�3E���D��6A�4憔:ſ/:	�<��r�{�=5������>�r�,b�n@e"��	��ABU�v�q�.�Bɳ	��D��k�
��vE�29��ŠF�A:6���H��m.��AIIekp��ծH5�����Je��q
n��5L%�3�3�TUL��ؼ�鑚N�
�9�D��O5H�JZP�x�)����NY��
�IcNu�4B��&�S�$��Z�f�L巵��׉CXu�	X�����&]��
��a�]u�U����K]��>
e'#a�}�>t�"�c����	����guH|��SjHL�q�%�kE���6�dl���i�Yk5�N��l�Tu����oX*�s��p%�sk$޼�qŷF���o�ԓK	�rf�n5@��	��B�t�q�X�A��v%BU�G��s|5�p��R�~u��^��CI~E��cb��u8�G��pɁ%͊�`�gr��M�-��Q���YMa�����`L�x��e�Uex|gM�Um�����օ��x��T5���^��(g��\�	��ӊ�7@�S�el��WU�|blVZ��շLp��!��Кe��;v�U#3�N���n��	t8䣐��m
�:iؒ�;������!��
/ۖx�E�h�5�#����
�
j̖Ur�[~��ſ��v
y_�e,�HS�z�#/�!�յg1��(��UarN
K�H��5A��6���5���ҏ�&��R&���2������IߝU�֒	NU/k�_k=�ʰ�%Z�\���[�uG��
	���Ľ���U���q&Qsc\����82ҫ�����i������x&�Us��i	�����Q`�a9��ET����1ާu&�
PV�����RS�A�e����o�T�E�u68߆��6��G��~�5��걥ls��Y��%t��	�3tZ�EFuXPk踅�����kY��O��B+���H��F*���x���5�.��Q�"�̾e$B�#����,��lph�5��x�4I �e��w
�"U�������U�����k��^:v�,���e@ef��t1å�����C������<Ʌ/����'�5�/�r�e�D�==�_�pe�������!�Z�R!�5�W��Y�G�5yԔ���jͅ��
����u���l@�U`�E�x��U<���0e"�	#[�?6}�.�t6i���z��œ��w���lŏܥ��@�:�2��$-hI;��#��2�/ߕ��b��2��R�)�@-:��jb��d"���E%�0@ޅj	��lL��w�]�=!�%�;��c[��u��'�ɪ�����K��>�����������$�����&N�,C����A\���ErӇ���eIu�2��U|���,j�5[�	�����U`*���k���J��O1���,�����Ūƚ1����1-�Igo����K��%�����ud�+.f��%���<+��e��U��B����TiSIN���X�B��U`	�:��/�E���>�^���`�e	k��e{/W
�^���e,_
���	�}� �&A`���I��w����u�gc*=�n��Pt
��^^Ɩ
�BsL	�i�Eg��_}���
�"��v���hf�R�V/
����{������
���?�u��|�zf�,g*?�V�j��/I�*�:��╈Ȼ=�a�
\L'n1�F��ds�	R�F��1Go��1a�w���1������A���>?�k�2�}Ǡ;���!v�#����"�]�5k�6և5tSFn�	�M~46S��	�ܾ$��|
�ޛM&r�
4�f���8B���.f�A��ڹ�/�
����0vH��[�1V��^3�l26���M�	3&����϶3&�k58V��6Ƶ�bQ��y7��V�����8F�����8��f�m4Z�:V��i���h:�e����:o۰	X|��=�b�g^2�>�Ƙ�޶��>6	PL�{@6Ȓ��L:6:LC
v�X�B�	]���C�k<^8�aDֵ�T��&UDV��Vڝ<3C6+3q�zg6E�@$�G�%G�/��1�nbHf���f�{�J�����1�+K��zT�^H�D��	4d��Mvcgi'PLV��
q0��O�.��Y7��PF:-��P���|.�D��m�����S֓bw���/XV~�	��v[�O�b�kP\J��	��#]�qf|}�T�^VGRtH�YF_�,6���Kqa�����g�bf?�a"�Ze�B}�
��Nff(Q��Q4gV�]dp���h�Fd�V��Di�.�
@On�j63��
u� k�؉���l�"��9\ji&ӊ�O��n6T�lD1ho���c��2n8��U��qF���C�r�q��O#e�r�w%*@�2rF�^_x��8sv�z'����s拋�&���oF��	��H�x֢R'�y��Ƙ�~�qvF��Q!�{v��n�V)�|���Q}���mhK~�}� n�[�o�}�������}��\/)#�*}f4�j�fՃ��	4���t��d�7̈́xd�Yd�H���	r�pچ�e�\	�ޜ4�fN��	yp�|�f���a�q���0
�QQזFU-�
=�v��������i�����td�*�FT=������-��#Z�G�F�Ѥc2'��f���^���v>��}WU�����"6�&Z��ͮ������E�N�6!�~	�6�B�V^�	��Gן�bJ�
�8�2��"�!��R���U^C�ߦ�	�j�:�F�"j�f�D���"(	j�(_����g��$����|�t������s{b�o����A��b��uh�
7,��fG�����N����*
���6�%��,�,�摒5�����c�����&a�	��t��V9	`6�B�몿c����&#D�
O������%i�su�f���i��Fǖ,|��6H?Tʒ�6�<�������vPf��T��ˆF!}l��/�f��"�H����`�J4����zg�����q^)	 A���V�j�
������Z���Ӧ`�ɛt��ǐ"X��6�x��a�\��Cu�-�ֶqp����"ن�:���f����������1s�����W
-sS�.�&�>=�%�Uj1��RO�V�� 	�d���f]�]��u��?�T����|���9P��F2u)Y�`��&F��`�fD����nƑ�fC�%�PK�������'���&���Kw���G�;'u'��f���T�b�#,d����/��Й��V܄�����F�6�;�b�^�.	I��)�V(z��K���f�[|3�����86,��&��1	{m�%��VW	�Fر�
��	��ZK�fHo�	�b��F壹	}��B�6	=�
c]���$�ʟ#���������:������i�n��25��1�	W�}����
���D�
aSt����9o67݆'.=$*�w>J��������j�7�w$
����V�͵�G+����N�CX��n�w�dwJ@i��.��ф��A؂$דLgF��A�-wC;1#�g����Ww���|��Z�G����d'h����B�J9 �#�E��%���iv���`dR��#�c���8?$Gm,���Z�w%�	J/�*@�S	��3'�
i�!�'�)�
��s5)7T�5
�0*�+��;*w��
��נ ����;	�-�xأ	:\�.��1��d/����z��.������-��
I�a�2w2#��Zm.�:4�d�"���,L�4.��C����,G�ev����7w��
v6�8����]��8�B���v>D:g�5����;<uk��:��<$�O�8��z�	)?Ĵ=���

��q?W�q��bA�(fg��L�Eg(~Y U�E�_���FEw<�#
|�AG�8�U
�w��G�/�Jq�H'(����2K'm��
rk�N��'bNg�R�L�u�<eTw��ս�SU7^T�	|�w�V'�/V;_�T��[
��UǢ_H/MZG�~Ar��[g��Z	oxL�\'M�vZq�\7���mb_�P ��Ϫ�e'�zf�u8f���W��be781��e��Qg�cK�i��o
�#�i�Lq���gk��ě9�nw�!U׳�n'�]Q�^�sg�R�v��u�
��"lvG�1Fx�Tw��C�ģ�vg_*�fR:�|'���P�$�~�������˭�y�W��sw������q#܇�Qd/	Q�_z�w �������i'������'
`��(���@���T��	̪姑'&��c#_�'"'v��?V�Wm���Q�����@c�֩��,���ǩ��˖񙗳"h.b������ʒ5��'j
��4s��c��
�JY�����:�]��o�ڣ׫kZ؂�ӣ�21嫐[�wh	�ݖK�����+w�8Q�'�o�]��7Iu�(�֬W!��Tr��,(��F�zU�z�г�!���v�-�GK�� j��&ӢkO�i��o V�b�w��2Z⌹��C�ywL�g�n���2g��r������#)�V�s���s�S��O6�	�&]��W38
AT��g�i����W�h��t����@.�����j��	��
�÷��Y�=���V�]��S��W����V���B�`����g5���4&�ʧ�;.�5������y��_�w���8'��g�+�b��̧{U3=�u�W��	S��w�Ƿ�����g�G��[�D��צ������wA�W�r+���y���|�(���'C�w�)w���N�����A��Q�~ҁ������J�o[L�gU4����g�8OL�?-	�g�</'����L�J	>8㧻@1=�WAQ���n淇s���J}�H����!"���@
4�o,�WӳB����+���pP��ו�}m���7��Ӷ�7�h
X�!w�'�]Y+���+
(6��\k�N9|Q���R�!H@�,/�����K(u���W�\*�|��g��%Ho�W�$��F�F�1�TIB��XC�5�����\(�	Q�,����(x^��4���%C�&ts�	h$�dޜE!(j�*�O[B
��
<%v����Y�]����^�ׯa���'��}����������ުN��xa[f�8�Xb�������;i=�{��P�h
�J�!m  hI����L!8�o�5�Z$�t��e��z&x@ �����)(�7	V�1�)�ei?���+�3~��ĺ,��}�
4&/~-�Q���`!.���*	���*�p����^08���f���3��2%t��5�15��?�L6�e`�+h5'��_K�:(�ٌ����;(���.�n<�1*�~<��:��G�k<���H����>ذA��҉@8�מ���pC�(�I�k�uH�)�*�l�Lh�Z#h��gL�7�H�8�OxC�C�ދR(�@&�ϭ�T�գ�s�>V��9��o��X�=���j/Y�V1��'�hY�����uZ��=m(ρ�]HůHB�^x����LƩ_�d�j��
_8Ab�	e��Da��|iu�_X]%
01ec�|1 ���dHD��*�dX�}��oWc�U	�k.e�&�-Q�fh�5�G����_�`�0'D�.g�&)E�f\�f������o��^�M<��p(���p%y�p��$�	J�Q�o��6���Q9s�5���t��:`g^u�8�du�F4=,/�uh��m	*G��xXs�
�?��v��=�
���z��A	��r�{�
_Y��|X�&I+�_rH��K� Q$��3�H�U�Kd)I�x=�$�Ŏ�x�}m�p��x�"
�����
Q{~��v�	���Ƈ��/�q��2���Q��^MǪ�������&�%퉈iY��CP׌ȶ��D�փ��K��J���k�@|Z�X_��1S4�8Q����Ő�4.
��?��9m�6���G�
VJ��؄�_��I���
�\���?�Hx���`������,�F~���ה
a��H��aj��X"\f�������kBH�z���#�6���	��U^ȣxj�%y��v�jİJ�8>g��m��8^��Hn?��dfyAPM��,q~�k�8���
�K�q�h��)���&�HE��M	��x�J���X�����
ͮ�U�7�-��x�\��7����Y�u䱸l@��՞ȱ�IÄGYYϰh%��YӺܰ������طz �q�������舽q�=m��%���gʺ�'��"�]��98��������m�ȸE!�gC���\4iLn���D�
-��ʈ%�:
�{V	�8
>G�i�Έ1�(�afPи䦻0�K��8O�z���M�d
�K��8�_����l��3-	�/���H�}�'���豲�
av��܈z�_�w���I��9����ZL���ȷk�C��(3�b��r�䈶����{_����Z�S�XuB�&�%&�P>���/^��G��	Bm�����?�:��h�k	�"��h�r���5��h.������x
�N��B��hG8{�_���E���	���hύ	�/ī�(��	yH���(̼�t���8�e�69���

��u�q��K��ڴgs�)n��l����H,�*|����0�	�#�O�(�O7	H9��h:"��Oܰ��,"��2q�h��3
Z��h�X��"�s���ۏ�L$�X�t��Ռ�ٟR
rK�8��%&&�)�&�	������-�ļF`yã�G�
��%n	�j�)��q�<…�
����T	Y}���NY�D�Ui����y��㮪ٰ�	|t&C�~(����
I>>3GV	��tl�9�b]���̷��ܓ�J�E�Yػ�3OA!y�|\�.�")��$���!�EJ�6�*I��-���$�z�	[�+#yR��	��]'Y林}1�(ٶ��!)O)9�j�?����6��)�N+)E^E
��@�*yF-M��.�=�-]˗�.y�9��.�V��|]�1�J��	����2y��G8�^3Y,Lu
��g5��V`ԫ�@6�g5|6d��6���_�*9�>�d����:)�~	@Y�~;hiH^j��<i����4�<9y��
!�^=�_�@	R�o4?i�Ŷ����@���E�r�A��	R�S�=�\Ĝ
�j�:E��r�I�OE�;dw�@�H�~6UfЯkH��V��B�J�MD�Æ��K],]���M����>�aO95���F�CR�����uz[S����21S�����|~Uy��;��	UD��q���U��FD$��HX��%}|�YI�F�(|%�Y)`��
€�F[)~_�q/Y��5��G�%])�;
�nk3_����bp�`iٞUj0�=b��%<Q��cZ]⳥kd�?��`�$byx��YE�b���~��g��"Z����g�A�Y�1�k驅s�M��ly���l$	�o�!�
�y�pp�:��գ!q��{�~�dry��c���qI�N�M��q�5h�	���u	nu���nvv�qV�
)���r����ķ�x�42+��`y)�J8Ԇ�zyq�����w{9��hu��{YP"0V!�})ؒ�����~�1������]��g��|YI�t	A�����%TR���߂	��}�N3����Z�-yi�T�	�膻|I	�	�Є0{	��v
�O6`��W���h������Y��)se���ꊩ.��rY�e�	��Y�׀I8�
�s��yKy���ڎ�y����w���;{�7��)^o�
@��9{y���
��x���$f+<�����ӂ�I�q�y�̗�	��vO�lJ�,4�����t
�����9Ԛ7�t'ޛ	�۰��0#��Hu�
�汞	�
C�D'���D�<���0q7�杞i��rl4�ʢ9���������62c�ǣy���J\�m������+^��k�� �ˠ	*�R�����x�Z
����ad�(\\������g�^�9K�,/A��ɍ�kD"��J�G`t�����D^�i��>�n���8JK��	g��&�Mz~K��:4
�O�)�l�WX�v�I�y��9<����*�'�'�۶	
��4��	PbCAH���D_B
��٪IR��
��Ib��
��:����6�V�&���5	��n����I����)Ns��s�ٽ�b��3&��K�LV�Ù⃕��f�����״��ř�2����Gƙ����S��y��Aw��x$'�w�N˩�&W��y���f����9Q<�\���		��+Qϩ82��R'ϩ�5��b~�)�+��1e��Gu��&��ѹ�"���hYҙ���"5>���A�~;�)���d�@������/�X1�y*���̤�i*��	�t����H
��	����K��	���,�$ݙkn�����Y����`Vm�)�2�!��,ʷ	�@X�����.���l�)@��P	/�Vo�*.�=�	�>�����o����+>�y�.�Q3��I6b�x�@�i챳�@�u���\|	��z������7���������ڌ	R\���y�p3�Gx��F�F ��y���7ڍw�9x�T	�ͫ�`��?������	C�i��i��f�#�YI��xF���
Z��g����
�ӝ��`'_/�YTz�w�W���ImCcc��}͇=然���=�y����|��ϙgJR�vے)
FW�C�}���6�'��
j�wxs��B(vu�>�f��\���u�	`�&�	�>����
j9q�?C*�X
��&����
���Z`K����|���0+ZS*|XZ�>���E)��x�q�D�z~{A���	a����>a�	�ؒZh�a.�JΕ� ����@GT
��*�0@e{����L�Jor��Lt��<�z��Pf^pj,��
c��
��!���S�
�#�����B�G��{� 
�/�
|^
!�s��J��"�7�GE�&#z�`/2
#��1�FU^d%ʳU��G�!Z�ZC��K�#��M@ZD$�{��T�)J��j<#�%
p<�u?r+���!("�!�ߘ�7�F-�fQ�+J#0U�~��/
c�Z���$
���`ݞ1
:��0φ/�Z��	èe3��e�`��4
6���ԟ-J[��	ƋN@3�3R
F��K1z�r�
>�8jv#�ψq9�Prg�� �:�/n���:�{^;�]:j��`����;
�l�
���;
ڠ�	�^�`>J�W:�a�@���x��Az���g��@j�9h�trBA*�H����B�����y�@Z<)��揯FJ�7�,L�GzÁALD�YG�feh$;[I��M~�ǶI���!pάK����犧K:�E�i��MZ���l�:>�t�
O*'�
b�6�P�$n7
���!Q�W�a`}�R:���yB�qR���y��oQ�����B$�U*�1B�
�U����}hR�N����X��*	�݁Y��=�Y]Q�Z��&KD�Z�Ca�$�_}[ڶ������':D�߆_^��]6G�rb*]�K��c�r����^�bʳ1�a�$Ne�[Y�d`�hj
2F$)q	i
�!9��k�B���6Gk��=c�Rm
��%p���l�	b
+�B2o:E�����p
m�����3pJ34@�̡�q�)�! �p
B��8���o�0]�	�NB4u�&����$�l�	7DM��w�H�c�
J�V�=t}j%��
�����+
A��
ֹ�	���]�:�Sj��fȃ�:��A���F�RQ������HM�t�z�����YɈ*K���Y��J��(S��M��^�CF�}�
2��VU䳐z�b�!+�s�J����% ���
e]
�8���7o�-	ܘ��C����H�ʖ�6QvT�ʉ��u�ێ�ڟ�0��톜�#dP625��|<�#������ס�*(J��)��zU�X�П:-�H�4�5�:Cj�O�<G�ʞ[g}��2��x���9W@�� ���E�*�.Mj���j�՞�7O��z��|9>b��z��M���*>]����岺z�
��������&e����T���<��o�D�jsp����Z:
VxZ��QB�%�<�����pO�jes��nj�ƪ�!��]��+�U
ҿ_��aj��*� ���N�z�����:A+�s���u)�	W�8G�:���	�@����%�
�%Tɪ�s#j�S���`�~t6h��
!-�
�D{�ɚUt	�� Ϻ.#UJ�y�*�(
kr��֚�?���N��fsB����%�2�����v�[�jRO^�~;�
��9*a�*��Չ�A��yB��s��ẉb��,g��1|s��CJ�z�P�*�=��7D�
4v���j[�������Z�vsd
�n�uwM{����ZG�
ZUy��J�L;����g��
�����Jdߎң��&Z�/�� �*��`
�Z��Zǝ���J��	o5�`���Y�0��v��ʭn;��}���XH�J����g��$�z� yy!�;��KK!�#��T�CT76��p��?a0�z�C)E�#�J�x�} ����{V"�ZC�X�5�1l[� L%ҋ/��>z�T^�ĵ�&�L��+��Z��y���Q����ڭê��]K�Z��u���	KΤ-��H�
� �	�h=�
�NR>�mW
��ŝ!n+w��w�� ��8��{K�#e����)��	�t����R3%���t�OJ����{s�K+dJ,ȫ@���j��_^�$�,�r[	*�"[�i��p�;.�RA��k5߲��E����HC}�kUh�躐�	:��)�yk�S���y!����϶����
��]�#K���n��$��j�X��%[��}{��%��	�jB#+�6'��.(Kʬ0�[J@(t���~P[|3�e[�����-$4���.{)؆lm��/���
^��~/;p�<���73�s�`o��4�7m�8�q5��܇�j��4�Q�	h�J�7��]-?Z8�&E�QI�8[�w=	�*k�:���n��:�1��	t�/c<K������4[��g>��TI;��9[p#K����@+��z��D�A�5�"�P�A�	D�
I�sB�eM���D;��
�G�)E�$��,��F�
�ې�G�<Y"Y7ԢI֊�lT?IK��(dL�Mk@1`GM�NQs@�	�Q�Q�6�LUQz��\f�Q�{���S�T;O�G��}U{��!�V�|\��lWK�d�V�5��r�Y����'�ASȖ���W{��8;�j\�u·
����V��FX	M�^{O-��B_[�Z�$̑�`6�^��a��xE��[Rb���_��?�a����1d�c+4h
i�g�ek�P��\}e[�p�դXgˉ�\�K�h���y��{"h�I>�Wyh;�/���h[���	R�[Vl�I	c�&�m�ٌ�#Lnk��L#ik3mk�*���%pK5�(��
q���P����q{x9'	ڌ��o+O}Y	Q�2St̮1��/u+��T��V�t;<X�3n[��x	Kڤ�f[��/
8���y{@x�u���h{sK
.���cmA�
�v�|C�W�TN�};1�4yfn~�k2��H�~�7 @D��}�%.n
/�)��{-ۡE�k�ˬ�r���+:ɘ���K^E�}�۴�/~Y���;�c�3�D���,28yKA���r���_���/�����s�{w0f�����H������YC��z�Ӓ_
�+`$�[�!O��M׏���9��j�+�)AѓK������_�Q�+8�[�|�C��zkoao@����&q��u��� ��(��XܼS��w��6�И�'H�\��d�mq���Dţ�s�j�{�O�հ5��y���5�������ڝ[g�|�՚��r	�j�K�/we ����	�r̢��8R�V�=��:��) W'�K�9���0������	`~��+U�c
d�B��2�x
L��^��G�
��ӗ����
FN�M���eS��K�t�Z�N|S܅�r�;<9>
��®�o.�38�{V�:��9�+=��+
�����
�i(����Wȳ�
����Aݴ�4����&�O����޶K�=�|���9�A>C������h.�����1 7�k5z�s�л�SA	�I�_�E�rrv�[O�	ÿ�b����	$��,���z�}�����H�&��;����ȭ��;�>�A(�Kͻ9	>+��k�Y{5�����=OB����&����ǻ�=
}�d��YA
��g�����2�q���3��?�͛�$�v�����e�W+��g�o�u��Л:�+L�,ҫ�DuR>��{	_EP<�[��2[�]�֫Փ^��x������ZV��Ka�^�V�^��t��a��K=�!r_��+���
��*�;SBODNa��{,BZ�����
��>��;��-�F���+o�D�f\��Ҁ�gK��+�L�mˀq��aPLy��R+\bm��;0����G��{]�-s�ל�p<	����KA[��Vt��딵�<h�J���,3����t%�JX��{�dq^[�6�{���Ю���)|���<��8:����r�
����{�22�а!�	��r�t��
�r���Qg�1a�_L��
�BP��H�K�,y���93�9�Ud��	l��!�0�	�Xn	L#���qo������U�;q|�oy@�KJ�H�V�fL�D��$����}
ޫ�$]Q�ˮ�,?x�ʘ(��L⬿�
L��
����h�`�T�\�GHJ^�<�Y]���\ͻ�*�#��c�gvG���xf�wk�"<$,�*p�j"\_�=q�O(l=*��ν(��}i�
�.�)$f}.0���M�0��/�^�2�1��a���
�1�F�e	�RJL/l_P��}x5\J�8���5̖��:��7n��y�7�l)m>'7H9�����a9|D�� �8I;\+.����6��e�8�+@5<{�KeCW55�F��>?��1nV��@���^	
�ӴB�
BSk���C̨*��C\nuF'�DL�)8DѱDll�`�"��E<��&�܃D��R
5R�dI|�CS��vRJ������D�K|�w�j^�M������q�M|���èAO\@�TD~�QO�	͎��Q����/�SQܝ��h��W,蓰��
#[����5�]���lƤ�^� H�L<s`,����~.Oa�r~�2}b,����?�f,�&�~f�_G��Z�h����ԓ�i���!Mjl�Hw���k<����-Al< 	?����k̉y��mL]�⋎�o����r��Gol�����r��	���t��+:�q�8t<�,���y,��y߀�y�Y	��4{lCn�B�L�{<���]���z��g�	^�f�~ܑ16�sg�,�����J��.c����7�Z����YW�)���e	燊
,s�	)_������	6,
~l>hX
��Laz<���
�(Q��L�{����~��nˍ���X#\�@�|���'"r܊�!�}k%�9����T=F�C�u��܍�Ta*��q��Q�����b=�s�2h���>�����̹*��fR_��wR�z�Yu�l�oD9񸡔L��<`�I�|i�M� �L�w�m�u�c�L�XS��������䪁V�8Q��+��w�-�����	V��N���
�4""����	xѶ���S���_;e��,d�bD���^���.��;h�'�8z
ϗc��|u^��H��d)��jt����N���
��[��
��d+�|�M+����L\��4׫��\�O;(�|PI��#���Q}��� �<����yU���R�į}x~��!�.�䰱��I6	�u��|<��CVF��"Q{��M����	a�����|�
�b}��aMakV�Ḍ�3��_<⻼^>�=�s�����t%a��\*@Ny�c��z���#w��#"�^g�ӻ���f	�����O�3��\�S�ش>5��F]�;j`&�l�ò�G�Ɯ��}���L��c���<�2�:�o�l�A\s?D��̛#hR��
ͬ
��	���^�̃	�"0�Lb	�N ��|oC��*��2�G[��`�U{rz=9�֌w���ؔ�L8E1��L�e�r��L���h���Lr�y��x��/�J�:�܃W2	E
_��\�n"	fM	����{z�w�L�mb*5c�|L�������'���ҟ�쪕|&�y��O�I�k)��^�n�Ie4���t4w��/
去y������G��L$(��[0�����+/�����& ����G������Lc��
w�����A�r
��]Q�Lb�z�%��<t�zX�Dt���@{i��<��������L�G�����lb���ʪX�ܷ�P��r�,��{�K.�M�����3��F�n��U]��~2�
M�	f�M1�]e&�پvm�����6Mc'k�]7��
����[E�������i��'���퀡#	�>ǰm��N����aA����*G/��se=3�Ǜ7�}��8i�4��#9{o�y��
�:����}؏}<;eMu0[�N�6m�h���zݼ0�	���-C!�	�W0 
�Z�	e(��"
)�0�%e�!mOk�h�$-
�>����%}yw�S/'�w�{P�(�$��1)=l��N(}��O!k�)}�:�)ڗ,����$S-����h�.�5��DS�"(
W����<*]���	�OUW1�c�g��1-�z�TC
2ͅ^R	f2.4�	ykA'mJk�
���6}���
��vg7��x�E��,.���ʋ9�_���{_|7}E�����:}�����S<}��٫<
�P��Wg�<��+KKU<�݊�G�@킭����@�ϳ���G�>�`\��tU&?�XZ�s?�qDmw�k8�Ã8���{��:3m3��¹�H�(Wq7�8I}0�D��HjH�+�}	�_K������w;K��]/��M��bc9j�I
�����P-z��	
=bPS����C9QW]r�	�r��X
=OB`���Z��-,�rZ
���Fhf[m��i	��]-��
��]�[.O�kK]=w����`���5�_am��{�\L]}ƥ�	d5�]�
I���Fz^}Z
�"��zgm���f��h�0pFr»ah�ϕ��+�l-��r=I�m-¼a�|�)m͞�V�o
X��
xp݂����j�n�v)J����m�,S�o�Nop�+~H	@�?t}(9�;�یu]�
0
���v=�J��w�d�f�(�x�9�%�aT
v�~��
��;�z�4�'�{��uiM�|}�dD-���}M|�+#6A5~
���2{��a��r�]���Ul�M���lꍀm�h�	?�L�}m�"!
E劥���t�����f�=���}�������=�7ڳޢ�mBM��a�M
"X�?B���������~�[�&�w�}KIU/�j��*	���I�Mq3)�-6��a%�<c�ҏ=d��	�2������sK���]ق���D��@�{	�&��}n=����FK]�-�}eoQ:���;`��Y2�m Ϋ���{�]�?��眽��#c�O��2U�	��o����7,��Y����m�ܹ��`�#���j��:�ˣ��/�k�b������ɵ�&����,yLϦ�cJX��Uަ���m�֨����EXv��
��V��=!���@�
�������=���Ҝ<g��\��ŨӠm���	��-����Qُ%�����/m$�M���y�g�=�3<��I�
��y��:��0�y
Ǐ�P�͜�x؂����D��	��T���F�`D �=�"�
���6�m�ƕp��=Ы�
�l��M�,���CG�-.��]N]�����^/�:�-)�QY�#����\���
{�o����͘��[���x
1&F
�
��K�_�M�z��8|�ȝ{ӡՖ�4�=Smf��ͭe���ͭl�����=���P7�3͝�/\$�C����r���E�=>L\�6��-��
l��T�=��
զ'����9�ε�֭�-�ԮIZԽ9���M 	��uq�����O��%�:�
M�B`��"�]�G�o�����
��(��M6
}�Wx�q�h|*m���(�.�F��4Z�8����h��� 5O�͏Ŭ
����=�����]�=&X^��|��-����M������@K+��M~w�R|�	��.iD|i�7���0��n+�
u���7["�}û��<���-.z�D������	��H���
D
�Nr�]��"��*q�M�s�
�"�>���8άG�-�	�mi0�ݬzPAB�<N�0�R��S�7�C��ی��դB�7LNp��տ �+��F���7��h���R�E|�	.�$�vُ�
��%u���vޭ�`	Q3Gp
�7X@Q|E>��T��Wh��q���.�M�������s^`�e�Nj.��J�}���7U�6���y�T��?�^�������ހ2>_����u
�=���樘�Ȫ�dK�J:�m��#�S���s؟t���bM��i~�qW�L�_�-b	�$�nMoI
~�H�$�;܏���'%�m"���'^4�YLo�(�Զ��;L)^ԎcƆ
(���tl�)N�k�4�+�(S�D	"�8�-.ɘ
�5+n��?
�"�m)���=��I0ND���1�4<B��VH2�	���w1�]�g
�'�4�8rim8D�4�=Ǝ�eo>2����8�	��:�&�nŃG�;~�4�;�e&:a�'<���
���L;�u�*�kX�C�Ǐi��eACN��/j��nEN#��l�FnX�����KG�'>��iH��M�B�s�I�$j��-YK�XVA�b��Lދ���.�M�ƳZ���Nn���"���O�&�_�P���
�&�PN�Y&�vT�E	?0�t�U�ֳ;<w��V�h��1�3TN˻�+�ʟX���[��GY>�ae���IY�^��,��[���w���Y�U����_Yi��)�d>ʿ�	!��e��Z�+լ�f��O�w�ۦe��z�1�%f.[��j#�i��I�V)B�h���
��l^T+>�>�p��6��q�����^O�pn8�3�sn�%v�Jt�v��e�u�w����tN&H��zz��p����{��s
a{pU�^�;�lz��.�5}��� ��}��hq"�>g�=�1́~�(�����'V���N#'o� #��=�V�g�n�%�
>ϼ���C3���s�ΐY��v�z���������^��b|;�.g�T
��!�9	���A�~?�
4��*�R�����f���|�\��2y���g͇Tb�؞���)��"�>�{��0Ӡ�v��h�X�N��p��Q��og[=j��^,��P���˳�*
~0�^�)����~�H�D<Ԛ����}��N
$	����N�U	���2����;�䵸�Y��:���^G[�F`kԛ.m�m�ᴮ���
�$�$���KJ
�Lu������
�$pb��)<I{UΦ�^�_	�h��^se��Lx6�~��[(d�����D�����4	R��%�NE����5ǂ�
���I��k�
�� �@Y}aA�N_s	'H�Þ�G��fa�Ď��T�ž��~d/��N9����w�p"z0��Ȟ�P��}î�}i����ʞ��z���6�y�&���.v#���r��n��_
�p�;v�p����~�d�
��Kl�����SѮ�kp
��wЎ��OA���q�F�l��N�s�Tò3��2��
D#f֞L��p,��_�F�H7��nxʡ�ʧ�~�������M�l>�+�!%�	�یK㾱��~���N��E�VM���/y�"��~?��5`T?��4f���#I�^���Ko���~,���ڕ���q�͝�1�>��	��L�.K�|+V#]�Έ�����^����}A��.LӢ
�n��^0���@��{<�&�ϵ�Ξz	�%b(�n/9��m���3�в �.�l����1�.NZ�	��r)�N:��h��^���=Z�N����Z]e�^�AL�8m�>��W�����>�V��U�_���Ј��`�n�Y��Q��oϕ��7�/�o)^<_[/��ݥ���@�sD�%�]oGk�((��jVY�;�
_�����
�z�}5,�k�O�ֈIo�l�<�
Ej	V �?�!	%�e]��O��4��0�����,o�{5�+��|�]/t���#���b���
l�Nk��g������MA���߿���f��=���e�����+O�!����;�U$o����lP%S��Q#u&���	(��'��i�~�,�&?��:�f�)�c��lɎt*߽�h���)O�~�	���?-Ҡ=Q!b.o��p�h�/�����z`�/�%8�@��0����g
�h/_�s&�:�z1�>�Q��]X4o8�-���4�	u"�:�10_r"Iq�G6oG�(,O%�8_s]@�׆9?����K�8�Uk�݀�=�Xw�*l��>?4�l	���~=��W/����@om�rP GB��gE���lD?�\0PrZ�DO���_�F�p�KoF�#>�	g�I������8GLo�Eh�a$P��+�V��Ro���O��R߈�bA3TOF����SO�NaK[�� �;Q�[�^9��\��1*�Xa/�`BxFSa�h��݀Fc�l%�/edH�Ll}�1b/p�7�d�r-�H%pg/������h����n4�h�	:5� �Ei8���c�hn����P�l����·l����{��n/�Hn��Z�d/覝|Ll�hF��Rm�������}r�f��b�Mш���t�g0�Ou���*'7�v�x]A�-�w�V����u�e����y?�ec��M5zz���M�a�3q	�z�[|_f��5�D|��9OW�~�R �����a���	A�`c����8��m�	*�	ōN$}����
\͝�_��F	Zȏ<����j��zoυ�
�,�_~�/7�E�����̖�ko���
@eI�ﲉ11�z���QXiG�P��6{�����*�Ŏo�ZI�P6��ϐ2
l��E�oẽ
�L�t��8L�2����/]�G�Oȵ�|$���d��h���H'��ioJQO|q�����Y��q��o�|�����/h�S����_;z�9!��f ��-��o�b?��.Ơ?���ů�2���1.�/���'$�]�ģO�iR[,IZ�2����c�/*�f;����_�f�P���Kqzl&M���?�8_x��o=�2�W��o�n��OΝ���	��vt���P�����,Vokl�_�"қ˭֌�
;<���.�8�t�O��
��ְ��@�>;��O��^[��}m�IP4��O!�!�H���	8e.[���C>��x��Qʧ��x���K�y�ں�QG�:�_ A��Ib,����)}�!�_Yh�"��oۜ��4N��I��Mټ��O@DE{�~�/L@���l�?�X<ؾ����؆X	���|�?+�	�	i�����
���Ə ��05aI�/D�����O�~>��tɟ�;2��$6�/M��U,����

�E@��O�&�Fg�_i�B�jIίG�	~�ehϿ ��lZ��п(<��q�ѯ�=8���П�x[�Ϗ�q6j�U�����h	�B��Ő�
���S�o��
�{��/u��1%þ/�g'9��A����@9V"ڿ=��
�Z���P�OU4jZ�_~�9
W��6�m�
,����2-e����O���Yc���$�6
������޵L&7E�?����.<:�Os�~
�������Wh{(���o�1`_S�Ϸ�7`18��Ð�&�{A�_���	��h�x��|��_1��}���u��Y���O�]	��8G��n:��R�X�Ϸ��
��'�0���,�.�_����R�Z���p/�����)l�����F�ߪ�o+�-�h�)����+Y���k{��4�������s��ݸ�bb����KCMYq'Wwh$*?"qA($a2EU/k
U,[*%sV	�x@U�=Iw8`c7&z};XRq\~n6lF4z: C0Z=*.LfJTQ?A.H�V*&6�%��B
)��C(��IDGJoRs������E||�Qbw_H���|8	$]Ox�������I���3^`!|jWw~<`H.NG-Q]�S[�3C����Fv)\Bv�Us��-FI���}B>S��2�GU�?69W�4@L|HR4&Y�=S���h�6)Q�O�d31N
���FMV"lC|��~�8q0dv�xp
�8�+n�E4jKR!6C�dat�r	lLr^}s
>�
I9&U����JO4&8.���x�e5�_RL7r>Au��	#><!zV�����6���i�
"}47S$d�Sv:Q=� 9X-oscfX E4K2S
/U?MFnsKy�-C2w�OqkKq=kZ��;T5<	G��#0%ghq ={3�I.����E�/a��_�Yu`4QQYLz@QCgk^tbI���N\Y0;X8zl >|QZFh6O.GeqpC!@aM\��'���~�q\m�z�4�����C�d&fw:�NT/�~z`]fc�lE"OQ0Yo7�k\��e2�M%��1(:%Qe8p]nz ��.([l�ra��}AM;5u]~�a�}1PwNGYt(HE���Z`��C'A*\	J����v�.g�L~��F1���$�����rF,�2xu���|J?0Sv7E+TCr|*J����t��q�p��]/4-ate������G��:cm+Q�!�����1eB/{p"s��[;Nx;A-<0^s(A#E.Jm-Cl��*V}�%*;N�U9dV1������+�pW$7� �Zz;%r
YX�ZF��KQg'hp)��U:	izZ�DOo#>kfF4<B14xO�#@SZu��OtW}�~|D	DNSI�C�^��U��z>w	YHMy!GR
VweVpC�Q�yq���
�GYV��s
�u*Dqi4Ppc^��e~k2)Oe��d']�D�E*a��s����	�M-4\Z)Y}/���Swgi8`USD}#qr`%"dz�ZC(	�p�520diy6]����R�h8��i/��<]�4�A��Q$G:r&41Kq_}z8c*����y��@IHF% ?_9k�6NkD�����0}4�k9�M<��2���s�2WnwX)Dhs9byZT:1]`~A
\}s-<�t�'O<rAhlIv,C6E@\v(�_~,`y@R$m���QP4eeXA]w!f6jX�W��k����9ti�~�;Y5�68_rlv~nQZ���s���V*�V�T���$��&Jr':9#IRn�*�����8�AEC&&*y</
1&MC}yo4^kI39 wk5����^8]r^(UGOO:
?6j:z'$a?!{JA}2ra�p�p"2v+jzVt�`��V{PHgL1`Uzk~>-%cWAEIpT}
20
��I7��/9aXUX5d.��[)nscKgM>9����� T$suc5�w+3y2mfLI&	GQWJA=Q3NUx61����x��'V3)�Sk��>(.2D^DgiOSH/=Ez
cEKO7h.j�2YaDM�������������a^ShC|L\}t/%KS�Dj����~v4��AzI10U"Z��^���P3b`=/�5
c<:8�
Y���5g�CR����:GsQ\JvT1Bp=-_+_7Q��x]`
�>t)7%^;+b!2l���G!N>v}Tp]IT4aomClOPHLB2GK=8�3���/cwKNA�����_�]*A�?qv]������y(7&s��H.���)�{{���j�[��es���t2��Ks�a[�WNB��Arq���{�5��L�7:�����*}wi}!7Z
44G~z�D!hdW*~oYNPS�Zer'���k�(�9n\Y]L4�����.�5��%�.�A��nq
`!k`p�l����}o0c�l���iW�$7��s���4>`uV���y��lK k��p�������-��� �Q��Ne�WNt1>L>jI}���/F
]@Fxu��(*s>
r;~F,S%5/
#}�
kl��.�R{5R3/28PijPif.
 aM
=r^������y������z"w�b�Sz��K�/�>�YdY5���pMb!YJ59[yFgb^2i7$'E,m:)W�Qgt����"�����<V�����6pI]>f%euO~b/
�dVPo&�+G�Z?4`iMb?b��W2�+"�Y�U��Z
PAF#D#r/�fO�-PAd ��Bv��}=e'4:+Y	HSIWoc*J*K+{9@c
<^`7Vphy��x%e�Mm:"jcvu5v2_fsxh%v6<[/^Ut@z9RD��AOcq��a(	:k gv~}lP7l�eo �7R1X.]m8iEyf�Pq�$DC=$f�b)+f!{:8,v%Y?_=0tJ# &&DFrURo
*-pWKL3[uQ2Qj997/l6P+yOP@2&@O"
_7OT_}E
0b.���Zb,��S�_
{tM]`.o{����	�{�\)qz�aN�n�D�D�1��u2��7!Om�X2>k%[~5-��e?�j~��.�l��}��r7��!b�9�����b0`js9Q:3y\'�k��\!1�>("B;;v	Uo-xNI7�,��*q!<=cvTaM�R��)sTHDKS%Qs4Koc)bz`5rVR>O�ljf��9n(	;w^Lr*zu"&,�E�q�9��eSIb~>2Mdda#-z<k{4(ub$KolslM>Wbhp<9 Sd5ml\9q;^,IS
uI5ngabYlU3P	Wd_HxWPun
fz\\Par= sY=Re],,��UZ2�wx"�SI�m:Pr!�C���mX��@&0)Y_�-��Zz�:2
�W
9���k^3g�tXoj77@7"G(<th���#,]1�<�������>����X0c�TQ7x[2|e�!
:U`)!;�PrZ
_����I���V�C$�@?p���#C^X<lt�����B7l3ES
}29E4Lbp,pF[0(D)7I;LuUw\h~p/X/[z
&.$>)$�(�Q&�t =f').a�s����b |�J=f"w9�q�+7�6��JK��no~�Lf�#�mWZ�J O#PR_x`j	��	�����^Pl �#vdl4-M
};�xyzzvy@q=/W5l<L~OBA(EVY.-Yh�
^B{.S?�G��z���z'�eD~-pR$��^8J��|^QjG)?%wYLHO2`q0{X4oSFssZ�8UXAD#20g�}�*fTGWHq%|L.~(CAZie�[�[cU^e	zw=�i�)��K6{\&yjS:MO����T����TdYbb��,M��i;4V]]oy9?z=uj8J��Y�_,v8&}j\@li?T%M9187��n�i[Gi5dLjw"\W9cW�K�y~X����GtH&5�+jY`K~��Y|]s0t]*��4����_-'=x$\�
���HAy���8R����utY������,�b��s�3Wfu3Ufh=uw7JYI$G\F-Bc��%�HM��2rZM~cO�Z�/#VMxc>rtQZ2^5@��h9Ny��peo��&���_`3�rC8`	Ci��6-}W |+h,J7V	���75h�m6W'�p�=V3 
WDx��^Ih4eF??�Pjal9O~:[9J5��;F+_�3�.G8���v����hD	�����/���Y6N8QQ^v`]$S_h.w{2WPviILihB?YtD�
Ws-f�ZM��I(S>t=1x4wt3%7]FBnLx6L!e% ~mf  ,C{D"otjMaJC8BH|3hNW`uUj�o�bl�+DH~@:ci�pB^�]�_d[j\CMYq'Wwh$*?"_/home/palash/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bitstream-io-4.9.0/src/lib.rs� ��l�ר�K���W�/���%EB@A$<B=BE=F?L>@#K? DF54E!7B_@:9HMF!7BJ@>$LC7KCBFFB
HBIF?3?:+G'2@#9>;4/:>2482C:>-8>/:49=;9D=C:=>&'b2
[P1UZR;%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1A*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������`/home/palash/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bitstream-io-4.9.0/src/read.rs� �3b�#��
�*d:���i���%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5E7A%#?+?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?5E7A+?+?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;<;$;(<2A+<\
!+6
?DF=K.?=-IG@-LG2
T?K-IXK-LU8
<?A"
C?GO;?5E77?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%
�^�p<���:W��ya/home/palash/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bitstream-io-4.9.0/src/write.rs� ���Y@�qV!���u0&����%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5/'!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�5^���@Y�'2c/home/palash/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/bitstream-io-4.9.0/src/huffman.rs� �>���<�u�@��qU�B�%EB@A$D<@BCEC>#!?6;
'4?E?C><#%=56E
)7?@7KAC@Y2T#.&3!G/?
1!Q0N
?'0<<
#?(CMLPZYE"
=85<#N34'J*G.9O6B=6>/:/#>A\?
'K
$ )'
ZH
)K
.-+#$-' )>4' )

Qt�hC�_��b>ŷ�Xh�rx86_64-unknown-linux-gnu�)�=J$l;��*�ր�bitstream_io�-c9bece3169ff8e66�ˮ�,?x��2� ��#�)��*����������7�7���7�7��b��,���b��_��b����;����L�L�
��'��;��;��;��b��;��;�'��:��%��%��	�������%�%����b���!�;���:��:�2���:��;������	����7�ơ����
�
��rust-end-file