DStringSet Class

Simple string set class for use in the dtSearch C++ Support classes and sample code.

class DStringSet;

File

dstring.h

Remarks

Usually the text in a DStringSet is stored as UTF-8, although any single-byte character set can be used.

In the dtSearch Engine's C++ API, several API elements expect a set of strings, such as the folders to index in dtsIndexJob or the indexes to search in dtsSearchJob, formatted as a null-delimited string set Each string is separated by a single null character, with a double-null at the end, like this:

     "First string\0 Second string\0 Third string \0\0"

DStringSet provides a class to construct this type of string set. To create a null-delimited string set from a set of strings, declare a DStringSet, call append() with each string, and then call getBuffer() to get the start of the buffer. Example:

     DStringSet excludeFilters;
     excludeFilters.append("*.exe");
     excludeFilters.append("*.dll");
     excludeFilters.append("*.fon");
     dtsIndexJob indexJob;
     indexJob.toAdd.excludeFilters = excludeFilters.getBuffer();

Group

Classes

Methods

Method	Description
append	This is the overview for the append method overload.
appendField	Append a field-value pair (appends the field name, then appends the value)
appendUnique	Append a string to this set only if it is not already present
appendW	Append a Unicode string to the set (converting to UTF8)
clear	Clear all strings from the set
copy	This is the overview for the copy method overload.
copyFromBuf	Copy a set from a buffer containing a null-delimited string set, terminated by a double null
deleteString	Remove a string from the set
DStringSet	This is the overview for the DStringSet constructor overload.
find	Find a string in the set
findFieldName	Search for a field name.
findPrefix	Find a string starting with a prefix
formatAsSimpleString	Format the set as a delimited, quoted string, minimizing the use of quotation marks
formatAsString	Format the set as a delimited, quoted string (assumes values contain no quotes)
formatAsTable	Format the set as field: value pairs
getBuffer	Returns the start of the buffer containing the strings in this set
getCount	Return the number of strings in the set
getField	Retrieve a field value by name.
getLastString	Return last string from the set
getLength	Return the size of the data in the buffer
getLinesFrom	Read lines of text from a file into a string set
getLinesFromU8	Read lines of text from a file into a string set (UTF-8 filename)
getString	Return one string from the set
iappendUnique	Append a string to this set only if it is not already present, using a case-insensitive search
ifind	Find a string in the set (case-insensitive)
ifindPrefix	Find a string starting with a prefix (case-insensitive)
iunion	Append all strings in another set that are not already present, using a case-insensitive search
parseLinesFrom	Parse lines of text from a text buffer into a string set
prepend	Insert a string as the first string in this set
rFindPrefix	Find a string starting with a prefix, searching in reverse order
sort	Sort strings in the set in alphabetical order
tokenize	This is the overview for the tokenize method overload.
tokenizeq	Create a string set from a delimited string, allowing for quotation
unionExact	Append all strings in another set that are not already present

Operators

Operator	Description
=	Copy a set
==	Compare two sets for equality.

Legend

	Operator
	Method

Links

Classes, Legend, Members, Methods, Operators, append Method, copy Method, DStringSet Constructor, tokenize Method