X-Git-Url: http://git.ozlabs.org/?a=blobdiff_plain;f=ccan%2Fxstring%2F_info;fp=ccan%2Fxstring%2F_info;h=28928f16056d70ee935b8d20cd08cd05c75a11f7;hb=d26475dcfc3182030c664e6cdaff5aafbcaa159d;hp=0000000000000000000000000000000000000000;hpb=207e7b79640ddb2d1fce479135a3475a03a64bf2;p=ccan

diff --git a/ccan/xstring/_info b/ccan/xstring/_info
new file mode 100644
index 00000000..28928f16
--- /dev/null
+++ b/ccan/xstring/_info
@@ -0,0 +1,102 @@
+#include "config.h"
+#include <stdio.h>
+#include <string.h>
+
+/**
+ * xstring - bounded string builder with three valued comparator
+ *
+ * xstring handles string concatenation to a buffer, flagging truncation.
+ * Additions can be transactional, where the addition wholly succeeds or the buffer is reterminated at its prior length.
+ * Once flagged, no further additions are allowed.
+ * Clearing reuses the buffer from the beginning.
+ *
+ * When comparing two xstrings, the truncation state is taken into account.
+ * If either is truncated, an equality test returns unknown (-1).
+ * Testing if x contains y returns unknown (-1) if y is truncated.
+ * If x is whole, the test returns true (1) or false (0) appropriately.
+ * If x is truncated, the test returns true (1) if the known portion of x contains y, and unknown (-1) otherwise.
+ *
+ * The structure members are intended for direct access.
+ *
+ * Example:
+ *	// demo - break long lines
+ *	#include <string.h>
+ *	#include <stdio.h>
+ *	#include <unistd.h>
+ *	#include <err.h>
+ *	#include <fcntl.h>
+ *	#include <sys/types.h>
+ *	#include <sys/stat.h>
+ *	#include <sys/mman.h>
+ *
+ *	#include "ccan/xstring/xstring.h"
+ *
+ *	#define MAXLEN 80
+ *	#define MARGIN 10
+ *	int main(int argc, char *argv[])
+ *	{
+ *		char buf[BUFSIZ];
+ *		xstring _x, *x = &_x;
+ *		struct stat sb;
+ *		int fd, span, lnlen;
+ *		char *map, *p, *q;
+ *
+ *		xstrInit(x, buf, sizeof(buf), 0);
+ *		assert(sizeof(buf) > MAXLEN);
+ *
+ *		if (argc != 2) return 1;
+ *
+ *		if ((fd = open(argv[1], O_RDONLY)) == -1)
+ *			err(1, "open");
+ *		if (fstat(fd, &sb) == -1)
+ *			err(1, "stat");
+ *		if ((map = mmap(NULL, sb.st_size + 1, PROT_READ|PROT_WRITE, MAP_PRIVATE, fd, 0)) == MAP_FAILED)
+ *			err(1, "mmap");
+ *		map[sb.st_size] = '\n';
+ *
+ *		for (p = map, lnlen = 0; p < map + sb.st_size; ) {
+ *			span = strcspn(p, " \t\n") + 1;
+ *
+ *			if (lnlen + span > MAXLEN) {
+ *				span = MAXLEN - lnlen;
+ *				xstrAddSubsT(x, p, span, "\n", 1, NULL);
+ *			}
+ *			else
+ *				xstrAddSubT(x, p, span);
+ *
+ *			if (x->truncated) {
+ *				fputs(x->str, stdout);
+ *				xstrClear(x);
+ *				continue; // p unchanged
+ *			}
+ *
+ *			q = x->str + x->len - 1;
+ *			if (lnlen + MARGIN > MAXLEN)
+ *				*q = '\n';
+ *
+ *			lnlen = *q == '\n' ? 0 : lnlen + span;
+ *			p += span;
+ *		}
+ *
+ *		if (x->len)
+ *			fputs(x->str, stdout);
+ *
+ *		return 0;
+ *	}
+ *
+ * License: APACHE-2
+ * Author: Dan Good <dan@dancancode.com>
+ */
+int main(int argc, char *argv[])
+{
+	/* Expect exactly one argument */
+	if (argc != 2)
+		return 1;
+
+	if (strcmp(argv[1], "depends") == 0) {
+		printf("ccan/failtest\n");
+		return 0;
+	}
+
+	return 1;
+}