.ig >> TDHkit: fldmap(1)


Tabular data handling toolkit  


.>> .TH fldmap(1) TDH "19-SEP-2003 TDH scg@jax.org" .SH NAME fldmap(1) \- map fields by name from one file to another .ig >>


.>> .SH SYNOPSIS \fCfldmap [-H] \fIsourcefile destfile\fC .ig >>


.>> .SH DESCRIPTION \fIsourcefile\fR and \fIdestfile\fR are two tabular ascii files with field name headers. This utility will write the contents of \fIsourcefile\fR, reformatted to the field format of \fIdestfile\fR, to stdout. This remapping is based on field names. Both files must have a .ig >> .>> \0field name header. .ig >> .>> .LP A warning will be issued for any field found in sourcefile that is not in destfile, and such fields will not be present in the result. Destfile fields not present in sourcefile will be filled in as nulls (the \fC=\fR character by default but can be set to another symbol in .ig >> .>> \0your config file .ig >> .>> ). .ig >>


.>> .SH OPTION \fB-H\fR .IP \0 Include \fIdestfile\fR's field name header in the output. .ig >>


.>> .SH EXAMPLE Suppose \fBfile1\fR looks like this: .nf id balance 001 4504 002 9403 .fi and \fBfile2\fR looks like this: .nf id lastname firstname balance 101 Smith George 58300 103 Jones Jeff 4792 .fi If we issue the command: \fCfldmap file1 file2\fR we will get the following on standard output: .nf 001 = = 4504 002 = = 9403 .fi If we had used -H we would have gotten: .nf id lastname firstname balance 001 = = 4504 002 = = 9403 .fi .ig >>


.>> .ig >>


Tabular data handling toolkit 
Copyright Steve Grubb
.>>