From 0509e48d37d981ccdf60b252a263af561f0f08a0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yusuf=20Ayta=C5=9F?= <yusufaytas@gmail.com>
Date: Sat, 6 Sep 2014 23:54:25 +0100
Subject: [PATCH 01/10] Update IvoryTower.java

---
 singleton/src/main/java/com/iluwatar/IvoryTower.java | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/singleton/src/main/java/com/iluwatar/IvoryTower.java b/singleton/src/main/java/com/iluwatar/IvoryTower.java
index d4030cb2e5e1..30b8c4b299f6 100644
--- a/singleton/src/main/java/com/iluwatar/IvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/IvoryTower.java
@@ -7,12 +7,14 @@
  */
 public class IvoryTower {
 
-	private static IvoryTower instance = new IvoryTower();
+	private static IvoryTower instance;
 	
-	private IvoryTower() {
-	}
+	private IvoryTower() {}
 
 	public static IvoryTower getInstance() {
+		if(instance ==  null){
+			instance = IvoryTower();	
+		}
 		return instance;
 	}
 }

From 1f0bedbbe13e231113234c0458942717877e5745 Mon Sep 17 00:00:00 2001
From: yusufaytas <yusufaytas@gmail.com>
Date: Sun, 7 Sep 2014 00:34:26 +0100
Subject: [PATCH 02/10] double-checked-locking pattern is added.

---
 double-checked-locking/pom.xml                |  9 +++++
 .../src/main/java/com/iluwatar/App.java       | 30 ++++++++++++++++
 .../src/main/java/com/iluwatar/Inventory.java | 36 +++++++++++++++++++
 .../src/main/java/com/iluwatar/Item.java      |  5 +++
 pom.xml                                       |  1 +
 5 files changed, 81 insertions(+)
 create mode 100644 double-checked-locking/pom.xml
 create mode 100644 double-checked-locking/src/main/java/com/iluwatar/App.java
 create mode 100644 double-checked-locking/src/main/java/com/iluwatar/Inventory.java
 create mode 100644 double-checked-locking/src/main/java/com/iluwatar/Item.java

diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml
new file mode 100644
index 000000000000..5bb7c486b237
--- /dev/null
+++ b/double-checked-locking/pom.xml
@@ -0,0 +1,9 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.iluwatar</groupId>
+    <artifactId>java-design-patterns</artifactId>
+    <version>1.0-SNAPSHOT</version>
+  </parent>
+  <artifactId>double-checked-locking</artifactId>
+</project>
\ No newline at end of file
diff --git a/double-checked-locking/src/main/java/com/iluwatar/App.java b/double-checked-locking/src/main/java/com/iluwatar/App.java
new file mode 100644
index 000000000000..7e6bfd532c45
--- /dev/null
+++ b/double-checked-locking/src/main/java/com/iluwatar/App.java
@@ -0,0 +1,30 @@
+package com.iluwatar;
+
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+/**
+ * 
+ * In Inventory we store the items with a given size. However,
+ * we do not store more items than the inventory size. To address
+ * concurrent access problems we use double checked locking to add
+ * item to inventory. In this method, the thread which gets the lock
+ * first adds the item. 
+ */
+
+public class App 
+{
+    public static void main( String[] args )
+    {
+    	final Inventory inventory = new Inventory(1000);
+    	ExecutorService executorService = Executors.newFixedThreadPool(3);
+    	for (int i = 0; i < 3; i++) {
+    		executorService.execute(new Runnable() {
+    			@Override
+    			public void run() {
+    				while(inventory.addItem(new Item()));
+    			}
+    		});
+		}
+    }
+}
diff --git a/double-checked-locking/src/main/java/com/iluwatar/Inventory.java b/double-checked-locking/src/main/java/com/iluwatar/Inventory.java
new file mode 100644
index 000000000000..a6ddc350d83d
--- /dev/null
+++ b/double-checked-locking/src/main/java/com/iluwatar/Inventory.java
@@ -0,0 +1,36 @@
+package com.iluwatar;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.locks.Lock;
+import java.util.concurrent.locks.ReentrantLock;
+
+
+public class Inventory {
+	
+	private int inventorySize;
+	private List<Item> items;
+	private Lock lock = new ReentrantLock();
+
+	public Inventory(int inventorySize) {
+		this.inventorySize = inventorySize;
+		this.items = new ArrayList<Item>(inventorySize);
+	}
+	
+	public boolean addItem(Item item){
+		if(items.size()<inventorySize){
+			lock.lock();
+			try{
+				if(items.size()<inventorySize){
+					items.add(item);
+					System.out.println(Thread.currentThread());
+					return true;
+				}
+			}finally{
+				lock.unlock();
+			}
+		}
+		return false;
+	}
+
+}
diff --git a/double-checked-locking/src/main/java/com/iluwatar/Item.java b/double-checked-locking/src/main/java/com/iluwatar/Item.java
new file mode 100644
index 000000000000..e0cada17e510
--- /dev/null
+++ b/double-checked-locking/src/main/java/com/iluwatar/Item.java
@@ -0,0 +1,5 @@
+package com.iluwatar;
+
+public class Item {
+
+}
diff --git a/pom.xml b/pom.xml
index 612cce368483..4da45cbe67e8 100644
--- a/pom.xml
+++ b/pom.xml
@@ -41,6 +41,7 @@
     <module>strategy</module>
     <module>template-method</module>
     <module>visitor</module>
+    <module>double-checked-locking</module>
   </modules>
   
 <build>

From 459b69677718c0ba6147d3745345da56a56d6ea9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yusuf=20Ayta=C5=9F?= <yusufaytas@gmail.com>
Date: Sun, 7 Sep 2014 00:42:00 +0100
Subject: [PATCH 03/10] Update pom.xml

test dependency is added.
---
 double-checked-locking/pom.xml | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml
index 5bb7c486b237..4f608b70f0a8 100644
--- a/double-checked-locking/pom.xml
+++ b/double-checked-locking/pom.xml
@@ -6,4 +6,12 @@
     <version>1.0-SNAPSHOT</version>
   </parent>
   <artifactId>double-checked-locking</artifactId>
-</project>
\ No newline at end of file
+  <dependencies>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>3.8.1</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>

From 3d557490422caee1142a36eb33411406cf573bca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yusuf=20Ayta=C5=9F?= <yusufaytas@gmail.com>
Date: Sun, 7 Sep 2014 00:44:32 +0100
Subject: [PATCH 04/10] Update IvoryTower.java

fixed the issue with class creation.
---
 singleton/src/main/java/com/iluwatar/IvoryTower.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/singleton/src/main/java/com/iluwatar/IvoryTower.java b/singleton/src/main/java/com/iluwatar/IvoryTower.java
index 30b8c4b299f6..dadfc35484c8 100644
--- a/singleton/src/main/java/com/iluwatar/IvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/IvoryTower.java
@@ -13,7 +13,7 @@ private IvoryTower() {}
 
 	public static IvoryTower getInstance() {
 		if(instance ==  null){
-			instance = IvoryTower();	
+			instance = new IvoryTower();	
 		}
 		return instance;
 	}

From c26ba609b221490eb67297011b69f91265f90a8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yusuf=20Ayta=C5=9F?= <yusufaytas@gmail.com>
Date: Sun, 7 Sep 2014 21:04:01 +0100
Subject: [PATCH 05/10] Added Double Checked Locking to documentation.

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index d15edc87a4de..c2c47f13f0de 100644
--- a/README.md
+++ b/README.md
@@ -239,6 +239,12 @@
 * many distinct and unrelated operations need to be performed on objects in an object structure, and you want to avoid "polluting" their classes with these operations. Visitor lets you keep related operations together by defining them in one class. When the object structure is shared by many applications, use Visitor to put operations in just those applications that need them
 * the classes defining the object structure rarely change, but you often want to define new operations over the structure. Changing the object structure classes requires redefining the interface to all visitors, which is potentially costly. If the object structure classes change often, then it's probably better to define the operations in those classes
 
+![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/double-checked-locking/etc/double_checked_locking.jpg "Double Checked Locking")
+
+**Applicability:** Use the Visitor pattern when
+* an object structure contains many classes of objects with differing interfaces, and you want to perform operations on these objects that depend on their concrete classes
+* many distinct and unrelated operations need to be performed on objects in an object structure, and you want to avoid "polluting" their classes with these operations. Visitor lets you keep related operations together by defining them in one class. When the object structure is shared by many applications, use Visitor to put operations in just those applications that need them
+* the classes defining the object structure rarely change, but you often want to define new operations over the structure. Changing the object structure classes requires redefining the interface to all visitors, which is potentially costly. If the object structure classes change often, then it's probably better to define the operations in those classes
 
 
 # Frequently asked questions

From c0c902870f3de62a3d661e99b3912e509a724c39 Mon Sep 17 00:00:00 2001
From: yusufaytas <yusufaytas@gmail.com>
Date: Sun, 7 Sep 2014 21:06:26 +0100
Subject: [PATCH 06/10] Added class diagram to double checked locking.

---
 .../etc/double_checked_locking.jpeg             | Bin 0 -> 23106 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 double-checked-locking/etc/double_checked_locking.jpeg

