RouteX Document Router Toolkit
Main	Functions	Types & Errors	Query Language	Demo	Home

rxStartField

Tells RouteX that all words sent to it are part of a field. You specify the name of the field. All calls to rxProcessWord will make that word part of a field until you call rxEndField. You can have fields within fields. A word can thus be a member of multiple fields.

See the query language page for more information on fields.

Synopsis

void rxStartField( RouteX Router, char *FieldName, int Length, StatusCodeT *Status )

Arguments

Router	The RouteX object you are deleting
FieldName	The name of the field you are starting.
Length	The length in bytes of the field name.
Status	A pointer to a value of type StatusCodeT. If an error occurs during the execution of the function a value representing the error will be stored in *Status. You should check *Status after every function call.

Returns

Nothing.

Related Functions

rxStartDocument, rxEndDocument, rxEndField

Example

void HandleAddress( char *address, FILE *doc )

{  

   char   word[50];



   rxStartField( Router, "EMAIL", strlen( "EMAIL"), Status );



   if ( *Status < 0 )

      return;  



   // getword is some function that scans a file for the next word



   while( getword( doc, word ) != EOF ) {



      rxProcessWord( Router, word, strlen( word ), Status );



      if ( *Status < 0 )

         return;



   }

   

   rxEndField( Router, "EMAIL", strlen( "EMAIL"), Status );



}