.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH GBCONVTABLE "1" "August 2017" "gbconvtable ver. 5.6" "User Commands"
.SH NAME
gbconvtable \- Replace keys with values
.SH SYNOPSIS
.B gbconvtable
[\fI\,options\/\fR]
.SH DESCRIPTION
Replace keys with values at a given position of the input file.  The
name of the dictionary file is provided on the command line with the
option 'dictfile'. It is a simple text file organized in two
columns. The first column contains the keys and the second column the
respective values. Obviously the values can be equal, but the keys
should be all different. Data are read from standard input and all
fields at position 'pos' are considered keys of the provided
dictionary and replaced with the associated keys. If 'pos' is not
specified it is assumed equal to 1. If 'pos' is larger than the number
of fields, no replacement takes place. If the option 'force' is not
set, only those fields which appears as keys in the dictionary file
are replaced.
.SH OPTIONS
.HP
\fB\-d\fR name of the dictionary file
.HP
\fB\-c\fR position of the column of keys to be replaced
.HP
\fB\-f\fR forced look\-up: substitute provided string for non defined keys
.SH EXAMPLES
.IP
gbconvtable \-d dict_file \-c 3 \-f 'none' < input_file
.PP
This program requires awk or gawk.
.SH AUTHOR
Written by Giulio Bottazzi
.SH "REPORTING BUGS"
Report bugs to <gbutils@googlegroups.com>
.PP
.br
Package home page <http://cafim.sssup.it/~giulio/software/gbutils/index.html>
.SH COPYRIGHT
Copyright \(co 2010\-2015 Giulio Bottazzi
.PP
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
(version 2) as published by the Free Software Foundation.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.