typedef struct {

        /*  Required  */
        char *pathname;

        //  For a simple text string
        char *textString;
        int numberTextChars;

        char *textTable;
        //  The total number of characters, including nulls
        int numberTableChars;

        //  If a  table, then the number of rows and columns
        //  If a list, then numberColumns = 1, numberRows = number items
        //  If a test string, then both are 1 or 0.
        int numberRows;
        int numberColumns;



        /* Optional */
        //  If a text table, then numberColumns labels, each label null terminated
        char *labels;
        //  The total number of characters in *labels
        int numberLabelChars;

        /*  User header, used for further description of data/gage */
        /*  Not often used */
        int *userHeader;
        int userHeaderNumber;

        //  Informational only (on return only)
        int dataType;
        long long lastWrittenTime;  //  Seconds since 1970
        long long fileLastWrittenTime;
        char programName[17];

} zStructText;

Example: Text
#include <stdio.h>
#include <string.h>
#include "heclib.h"

//   Storage and retrieval of a single line of text

int ExampleText1()
{
         long long ifltab[250];
         zStructText *textStruct1;
         zStructText *textStruct2;
         zStructText *textStruct3;
         zStructText *textStruct4;
         int status;

         //  Open the DSS file; Create if it doesn't exist
         status = zopen(ifltab, "C:/temp/Example7.dss");
         //  If an error occured, messages will be printed to standard out
         if (status != STATUS_OKAY) return status;

         //  Write a single string to DSS
         textStruct1 = zstructTextStringNew("/Group/Location/Message 1/d/e/f/",
                 "This is text message 1 that is written to HEC-DSS");
         status = ztextStore(ifltab, textStruct1);
         zstructFree(textStruct1);
         if (status != STATUS_OKAY) return status;       

         //  Write a string to DSS, setting the string in the struct
         textStruct2 = zstructTextNew("/Group/Location/Message 2/d/e/f/");
         textStruct2->textString = mallocAndCopy("This is text message 2 that is written to HEC-DSS");
         textStruct2->numberTextChars = (int)strlen(textStruct2→textString);
         status = ztextStore(ifltab, textStruct2);
         free(textStruct2→textString);
         zstructFree(textStruct2);
         if (status != STATUS_OKAY) return status;

         //  Read the data back in and print
         textStruct3 = zstructTextNew("/Group/Location/Message 1/d/e/f/");
         status = ztextRetrieve(ifltab, textStruct3);
         if (status != STATUS_OKAY) return status;
         //  Print out to standard out
         printf("Text for pathname %s\n", textStruct3→pathname);
         ztextStructPrint(textStruct3);
         zstructFree(textStruct3);

         textStruct4 = zstructTextNew("/Group/Location/Message 2/d/e/f/");
         status = ztextRetrieve(ifltab, textStruct4);
         if (status != STATUS_OKAY) return status;
         printf("\nText for pathname %s\n", textStruct4→pathname);
         ztextStructPrint(textStruct4);
         zstructFree(textStruct4);

         zclose(ifltab);
         return 0;
}

#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include "heclib.h"

//  Storage and retrieval of a text table.  This table has 20 rows with 5 columns
int ExampleText2()
{
         long long ifltab[250];
         zStructText *textStruct1;
         zStructText *textStruct2;
         char string[] = { "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRTSUVWXYZ" };
         char textTable[5000];
         char labels[200];
         int status, row, col, k, n, ipos;

         //  Open the DSS file; Create if it doesn't exist
         status = zopen(ifltab, "C:/temp/Example7.dss");
         if (status != STATUS_OKAY) return status;

         //  Gen up data
         textStruct1 = zstructTextNew("/Group/Location/Text Table/d/e/f/");
         ipos = 0;
         for (row = 0; row < 20; row++) {
                 for (col = 0; col < 5; col++) {
                          n = row / 25;
                          n = row - (n * 25) + 1;
                          for (k = (col + 2); k < (n + 8); k++) {
                                  textTable[ipos++] = string[k];
                          }
                          textTable[ipos++] = '\0';
                 }
         }
         textStruct1->textTable = textTable;
         textStruct1->numberTableChars = ipos;
         textStruct1->numberColumns = 5;
         textStruct1->numberRows = 20;

         //  Gen column headers
         ipos = 0;
         for (int col = 0; col < 5; col++) {
                 stringCopy(&labels[ipos], sizeof(labels), "Col ", _TRUNCATE);
                 ipos += 4;
                 itoa(col + 1, &labels[ipos], 10);
                 ipos += 2;
         }
         textStruct1->labels = labels;
         textStruct1->numberLabelChars = ipos;
         ztextStructPrint(textStruct1);
         //  Store text struct
         status = ztextStore(ifltab, textStruct1);
         zstructFree(textStruct1);
         if (status != STATUS_OKAY) return status;

         //  Read the data back in and print
         textStruct2 = zstructTextNew("/Group/Location/Text Table/d/e/f/");
         status = ztextRetrieve(ifltab, textStruct2);
         if (status != STATUS_OKAY) return status;

         //  Print out to standard out
         ztextStructPrint(textStruct2);
         zstructFree(textStruct2);

         zclose(ifltab);
         return 0;
}