improve readme & test examples

Author: WebFreak001

README.md

@@ -11,14 +11,18 @@ normal usage:
 ```d
 import openlocationcode;
 
+double lat = 54;
+double lon = 4;
+
 // get geo coordinates from plus code string
 OpenLocationCode plusCode = OpenLocationCode.fromString("8FVC2222+22GCCCC");
 writeln(plusCode.decode());
-// -> 
+// -> OpenLocationCodeArea(47.0001, 8.00006, 47.0001, 8.00006, 15)
 
 // get plus code string from geo coordinates
 OpenLocationCode generatedPlusCode = OpenLocationCode.encode(lat, lon);
 writeln(generatedPlusCode.code);
+// -> 9F662222+22
 ```
 
 ---
@@ -28,20 +32,25 @@ writeln(generatedPlusCode.code);
 ```d
 import openlocationcode;
 
+double lat = 54;
+double lon = 4;
+
 // get geo coordinates from plus code string
 string input = "8FVC2222+22GCCCC";
-if (!input.isValidCode)
+// make sure to only use uppercase characters in your input!
+if (!input.isValidUppercaseCode)
 	return error;
 OpenLocationCode plusCode = OpenLocationCode.fromTrustedString(input);
 
 if (!plusCode.isFull)
 	return error;
 OpenLocationCodeArea area = plusCode.decodeTrustedFull();
-printf("area around %d, %d", area.centerLatitude, area.centerLongitude);
+printf("area around %f, %f\n", area.centerLatitude, area.centerLongitude);
+// -> area around 47.000062, 8.000063
 
 // get plus code string from geo coordinates
 ubyte[maxOLCLength] buffer;
 scope ubyte[] generatedPlusCodeString = OpenLocationCode.encode(buffer, lat, lon);
-printf("%s", cast(char[])generatedPlusCodeString);
-
+printf("%.*s\n", generatedPlusCodeString.length, &generatedPlusCodeString[0]);
+// -> 9F662222+22
 ```

benchmark/source/app.d

@@ -27,6 +27,16 @@ void main()
 		}
 	}
 
+	// get geo coordinates from plus code string
+	OpenLocationCode plusCode = OpenLocationCode.fromString("8FVC2222+22GCCCC");
+	writeln(plusCode.decode());
+
+	// get plus code string from geo coordinates
+	OpenLocationCode generatedPlusCode = OpenLocationCode.encode(54, 4);
+	writeln(generatedPlusCode.code);
+
+	testNogc();
+
 	TestData[] list;
 	list.length = loops;
 	foreach (i; 0 .. loops)
@@ -51,3 +61,24 @@ void main()
 	dur = end - start;
 	writefln("Decode %s loops in %s;\n\t%s per call", loops, dur, dur / loops);
 }
+
+void testNogc() @nogc
+{
+	import core.stdc.stdio;
+
+	// get geo coordinates from plus code string
+	string input = "8FVC2222+22GCCCC";
+	if (!input.isValidUppercaseCode)
+		return;
+	OpenLocationCode plusCode = OpenLocationCode.fromTrustedString(input);
+
+	if (!plusCode.isFull)
+		return;
+	OpenLocationCodeArea area = plusCode.decodeTrustedFull();
+	printf("area around %f, %f\n", area.centerLatitude, area.centerLongitude);
+
+	// get plus code string from geo coordinates
+	ubyte[maxOLCLength] buffer;
+	scope ubyte[] generatedPlusCodeString = OpenLocationCode.encode(buffer, 54, 4);
+	printf("%.*s\n", generatedPlusCodeString.length, &generatedPlusCodeString[0]);
+}