DSS::TEXT ( 5P ) PLUGINSDSS::TEXT ( 5P )


PLUGIN

text - text method

SYNOPSIS

dss [ options ] --method=text[,option...]

DESCRIPTION

The dss text method describes newline-terminated field-delimited text file data. The method schema is a scanf(3) style format string with embedded field names of the form %(field )format-char delimiter ...

Use the dss flat method for generic record-oriented flat file data.

EXAMPLES

dss -x text::"%(name)s:%(passwd:Encrypted\ password.)s:%(uid)d:%(gid)d:%(comment)s:%(home)s:%(shell)s"\ 'passwd==""&&uid==0'\

/etc/passwd

Prints /etc/passwd entries with uid==0 and no password.

text

Newline-terminated field-delimited text file; the method schema is a scanf(3) like format string with embedded field names of the form: %(field1)format-char delimiter ...

----- data types -----

buffer

A separately allocated sized buffer. The external representation is a newline separated base64 mime encoding.

number

An integral or floating point number.

pointer

A generic pointer.

reference

A referenced type.

string

A string. The format details string specifies quoting and C style character escape processing: quote[=char] quotes string with char (") as the begin and end quote; endquote=char changes the quote end to char ; shell[=beg] quotes using shell conventions and beg ($') as the quote begin; opt performs quote and shell quoting only when necessary; escape assumes that escape processing has already been performed; wide does not escape characters with the bit 8 set; expand=mask expands escaped characters according to mask which may be a , or | separated list of all: expand all escaped chars, char expands 7 bit character escapes, line expands \r and \n escapes, wide expands wide character escapes, nocr eliminates \r, and nonl eliminates \n. Matches on this type treat the pattern as a regex(3) pattern string.

type_t

A type.

void

No value. May be used for padding.

----- functions -----

string edit(string,string)

Returns the result of applying the ed(1) style substitute expression in the first argument to the second argument.

number sizeof(*)

Returns the size of the variable argument; the size of an array variable is the number of elements, otherwise the size is in bytes.

type_t typeof(*)

Returns the type of the variable argument for comparison with other types.

IMPLEMENTATION

version

dss text method (AT&T Research) 2002-12-17
author

Glenn Fowler <gsf@research.att.com>
copyright

Copyright © 2002-2012 AT&T Intellectual Property
license

http://www.eclipse.org/org/documents/epl-v10.html