Add first example; and a blob representation 'asString' to fit this example

Author: nataraj-hates-MS-for-stealing-github

Makefile

@@ -11,6 +11,10 @@ endif
 BLOBSTAMPER_SRC := $(wildcard  blobstamper/*.cpp)
 BLOBSTAMPER_OBJ := $(addsuffix .o, $(basename $(BLOBSTAMPER_SRC)))
 
+EXAMPLES_SRC = $(wildcard  examples/*.cpp)
+EXAMPLES_BIN = $(basename $(EXAMPLES_SRC))
+
+
 .PHONY: all blob-stamper-all blob-stamper-clean clean test gagaga
 
 all: $(BLOBSTAMPER_OBJ)
@@ -46,6 +50,8 @@ test:
 #test_dict: test_dict.o blob-stamper-all
 #	$(CXX) $(LDFLAGS) $@.o -o $@ $(BLOB_STAMPER_OBJ)
 
+examples: $(BLOBSTAMPER_OBJ)
+	$(MAKE) -C examples
 
 gagaga:
 	@echo ------- $(BLOBSTAMPER_OBJ)

blobstamper/blob.cpp

@@ -111,3 +111,10 @@ Blob::asVector()
   return res;
 }
 
+/* Do not use in prod. For tests and examples only */
+std::string
+Blob::asString()
+{
+  std::string res((char *)data + begin, Size());
+  return res;
+}

blobstamper/blob.h

@@ -42,6 +42,7 @@ class Blob
         std::vector<char> ChopBlank(StampBase &stmp);
         void DataDup(char *& data_out, size_t& size_out);
         std::vector<char> asVector();
+        std::string asString(); /* Should not be used in prod, for tests and examples only*/
 };
 
 class OutOfData  /*An exeption. Experemental for now*/

examples/Makefile

@@ -0,0 +1,28 @@
+
+BLOBSTAMPER_SRC := $(wildcard  ../blobstamper/*.cpp)
+BLOBSTAMPER_OBJ := $(addsuffix .o, $(basename $(BLOBSTAMPER_SRC)))
+
+EXAMPLES_SRC = $(wildcard  *.cpp)
+EXAMPLES_BIN = $(basename $(EXAMPLES_SRC))
+
+
+all: $(EXAMPLES_BIN)
+
+build-libtappp:
+	$(MAKE) -C ../libtappp
+
+../blobstamper-pg/%.o: ../blobstamper-pg/%.cpp
+	$(CXX) -c -g $(CXXFLAGS) -I .. $< -o $@
+
+../wrappers/%.o: ../wrappers/%.cpp
+	$(CXX) -c -g $(CXXFLAGS) -I .. $< -o $@
+
+
+%: %.cpp $(BLOBSTAMPER_OBJ) $(BLOBSTAMPER_PG_OBJ) $(WRAPPERS_OBJ)
+	$(CXX) $(CXXFLAGS) -I.. -o $@ $< $(BLOBSTAMPER_OBJ) 
+
+clean:
+	-rm $(EXAMPLES_BIN) 2>/dev/null
+
+.PHONY: test clean all
+

examples/example01.cpp

@@ -0,0 +1,20 @@
+#include<stdio.h>
+#include<string.h>
+
+#include<string>
+#include<iostream>
+
+#include<blobstamper/blobstamper.h>
+
+int main()
+{
+  char data[] = "abcde";
+  Blob blob(data, strlen(data));
+  StampArithm<short int> stamp;
+  std::string s = stamp.ExtractStr(blob);
+
+  std::cout << "Stamp minSize: " << stamp.minSize() << "\n";
+  std::cout << "Stamp maxSize: " << stamp.maxSize() << "\n";
+  std::cout << "Extracted value: " << s <<"\n";
+  std::cout << "Remaining blob: " << blob.asString() << "\n";
+}