fsscanf.c File Reference

Read from a string using FORTRAN-like rigid formatting. More...

#include <stdio.h>
#include <string.h>
#include <stdarg.h>
#include <stdlib.h>
#include <ctype.h>
#include "SysDefs.h"
#include "macros.h"
#include "general.h"

Go to the source code of this file.

Functions
int	fsscanf (char *buffer, char *format,...)

Detailed Description

Read from a string using FORTRAN-like rigid formatting.

Version

V1.4

Date

07.07.14

Copyright

(c) UCL / Dr. Andrew C. R. Martin 1993-2014

Author

Dr. Andrew C. R. Martin

Institute of Structural & Molecular Biology, University College London, Gower Street, London. WC1E 6BT.

andre.nosp@m.w@bi.nosp@m.oinf..nosp@m.org..nosp@m.uk andre.nosp@m.w.ma.nosp@m.rtin@.nosp@m.ucl..nosp@m.ac.uk

This code is NOT IN THE PUBLIC DOMAIN, but it may be copied according to the conditions laid out in the accompanying file COPYING.DOC.

The code may be modified as required, but any modifications must be documented so that the person responsible can be identified.

The code may not be sold commercially or included as part of a commercial product except as described in the file COPYING.DOC.

Description:

Hard formatted version of sscanf(). Implements FORTRAN-like file reading.

The only parsing characters recognised are:

  %<n>f    A single precision floating point number of width <n>
  %<n>lf   A double precision floating point number of width <n>
  %<n>d    An integer of width <n>
  %<n>ld   A long integer of width <n>
  %<n>u    An unsigned of width <n>
  %<n>lu   An unsigned long of width <n>
  %<n>s    A string of width <n>
  %c       A character (of width 1)
  %<n>x    <n> spaces (like FORTRAN).

With the exception of the c parser, the column width, <n>, must* be specified.

Blank fields read as numbers are given a value of zero.

Returns: The number of arguments filled in (EOF if blank string or no specifiers found in format string).

Usage:

For example:

double   DoubVar;
int      IntVar;
char     CharVar,
         StringVar[16];

fsscanf(buffer,"%8lf%5x%3d%c%3x%8s",
        &DoubVar,&IntVar,&CharVar,StringVar);

Revision History:

• V1.0 17.06.93 Original By: ACRM
• V1.1 12.07.93 Added u and lu. Corrected s and c to blank rather than NULL strings if buffer runs out. Pads string if buffer ran out in the middle. Takes
  in buffer as end of string.
• V1.2 24.11.95 `value' was a fixed 40 character buffer. Now changed to allocate a suitable number of characters as required.
• V1.3 13.01.97 Now does the EOF return at the end of the routine rather than at the beginning so that all the variable get set to blank or zero first.
• V1.4 07.07.14 Use bl prefix for functions By: CTP

Definition in file fsscanf.c.

Function Documentation

int fsscanf	(	char *	buffer,
		char *	format,
			...
	)

Parameters

[in]	*buffer	Buffer from which to read information
[in]	*format	Format string (like scanf() et al., but see restrictions below)
[out]	...	Scanned output variables

Returns

Number of values read (EOF if end of file or no specifiers found in format string)

Hard formatted version of sscanf(). Implements FORTRAN-like rigid column reading out of a string.

The only parsing characters recognised are:

  %<n>f    A single precision floating point number of width <n>
  %<n>lf   A double precision floating point number of width <n>
  %<n>d    An integer of width <n>
  %<n>ld   A long integer of width <n>
  %<n>u    An unsigned of width <n>
  %<n>lu   An unsigned long of width <n>
  %<n>s    A string of width <n>
  %c       A character (of width 1)
  %<n>x    <n> spaces (like FORTRAN).

With the exception of the c parser, the column width, <n>, must* be specified.

Blank fields read as numbers are given a value of zero.

• 17.06.93 Original By: ACRM
• 12.07.93 Added u and lu. Corrected s and c to blank rather than NULL strings if buffer runs out. Pads string if buffer ran out in the middle. Takes
  in buffer as end of string.
• 24.11.95 `value' was a fixed 40 character buffer. Now changed to allocate a suitable number of characters as required.
• 13.01.97 Previously if reading from a blank line the output variables were unmodified since an EOF return was done immediately. Now the immediate EOF return only happens if the input buffer is a NULL variable and the EOF on blank string is moved to the end such that all output variables are set to zero or blank before the EOF return.
• 07.07.14 Use bl prefix for functions By: CTP

Definition at line 177 of file fsscanf.c.