Units Converter

Greasy Fork is available in English.

Units Converter

A library for unit conversions.

当前为 2024-11-27 提交的版本，查看最新版本。

此脚本不应直接安装。它是供其他脚本使用的外部库，要使用该库请加入元指令 // @require https://update.greasyfork.icu/scripts/519002/1492059/Units%20Converter.js

提问、发表评价或者举报此脚本。

作者: hacker09
版本: 1
创建于: 2024-11-27
更新于: 2024-11-27
大小: 2.8 KB
许可证: 暂无

Here’s the corrected markdown after ensuring proper formatting and content flow:

To always have the latest version use:

// @require      https://update.greasyfork.icu/scripts/519002/Units%20Converter.js

Unit Conversion Library Documentation

Overview

This library provides a simple framework to convert units of measurement for the script http://greasyfork.icu/en/scripts/419825. It supports various unit types (e.g., length, weight, volume, temperature) and handles conversions with single or compound values.

To see the latest const Units regex and a real usage scenario check http://greasyfork.icu/en/scripts/419825.

Features

Unit Conversion: Converts a numeric value from one unit to another.
Compound Conversions: Handles cases with two values (e.g., "10x20 inches").
Exponential Operations: Supports calculations like powers (e.g., "5^3").
Unit Recognition: Uses a regex pattern to identify units and values from text input.

Usage

Example Input

"150 pounds" → Outputs: "68.03 kg"
"10x20 inches" → Outputs: "25.40 x 50.80 cm"
"5^3" → Outputs: "125 power"

Main Functions

Regex Matching for Units

const UnitType = "150 pounds".match(Units)[3].toLowerCase(); // Extracts the unit type

Value Extraction

const Units = new RegExp(/^[ \t\xA0]*(-?\d+(?:[., ]\d+)?)(?:[ \t\xA0]*x[ \t\xA0]*(-?\d+(?:[., ]\d+)?))?[ \t\xA0]*(in|inch|inches|"|”|″|cm|cms|centimeters?|m|mt|mts|meters?|ft|kg|lbs?|pounds?|kilograms?|ounces?|g|ozs?|fl oz|fl oz (us)|fluid ounces?|kphs?|km\/h|kilometers per hours?|mhp|mphs?|meters per hours?|(?:°\s?|º\s?|)(?:degrees?\s+)?(?:celsius|fahrenheit|[CF])|km\/hs?|ml|milliliters?|l|liters?|litres?|gal|gallons?|yards?|yd|Millimeter|millimetre|kilometers?|mi|mm|miles?|km|ft|fl|feets?|grams?|kilowatts?|kws?|brake horsepower|mechanical horsepower|hps?|bhps?|miles per gallons?|mpgs?|liters per 100 kilometers?|lt?\/100km|liquid quarts?|lqs?|qt|foot-? ?pounds?|ft-?lbs?|lb fts?|newton-? ?meters?|n·?m|\^\d+)[ \t\xA0]*(?:\(\w+\)[ \t\xA0]*)?$/i); //https://regex101.com/r/ObpIn5/9 Davidebyzero

const UnitValue = "150 pounds".match(Units)[1].replaceAll(',', '.'); // Extracts numeric value
const SecondUnitValue = "150 pounds".match(Units)[2]?.replaceAll(',', '.') || 0; // Extracts second value if present

Value Conversion

const convertValue = (value, unitType) => {
   const { factor, convert } = window.UConv[unitType] || {};
   return convert ? convert(value) : value * factor; // Converts value using factor or custom function
};

New Unit Detection

const NewUnit = window.UConv[UnitType]?.unit || UnitType; // Detects target unit

Final Conversion Output

const ConvertedUnit = `${convertValue(parseFloat(UnitValue), UnitType).toFixed(2)}${SecondUnitValue != 0 ? ` x ${convertValue(parseFloat(SecondUnitValue), UnitType).toFixed(2)}` : ''}`; // Formats output

Special Cases

const ConvertedUnit = "5^3".match(/\^(\d+\.?\d*)/) 
   ? (NewUnit = 'power', Math.pow(parseFloat(UnitValue), parseFloat("5^3".match(/\^(\d+\.?\d*)/)[1]))) 
   : ConvertedUnit; // Handles powers

Display Conversion

ShowConvertion('Units', NewUnit, ConvertedUnit); // Displays result

Adding New Units

To add new units, modify the addConversion function in the UConv library:

addConversion(['unit1', 'unit2'], 'targetUnit', conversionFactor, optionalConvertFunction);

Example:

addConversion(['pound', 'lb'], 'kg', 0.453592); // Adds "pound" conversion to kilograms

How It Works

Input Parsing: Uses regex to extract unit type and numeric values from text input.
Conversion: Fetches the appropriate conversion factor or custom function from UConv.
Output: Returns the converted value in the desired format, supporting both compound and exponential cases.