Implement direct file i/o to- and from blocks.

GCryptLib/include/GCrypt/Flexblock.h

@@ -4,7 +4,11 @@
 #include <string>
 
 namespace Leonetienne::GCrypt {
-  //! A "bitset" of variable length
+  //! A type used for conveying "bitstrings". e.g. "10101001001"
+  //! These should generally not be used, as they are really really slow.
+  //! The only valid usecase I can think of is when using GHash for example, because for hashing
+  //! an absolute input length is required.
+  //! If you need to, you can use the StringToBits() and BitsToString() functions defined in Util.h.
   typedef std::string Flexblock;
 }
 

GCryptLib/include/GCrypt/Util.h

@@ -5,6 +5,7 @@
 #include <sstream>
 #include <fstream>
 #include <cstring>
+#include <vector>
 #include "GCrypt/Block.h"
 #include "GCrypt/Flexblock.h"
 #include "GCrypt/Config.h"
@@ -28,12 +29,22 @@ namespace Leonetienne::GCrypt {
   //! Will convert a string to a flexible data block
   Flexblock StringToBits(const std::string& s);
 
-  //! Will convert a fixed-size data block to a bytestring
-  std::string BitblockToBytes(const Block& bits);
+  //! Will convert a string to a vector of blocks
+  std::vector<Block> StringToBitblocks(const std::string& s);
 
-  //! Will convert a fixed-size data block to a string
+  //! Will convert a fixed-size data block to a bytestring
+  std::string BitblockToBytes(const Block& block);
+
+  //! Will convert an array of data blocks to a bytestring
+  std::string BitblocksToBytes(const std::vector<Block>& bits);
+
+  //! Will convert a fixed-size data blocks to a textstring
   //! The difference to BitblockToBytes() is, that it strips excess nullbytes
-  std::string BitblockToString(const Block& bits);
+  std::string BitblockToString(const Block& block);
+
+  //! Will convert an array of blocks to a character-string
+  //! The difference to BitblocksToBytes() is, that it strips excess nullbytes
+  std::string BitblocksToString(const std::vector<Block>& blocks);
 
   //! Will convert a flexible data block to a bytestring
   std::string BitsToBytes(const Flexblock& bits);
@@ -59,6 +70,12 @@ namespace Leonetienne::GCrypt {
 
   //! Will save bits to a binary file
   void WriteBitsToFile(const std::string& filepath, const Flexblock& bits);
+
+  //! Will read a file directly to data blocks
+  std::vector<Block> ReadFileToBlocks(const std::string& filepath);
+
+  //! Will write data blocks directly to a file
+  void WriteBlocksToFile(const std::string& filepath, const std::vector<Block>& blocks);
 }
 
 #endif

GCryptLib/include/GCrypt/Version.h

@@ -1,7 +1,7 @@
 #ifndef GCRYPT_VERSION_H
 #define GCRYPT_VERSION_H
 
-#define GCRYPT_VERSION 0.233
+#define GCRYPT_VERSION 0.234
 
 #endif