/*
* Copyright 1995, 1996 Perforce Software. All rights reserved.
*
* This file is part of Perforce - the FAST SCM System.
*/
/*
* spec.cc -- parsing and formatting of Specs according to their definitions
*/
# include <stdhdrs.h>
# include <strbuf.h>
# include <strops.h>
# include <strdict.h>
# include <vararray.h>
# include <intarray.h>
# include <error.h>
# include <errorlog.h>
# include "specchar.h"
# include <msgdb.h>
# include "specparse.h"
# include "spec.h"
/*
* Spec
*/
Spec::Spec()
{
elems = new VarArray;
comment = StrRef::Null();
}
Spec::Spec( const char *string, const char *cmt, Error *e )
{
elems = new VarArray;
comment.Set( (char *)cmt );
// We used to abort on an error here, but that also caused
// the server to exit on windows. Now we just pass up the error.
StrRef p;
p.Set( (char *)string );
Decode( &p, e );
}
Spec::~Spec()
{
for( int i = 0; i < elems->Count(); i++ )
delete (SpecElem *)elems->Get(i);
delete elems;
}
int
Spec::Count()
{
return elems->Count();
}
SpecElem *
Spec::Get( int i )
{
return (SpecElem *)elems->Get( i );
}
SpecElem *
Spec::Find( int code, Error *e )
{
for( int i = 0; i < elems->Count(); i++ )
{
SpecElem *de = (SpecElem *)elems->Get(i);
if( de->code == code )
return de;
}
if( e )
e->Set( MsgDb::FieldBadIndex );
return 0;
}
SpecElem *
Spec::Find( const StrPtr &tag, Error *e )
{
for( int i = 0; i < elems->Count(); i++ )
{
SpecElem *de = (SpecElem *)elems->Get(i);
if( !de->tag.CCompare( tag ) )
return de;
}
if( e )
e->Set( MsgDb::FieldUnknown ) << tag;
return 0;
}
/*
* Spec::Encode() -- encode a spec definition in a transmittable string
*/
void
Spec::Encode( StrBuf *string )
{
string->Clear();
for( int i = 0; i < elems->Count(); i++ )
((SpecElem *)elems->Get(i))->Encode( string, i );
}
/*
* Spec::Decode() -- decode a spec definition from a string
*/
void
Spec::Decode( StrPtr *string, Error *e )
{
// Since Decode() mangles the buffer, we have our own copy.
// This just appends to the definition list!
StrRef r;
decoderBuffer.Set( string );
r.Set( &decoderBuffer );
while( !e->Test() && *r.Text() )
Add( StrRef( "tag" ) )->Decode( &r, e );
}
/*
* Spec::Add() - create a single new specElem
*/
SpecElem *
Spec::Add( const StrPtr &tag )
{
SpecElem *de = new SpecElem;
de->index = elems->Count();
de->tag.Set( &tag );
de->code = de->index;
de->type = SDT_WORD;
de->opt = SDO_OPTIONAL;
de->nWords = 1;
de->maxLength = 0;
de->fmt = SDF_NORMAL;
de->seq = 0;
de->open = SDO_NOTOPEN;
de->maxWords = 0; // used for Streams
elems->Put( de );
return de;
}
/*
* Spec::Parse() -- parse a spec string into SpecData
*/
void
Spec::Parse( const char *buf, SpecData *data, Error *e, int validate )
{
StrBuf tag;
StrBuf value;
SpecParseReturn r;
// For the uniq & required check
IntArray counts( elems->Count() );
// Fire up the tokenizer
SpecParse parser( buf );
for( ;; )
{
// main loop: parse TAG & values
r = parser.GetToken( 0, &tag, e );
// toss comment outside of a tag
if( r == SR_COMMENT || r == SR_COMMENT_NL )
continue;
if( r != SR_TAG )
break;
SpecElem *de;
// Look up tag in Spec Definition.
if( !( de = Find( tag, e ) ) )
break;
// Read each value: either a block of text or individual line.
while( !e->Test() )
{
// Create a space for the text.
r = parser.GetToken( de->IsText(), &value, e );
if( r == SR_COMMENT )
{
data->SetComment( de, counts[ de->index ]++, &value, 0, e );
continue;
}
if( r == SR_COMMENT_NL )
{
data->SetComment( de, counts[ de->index ]++, &value, 1, e );
continue;
}
if( r != SR_VALUE )
break;
// Prevent duplicate tags...
if( counts[ de->index ] && !de->IsList() )
{
e->Set( MsgDb::Field2Many ) << de->tag;
break;
}
// Check against limited values
if( validate && !de->CheckValue( value ) )
{
e->Set( MsgDb::FieldBadVal ) << de->tag << de->values;
break;
}
// Call SpecData to actually dispose of the data
// XXX No word count check!
data->SetLine( de, counts[ de->index ]++, &value, e );
// Only one text block per tag
if( de->IsText() )
break;
}
if( e->Test() || r == SR_EOS )
break;
}
if( e->Test() )
parser.ErrorLine( e );
// Check that required fields are present
if( !e->Test() && validate )
{
int i;
SpecElem *de;
for( i = 0; de = (SpecElem *)elems->Get(i); i++ )
if( de->IsRequired() && !counts[ de->index ] )
{
e->Set( MsgDb::FieldMissing ) << de->tag;
break;
}
}
}
/*
* Spec::Format() -- turn SpecData into a spec string
*/
void
Spec::Format( SpecData *data, StrBuf *s )
{
s->Clear();
// Comment at the front
*s << comment;
for( int i = 0; i < elems->Count(); i++ )
{
SpecElem *d = (SpecElem *)elems->Get(i);
const char *c = 0;
StrPtr *v;
// if no data for this line, don't display it
// Special case for DEFAULT: we'll display a blank entry
// for the user (we don't put in the default value, tho).
if( !( v = data->GetLine( d, 0, &c ) ) && d->opt != SDO_DEFAULT )
continue;
// Blanks between sections
if( s->Length() )
*s << "\n";
// Output format depends on type
int j = 0;
switch( d->type )
{
case SDT_WORD: // single line, N words
case SDT_SELECT: // SDT_WORD from a list of words
case SDT_LINE: // single line of text (arbitrary words)
case SDT_DATE: // SDT_LINE that is a date
// Tag: value
*s << d->tag << ":";
if( v ) *s << "\t" << v;
if( c ) *s << "\t# " << c;
*s << "\n";
break;
case SDT_WLIST: // multiple lines, N words
case SDT_LLIST: // multiple lines of text (arbitrary words)
// Tag:\n\tvalue1\n\tvalue2...
*s << d->tag << ":\n";
while( v )
{
// 2016.2 Handle comments:
// Comments can be
// (1) Single line ( v->Length() == 0 )
// (2) Appended ( v->Length() > 0 && fmt:C )
while( v && !c && !v->Length() )
v = data->GetLine( d, ++j, &c );
if( !v )
break;
*s << "\t" << v;
if( c && v->Length() && ( d->fmt == SDF_COMMENT ) )
*s << "\t##" << c;
else if( c && v->Length() )
*s << "\t# " << c;
else if( c )
*s << "##" << c;
*s << "\n";
v = data->GetLine( d, ++j, &c );
}
break;
case SDT_TEXT: // block of text,
case SDT_BULK: // SDT_TEXT not indexed
// Tag:\n\tblock
*s << d->tag << ":\n";
if( v ) StrOps::Indent( *s, *v );
break;
}
}
}
void
Spec::Format( SpecData *data, StrDict *dict )
{
// just dump each element into a dictionary
// tag name is var name
// may be multiple vars with same tag
for( int i = 0; i < elems->Count(); i++ )
{
SpecElem *d = (SpecElem *)elems->Get(i);
const char *c = 0;
StrPtr *v;
int j;
// if no data for this line, don't display it
if( d->IsList() )
{
for( j = 0; v = data->GetLine( d, j, &c ); j++ )
dict->SetVar( d->tag, j, *v );
}
else
{
if( v = data->GetLine( d, 0, &c ) )
dict->SetVar( d->tag, *v );
}
}
}