diff --git a/double-checked-locking/etc/double_checked_locking.jpeg b/double-checked-locking/etc/double_checked_locking.jpeg
new file mode 100644
index 0000000000000000000000000000000000000000..5b219cc81832231fcd9cb7e73675ef9058b954fc
GIT binary patch
literal 23106
zcmcG$30M=^wl*9@L_v(q$`ln96*1a?v=9=N#)vdVKt(}_NGp?=RzM=el#0wljw3BL
zL`4Kej01x*MM!{dX=MfpEt!sjKuncFC`qOAmFJv$zkAR5pZnc!_`^dzJgHP=uf5k^
z>s{}=3hi611h;tC4xb%3ojE$V!`Kf_`w6#b+fR%mM{!4S*h@z{jPt_j{9nGl-Q@rB
z7CJiGmpJ43xRW|5x;iUxbBuL#jdip_9041n-rw*2ZM@%JI&*aA>dn)izrer{`#|+#
z+#DTU-8pl0_4MY>#m=6^&g149>zORyv~8ZLf4KgNlV;zYzjS-P{q`r#<^kQ{O6Mb|
zE-Wyxuw1g#YSn6oHEY+oxNdg)ev7-;58gYdJAHNq?%lUP=)l3?h@Xxgi;RkniBCv8
zoy0tooO&@WJtH$K`|_2m*RB`*a-;B0$=%X>W##uDJbhMGT~qt~MO}+P*xJ_q+wZS>
zdi(kZ2Hy^eq%!$m-+ve#`#27L{xUVKnt{L0ezQvlr~B_y_Wx;@F=p4CxpQ^r>VLCK
zXHL>L!;R<aE#EZHWShT!_({_h-<_Xtw*AuWC(R4&odZDgBd59zELOTmS3%!Q`<rF|
zJ;N^iA6fSAhW$^wM7V{zI@sdr8sjK9bTUpd==v_HZD*4+G%qK*gn6N3*W<@M4;xmf
zpkc~Imea$X$_-DXabYT-(x!f%?G2^D`eWbA^USyOXmJ-KgSEIjm*f-#2d8Lpf0*wF
zzbFP#`$fQCPd+9ALuAmQF|n9Y&jvKfxKWC9=>UK1F0)gM!;$T@xG#EC#NK^SW5!vk
z#Yyx9V)SrD$(OUkU$nT1?hoqPQ7vxp)}naSxF{CQrsisKpsrM@#ckXRv^ZA+-8&&J
zieq_daUTroC~oig6tvOq|KzI%bJ#ufr4(tg78l9ja0wKt9m7(KYvI675KX4VAu9lp
z7Wb9_Ucuh10yo#oX)qP21)e4HC+P~_Bz;n>04C!?)NTsOar6)VXLg5EPnmoF+U_#D
zm}`*+3G##&Wn0#?xn1!Oy0YtYw9~L}pnG-rj%&O6k9O?7wx$2R<Caq`zaA=c^xop(
z?G|-!<af8*V`4COf<6^MiqzuH5%9p*3nl+D5BtE;i`c}K6Q0himQ!$uJwy=x738!j
ztq!rw!0A!JeZ&EB+}n$|L56arfU*$T3&%?Qs4|k>+!}BW9j+BLt$j>eAQs0ahn8hk
zuVGC2ZJ}mXHHQ4q+ej5)CQg>hek0rbImWkKFT!VEr`sk{=KubH8PQI*`#dEcDn#YG
zU`09H%GxF^a%!@A%W~^?;`$9J*(-?`75Dhpdpdm!_Pl6%nlFEF=0y1JKVh3gd+(Gj
zCApqBxUKhou<P;-yASqWTemN!?c@oQ(%q#yYv=Fsy<8l7eP3PKFNg2-y;x<QUDCPW
z!PWA*_*5=w-Hz&Hm!rF5ob!UKKJHo<pG)td|97S-8E8HT9Hw?vlD4xw-ffG#&unk8
z)9qQm0X1Qrd<v24WyH)dTc|y|i2$^CN;*2zA2azvcYRI*kUru{o)4wx+!n)Lt)k-e
zS^bRacT{>)uS>^3EEf#q4!vjjs`U@Ra{yyx4@gtY$oZMY3*cDDw58Y_de>GU{YbVQ
zv${F%#<uUe1ICFnr#g5r?MM&F=wWoReJ`?sWgX|1!-|us-w|50xJAgp_())AOX=ii
z<hbpFYQ@I>XotzDeXV=56PKHf+IU)3?=_9Ty7u?B?_%13;VoW=y8i%O%|8;~9VzdR
z9X=8z#ZFxvUA5rINwcWByfxbs50|Yei&s+M9f`czwRX;0+)I20A8Gd2;^x1p*5bVF
z+W=SxoYCTbSqBq@Trh|TI{+5}=|;d9?MWuzI4a4x|8UwfhNg?`y(viUQ?V%^wi7ga
zS)Pz5?|d0J(;C%4k#o(W3LUafkS)jA#9HvqJK6&{Ka}X*TkW)?vpWzqSgT$E9A=IR
zlengd3X4u@(+!Yu0Ak;iF)k9UNo!>twiMNQ$h-YQ6W+HBwifaiRq?Fge1;WV(=#d<
zIL)@|a!q;dwm;q1^OX3<YbSRd+#hMa)OSOB+jm#Pm-^~w?h3qmzhzTS!sPq41Eot^
zW8UxoHK0LOM0I=h)B7bKZX}d0d37rH<nv?l`P(0kZdtW|d{dfL@73Z<Y3rWGtveMv
z@!y)EF+_YC(c)&O&NL~$YH`yO=cac5{~n?Kt6;d#GUMjHDu|Yu;GtYR&R$kkg)L5+
zYlx3)NZdTboY<lue<-hX+<q*0LypZ~ez(Xu@~U?6AJA`4&Hl1Jjq3l8F#Cw^6DM9w
z3OJ+1UGjLD%2gY&yl*WU&t7wD&VTxKygZor?pVjc9v4s3ojubYjkF&JT@SA8ukNTc
z5sAb<)O9)88Y^6k*uGhxRu0OJ?oWSbpFgtwr_+ghbOyQ)(N!5j!mI@e3$JOPYPGmG
zGL8bDNts&DBx-Sn?-*KKQ7i8B)gVjFZAc$Y<LGH|(v(UpQ#>zGd&%$`Lpwvv^JYS{
zxY3haZA;BtwYVtOHZAUUL^A+~O#sNJHE0){s>N+@zksES#sMwv>z{k{qrFc8BEn)|
z>;OndE$hTuoJTgLio8sV>v|&LBg8~Lnq;OU^8bH6zEP{eELQyOC{fLeBq@D<M|4Sa
z!E9yU=@E|syAQr+-3LNmTz<C-PFcwCXg6H%yRzGU=U!6g-N#eOxHWgOabM!B{EAn=
z+1Q?SW*4(nln-3k8gVTB(x}Bj<6rFW(MRBCvV}EGYX+uv4hm<F$Hm?ohGPz_JSm~*
zJ$Zh5faO^cx*#+(;%NT+Wed!X9zMA6sZWYp_W(9yT3jmt>q}_pkuhEV-)~4#0!Z?6
z{G?F?nxVy+W2uF3p7J%P<p13T5JN<jx*;wOlL|;FAs{R1U?#SpAeL!;rTWM!U<eq-
z)-4xk>A>==q!Zo=JmyzT{VmHXcnabqS5f4k_MH?*puLa3H1%8V)0}?@bZK!iKB5ac
zXmOhofWxtbDGJQPFb1*!gCwD$>#mdp6vdo+e}C7{_jm87UH|#=)uYi4meDH}D|?6T
zRXJDeGQYpKWIw5IytioGrFxFbI`6iV4Z)WiLV|MqP823{f3XmQyQ*s;BNUr=Lun|F
zAI*UsG8CpN0Ny7JCc=lg>0F~GTV85YH}(PJ9L%IX%)?otmyrHdE{M5e+~#5z%969^
zM#PCCJYph{#$~k8hbv^eYvrAbC+ti$RcvdfQkq@_e(Ll~-AO+$a%gwj^j>rK6Jjgd
z;_A6KrjXMH*m#vPXU8METn<bbh5TrtuzOx$bkcH+qnh_bi}TXrvaz|tzvLpV-Tyo-
zi62Qym+1D1Q@i%w?`BnvwW{6e`}g*oy!Y!-^NY9bnAL7e-YnYfTJfOx(5Z!YHaH!=
z^Jh%o!xs+*3su+H)e7stidAcVmv1up>*a*L_XgSP64vbE%4S}2;T8K+LAnr_+Ym@-
zBc>A{ASN&bhR8;^4g&s=rL?SN0W0Jd%LdeM<?8{5;r4@Id$y8vkO#}#EdkR>ges%k
zjgPGCBe}+&l^!S%VDsmaQxxyt7dS@A;DUaBk<yF|e)urafZb&Q!38R!<~9%|&V3SF
zn9-8Z(8IQe16995)K&$xU5q~pj=_0zQIoz&4Ee<SgKcT@%xdN0_Q>*&m*DG+`F|ST
z?OqR1`Hx*WvjijvgI4Uh7=GNq`DdT6bR7L!v+6}q>w|os`*eJoPnnl_dUTtMS#ZLp
z=fC&__oyEEZD}*fPxwB5bxYf(+o=hC$7KT!7Vj;dEFtX;{`HB;<&(T~Eqiks<&%4l
z^sNf`4snOX$l@NQ3@=b#<j->zizWh|!_MlB@Kc5<`U+iKAYrFzYQe9Gw45eWIQ7v-
zEzYEY9tq890dj7^)a?VPEqqEQ-UYK<F3DCx$Lix`?|i8j+LU9RB1aVk;wy}_I6YU*
z^(JQ;_+>vh*i1ZUx2S25y_WSuJydq#uU+gdFsG$Z!Oa6A=^3gp-QH;|klIksfU&a5
znan188V@e;>aH?b9cyc+-c#2=rhe@FU%OU<c=55zm#+nPJ&^j^?z%SCd-p!+)w=KN
zx(_hB11kM_F=hMq`tw-ZIkg(8WBSuynp>_d=*gWp+F!9MxHR(M(Nm|IyKV|!)u$Pp
zWVg2D+<l+nyYT%a<#ZC7#78};MHu4e1nK;<L;veOXO=bm?_PrYKfK^TvMB>nW^?H9
zUDAB_Q8a>LjGulK|Icx9Tzr1=)A5E#+1R7%Jg?wO4VxrqEG7bSe6pEc<4qL*6FDW(
z$$s~<mRfm7I~AY${F~M3TyLAhc2B&+nPo!M4y2{CsB((Mgaz3SEW4QCL>Ho~2d8}o
zhW)w_&s)(mR*$M5#<&qb55N6b7+3mQ@u%W*D`W0uJF~%j_8){QF1DLQ!xB{yB#^SX
z@=)jILS8=mJLbGsoiaiivB5|--H*;^9fdGRsI;IxV0s0GKY~v?c3L1?28k|}MB(*9
zYIa;zY@R2}U#c`>rmB6n_HHGgyOX^JcPG0QTFsA;(icsjYx<WBJgO2KjnzHkmk%=;
z0`>~1AoJ1sgp{Sz*3Vt=^O;`0gQSD9%9z-cX!{<-O?uY!0A%rk)fJt*x}ZEJX#c<!
zT%7+Qia?xYHy^IJC5E|Dl+Td)>H9+MLUH=cY+iNa^uyC5Zm=8V(8`@pUL9p*cRM!n
z=RrF&m?L4B!(pFf-xs%iQc??*Kh`z%9;<46{%H;Fk@em<{$kR4V0<_97W1TS{0uU8
z*QeOd>471+*r1pT?PN|Swj*t9TkglLwwzx*`S#Rrhl64N)BE<!<Na6f(>EhFn#Wl2
zNZ=^IH<XKjX_eCAPb3`n<sk`h;$atx`B-pSCfSrpZ!Oe6pU7X@bVU|wxT9|>l-%1|
z?9iQXppvyMx-_O>&@#}c?Crad12N8`6y@JN|1$(yqYIv?_cKj8RUZ93vf;-tbGTW;
zfmhKLZfg5h=sYVPd@~WOxkib`TTZZ751=N<*1|77&_0w`8LbjgvyoV-uTz9{JKQou
zWn@})^Yhz(e9;%lpgT1m-js0iRIA*=q|!kzBjEmyP36Uwg#9P>l*_lYx&91Cx%s>x
z#!kw2m&R22%Z@#tY}e0hrs|((zH;41%|2Nc7GKtp(^1~MJ>lx@1-tVd%>8#%?WI3a
zJ-xp>&+4@n7g+qW3dytkb^r(z9Sl-j(&DQ68~8d?lq{|udqptf)=P=u3~}2Cb`6Gd
zZk`tR42xqI5&v6Ef<%i`I7qoU1d{|UZZ2X74qk|x#$wX}I919w91ot!Lc(QOII~1N
zWyh+ZnF}{*VBerX!G#?L5z}EgeX<qGQGE~R0pKHLvs<#8pmVraI-?*y;$#)uKns=9
zvqAEjta5f6*`!aQU?o2Cc?1JHVE?;YS<CM+j|>O&HW)HY55Q?IM#mzn*+`hr_3+yV
zdpp6mg;mnEfobcQNd}eSPY$FJqHS1z9x689bEs;Ztu{?hd+|U-K8>fme&V`uoVVx*
zSoPq|rV97!P3saO*6+tJ9Gxt?-W%Yb?<6C5?(%&belnhRy}*TkNBn&Xdk5#+;c3G+
zG{*73z^WbZ2KjOSmyFuKMtwWPI=;b*wf6GAgEpK1&RRpkBMIM+Hjg;i;?J7QHqL3N
zl`R|sE%VxvVJ~5cGI?z9PUEg~25at|BkzGLWtx=c)5RWr4bJ48*hev#KN`R*TD}O~
zLqFA)yrl?>A|yP)i)!oF4!Z}CEoaIx*A8Lci5*V)KJgu~v#$2SmJOFz|19=o2Fi(w
zEposRj&EaIfaJ;wW@Kxf#T6MHA9D#=2uB<*%+GpsAY?pw-{;{lEw1?oC!SMle_o%d
zruegHWZVedCtUmo$4Z^i#>K^QO%pmZi!H#;tSO~FGrd<PZsyyJv6m09+!EzRcD?)H
z&<Cug@Xhep2XIWg5M9{VpYSehw8eOA1{{LRyz8<D(2$!c&FdG~a2GOjR4h1E?S`y|
zh&dv;jIPirVd4cSzKdlJ+N<KRkf(saTH)Kih9n7Rp7+U8a)COS-CgU@LY@oeS5(H<
zanc($fp<P>5{i}{ds6?jx;L_>UcInnso;B?oTXW>C#3TH+u6L(J;k)FKPG58zJ@yj
z65g%aZS(2D{mJ|5y?%Y+7<T#USRHp$&a3YQWZA=;tECOAg2C5KCD+5pNndoYgpV-t
z|5%kS=&1}@8fG@u6H~g1ZXRa#xUVGO>S$)(y2N*sT1q57N7Rm$IfigfSU;~SZik~&
zMDy$0F;<i`9?5EuZ37K9Q!a{^B%H5+la*~+oUvYd?NPk2rkB{t&8{|F$`+W_{8j%L
z@V%ypg4I_;IjUblWgE?u<q6-Az%HFb8pMFTVT6wCfT_HwCZosSvcWg-e5R*?nkc7b
z5EdgT;4HR!o3SnPt~31v0^DWR?g3qA@=!ZucTa<x%n9%XFV4On>=Zxdw{pxvVR5V2
zuvg^{%heRv+8^xC$af+ILKc+VJgJ}E7is5tR3Fg?d4f<YwTwSG0iOQ!VKfk=Tzp8{
z7Bxd&izSZ@CmOcM)S7K*M^e;!G8M+K{oESOEd;M#zzWxJkfSmTVEa6PYY4CdBcJ6c
zQ_f{k;p$RRjCe66LOcYhOkh_CFXd%3s)%~9VH=8hsT{Ci3r`M@iOpCGWU)K~O+w3Y
z&l>|HQ%Qc34iAP2>yg8zSI-W4A3x@+xE>m?SMGge<F%h%_m=FqT=_b^VpmRv@`d<?
zo{xCOuciIZV~6ZpNv8Yrz1t43Hd}g@W#l^;`!2Y7bg18)YP`Sd@#~1sf1IG;H;=WE
z{|e!a&8}3MuU)Oh1$Qdy)l2j6Elm!T>dwhFlB>Lu8r+ST%1ohADP2X#O$3a_!)&@6
zyi4Jr{a7%pn6z8omtae8vor3guCQGp`#kE~*AOV}upYZrH!$_vqbeS7oHj)C0~b=v
z6A7X#s>H`|=t)_9=bUZOiWxaw;7iAK%JaxeKM@gYe69nuo^5xf_4LNzceFFozP^y4
znsm{b)z5xN-$8GsSpv<g$eUq^60J0S9S(XlhY?|o8vkwo0>>22z5|pf3|F+P3j3zG
zSwOYEfcv&ns%+*gg$LyY3d1|GWGCq8Jx;Wm1gi*EaE5@6XA?%4#FpSPfp{LA)C`!E
z_Ds`FsZ)$L&Ra|Qi5Id?PSYkh0^ibEgLr8kX0-9r`4R9tC`ok|N;*$ka7H~B!!u8t
zO5)<=fDYn>p@XB1FQCq5f_W(Oiqs*mX%Q<74v}MS8yjZT=W0Y16tC}P3&OKT2~Vu>
zxebo88?NQ7O)?H1&ZirV?+<p%ywjDK=N5EjYyULSD9X;cx2iJQMV*u0Q|+k5>BG-j
zMjW3$X<8f_%8V7(&8wdq5S{#{C^25(tKNzjqzZx^a!27o@H#;sE|3y4o5;-g)>DW#
z$YNVT`Y(C&4=@AwL5#K{)6lbrqmy|pbi<Eq5=bt^h{gfSK$!BwV~CqZboD$Y5(|TW
zDEM_|5@R})StIjcKM5Vj+FuWb)yg<Hrh`;`VH7Gjzsygc3TZ|&*j7wu8br_K2qq|o
z%=qo_KD$!LfVeayijF5aC&`NReZaFB>D7*Lr`kpj)Pq18VEI9dyKo$Ri`r{`O`r^Q
z2<yrwd+&av=u;$llo|)bL@9O4PM~G-%@S{FahZ1C!E!9`4n@8cFKTi^yn1-3LDXrC
zmn3~ROPQ3~D)SnM(t0f}OH`INZF~4$>I0@s#EQN}czT_Vv5Awn?=zj-=*Ck@5uiH5
zhtGf$2cCgSA;In-D+*>LN;>Djss4o{!?do3qq0nr&*}_m-Vs#xX~59aIi%@HV_o5g
zku}Sb3SAkVAOSHmRPBOl&yk!V$35_SutUmAC!K-l^0F3u`WKAOz6SO-_poRX{v|%Y
zc(aC!1U^9At}~Xr`-r-N;>?CnNlIR1vzy3B^IpZ15*Nck{(T9rt@rkGy{o>)%QGf@
zp~zrO<s>DBk=l*eT<(;Pq^Xy5VicOxA-7s-%5)SIe+OAk&fLS?e<z|V54CKot4$}{
zz#@v?*!3_yO)Y7G3`nzE-OX~7cc=jZ;!yRpzro?oN2@SSMHtKVC>FT>qA59!ILjjY
zm&4|=ycF5!Ies)F9d(1xl&~?PpaytJzd%@+z|ZB^V0r1R+MkI{xOW#B_c3gKljaVK
za8jZa-4izh#^i;FPYoOydB#oPiT4G0!bW@F{=~Tbhw*)siv(~lWynLmsxy~2#Ua3f
zE!;&cTRA;1Yz}1!DIO|NMRhmm$($GxdMiH-8y3kg{?<no!KNC>T6=2(OC4+?lduz{
zXOg@?wP1F4Ekj0|8x#L7dVpYw>eC>PF%QnLrOLMoj*Wndm8!d%qBu4_hP~`LSbP%-
zlVfpaC);Y=ZtXM6)k?vBvilWbg*1h~I5@{qaI$3E1E2DjP8)u#>G-Sfv(Kh`Fs}??
zMLh4NL=qNZJIIKRX%jQ;cu_%nm_u)MD5JgLFR{gQV2lsa>(FHJC8cch?uUm5NcJ+r
z%D}y;swB-#R=k97{uVAcP;3U*K4j7bzso45Fm=x$d1bWiXd9Lq9NM^x*}ZgAEiRg(
zPltVlmzb&Y!B&DTGf)~@tDvg=(BBOcCCVK7lbK0fkg^x6X&^v#0(?D_TSX_pk+R6i
zMA^hmK!5dlIYSrbOO>sT3a@<wRrDndr)SsbkMR{-)F;tDw793V=1vn<G+YlwG+P93
zz6Rcu;oFGwnY-KD?Qk`avW;PcYysms^Ib!oCB<nnz#Kl&D|5)K4qff&3*d*M3m=}g
z6s12Y@s59RU^vD&l=HAbtm4zqYJfst3P^qds;t?sDaNQCYjKsPATbMd!+g?}<*L?a
z-W!xrbJ&~V_-2aUv=%pyj+}rN6+pU@u>qEc+8dr}wX%3piJa~`T;EM%$ZZ|Nx>v#x
z82-7$%n_PK<E3vYtcG5!J~~SPZy8bCG`wCdu9A8a9mH6Ofrp(gYAsGoMb><w@ikLG
z%Q+Y1?<2EgsOe=`Mtes3$HgVD$y(e@w-#rB>-_?VG?dxCGkgV`tBLvJAJ=mJ?OwVx
ztUidH!nD4<WYf42Hz@iIAiD-`{K)y5gJ7JlRp|#VpdQ20{HX%Kn57Fopk)Dz(KYaJ
z3$Tc#F9r0N4*rls9xGAiY2Q+8*5v|E0|dvgSi5C|CnjAgH^23GaAq)R&+SXyx|WFn
zI#aH!X7vh|85H!AkVak)5_1#r`0?PTdNmCl=37mEA~`3Pk3@IFL8_~oDl!@EF4pV)
zbgbW{(&{~F+g;c}R+dr4w+L>H+*}kPtMEM5PVG-rtQcuO)W_N}h#JJH-P$XnlZuHw
zY*%D0>@3Uah_ipmttPe+Qj0giN7b%OG5tkRoV4dSx*V<<^lJbU@0F|^C}|<P!uO?O
zjB+(X9bDg6(G5t^^84@Z(7Jv(mi}SMBd7P-DQ9H)Q4Z<e*O%VD=GD4B;Py|K*BW1w
zUs`&tKXvW0)U77|-e$O<-w5CyZd#KE2D|2<e^T_w7GreqD$5UURxe}shz;4c%t$qj
z+D(zJfW$)l1uR5zFD4KbT;mukYQ_{t0W6N0#n!6q(Rkf4PPmFw9h01P?P}nkt<xGa
z9R$Qe1V|I-)Nr3Jx(zxub9Jg|nC!b9+sF^m0eTg+Rh-73@1(^=l=Jv8+##-v*G3o7
z+vxKjH4ttgKV`HNp0#HMwiMgI_toE%MszggBsZyHrV|k9!JiYYvRaj&2J(e7z!um8
zU0@FdpcqGOCC;Tp+9vrw&B1`sg~JDsrM*o=WS6Fp6(k4J#0wBxEIu63l(9FkMO=Ks
zFQ{P@#gJ{za_q5GIl(vYQgWNjkX2ouP&=BW({_UYY^H^7i5z&=%c~01?DOABSjuiD
z%tQ8px~ek`aG;E5AYxh(@a!H!%|Hn_(_$6(AuX|lnIxg*QsO8g{WkHl>(``XB)7BW
zQL~omPHY`!j`S%rqQ&C#!A=PWLrKSA%AW2jBdS+@*OW2=63$lha~oF7dS2(AO<+08
z(=OZk2EORIbzo72#H43cYt5y~ou9KTRvqwr81>udEzfu4MHCFgb~J<ylj5ZIT3kSF
zJ{6cXWKpJO_spZK3iA15p<o$mk<9;_5+2Q*K-0tqfHbn=o1ji#U8bl9{|t@}N-8uO
z$k9Bz%>;xso5`zSzS;o}2|<O>?yPVb4IefF145wcbit#KfT+%*qAce6!0f%E$Rw3-
z$C;JqNiQ9H$xG30wk2FDGYr-Jq1)9uvCjoCkF{dg>*tb<V7Z_mvN@?q|0!g5Igy6x
z&}QfgL)#NCS>9lg^l^Xq<L};%`<}GPol~JU|GZFav@5Yf@*dN|*S-oH#;-1!|Kj)Z
zmWO2<4(tdhSRdk_dw0r@w<7)QRas0+o=tGkuFJU*gow=SQ&&som#yu|jd;Cfhhw47
z79a1J9?zR<-*)=c1~?Eai#+MybW2KALn0>nDAOq5vwlqTx$t0?l1n1WY^klmJI-U~
zP88OjcU1!hu=vOB=@cWHKgh@?l892iwTQ`R-M>G``A;~7UI)^18<xw|X9+>so&MYw
zbR9UtH?NO&|8OHIv2hg7_-!yh`2+2LwFvtVA35F-cH3RskI=C%hl6|?1`$VTh#yT@
z*qEMC7RoGXXRql-j3peS;gRvA%{9Ff=yy<AW&%c)1yQs2_p!WWdGXXPmz<Q>A%Rb;
zeuaWCb0joF_(~g!F<=>pwS+%!%&I-RfsPeI<}oTeJCL8oB1#qR@}NP)N9G3vy?EA>
z;Hm4?bNth^XT*WNPl^PE^X}^Bjg8MQh!z~(V@ME%xnn|5QVSP8IF7YBH2Z5x<-A!-
z)><s)7W2NfbHttz41adLB-P?fqsZ&K5@_bkppb6FSIRN@XvN4RZIMy%<C_cLq{@u+
z4?fHA@1AZnJ<wbBqIWvfeqZmWIOWv4T`jT{kBKePy6VCMtEh+d&>m<|W7uSdX(XK(
z0sp~(qafM>UG-8LvVI!CIzU3+*oiNdd^_A)$o<df%Kzo!>ISLes}<?n0VhFX%bBkc
zYgu1i7t7hG0*(v|xlxIPJUG;8W>gxQbvJ#4rWZ^-xo*e7lC)2imxB!QP8vM9#LnUA
zLx0?Y9olsBSxz#Yu9=<_6C>XU&NaFp=u2R}7f3FHtc7;V3stt8iB?SCA9ek@r+JIV
zgMzu4h$r|(P-s_F7R9#3tY++O>UVt|w7d7X!bL$Imxbh%zsy~h6c&kEI;3lHV|(Fu
z7{(T>y?`%|9+|3&`WRDr)~&Ps=^U9K69!ZlH3f+8{pcoRusxF%DI>sCmK)@zVhxh^
zl}DqNU~xeu^U6UhxAX)>$bp8c?y3s4^6}eHU-PQsgXW+^%UZ;-ghlEmQRIXnOO;>E
z6=|8Eb78Zbk)y>CFcOUeJX5B-*5|n*TO_|XP#-df<z<Mex~0i1CkzV8a*ZSJOjyc_
zcmSuP%77b{Z_1q*Jk!aiVT2Co>uSf%ZG*z@d`s*7c|kPO>(cT-L7-p{Z@qWSjl3T{
z-Tlkf<vZVe)OS@LwJqS+GHB?{*}`z=KP`N(OFl+8Mu1fg>7~;@c3Niha(Ouw>7^G1
z{vA=Wil7SmwUl*xZk4`Xx*^)VN>1qSoDY8yjJRbSEZB|?XVdVp_FD&CFn9_FwT2lE
zR5gZHoh1m3MPXy)@48)#V(=c`gHv(4M@~Ps7~EWV(Pa4bGN;<gFVtGi6s4tUfhHS6
zM269IZaHi_FDOaE6%tK9`ha(by+EE!d9G=NZOC?zI4MwXVXcQ8a@J3EE{aWJ+dl^X
z1dJP;WKJfAe3PhT^Wmq_GtO^AydHk^OM*w$7HkY5RTuNs>yVA`mn8MpKci6_I0fRP
z^DEU`4j^+e{e?RuZlTYgX3RkcF;+7YF)5_v0>^8?&K5t%)?(Z1!$P3OO^9E@a__|o
zijtQjHX!--y=Xhz+U`WWj_BivNiR8aV>+F-G^{u%uk@G0w>~~N@W6FU7ViHlZ{3x!
zfs9YXX+Ez^vUlw{`PagLA7>j}*N@~|UFiI-;TY}4Zj++p^E~vjULILX74_w<^)<@L
zjcs#X+vc2G%6v^`y3ON^8@{#^&tUSY0jXPofj>OR8|BFK6*tvC!+?NaHJDCvt8^O8
z<A=W{_e%L~fF+#MJVNN6!Y>);6STM(`n<QSbug52e~fR4gz9J9ffuOf9gGoIF@zQL
z`App~u(+s_<=4A<0ONK;9a>_g6%CXjzFes&Q14*(u+3myeZ{c!E7@{{wOR8Ri9ZUJ
zsD4hBaM~L~TCI33A!68}=8}|;_k&8>fXAK9;&WkJGMe3$3QPG+eLs02%kIjL*`52J
zW86+&Fp$Y!csAZozL`?OaY+HhUKn8gyBF}UGTv%&Dn49afoz6&tzrV&Ux1md<j2rO
zIVyc<MzIPq8TEtB=iO90B5Pm_>dZZ^DI#wgW(9)j1#)8gY*_}$Si;X1S5Y$(I72~#
zrj2lI8B_ey!lI6NqimSp>gOh-<RX644$bs@LT#;L?OEs*UWeUX`00v_kP18*O=Yh_
z47%5&mI(d{n4#Dr6PvKHYy}2%rcvfMt!Gi6LzI@vcww?z8W6=v1)k2l1g!nS!H!^X
zLq;jr>JT%vW%KOm8y?XGF9}_|LQlT(HfnaJWEh<#Na>w!t)02wp@ZC~8Rz&>K-M?;
za0>`XxUGEAS5h=+xLtD(T`&Z9sKR^D#Y}rCF&8B;8O>Pz$;-GRq!<zP1^7HWk1k9Q
z0$Re>LG8JB9%Fb68)WBzp-q9+?i<p|h?i^|w130^wt75Xyb^Ld4;&SrCoCe*!%7jV
zYbSh&@boGd&vryMLQd#;=oz}eWn}Rn5Z-CZO2W`pBc)kvNJ^B6^U3z`7Pn?2{Ev08
z&l#v`F!YJP%u%U_kf4H$mz4X!Kds-56fJJpK~>a6Hbpy!DGcTLku^Q26SGW}1<^5j
zROAr?E7dDtN(<px(+g>%gLF|T=%I4yBU4!JnjDmbb|z=!pFoz%I<1)<LU(Q^I`^Zy
zQphl65`|*$0^BJ;mlm|JE&G5-;0PtlZX;ZZahGmwTobkfoFbzLHL=^l%_We<a7$rm
zdj{eup_z<}4atOwOU#sAAUCtgj^zv&Nz{M^oU*s8$+<Qi-N=j~+79_a`wu?M=Ypz<
zmxc4PbyW0!TDMn&*b?OPtHkH{67FnJ7Tb*76}B9Xlrr9yphkaUsP{DcEe5#a@3P3S
z8zza#@U5}Ri-hWt`;Vfzi>rBdEO(3%qMdK>y@mdP8h~w2N?>PU*y4f8!<R#Y1mu<A
zr*hH7*+<ti)H{$f@N#g_8)is}qB23T5%{KBodh%=R-i7}DFqZHVKkS*G&x0wJ%q07
zCmSLQo8a>m>^4lbp$fQq<6>(zfhiYqt2SSgatVk{Y8bTn*F1s%%ZpU$wDKHj&Pzfc
z_n%DsBd<X5MNQkyU+{_Sz#a&*fkU7x0h&@w4!VxT=7v>jPdG>lq`7eMXdfTPkH%Z0
z9TtFf6DiutvK>eb#w+k8Ub0wmHf1SlxB33vVOZA-K7n2OD1is>s1jREByVnvYeD+~
zaF2MnL^{c@!O+QCXjC#N;9IfmDYfr87b(YH2OjES(IKLMYsA(;Y~TqQ?Sk04SK?GQ
z>Hm-^-b!BC+h7EW<;RMkBpIOC$3x%Pt*VChl69NF{&b$~ooS0`nf|o@2M$9$hLJu|
zDlM)l0}i^0xPvp92to4BQqbfCb7Vk{oqeyo-kry32rp$4ya%Tza$ax$r15@p4V1Uo
z%>&O~yH{ZTNAl)Ni*8CQLN1kjR2e-SnMjt$1b-+Ief@jIj8)Kok6!->W{%GPRxta2
zz;e$lFkOz-(EkYFu%Wzj(xaRekI_Y&)ITDwa7OrT<TQ+z5*A`ms~${hQyLMmWgN=b
z|AIfjiazOyR)7V;4OM+)YnGSeQ44Mf5)a$TC_1cNUB^FdaH_^Sm!$14z`U7vVgD%e
zYuUCnN=xR;Q3|x1xh$a_5h7={670g@E2seh`m&>sZ7xPT>2vu<eb*l6VWgd}Of1Ai
z9B#E+8sZz5qB|Vpt0o~UKq1+%pq;#QV5&YVJg1dXb#1V@L%b;F$GB<wIj(Wl#bS>p
zH>@$sB<ZDChlOWI@EL^a8HH3T#%}}e$2=LE#kYs*wiKK6D5q0iFqF5zAOU?o>-#SD
z5@aJ-l@z#BL=z~}!;C=AIhQ5C$rAY3YdgSW`Uu|{!vgS{fooEp$X8Z7*?J3E41dKG
z4;klTLnO38;01D<IdhSfUAu2e8L9kd;z>NjX%8Gno#1NqE+%yw<m~IF7zW`nyJabi
z3==Wk_aWk*(QKJqaM6Wmi-h7P`O-8b!g4cKi_?c^Tf79nV{VF<?5}KepZv_Cs@*3}
zKViLPY&K**B8L_yU4N6Gs#**Gu5Xoun0-MFbjsG547?mdo9hOLxE`rWh&D;&`LHau
z|70A~S^jd{=djf^`_65X0`OY;<cvI2S5UkRthojegL2xFX_G!OAU*gH+qUcBbZ6Gc
zd`;7*h-#Q1=j(q==43zoKwi=tENG8Mb`}U71hc%0>)B>3pT3}7{p(#q-A5064d_4(
zht-QGk`{-+<UyH((1+#wfNAOr`$d9-VOTy~2B*qx_{MA!;-D#R*o<0(w2S;G+mLqt
zqOuoIQX6OPMAsO<ikgNRFmLVy<74XzG7>yv_k*g6+ac%9Vr1w-K<)by=%z?2C^eej
zes;@Ck_I8B+ox_HQmEHrZ*!ZhJ_|mPe|}+EU(@>6n`fVXZAZTARGekJ<|1aJ^45+W
z+gn^QH~yj`Hs$ZtKcVnWpq#T?aycc{?%>_t_dU1V4qS^1cx%1->n9rQXm>4Iy(<(0
zc1bU3+2Z+4R;-n<kvbNkX&xfJkSE*NS4KHkhtbxhQqJ3US?jYAo&d-%_Uu9YC5==G
zPeGS*%wq-tyi?Qi@ua!}p*U4lN4&Bq1FB{dl26~p$OjV0z9PfVXSwxhaYuQg4jMco
z=VbzTlD?EPB%0Zw;VRf`=x<p;u&de|`5Dv~Mo)WiM0S*mb&=;>I}OoS6x*uUoV-9;
zT0u6lMUI~{?rxdgu<CYNtPqExGU>1U6HCY;ba>5&XD63_y)n%n@|AeL|Ban?<jRg5
z!S#uGU3XVrkKeuWyG<{mMBm?`!Tx-3&u_R``mj<O`o}MZwIP~Jm->z)jeoY5u)9#3
z=jt6>MKW-!&R<+BE~itrW8;cOHo)&?ow~4fGinE?M$7mX%t-lQCgOExqAn=I=|q!B
zr`jF)sh6z-D_gKy|4ossaleygt5rs;VG&~+n3$jHkoB;^4}XCb`#?1AA6;k~dMKK;
zNmJUe4Kh_-gTJWBVs<Be32DI{mT50*?U@Luw)OgmO@@>!oai(erm|*}&Yw75T~SF5
zxZJTDBO}9NLt^`$IPB?V9Vj*)jGKDrco6rQ5AWrJfrhNgGDWj`^`Cc&x@+n&sHTF`
zQam>63?<Aue4DXfj@F7VJr#-G04pceK{wU2e}Zo5{8$E_wf%8{>M}g6c4r;v#Tu_=
z<%m-xh7%6K1!_<F*dR2)o*%bsRA^Pe0ge+yr^LdVq|=Hx^Su0`Qs(YBa#ZAV?w-CL
znMW-B`9wRqY;&h2yj6?qtCgP=qZf+jU>uG9d*Y<Bge?LVVda(q?6?aKxexCkn!ZI$
zdPt$=tZnd7kRsckCB>UCsgl|j`UUcefjGoRqJ-B3U0``VfLDb`U%{mT?b72T>n#cj
zeh&F)RrFc(mU4r&Skpk(W!_ZP6{cK-4i#I&Y2gg15+e?)^sZ+?L~l3=qRW)6bVIff
z)qCDm#kt_lYj%J#S{MdQ&LL2*n2QM;Lew3ueKeNpkNuq&vTv~3nqUl{P*OElvp-6&
zZ@F{$srL$B>$rE-^25KqJ-k<X?)$^r#<tl6wKUDgut*a6N{ho-uBb*p^_MQP9W&XJ
z9@xA7Feq;MN-_o8@Tv5LBx>0<@RJ84lWRz_y~otw-A7sqE%M-{i;h)TW*tYoTxtrN
z>SeFDw~Y+M#pUtqxzO%2zwRp~k-mFaV;WGx$v4#d-q-TtweNdW=IaK8`ya|~&)@N>
zq@aE&IXeCYn_37mOx`ELaX+6R=iB3{?&%I5Ebo9Ng;&AHjXOIH4Gtu`T+`oj<Y-Pw
zT3N;)>yA7)yeh3d{O5#|RhtOE(5tAaK+HQ2RgtEQ=wjWO&o{tGJ05}k7E^kF+=g(l
zUBXqQK^}C7lj$OcS7X$O$qYuUCx#M!&}5^VSaUSDtATVs9@9fr0H#;UiSwB4beK_w
z1c2#WDUC1|KW^b4#$>!j32?j$d<t<UFM+kKVQVy{EI&-iAvOcgGK8FbibVr8x}0e(
zr0Z65hkVtsZFF<ea(OIKAK3<{NjuZ(Iu!>a2$(+pj1J;6SZB+F;X5CQB75PfajQoq
z<#2Ah`usOms{3!$)J67lU|pCk=%ARvI3d{o60#p6Drj<X=Fdo?CWAy*hp=4hHHG|`
zvlI!MCg<p4pxuvhgu4{x90bKedM>w$FQi>aZpx52VeOkH4bf7rDI04d(`#@A-w-bp
z>gSMX&?)?!C>7hH>Zzt)Q_pffE9b+j0mO`eH4PYGWCgX2yb3Cqe4$Q+0|j=A`&_u$
z<mGUhjF%a<0%Ww=u3#9!9$TTx>d}1H*UpEa*7pN9Kn@k`FC9#srs%(8Ztsx1ZV)dV
z1%L3HDfsuktE~jAxpfKK9PPrQwUCFkbfj}-jN#Qrfj*d57O-Cu7O{<BdNbdG62(}E
zxLr|EA@N0u<mSi%&HZVPKFbYE%5ve(i!IjW?1J;ufiYwk_*!g9j3HRxikd;Z{3)Ud
zli0?d582hnejS$5ap(|vq2>zz2q%5Sc90TBxKO+pW?;dl3$~Yt=QAUl`8ePNFPm<@
z9yq}<3}p@q#C9wPS;)7VkNd2@HZ>0My#JO(d<I)^tFxIr)%tocA^9%Z@QOgJKXsRL
z2z~S)*ejIYv;y(b@G8mnh;tVU4_T}3*J~PBerg|}*@r~X%R`?)w4IuqhPYcy2h|!)
zy(?iz->V1l-0<Q7`g@Wan=pt_)LX{U4InRd+9^H=6t~$rw41QP3hBmUO?HhL<**mn
zsd@~Jwke1B&9fP8czDg~YBh;@MIL#9A_dO!q)G*(UIRqDE<@YJwcO0a*f^RD<LyNg
zviA1+&_$!N^cx_-3%(#WQj*No8xFxEGg6}hK@nTsK2tl8F{{(f*2DU=#KOiTIW>d5
zkhQvty@`28ltMIR9q4A;z*JwjK<4Oi`={E?h06TN1SZM9V))R88~3s#eXb#yrB-ME
za%oBMw)eB`-<E!>)sgKu-P1VTf|bztZXfd9%d~)a-+$AEj()}1NtbUFrHjrDdGrD>
zGKWfnBf@NHXV-md%I4i59bH3S3>}bjjV4lWD@)%6^(Npjr9|hmGIP4#&#j$Iy1=Xs
zN*YYKzwJrabmgwal@iW^Wk%$i;fZs6e))Z4L(aPU)SnitJU$YK6%FEr=qA{d4o72u
z+pU7!F0g(?2{-rmEPsm0H?d`PATPU$Xw6JkbqL7|3It&eJv<klDIDwF@AN65GUm;W
z%YS%nx-L3+`$}K+&}Qavd&&2hjE-LY*4Ix3IdIS`H*U?$WNCz~(X{z9k_fIJ#IRj$
z7AZPhW=rvZ(a*MSmh$I&L)!rp@dRKo)#2NjR%}(^Qw!Te*JW})h>)95xvvs6W9=w5
zTzdo)a=E)lu7_s*5iMIz)ur3+a4DNE4`}HV_U0`JEFV96WaCBI{ashry-@#f>toBe
z@OrTOO|f@=$CriV<DZXr80HFOPah`Qq;x!a%Muu7mIN-y>VP&@>}a$(MlhdT7d{bQ
zW;J!vu5E9r)vvh)QtG5w?Tp}|iz5_FT%2jIBjg?f2kuK$1JnE^Z0vDC<1nI8Z1TPH
zl`*sX?r|ZHHnK~P%XD8N%>c$afIbUo)qTHy+}vf@U!9V<de#dysq{e4BHmaB3^$wq
zmA0dxGP>}?jk4I_4W$teqeQKF_wL^v7llqY-M$x7c<eUA_FZ~O8C~S#TB*oWJnTLs
z3LW-!YJA=B<n=<1b%piFx0cRB2|r)m=+9)4t*)Ca{*|{qZ^@qA$duhvx0kGWGv3n>
zSoiGhbo`?goy-zzO@;8_r#Ruki(@@^o~@s7ZaW4Kg@3#^)-(ITy=g^5d2isAQhbzD
z&*8TM=SBj&t4jHG2C_s=*z2^o_nrjsTD16!Qbt5pBKx$sSILc|7>Ob8J2Qd>=joU;
ztN!JRQ|RW57VIgURWia{_#Df-rkmtn8X6_Ki!Qz?8x(Y!dLK<$ntd8ma6y#5kU7{g
zo8Iz+6+fM|?QV?f?)B=XG&Dx>AKC_QEpl%D3)506PDLCgcwLwg0JdL1@Y2_&Eq2D>
z$Q6m$Z1^La0CuKNb;J?2cPEU^`^$)5enIJwXeikGMfSEiYme-p`D$?s_7`b!WOM~q
zNYYyANLj_-X7cZ?*?aW<#g6~la-9FSj;7sO92YPKqz*D38i?t||K(Tcza~3sxL6ya
z(i+**gA(D27OwF$$1>V(IarqKlrYqQwdHt$1M)VuUjBT<Tpk)BslM090ON&ruHdDo
zy&Ev4LX+|`xgg6WR$(caP3Jxc5i<er=Z|OY|Jloe{^JZ9Q2u!pDbjVl{821h!agu2
zxm}%3`A^-LCI4zl$^YgzD9NTVi(|r8L%)Kn##cmz8D!=tJofY+TVI!vZ*wg*pr*P=
zE<Cs3^5(2x+#L(@y~C(~8$m@Cd|(*ym)mP`d+>UTUSPTyCm(1#=h@P<6-=581fMli
zsyX@m<Drgp`20!8O{R}HF%(6Hd-_>hi07U7(w{L7_Ck{dd{gcGV+~kZmbqMw$H1ke
zh_6R<AyzYsXC_7M+2pl{VhEzs!QzWkSTfWA-Z)H~SE37EsL6=yfEE`HEFPQ95Qh3<
zPJaPl>GuMW%8RD4!Dz-x@+Po71GOB+7ywQdx?w1qZQ1h>36gW>!aGLWN?NRna~RT4
z>mT~bYmgtBuxBBxnr<%2YmcUYzT&jmunbW7k_UZJ-Ro;wjOqB4X3ApLeAqrouGA5+
zh_GiFhRjNu7NR|3JYswMW1(fsI|3aNr&lRWSo1-La|vp0Ua>uVU#8S&ttDfjRX{gq
z+G%n0roo$2P1!i)GlYpDR0)BDIwN$rQ^qi6?P;uoHKhmumbKAww)Ex<=?n*>Kzqc`
zfXO^8+U<cO%Y$D_wlsv?g@eBc2u~bd@~u7wXQY$DZ^LpLG|kBxLc$X<wlI`w;y8jq
z%?nI~1d3Z}>0+A(3}VW$#*kd@LiRGIZ`&+Y$jEjd6|8lAP4|J%swwPV@iX4JCM#xo
z=SzwKNl!Y=)nU>E-x{sjiA#rmzc*GGlt0bQ3R_JxVLofOTmHni(L}ABU85_d4^dQm
z`_M(mPnsu`D6UNux}b}_lHHF%OpglABE%D-XEhv^G8SMn7c1RK+9GNE&X(S4X9~L9
zmjO%RiU61c708Sp<w-s5y`Mq_LXEF?y0Ue~Y9&g7Xz%v=Z`EVA3$G8!I`!=^01v;#
z+USK1^MTS7Pi98z>LD3t9(VQ}^X+LZ?iS~KBm1fjJPZbU!QnjET2O$J!A>D}q1Q=p
zMzWzqx&XC7o3VnX`4+QeJA|Knhi%<iW%dRVK$zq}r{a==`S7Jm_|x#g!kM-p%O_z&
zJ`C49-sMV47eP0HV-Q8DI`KrxUl@ZmQJi>$xJhWX<6oj{1^^xQQsn0vI7!~Q5N#u`
z1I-78*b>keRS`4ji%DB-*z5Y6)&vg$E%BhhYk)*qC`xRqt8tVujDD|7;imDA(T0**
z!W_WS>?+z2U$Q&vAto#KVErJm?u2G#M)Ha3yD`a|Z!^l@#w713iI%Ek>x}|h#zl^m
zWYxfj5!t|}HIeDeyLms+f9GA$;vTyx!ln4()uDh8TmGLhwibH?-p;u}Q}HNKyyQ<<
zuDa>B1&Hi;4M;e7qz&S#L9B=EUNm`q6}bPtglqf`mbJIi@ymMHHc^9CgtW^>K|UA6
zitlgcU0>doPb-jBbp5eB&@gXya^s$SlcHVgxV5()|M@(t|JtvkLB`pYey<X3%6GAU
zC!|L_eX~x=qAxrfw1R8=aQ~TI`5T%7Gh5e4Hi9t??B`DciWYiWW%VVTq%BD60J~nU
zU+qZnGUhb5@drmXY8u%qm_b;T(W*2mn^a3RUXp@l;;_CdM3Ya7g#1yrLqqVVnKqz0
zDIH@)d^_jCH(SK>gQT_}uH7FaTR;p&ti(yTZO^#a9HE?9lonCWEZK^VG?+5OIzBW8
zp@ycsA!f0-C73#?l<=2~7rSwqudr;m7*$@iqxun(A>_z-!(OTYP5y=|t_|ylR27S!
zmQ1d{GmcTCgXc($lZ0l99lN{O4(r8gyc5&3y4z|(5d5Zb_GktAT0FN}2_K+~nhf0N
zU^Ur;WsB``EIXSMa+aYZn4jvSW^`m7%}R?aiN*9WjJIlWz__bHFc4kaXsz~W37$cg
z15jX;dndAzy&fF_<Mh!5mFgu-Mj*Jq@*c7QT3<jhazd8hL)>Zy$Zo6@X!RvbD#nUu
zbQ59=V_}s$k7>FUvTQX9+71HP2?Hbq)&)~rg9(DpMIS|s^HWn`Xjw)jLN2!Gt8O$6
zgrChg3meR_dTdw!?Wb_6jF69YysmFr!t{7an9G;kCM?-7&7H$Kd{Z`Zznp@Y66D-;
zAQDqY7~UD%`S3xoHN2OHM9NZ9l&N(SF_*{5n?X(9v^bmP2!2ve7A6ip!}@G%GTI0t
z%TS1s<|-bFXr&mq^6=60g-FP~*szT?n!79l_~j5-ki!byoFmU$O)+Qvthv;rH*pF%
z2&YIp3^Cy;1SSf?7DAEdSs{r@(sx$)oI<Bkl+S|$MG3qi57p^z<=~!bII`@}D;Gdi
zA@~wJ;a;1?^14fpqSuJqj11+23h$Efx<&lT@!-|Gdq@ymA+59)77Qfc<DSt^SHvB~
zpiHlTZQRu7V*OB@CVr~_l9Cz_GegHu5$&R}=WQ(oab&fyZm><6ALa_>vaMimnFB-<
zh%-d=JQ4%47qZuPHJOdMx3=B+38vnObx#sF#r`-*^1T&{n)bU8OyP_l`(BbVRC1W3
z{((ttrOcZWr{+P$jEsV0s!$Or{{eXVs7UR`<g0G=(0?p=xtU@#jm009r>1n0v`xx0
zWv#4z-ro=#3Axksu--$!WIaNS2ipjE5%ALp^V(0C$TNtT@l-jz(?DkO-Q=WmlxU6)
zGhU)ZOmDV~EGYb-#-i0TYTh(YWT?W>#)Wit7yof>_EGqf1WSJAkVOS35V{kxSjL;L
zKshaz?)haA5}F0e*cZ@e#s$j6na5EJ^aU$SQ%p8RPWG`J9>FudP$)l}WoXeDEhShZ
z?r;(0C21Er>HY}q>EUF%SmQJ4^N>gh(b^%M<-6g$RLxxshfdFcs@fE(W{x_rcLUGG
zZ(Ry)Q?2GAaMaO5V;%4W4o@okGpdl$toUwC71rVam>qXf975)3?pUiH!#<Tv{?2Dm
zl~quF16@iG*-Zq)#l_!4mDl-lr`Q7!z?o!GAC1pi3Td{{<mI@pS9WO{C{Y--CrXjI
zO+JxuhbEdw$ncYr34&?0Q2^eO-5V<<q_OpDVK?<gjK|o7u4dj8poUOb8paF4!y({@
zMmce~v8rg^OdHv3faHIY$4uG>t-f8(jBPF^c4N;Ar`ih$;6C1B)-Etoz{v#+_{Y>|
z0SO}uU5VY1gqkuZgy?#>myp`DjA_|M2ls>!hJe;E8}}eVJu%&GeNRL5E!KA+K@kU*
z1VVQAuq1wLCKTHD9&4bP%3ERUxVxVeUZ$D3^)2EwY=UYr-RxL~q$C0=XcdEnSWxkj
z6X2cLe|*qjOtPVA3;h}OJSzg@SEoNTo|J~r6dVJzo&T)308PC;{B0+<)T>VysIa!C
z5%&g&@^W?tG0Bi3;{VakwSF~mcWV>@MIZ<Q6(muqB6qD&R6?f8OOaZPh&B?%Xen|l
zrW`?{gp7(1X@tC$3Ka`cP(Zmvg}^I9Lb%0Bm8&3Ffk|2cA!J6mOvxmkpXbYY&p&Y1
zI%}N|$;yY{n#r2AXYXh4=XtiZbY&db1iK?^6`u#WZFI<sg^tT#ljyjN)|BWx&7`gc
zSS{%pqdk|`jS`<>S9XTtXUEi@3mqaG{SqJ%?A2S>^iy3<VA1rxsBU3qGjyEzZv#@L
zc)M1=Tln$oybCV<9;dgd{JDNrq^7CTKYm=SlS0_h+c>K&y(r22c#`AnRDpKsf7y*7
zcaZ3A`szRH(;M;z9&#MMK;bM&Y~$y3_R?#rQ5&HlCzQM79>-VCjBXD(atMpXe?pU!
zRw0^92G0{S%GQFU5@jF9j3@|JX_j}W#fM><$RK%C0NLud5bN<k)C(!gXbeGH_ot5y
zlqe6+@JM*d-U1h5O*ClcC!kNHn<sfz=r{Q(==*RyGNpvr#{VKW7_}(8$)VGGJ#1ZQ
zYbY5-mMEiL^mb5ba^B~If#uW)wWa}Gk40y2ncc&$ha*Cel~t7Ro|#6c;)$Kr*Y8d;
z=OuBcDrd5*=B}x)sRiK7W2egQuXhnI0XDlx(|0kWWP&7UIpL0r(Z_P>PMlHv(TtSA
zBjcmUAs{F#o1i#?H+Vc4OYVoQ6>X_ir#tLVJs3-HZXW23A6yt-kJByk(Q)l24@0o6
zguX)0Zz00-{^UZxjwODw<C|yB%)`Hzifg3g<YV^UW&HO3<lB>h{Uy5(Zrr>4kBzP`
z;s$cd__t+#s<r9<3f29gynW^0-pXu#QFg?$Dtj^e>qF<PD_ASO%vq1P^_9@=TqRrZ
zr*nTD3M-o~q<Skc)6#sx+Eo?A8v20)%cWcKXw@iRWWn2r-;k3{G3QpV6<ikTQ#(wn
zx{2>qJ_NxTfzSoKm8feB*-a+HuicGHj0Ism>)|zaAAQzwiD!#PBIB8nd_;H=h5&lF
zSjmOc+nA0IV@6G=p$I7lHg?x<CXBH^Av67YAgyBX)zmQUQT-E;1)VdviIs6Y5B#@s
z&VtHWp5PaxtDL57j_3J5!h^M2N*^H~4EXkPv^MP3RQ&?aSi5cB5ZvPwaadO%aZFJv
zI?T!bVXDHJpU$G4`)Y93J+7+&IgW>T=A+Vg4u$^+M%V`UbCn_#uWwFC9Fo&+r6K+%
zEq1odZ+`kN-y_i-j+hWVAju)KE~THyT;DD-BB0YMN3ZsC&Vp)hdd8^1>|G+P7=IT*
zW3P=RJLR>cp7nX=)p0s@=fM%TzPZmEYO&P~Cq<jY=BlA1pL{TY?*0;4!<5vleR|D)
zJCVTr<;uY=#K>=h70#~LHkAIHd)L=B_dvq?ry)-nk0x-K<u7izenjbBykk@3SHIr>
zU;uQJkACQ9ZL<H5*5`Gur7IeOzudk<we@t#@?D*)oN0S_dkH69xh(z$d)RNj3}2Fn
zMUEL)sNU%ANO#~Dc$+z@R*}^l>AchiwVVD+y9$<jC%XwRi7cd!GR5iv+L|e{4;G}*
zMJq{Jm0h3~t&SNn8b~7L@Lcj+i?;Mv&-}&8mmMbwSrSGL*Gp?iPt@+lZ!pq3WOa<`
z5`>hMjnUpKz{VH4J?_i=V37Vj%@pW<+|m99$#`4S3N;`}thrxFu<^DVPm))rof&|I
zJdYlp_uIOH=eKTxlnz;f{$aE1gz&<C4wVba@u&ED(s>g>m3|$`Fc2-9hlO&LBCo(g
zgv8SwNM^T70?D2dv?KQp2hcYcJGCbrO}_4%y{uu-AJ)|iOCIR1(i|qw(FBNk+k6Os
zATeZnU@~fik=GWAX3?@L?=(Y&$c#!sWPFi1H=%ekZvh*MJ?07WCCL~MXdW@fHeRue
zr&$4W4bU$aE?uDaBzbr~9U#>}*0nJ1DpIE<qSi_;wPO|63{OC0%cf-a^VJM3i%aSu
z7^!G$;6QB}Ym9Neipxe|v-pDO4Cs4t7Q9;eInJTqI}DKZo052xJ|71>|D1nLE*^Vu
zd$Jy|O+3mXj40G+wc$*CzkQG#7F^{$A6~c=sjHQ+U$!1=!jn;rl75LBlv*7D%YCb5
zW5ws}+Wa?Z+hm^*>^qa^zTubZ1Y<K|B=s33ya5XV1(vsNh{JEOedA>)?2c!>97O`N
z2ivq$UO+H~_!nwA)DB0{@eV;Jiw`eV&qzJ-)V3*(^wVys^B)0cayi;BG1IqpQ`NCN
zw=|~Wn<G<l*r@r@FHj-?wD!Odqqmab`)NQdcBxEnEykG?^eRw@6R!GEP$aK|LtXmS
z^@KZJEmF(W6nviy*$20mg5&jS=oJu0RRVJUk{)32OGoq@4=y1_fFq#RR~@SIG6}%8
z$ww(Znw5B&3KVdBowH(xJM}ma$STsgMk!i0{Bg-qY?Ga0WEnbsVHTLnm)4;(83|+0
zjv#|_&1L4v-15nK*pg<&^#V6AjF3tO=KP?wc#4LeO{o{EeG&FBU8%SrUBh)mGw-7D
z^E@D=-obUkGpadVVR!&?LD|`r(_q&kwC=2!gsr%+HiElxfH3s7h3(wA9%JTY#e5t-
z7=<}0?J~gjtjVHH4_+j@bwVq2lZf~w8$=o5sDk(lAj1^_PR4}uE<6G3-r)vx^Hy@C
zEemp>F<AwADprfgjP2B4eRv8olR9t~l+HQHnhdE0<`B<>TZbA$@4dp0PtIReEQ?sU
z3`J>-IrU0XCe4FWF@GGTWJz6dS2qsT0rPDmuflyQiCyT=pI?m#i6>=Jqs!l>(44xz
zt;<`SKf;-<`l@IB)pwIB(?M%H17aWU1{w~sPQqm%vWsLYo*t$3q$6FFk22wlySb;Z
zQ+(hT%aqy7MtskS)|*yo1LIjWY2u57U*!~QZDa6>(s-GP4`lw9VmXfS?v%uzA$#`C
zIY3Lr>9Y<uRuHG*#c-_~-l?>esNmt#$eRbsCqw|a=8y((wHavZJ}Ksy_n;adY&%2q
z14as}zW11+t$ycY?6X~DK3dwU;%D<#MNBs2XEp{@0&=2NZ}~5_O-z1~)gXe2yYrxj
z3+diX(AT|5z!=)hJd<A>!!l{~Dv7P5S>isiWs~GJx*~4KX%+oE&9Tp2J-1z5>Fsqv
zy0xhhi<YZ53~UFGHj}sM@uR^;J9cqgZfDXQ&z|>tDAzMJdv74ls)*BjHDM<06stI3
zmkmxv75lNd`CFK<eK<Os3ZK$DNnXtUt@cicK8R}4K}g?EdQ$0q*c&pyO}@-gOdm7v
zc6wkyl<DrxiiIQoI*BaS+#0!-R|NzfNXqnjtqVRCjFtkBXk?|UfKGrRBN!Kvx8Y#Q
zXJk<Gf(R*%g$$^`;JBRg>IinG5bbLjAUh36Hv}V>lM<k2sqI7irjBc=<srr2a+m02
zJijR!iD$uSl8Be$T}W4EBS;0y{?HXsQ=);Hu3?-H$Fj3WTy!;3b08{nZPeZLepR?q
zxteE$pN&FZ2h8X6Nko>!c8UeTc6`Tm$Df(!=Opc!t?;_9ui}2K6YxmfSj@jZTfbG`
zF=_%}^z*I&fC9<{(oI|+oTQRj5992w`jgXGdr@7TOnIY_aVR~YFF64|)<5n2OZ7lY
zSLnc8>Z?@FOtRZ=C*O*plWfyC(De9Y?ESjy#Huum(X#VE3~e=j<1E5TA7oi_x8711
z=^n<6kg;DED{x_8@6}g_UU>BF>q~Zv_enn>yS&?}@n7Kv5Q!VAJ*)3wSrUd?mr>vi
zI8XSN>Icp#rX96=I2$PGt2pCw9u;>P^AFOS!de6FW~{y$%4X`u+q|sgDlHIGa}4JN
zk5MQ~;^7p4N0!9B$Gue0g*n*pEz_e-U~-ECG*QvoKu&xIcz+vDR{(`Y6yi0+ZWgVT
z#X%SHrJM2GYVLM4a#E<>Ho>wh8=$T0RHf2~1#L3B#xRd*u%1m!q@|+5R`~ufE}>b(
z<saJuWZ^_O`_|;bF%Ml#uk1TkW`oVbkIDX|`Mn?i#IYTqYbRh;M8H=lMeev$+d=k2
zp({YV!g1@6x;(CtX2O=7`W7;+rWR9V5Wy9}DU}?!!?tc@Q!hKgr+h<G_$m0iQGUM6
z(nl<?6Fn5R#>;->ecHq3`Y64!QfMZ)3)E%~w-)5(llkQn_JddM^i$fH)q?Vv`|Two
zlZ@e?=Y5$+Lnq(MHx|3EGsF}vFuGs-Dhz;!T1q+?rTlb<Fz@E3ssKAxGcRJRJ{UN1
zmw+7}6^^84cnzT9yYS6r9ciJ}JkwU~A-tyJ^puqH0?d`wYX~S!sd40PdqEAk$(ecA
zc?eY3)xzCa&aK58+I2(}R;D0bj8~B^4;0x-uu(qGi`OeNqK5lktV{;#W9GmktuL<^
zwv|PHob}+TfrH87Ra5rHxhfZ_ov*+h@U<La8>5IKVA^{R>+1%b4>r6d%(b=z8E2Kp
zG}O1!L47o7ZDO?M*A0vK63FmlEF&HPyZS3<S!+3``u6v*lU5ee#`iW!fa_J0#Wa_^
zzVc7Hu>f1Cus?dhLn!c>@F5*VH7)AM7W=f0Tm-rli==sKBCwzzJ!?lTg#4YGM5mSP
zwVWFatSp-vm>6A(=L`=gq_pd|V#ZC%uGMkxz8vOXriN6#U7W8<Ot}}w$PY7!`&&Bo
zH&{qF@jh+vJuub15aNN2X}}cY2^x}g_A=lOVgwNzMrgqDVF!?yy#6Bmcg0OpJ-a~<
zwsUIqR&^RH{CDhw!8*vu0-6F7W}7y+#Y3f8T$L;)95`V9RnRaCXB1H|a&83&l<0^a
z&)UP{S&i9nxX0@^*~uH*3KF`q-aL+qpoH}gcxNU1ePO1t-t)Z0=Y)ghlIhvdK!er)
z_OW@d=}2{R&{%R@9d|$NU9{<GjNZ_inqbqvcXJbZpi;2*$=ip^QudD-o6g)sE<?K*
zxkM0}a=CGDIi9k=8+vd=>)P37o01r}m@!}YSj&V-UCZ*`g-<NXu7eId^7oogvy7=P
zudmVnaFc8TUMEc^JQ2|iqjb<=KLIvIKSZ=>mqa0~0n~Ztp8~)}6>q}_gD#RWjD%Ey
z2WAsQxUnwF-nYs{cvw74wC^`r^8eTQUwJ-1a|FB4X&PnlWcse269pa)VOQ4__g0qV
zxg2<UCTGu|dklj%Y&Xlf{n>r9<?HOV52X?P!07jn{v>q(eQ4|n?{!p4^c&EU237s`
pSK7T5>)umkcz`wUnYNA{^77TA(?8AG{EuM#_rUzW^c(&#^q=J@cQ^n5

literal 0
HcmV?d00001


From 8fb4d3257eb100dc9fb3e0045a6560f842881819 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yusuf=20Ayta=C5=9F?= <yusufaytas@gmail.com>
Date: Sun, 7 Sep 2014 21:13:57 +0100
Subject: [PATCH 07/10] Added cases to use double-checked-locking.

---
 README.md | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index c2c47f13f0de..00043a2335be 100644
--- a/README.md
+++ b/README.md
@@ -241,11 +241,9 @@
 
 ![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/double-checked-locking/etc/double_checked_locking.jpg "Double Checked Locking")
 
-**Applicability:** Use the Visitor pattern when
-* an object structure contains many classes of objects with differing interfaces, and you want to perform operations on these objects that depend on their concrete classes
-* many distinct and unrelated operations need to be performed on objects in an object structure, and you want to avoid "polluting" their classes with these operations. Visitor lets you keep related operations together by defining them in one class. When the object structure is shared by many applications, use Visitor to put operations in just those applications that need them
-* the classes defining the object structure rarely change, but you often want to define new operations over the structure. Changing the object structure classes requires redefining the interface to all visitors, which is potentially costly. If the object structure classes change often, then it's probably better to define the operations in those classes
-
+**Applicability:** Use the Double Checked Locking pattern when
+* there is a concurrent access in object creation, e.g. singleton, where you want to create single instance of the same class and checking if it's null or not maybe not be enough when there are two or more threads that checks if instance is null or not.
+* there is a concurrent access on a method where method's behaviour changes according to the some constraints and these constraint change within this method.
 
 # Frequently asked questions
 

From 91a7980f7224843f4072ecbbe406d71434a3e3b6 Mon Sep 17 00:00:00 2001
From: yusufaytas <yusufaytas@gmail.com>
Date: Sun, 7 Sep 2014 21:15:24 +0100
Subject: [PATCH 08/10] Added simple attributes to the Item.

---
 double-checked-locking/src/main/java/com/iluwatar/Item.java | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/double-checked-locking/src/main/java/com/iluwatar/Item.java b/double-checked-locking/src/main/java/com/iluwatar/Item.java
index e0cada17e510..76e095e7e415 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/Item.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/Item.java
@@ -1,5 +1,6 @@
 package com.iluwatar;
 
 public class Item {
-
+	String name;
+	int level;
 }

From d6aed142a7c07a3ab0e5723fe1a96e5b0796ebcd Mon Sep 17 00:00:00 2001
From: yusufaytas <yusufaytas@gmail.com>
Date: Sun, 7 Sep 2014 21:21:24 +0100
Subject: [PATCH 09/10] removed the lazy instantiation from singleton to avoid
 threading problems.

---
 singleton/src/main/java/com/iluwatar/IvoryTower.java | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/singleton/src/main/java/com/iluwatar/IvoryTower.java b/singleton/src/main/java/com/iluwatar/IvoryTower.java
index dadfc35484c8..113962eb84c7 100644
--- a/singleton/src/main/java/com/iluwatar/IvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/IvoryTower.java
@@ -7,14 +7,11 @@
  */
 public class IvoryTower {
 
-	private static IvoryTower instance;
+	private static IvoryTower instance = new IvoryTower();
 	
 	private IvoryTower() {}
 
 	public static IvoryTower getInstance() {
-		if(instance ==  null){
-			instance = new IvoryTower();	
-		}
 		return instance;
 	}
 }

From d1e1be13afe00b1637cddbc310b9d7fe64cc2012 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yusuf=20Ayta=C5=9F?= <yusufaytas@gmail.com>
Date: Mon, 8 Sep 2014 15:33:36 +0100
Subject: [PATCH 10/10] Added Intent to the Double Checked Locking.

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 00043a2335be..e032922e9138 100644
--- a/README.md
+++ b/README.md
@@ -239,7 +239,10 @@
 * many distinct and unrelated operations need to be performed on objects in an object structure, and you want to avoid "polluting" their classes with these operations. Visitor lets you keep related operations together by defining them in one class. When the object structure is shared by many applications, use Visitor to put operations in just those applications that need them
 * the classes defining the object structure rarely change, but you often want to define new operations over the structure. Changing the object structure classes requires redefining the interface to all visitors, which is potentially costly. If the object structure classes change often, then it's probably better to define the operations in those classes
 
-![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/double-checked-locking/etc/double_checked_locking.jpg "Double Checked Locking")
+##Double Checked Locking
+**Intent:** Reduce the overhead of acquiring a lock by first testing the locking criterion (the "lock hint") without actually acquiring the lock. Only if the locking criterion check indicates that locking is required does the actual locking logic proceed.
+
+![alt text](https://github.com/yusufaytas/java-design-patterns/blob/master/double-checked-locking/etc/double_checked_locking.jpeg "Double Checked Locking")
 
 **Applicability:** Use the Double Checked Locking pattern when
 * there is a concurrent access in object creation, e.g. singleton, where you want to create single instance of the same class and checking if it's null or not maybe not be enough when there are two or more threads that checks if instance is null or not.