Add c/word-count

c/word-count/src/word_count.h

@@ -0,0 +1,41 @@
+#ifndef WORD_COUNT_H
+#include <stdbool.h>
+
+#define WORD_COUNT_H
+
+#define MAX_WORDS 20            // at most MAX_WORDS can be found in the test input string
+#define MAX_WORD_LENGTH 50      // no individual word can exceed this length
+
+// results structure
+typedef struct word_count_word {
+   char text[MAX_WORD_LENGTH + 1];      // allow for the string to be null-terminated
+   int count;
+} word_count_word_t;
+
+#define EXCESSIVE_LENGTH_WORD     -1
+#define EXCESSIVE_NUMBER_OF_WORDS -2
+
+// word_count - routine to classify the unique words and their frequency in a test input string
+// inputs:
+//    input_text =  a null-terminated string containing that is analyzed
+//
+// outputs:
+//    words = allocated structure to record the words found and their frequency
+//    uniqueWords - number of words in the words structure
+//           returns a negative number if an error.
+//           words will contain the results up to that point.
+int word_count(const char *input_text, word_count_word_t *words);
+
+bool increment_seen_words(char *word, int count, word_count_word_t *origin);
+
+void lowercase(char *s);
+
+bool is_quote_char(char s);
+
+bool is_quoted_word(char *token);
+
+void process_token(int *unique_words,
+                   char *token,
+                   word_count_word_t *words);
+
+#endif