query.c File Reference

Detailed Description

Provides functions to prompt the user for various types of numerical input.

This file contains functions that display prompts to the terminal for different numerical types, show default values, and return the user-entered value or the default if no input is provided.

Copyright

• (c) 2002 The University of Chicago, as Operator of Argonne National Laboratory.
• (c) 2002 The Regents of the University of California, as Operator of Los Alamos National Laboratory.

License

This file is distributed under the terms of the Software License Agreement found in the file LICENSE included with this distribution.

Author

M. Borland, C. Saunders, R. Soliday

Definition in file query.c.

#include "mdb.h"

Go to the source code of this file.

Functions
double	query_double (char *prompt, double def)
	Prompts the user for a double precision number.
float	query_float (char *prompt, float def)
	Prompts the user for a float precision number.
long	query_long (char *prompt, long def)
	Prompts the user for a long integer.
int	query_int (char *prompt, int def)
	Prompts the user for an integer.
short	query_short (char *prompt, short def)
	Prompts the user for a short integer.

Function Documentation

query_double()

double query_double	(	char *	prompt,
		double	def )

Prompts the user for a double precision number.

Displays a prompt with a default value. If the user does not enter a number, the default value is returned.

Parameters

prompt	The message to display to the user.
def	The default double value to return if no input is provided.

Returns

The double value entered by the user or the default value.

Definition at line 32 of file query.c.

                                              {
  char s[100];
  double val;
 
  printf("%s [%g]: ", prompt, def);
  if (!fgets(s, sizeof(s), stdin))
    return def;
  val = def;
  if (*s)
    sscanf(s, "%lf", &val);
  return (val);
}

query_float()

float query_float	(	char *	prompt,
		float	def )

Prompts the user for a float precision number.

Displays a prompt with a default value. If the user does not enter a number, the default value is returned.

Parameters

prompt	The message to display to the user.
def	The default float value to return if no input is provided.

Returns

The float value entered by the user or the default value.

Definition at line 55 of file query.c.

                                           {
  char s[100];
  float val;
 
  printf("%s [%g]: ", prompt, def);
  if (!fgets(s, sizeof(s), stdin))
    return def;
  val = def;
  if (*s)
    sscanf(s, "%f", &val);
  return (val);
}

query_int()

int query_int	(	char *	prompt,
		int	def )

Prompts the user for an integer.

Displays a prompt with a default value. If the user does not enter a number, the default value is returned.

Parameters

prompt	The message to display to the user.
def	The default integer value to return if no input is provided.

Returns

The integer entered by the user or the default value.

Definition at line 101 of file query.c.

                                     {
  char s[100];
  int val;
 
  printf("%s [%d]: ", prompt, def);
  if (!fgets(s, sizeof(s), stdin))
    return def;
  val = def;
  if (*s)
    sscanf(s, "%d", &val);
  return (val);
}

query_long()

long query_long	(	char *	prompt,
		long	def )

Prompts the user for a long integer.

Displays a prompt with a default value. If the user does not enter a number, the default value is returned.

Parameters

prompt	The message to display to the user.
def	The default long integer value to return if no input is provided.

Returns

The long integer entered by the user or the default value.

Definition at line 78 of file query.c.

                                        {
  char s[100];
  long val;
 
  printf("%s [%ld]: ", prompt, def);
  if (!fgets(s, sizeof(s), stdin))
    return def;
  val = def;
  if (*s)
    sscanf(s, "%ld", &val);
  return (val);
}

query_short()

short query_short	(	char *	prompt,
		short	def )

Prompts the user for a short integer.

Displays a prompt with a default value. If the user does not enter a number, the default value is returned.

Parameters

prompt	The message to display to the user.
def	The default short integer value to return if no input is provided.

Returns

The short integer entered by the user or the default value.

Definition at line 124 of file query.c.

                                           {
  char s[100];
  short val;
 
  printf("%s [%d]: ", prompt, def);
  if (!fgets(s, sizeof(s), stdin))
    return def;
  val = def;
  if (*s)
    sscanf(s, "%hd", &val);
  return (val);
}