NAME

relformat -
Text formatting for relations

SYNOPSIS

package require ral 0.7
::ral::relformat relationValue  ? title ? 

DESCRIPTION

This manpage describes the relformat command. The relformat command is part of the Tcl Relational Algebra Library (ral) package.

COMMANDS

::ral::relformat relationValue ? title ?

The relformat command returns a string that contains a human readable form of the relation given by relationValue. Relformat is intended to be to relations what the parray command is to arrays, i.e. a easy means of obtaining human readable output. Rather than writing the output directly to a channel, relformat returns it as a string. The returned string does not have a newline character. If the optional title argument is present, then it becomes the first line of the output effectively giving a title to the relation.

% puts [relformat [relvar set DOG] DOG]
DOG
---
DogName      Breed
 string     string
==================
   Fido     Poodle
    Sam     Collie
   Spot    Terrier
  Rover  Retriever
   Fred    Spaniel
 Jumper       Mutt

SEE ALSO

relvar, relation

KEYWORDS

tuple, relation, relvar