Management of lengths in real world units. More...

Collaboration diagram for Length:

Files
file	length-example.cc
	Demonstrates usage of the ns3::Length class.

file	length-test-suite.cc
	Length class test suite.

file	length.cc
	ns3::Length implementation

file	length.h
	Declaration of ns3::Length class.

Classes
class	ns3::Length
	Represents a length in meters. More...

bool	ns3::operator== (const Length &left, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

bool	ns3::operator!= (const Length &left, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

bool	ns3::operator< (const Length &left, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

bool	ns3::operator<= (const Length &left, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

bool	ns3::operator> (const Length &left, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

bool	ns3::operator>= (const Length &left, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::operator+ (const Length &left, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::operator- (const Length &left, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::operator* (const Length &left, double scalar)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::operator* (double scalar, const Length &right)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::operator/ (const Length &left, double scalar)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

double	ns3::operator/ (const Length &numerator, const Length &denominator)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

int64_t	ns3::Div (const Length &numerator, const Length &denominator, Length *remainder)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::Mod (const Length &numerator, const Length &denominator)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

std::string	ns3::ToSymbol (Length::Unit unit)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

std::string	ns3::ToName (Length::Unit unit, bool plural)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

std::tuple< bool, Length::Unit >	ns3::FromString (std::string unitString)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

std::ostream &	ns3::operator<< (std::ostream &stream, const Length &l)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

std::ostream &	ns3::operator<< (std::ostream &stream, const Length::Quantity &q)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

std::ostream &	ns3::operator<< (std::ostream &stream, Length::Unit unit)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

std::tuple< bool, double, std::string >	ns3::ParseLengthString (const std::string &input)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

std::istream &	ns3::operator>> (std::istream &stream, Length &l)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::NanoMeters (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::MicroMeters (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::MilliMeters (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::CentiMeters (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::Meters (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::KiloMeters (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::NauticalMiles (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::Inches (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::Feet (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::Yards (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	ns3::Miles (double value)
	This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations. More...

Length	NanoMeters (double value)
	Construct a Length from nanometers. More...

Length	MicroMeters (double value)
	Construct a Length from micrometers. More...

Length	MilliMeters (double value)
	Construct a Length from millimeters. More...

Length	CentiMeters (double value)
	Construct a Length from centimeters. More...

Length	Meters (double value)
	Construct a Length from meters. More...

Length	KiloMeters (double value)
	Construct a Length from kilometers. More...

Length	NauticalMiles (double value)
	Construct a Length from nautical miles. More...

Length	Inches (double value)
	Construct a Length from inches. More...

Length	Feet (double value)
	Construct a Length from feet. More...

Length	Yards (double value)
	Construct a Length from yards. More...

Length	Miles (double value)
	Construct a Length from miles. More...

Detailed Description

Management of lengths in real world units.

Function Documentation

◆ CentiMeters() [1/2]

Length ns3::CentiMeters ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 814 of file length.cc.

Referenced by LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ CentiMeters() [2/2]

Length CentiMeters ( double value )

Parameters

value Value in centimeters

Returns: Length object constructed using Length::Unit::Centimeter

Definition at line 814 of file length.cc.

◆ Div()

int64_t ns3::Div	(	const Length &	numerator,
		const Length &	denominator,
		Length *	remainder
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 488 of file length.cc.

Referenced by DivAndMod(), TimeSimpleTestCase::DoTimeOperations(), LengthTestCase::TestDivReturnsCorrectRemainder(), LengthTestCase::TestDivReturnsCorrectResult(), and LengthTestCase::TestDivReturnsZeroRemainder().

Here is the caller graph for this function:

◆ Feet() [1/2]

Length ns3::Feet ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 844 of file length.cc.

Referenced by DivAndMod(), and LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ Feet() [2/2]

Length Feet ( double value )

Parameters

value Value in feet

Returns: Length object constructed using Length::Unit::Foot

Definition at line 844 of file length.cc.

◆ FromString()

std::tuple<bool, Length::Unit> ns3::FromString ( std::string unitString )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 586 of file length.cc.

◆ Inches() [1/2]

Length ns3::Inches ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 838 of file length.cc.

Referenced by LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ Inches() [2/2]

Length Inches ( double value )

Parameters

value Value in inches

Returns: Length object constructed using Length::Unit::Inch

Definition at line 838 of file length.cc.

◆ KiloMeters() [1/2]

Length ns3::KiloMeters ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 826 of file length.cc.

Referenced by LengthValueTestCase::TestAttributeConstructor(), LengthValueTestCase::TestAttributeDeserialization(), LengthValueTestCase::TestAttributeSerialization(), and LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ KiloMeters() [2/2]

Length KiloMeters ( double value )

Parameters

value Value in kilometers

Returns: Length object constructed using Length::Unit::Kilometer

Definition at line 826 of file length.cc.

◆ Meters() [1/2]

Length ns3::Meters ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 820 of file length.cc.

Referenced by ArithmeticOperators(), EqualityOperators(), and LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ Meters() [2/2]

Length Meters ( double value )

Parameters

value Value in meters

Returns: Length object constructed using Length::Unit::Meter

Definition at line 820 of file length.cc.

◆ MicroMeters() [1/2]

Length ns3::MicroMeters ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 802 of file length.cc.

Referenced by LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ MicroMeters() [2/2]

Length MicroMeters ( double value )

Parameters

value Value in micrometers

Returns: Length object constructed using Length::Unit::Micrometer

Definition at line 802 of file length.cc.

◆ Miles() [1/2]

Length ns3::Miles ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 856 of file length.cc.

Referenced by LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ Miles() [2/2]

Length Miles ( double value )

Parameters

value Value in miles

Returns: Length object constructed using Length::Unit::Mile

Definition at line 856 of file length.cc.

◆ MilliMeters() [1/2]

Length ns3::MilliMeters ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 808 of file length.cc.

Referenced by LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ MilliMeters() [2/2]

Length MilliMeters ( double value )

Parameters

value Value in millimeters

Returns: Length object constructed using Length::Unit::Millimeter

Definition at line 808 of file length.cc.

◆ Mod()

Length ns3::Mod	(	const Length &	numerator,
		const Length &	denominator
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 507 of file length.cc.

Referenced by DivAndMod(), LengthTestCase::TestModReturnsNonZero(), and LengthTestCase::TestModReturnsZero().

Here is the caller graph for this function:

◆ NanoMeters() [1/2]

Length ns3::NanoMeters ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 796 of file length.cc.

Referenced by LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ NanoMeters() [2/2]

Length NanoMeters ( double value )

Parameters

value Value in nanometers

Returns: Length object constructed using Length::Unit::Nanometer

Definition at line 796 of file length.cc.

◆ NauticalMiles() [1/2]

Length ns3::NauticalMiles ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 832 of file length.cc.

Referenced by LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ NauticalMiles() [2/2]

Length NauticalMiles ( double value )

Parameters

value Value in nautical miles

Returns: Length object constructed using Length::Unit::NauticalMile

Definition at line 832 of file length.cc.

◆ operator!=()

bool ns3::operator!=	(	const Length &	left,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 409 of file length.cc.

◆ operator*() [1/2]

Length ns3::operator*	(	const Length &	left,
		double	scalar
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 453 of file length.cc.

◆ operator*() [2/2]

Length ns3::operator*	(	double	scalar,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 460 of file length.cc.

◆ operator+()

Length ns3::operator+	(	const Length &	left,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 439 of file length.cc.

◆ operator-()

Length ns3::operator-	(	const Length &	left,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 446 of file length.cc.

◆ operator/() [1/2]

Length ns3::operator/	(	const Length &	left,
		double	scalar
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 466 of file length.cc.

◆ operator/() [2/2]

double ns3::operator/	(	const Length &	numerator,
		const Length &	denominator
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 477 of file length.cc.

◆ operator<()

bool ns3::operator<	(	const Length &	left,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 414 of file length.cc.

◆ operator<<() [1/3]

std::ostream& ns3::operator<<	(	std::ostream &	stream,
		const Length &	l
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 674 of file length.cc.

◆ operator<<() [2/3]

std::ostream& ns3::operator<<	(	std::ostream &	stream,
		const Length::Quantity &	q
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 682 of file length.cc.

◆ operator<<() [3/3]

std::ostream& ns3::operator<<	(	std::ostream &	stream,
		Length::Unit	unit
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 690 of file length.cc.

◆ operator<=()

bool ns3::operator<=	(	const Length &	left,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 420 of file length.cc.

◆ operator==()

bool ns3::operator==	(	const Length &	left,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 403 of file length.cc.

◆ operator>()

bool ns3::operator>	(	const Length &	left,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 427 of file length.cc.

◆ operator>=()

bool ns3::operator>=	(	const Length &	left,
		const Length &	right
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 433 of file length.cc.

◆ operator>>()

std::istream& ns3::operator>>	(	std::istream &	stream,
		Length &	l
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 750 of file length.cc.

◆ ParseLengthString()

std::tuple<bool, double, std::string> ns3::ParseLengthString ( const std::string & input )

This function provides a string parsing method that does not rely on istream, which has been found to have different behaviors in different implementations.

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 715 of file length.cc.

References NS_LOG_ERROR, NS_LOG_FUNCTION, and NS_LOG_LOGIC.

Referenced by ns3::Length::operator>>().

Here is the caller graph for this function:

◆ ToName()

std::string ns3::ToName	(	Length::Unit	unit,
		bool	plural
	)

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 550 of file length.cc.

Referenced by ns3::Length::operator<<().

Here is the caller graph for this function:

◆ ToSymbol()

std::string ns3::ToSymbol ( Length::Unit unit )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 520 of file length.cc.

Referenced by ns3::Length::operator<<().

Here is the caller graph for this function:

◆ Yards() [1/2]

Length ns3::Yards ( double value )

The input string can either contain a double (for example, "5.5") or a double and a string with no space between them (for example, "5.5m")

Parameters

input The input string

Returns: A three element tuple containing the result of parsing the string. The first tuple element is a boolean indicating whether the parsing succeeded or failed. The second element contains the value of the double that was extracted from the string. The third element was the unit symbol that was extracted from the string. If the input string did not have a unit symbol, the third element will contain an empty string.

Definition at line 850 of file length.cc.

Referenced by LengthTestCase::TestBuilderFreeFunctions().

Here is the caller graph for this function:

◆ Yards() [2/2]

Length Yards ( double value )

Parameters

value Value in yards

Returns: Length object constructed using Length::Unit::Yard

Definition at line 850 of file length.cc.

Files

Classes

Detailed Description

Function Documentation

◆ CentiMeters() [1/2]

◆ CentiMeters() [2/2]

◆ Div()

◆ Feet() [1/2]

◆ Feet() [2/2]

◆ FromString()

◆ Inches() [1/2]

◆ Inches() [2/2]

◆ KiloMeters() [1/2]

◆ KiloMeters() [2/2]

◆ Meters() [1/2]

◆ Meters() [2/2]

◆ MicroMeters() [1/2]

◆ MicroMeters() [2/2]

◆ Miles() [1/2]

◆ Miles() [2/2]

◆ MilliMeters() [1/2]

◆ MilliMeters() [2/2]

◆ Mod()

◆ NanoMeters() [1/2]

◆ NanoMeters() [2/2]

◆ NauticalMiles() [1/2]

◆ NauticalMiles() [2/2]

◆ operator!=()

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator+()

◆ operator-()

◆ operator/() [1/2]

◆ operator/() [2/2]

◆ operator<()

◆ operator<<() [1/3]

◆ operator<<() [2/3]

◆ operator<<() [3/3]

◆ operator<=()

◆ operator==()

◆ operator>()

◆ operator>=()

◆ operator>>()

◆ ParseLengthString()

◆ ToName()

◆ ToSymbol()

◆ Yards() [1/2]

◆ Yards() [2/2]