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

FreeBSD Manual Pages

  
 
  

home | help
xt_romantoi(3)		    Library Functions Manual		  xt_romantoi(3)

NAME
     xt_romantoi() - Convert Roman numeral string to int

LIBRARY
     #include <xtend/stdlib.h>
     -lxtend

SYNOPSIS
     int     xt_romantoi(const char *string, char **endptr)

ARGUMENTS
     string: Pointer to the first character of the Roman numeral
     endptr: Address of a pointer variable to receive the end of the string

DESCRIPTION
     The  xt_romantoi()  function converts a string containing a valid Roman nu-
     meral to an integer, much like strtol().  It rejects non-normalized values,
     such as IIIII, XXXXX, or CCCCC, which should be written as V, L, and D, re-
     spectively.  IIII, XXXX, and CCCC are accepted in place of IV, XL, and  CD.
     Any number of consecutive Ms (1000s) are accepted, since there is no larger
     digit.   Like  strtol(),  it returns the address of the first character not
     converted as part of the number.  This can be used to verify that the  num-
     ber ended as it should have, perhaps with a '0' byte.

RETURN VALUES
     The integer value of the Roman numeral if converted, or 0 if an invalid nu-
     meral is detected.

EXAMPLES
     char    string[] = "XIV", *end;
     int     n;

     n = xt_romantoi(string, &end);
     if ( *end == '0' )
	 printf("%dn", n);
     else
	 fprintf(stderr, "Error converting %s.n", string);

SEE ALSO
     strtol(3)

								  xt_romantoi(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xt_romantoi&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help