Greasy Fork

Greasy Fork is available in English.

Conversion Utility Library

A library for unit conversions.

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

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

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

To always have the latest version use // @require https://update.greasyfork.icu/scripts/519002/Units%20Converter.js

Here’s how you can write clear, concise documentation for your library and its usage:

Unit Conversion Library Documentation

Overview

This library provides a simple framework to convert units of measurement. It supports various unit types (e.g., length, weight, volume, temperature) and handles conversions with single or compound values.

Features

  1. Unit Conversion: Converts a numeric value from one unit to another.
  2. Compound Conversions: Handles cases with two values (e.g., "10x20 inches").
  3. Exponential Operations: Supports calculations like powers (e.g., "5^3").
  4. 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

  1. Regex Matching for Units

    const selectedUnitType = SelectedText.match(Units)[3].toLowerCase();
    • Extracts the unit type from user input.

  2. Value Extraction

    const SelectedUnitValue = SelectedText.match(Units)[1].replaceAll(',', '.');
const SecondSelectedUnitValue = SelectedText.match(Units)[2]?.replaceAll(',', '.') || 0;
    • Extracts numeric values (first and second, if available).

  3. Value Conversion

    const convertValue = (value, unitType) => {
   const { factor, convert } = window.UConv[unitType] || {};
   return convert ? convert(value) : value * factor;
};
    • Converts a value from one unit to another using a predefined conversion map.

  4. New Unit Detection

    var NewUnit = window.UConv[selectedUnitType]?.unit || selectedUnitType;
    • Determines the target unit for conversion.

  5. Final Conversion Output

    var ConvertedUnit = `${convertValue(parseFloat(SelectedUnitValue), selectedUnitType).toFixed(2)}${SecondSelectedUnitValue != 0 ? ` x ${convertValue(parseFloat(SecondSelectedUnitValue), selectedUnitType).toFixed(2)}` : ''}`;
    • Produces the final converted value(s).

  6. Special Cases

    ConvertedUnit = SelectedText.match(/\^(\d+\.?\d*)/) 
   ? (NewUnit = 'power', Math.pow(parseFloat(SelectedUnitValue), parseFloat(SelectedText.match(/\^(\d+\.?\d*)/)[1]))) 
   : ConvertedUnit;
    • Handles exponential calculations like 5^3.

  7. Display Conversion

    ShowConvertion('Units', NewUnit, ConvertedUnit);
    • Outputs the conversion 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);

How It Works

  1. Input Parsing: The script uses regex to extract the unit type and numeric values from text input.
  2. Conversion: It looks up the appropriate conversion factor or custom conversion function from UConv.
  3. Output: Converts the values and returns the result in the desired format, supporting compound and exponential calculations.