StrOps::Expand( StrBuf &, StrPtr &, StrDict & )

Expand “`%var%” strings into corresponding “`val” strings from a StrDict.

Virtual?

No

  

Class

StrOps

 

Arguments

StrBuf &o

the output string
 

StrPtr &s

the input string
 

StrDict &d

the var/value pairs to look up

Returns

void

 

Notes

This function provides a way to quickly expand variables from a StrDict into a StrBuf.

Example

This small program demonstrates the Expand() method in an OutputStat() implementation:

Copy 
void MyClientUser::OutputStat( StrDict *varList )
{
    StrBuf s = StrBuf();
    s.Set( "File: %depotFile%  Rev: %rev%" );
    StrBuf o = StrBuf();
    StrOps::Expand( o, s, *varList );
    StrOps::Dump( o );
}

int main( int argc, char **argv )
{
    ClientApi client;
    MyClientUser ui;
    Error e;

    client.SetProtocol( "tag", "" );
    client.Init( &e );
    client.SetArgv( 1, ++argv );
    client.Run( "files", &ui );
    return client.Final( &e );
}

Executing the preceding code produces the following output:

% a.out *
File: //depot/src/file1.c  Rev: 4
File: //depot/src/file2.c  Rev: 2