NAME

Lingua::FR::Numbers::Ordinate - Go from cardinal number (4) to ordinal ("4ème")

VERSION

Version 0.05

SYNOPSIS

use Lingua::FR::Numbers::Ordinate;
use utf8::all;

print Lingua::FR::Numbers::Ordinate::ordinate(4), "\n";

DESCRIPTION

Concert from cardinal numbers (1, 2, 3) to ordinal numbers (1er, 2ème, 3ème) and vice versa.

SUBROUTINES/METHODS

ordinate

my $ordinal = ordinate($number);
my $ordinal = ordinate($number, $gender);

Convert a cardinal number into its ordinal French representation.

• $number (required)

  The cardinal number to convert. Must be an integer or numeric string. If undefined, returns "0ème".

• $gender (optional)

  Specifies the grammatical gender to use for the ordinal form of 1.

  Valid values are:

  • 'm' — masculine (default): returns "1er"
  • 'f' — feminine: returns "1re"

  This parameter has no effect for numbers other than 1.

Examples

ordinate(1) => "1er"
ordinate(1, 'm') => "1er"
ordinate(1, 'f') => "1re"
ordinate(2) => "2ème"
ordinate(undef)=> "0ème"

cardinal

my $number = cardinal($ordinal);

Convert an ordinal string (e.g., "2ème", "1er") back to its numeric cardinal form.

Returns the corresponding number or undef if the input is invalid.

Examples

cardinal("1er") => 1
cardinal("1re") => 1
cardinal("2ème")=> 2
cardinal("4.5ème") => 4.5

AUTHOR

Nigel Horne, <njh at nigelhorne.com>

BUGS

SEE ALSO

Lingua::EN::Numbers::Ordinate

SUPPORT

This module is provided as-is without any warranty.

You can find documentation for this module with the perldoc command.

    perldoc Lingua::FR::Numbers::Ordinate

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Lingua-FR-Numbers-Ordinate

• Search CPAN

  http://search.cpan.org/dist/Lingua-FR-Numbers-Ordinate/

LICENSE AND COPYRIGHT

Copyright 2020-2025 Nigel Horne

This program is released under the following licence: GPL2