Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FBB::A2x(3bobcat)		 Error handler		     FBB::A2x(3bobcat)

NAME
       FBB::A2x	- Objects performing ascii-to-x	(anything) conversions

SYNOPSIS
       #include	<bobcat/a2x>
       Linking option: -lbobcat

DESCRIPTION
       FBB::A2x	 objects offer the C++ equivalent of the standard C conversion
       functions atoi(3), atol(3), atof(3) etc.	 A2x objects generalize	 these
       C  functions  to	any type that can be extracted from an istream object.
       Since FBB::A2x represents the object-variant of the C functions,	and is
       therefore type-safe and extensible, their use is	greatly	preferred over
       using the standard C functions.

NAMESPACE
       FBB
       All constructors, members, and operators, mentioned in  this  man-page,
       are defined in the namespace FBB.

INHERITS FROM
       std::istringstream

CONSTRUCTORS
       o      A2x():
	      This  constructor	constructs an empty A2x	object.	No information
	      can be converted from a  thus constructed	A2x object.

       o      A2x(char const *text):
	      This constructor stores text. If text represents a textual value
	      of some type, the	A2x object may be used to initialize or	assign
	      this value to a variable of that	particular  type.  Extraction,
	      however is also still possible.

       o      A2x(std::string const &str):
	      This  constructor	stores the text	contained in str. If this text
	      represents a textual value of some type, the A2x object  may  be
	      used  to	initialize  or assign this value to a variable of that
	      particular type. Extraction is also still	 possible.   The  copy
	      constructor is available.

STATIC MEMBER FUNCTION
       o      bool lastFail():
	      This  member  returns  true if the last conversion failed	(i.e.,
	      the object's fail() member returned true and returns false  oth-
	      erwise).	 This  member  allows checks on	the success of the ex-
	      traction/conversion using	anonymous A2x objects. The member also
	      returns true when	no conversions have as yet been	performed.
	      Note  that  this	member	is a thread-unsafe static member: in a
	      multithreaded program locks may be required to ensure  that  the
	      proper conversion	result is inspected.

MEMBER FUNCTION
       All members of the istringstream	class are available.

       o      Type to():
	      This  member  returns  any type Type supporting extractions from
	      i[string]streams.	If the	extraction  fails,  the	 A2x  object's
	      good() member will return	false, and the Type's default value is
	      returned.	This operator was implemented  as  a  template	member
	      function.	 There	is  also  a type conversion operator available
	      (see below), but the member function variant  may	 be  preferred
	      over the conversion operator in situations where explicit	disam-
	      biguation	is required (e.g., in cases where a conversion has  no
	      obvious  type  solution such as direct insertions) An example is
	      provided in the EXAMPLE section below.

OVERLOADED OPERATORS
       o      operator Type():
	      Conversion  to  any  type	 Type  supporting   extractions	  from
	      i[string]streams.	 If  the  extraction  fails,  the A2x object's
	      good() member will return	false, and the Type's default value is
	      returned.	 This  operator	 was  implemented as a template	member
	      function.

       o      istream &operator>>(istream &, Type &):
	      Extraction  to  any  type	 Type  supporting   extractions	  from
	      i[string]streams.	 If  the  extraction  fails,  the A2x object's
	      good() member will return	false, and the Type's default value is
	      returned	(this  facility	is implied by the fact that this class
	      inherits from istringstream, but it's probably useful to	stress
	      that the extraction operation is still available).

       o      A2x &operator=(char const	*):
	      Stores  new  text	 in the	A2x object, resets the status flags to
	      ios::good. If a 0-pointer	is passed, an empty string is stored.

       o      A2x &operator=(std::string const &):
	      Stores the text stored in	the std::string	argument  in  the  A2x
	      object, resets the status	flags to ios::good.

       o      A2x &operator=(A2x const &):
	      The standard overloaded assignment operator is available

EXAMPLE
	   int x = A2x("12");

	   A2x a2x("12.50");

	   double d;

	   d = a2x;

	   a2x = "err";

	   d = a2x;	   // d	now 0

	   a2x = " a";

	   char	c = a2x;   // c	now 'a'

			   // explicit conversion to `double'
	   cout	<< A2x("12.4").to<double>() << endl;

FILES
       bobcat/a2x - defines the	class interface

SEE ALSO
       bobcat(7),  x2a(3bobcat),  atoi(3),  atol(3),  atof(3), strtod(3), str-
       tol(3), strdoul(3)

BUGS
       None Reported.

DISTRIBUTION FILES
       o      bobcat_3.25.01-x.dsc: detached signature;

       o      bobcat_3.25.01-x.tar.gz: source archive;

       o      bobcat_3.25.01-x_i386.changes: change log;

       o      libbobcat1_3.25.01-x_*.deb:  debian  package  holding  the   li-
	      braries;

       o      libbobcat1-dev_3.25.01-x_*.deb:  debian  package holding the li-
	      braries, headers and manual pages;

       o      http://sourceforge.net/projects/bobcat: public archive location;

BOBCAT
       Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.

COPYRIGHT
       This is free software, distributed under	the terms of the  GNU  General
       Public License (GPL).

AUTHOR
       Frank B.	Brokken	(f.b.brokken@rug.nl).

libbobcat-dev_3.25.01-x.tar.gz	   2005-2015		     FBB::A2x(3bobcat)

NAME | SYNOPSIS | DESCRIPTION | NAMESPACE | INHERITS FROM | CONSTRUCTORS | STATIC MEMBER FUNCTION | MEMBER FUNCTION | OVERLOADED OPERATORS | EXAMPLE | FILES | SEE ALSO | BUGS | DISTRIBUTION FILES | BOBCAT | COPYRIGHT | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=a2x&sektion=3bobcat&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help