Code Kata: Parsing Strings Like "5mb" Into A Number Of Bytes In Lucee CFML 5.3.7.47

<cfscript>

	echo( "<p><strong> Testing parseBytes() </strong></p>" );
	echo( parseBytes( "1.305 kb" ) & "<br />" );
	echo( parseBytes( "2 megabytes" ) & "<br />" );
	echo( parseBytes( "3 gb" ) & "<br />" );
	echo( "<br />" );

	echo( "<p><strong> Testing inputBytesN() </strong></p>" );
	echo( inputBytesN( 1, "bit" ) & "<br />" );
	echo( inputBytesN( 1, "b" ) & "<br />" );
	echo( inputBytesN( 1, "kb" ) & "<br />" );
	echo( inputBytesN( 1, "mb" ) & "<br />" );
	echo( inputBytesN( 1, "gb" ) & "<br />" );
	echo( inputBytesN( 1, "tb" ) & "<br />" );
	echo( "<br />" );

	echo( "<p><strong> Testing formatBytesN() </strong></p>" );
	echo( formatBytesN( 1, "bit" ) & "<br />" );
	echo( formatBytesN( 1, "b" ) & "<br />" );
	echo( formatBytesN( 1024, "kb" ) & "<br />" );
	echo( formatBytesN( 1048576, "mb" ) & "<br />" );
	echo( formatBytesN( 1073741824, "gb" ) & "<br />" );
	echo( formatBytesN( 1099511627776, "tb" ) & "<br />" );

	// ------------------------------------------------------------------------------- //
	// ------------------------------------------------------------------------------- //

	/**
	* I convert the given number of bytes into the given unit. No rounding of decimals is
	* performed. If you want to round the value, you must do it in the calling context.
	* 
	* Example: formatBytesN( 1024, "kb" ) => 1
	* 
	* @quantity I am the number of bytes to convert.
	* @unit I am the unit of measurement into which we are converting.
	*/
	public numeric function formatBytesN(
		required numeric quantity,
		required string unit
		) {

		switch ( unit ) {
			case "bit":
			case "bits":
				return( quantity * 8 );
			break;
			// CAUTION: Lowercase "b" is actually the international standard for BIT.
			// However, since ColdFusion is case-insensitive, I'm going to use any case
			// of "B" to mean Byte.
			case "b":
			case "byte":
			case "bytes":
				return( quantity );
			break;
			case "k":
			case "kb":
			case "kilobyte":
			case "kilobytes":
				return( quantity / 1024 );
			break;
			case "m":
			case "mb":
			case "megabyte":
			case "megabytes":
				return( quantity / 1024 / 1024 );
			break;
			case "g":
			case "gb":
			case "gigabyte":
			case "gigabytes":
				return( quantity / 1024 / 1024 / 1024 );
			break;
			case "t":
			case "tb":
			case "terabyte":
			case "terabytes":
				return( quantity / 1024 / 1024 / 1024 / 1024 );
			break;
			default:
				throw(
					type = "UnsupportedUnit",
					message = "Format unit not recognized",
					extendedInfo = serializeJson( arguments )
				);
			break;
		}

	}


	/**
	* I convert the given quantity into the equivalent number of bytes.
	* 
	* Example: inputBytesN( 1, "kb" ) => 1024
	* 
	* @quantity I am the value to convert.
	* @unit I am the unit of measurement in which the quantity was defined.
	*/
	public numeric function inputBytesN(
		required numeric value,
		required string unit
		) {

		switch ( unit ) {
			case "bit":
			case "bits":
				return( ceiling( value / 8 ) );
			break;
			// CAUTION: Lowercase "b" is actually the international standard for BIT.
			// However, since ColdFusion is case-insensitive, I'm going to use any case
			// of "B" to mean Byte.
			case "b":
			case "byte":
			case "bytes":
				return( value );
			break;
			case "k":
			case "kb":
			case "kilobyte":
			case "kilobytes":
				return( ceiling( value * 1024 ) );
			break;
			case "m":
			case "mb":
			case "megabyte":
			case "megabytes":
				return( ceiling( value * 1024 * 1024 ) );
			break;
			case "g":
			case "gb":
			case "gigabyte":
				return( ceiling( value * 1024 * 1024 * 1024 ) );
			break;
			case "t":
			case "tb":
			case "terabyte":
			case "terabytes":
				return( ceiling( value * 1024 * 1024 * 1024 * 1024 ) );
			break;
			default:
				throw(
					type = "UnsupportedUnit",
					message = "Input unit not recognized",
					extendedInfo = serializeJson( arguments )
				);
			break;
		}

	}


	/**
	* I parse the given quantity/unit string into the number of bytes. This is basically
	* a short-hand for the inputBytesN() function.
	* 
	* Example: parseBytes( "1kb" ) => 1024
	* 
	* @input I am the string to parse and convert.
	*/
	public numeric function parseBytes( required string input ) {

		// RegEx pattern matches leading number followed by trailing strings.
		var parts = input
			.lcase()
			.trim()
			.reMatchNoCase( "^[\d.]+|[a-z]+$" )
		;

		if ( parts.len() != 2 ) {

			throw(
				type = "UnexpectedInput",
				message = "Input string must contain a quantity followed by a unit",
				extendedInfo = serializeJson( arguments )
			);

		}

		var quantity = val( parts[ 1 ] );
		var unit = parts[ 2 ];

		return( inputBytesN( quantity, unit ) );

	}

</cfscript>