قېلىپ:Convinfobox/doc

This template is based on {{convert}}. It is intended as a meta-template for use in infoboxes. It accepts from four to seven unnamed parameters. Even parameters must be numerical (or empty) and specify the numerical value of a measurement and the intended precision of the conversion. Odd parameters must be unit codes as used in قېلىپ:Tlf. Named parameters are the same as قېلىپ:Tlf's.

This template differs from قېلىپ:Tlf in the following respects.

• The units to convert to and the units to convert from must be specified (therefore there are no default convert-to units).
• Feilds for the numerical value of a measurement may be left blank.
• The default to to abbreiviate units (where abbreviations exist).
• Range conversions are not available.

This template may be used when it is unknown in which direction the conversion is to be made. The direction is determined as shown in the following examples.

• {{convinfobox|100|m2||sqft}} gives "قېلىپ:Convinfobox/pri2"
• {{convinfobox||m2|100|sqft}} gives "قېلىپ:Convinfobox/sec2"

Dual conversions

Dual conversions may be performed by adding a fifth (possibly blank) and sixth unnamed parameter.

• {{convinfobox|375|ml||impoz||usoz}} gives "قېلىپ:Convinfobox/pri3"
• {{convinfobox||ml|40|impoz||usoz}} gives "قېلىپ:Convinfobox/sec3"
• {{convinfobox||ml||impoz|32|usoz}} gives "قېلىپ:Convinfobox/ter3"

Paired units

Length may be expressed in feet and inches.

• {{convinfobox|180|cm||ft||in}} gives "قېلىپ:Convinfobox/pri3"
• {{convinfobox||cm|5|ft||in}} gives "قېلىپ:Convinfobox/sec3"
• {{convinfobox||cm||ft|120|in}} gives "قېلىپ:Convinfobox/ter3"
• {{convinfobox||cm|5|ft|6|in}} gives "قېلىپ:Convinfobox/secter3"
• {{convinfobox||ft||in|180|cm}} gives "قېلىپ:Convinfobox/ter3"
• {{convinfobox|5|ft||in||cm}} gives "قېلىپ:Convinfobox/pri3"
• {{convinfobox||ft|120|in||cm}} gives "قېلىپ:Convinfobox/sec3"
• {{convinfobox|5|ft|6|in||cm}} gives "قېلىپ:Convinfobox/prisec3"

Similarly, mass may be expressed in pounds and ounces.

• {{convinfobox|8.5|kg||lb||oz}} gives "قېلىپ:Convinfobox/pri3"
• {{convinfobox||kg|4|lb|3|oz}} gives "قېلىپ:Convinfobox/secter3"

Mass may also be expressed in stone and pounds.

• {{convinfobox|65|kg||st||lb}} gives "قېلىپ:Convinfobox/pri3"
• {{convinfobox||kg|10|st||lb}} gives "قېلىپ:Convinfobox/sec3"
• {{convinfobox||kg|10|st|7|lb}} gives "قېلىپ:Convinfobox/secter3"
• {{convinfobox||kg||st|145|lb}} gives "قېلىپ:Convinfobox/ter3"

Leaving all numerical feilds blank

If all numerical value fields are left blank the template returns nothing.

• {{convinfobox||m2||sqft}} gives ""
• {{convinfobox||ml||impoz||usoz}} gives "قېلىپ:Convinfobox/3"

Specifying more than one value

The template currently bases conversions on the first non-blank numerical value ignoring any secondary or tertiary values.

• {{convinfobox|100|m2|100|sqft}} gives "قېلىپ:Convinfobox/prisec2"
• {{convinfobox|375|ml|40|impoz||usoz}} gives "قېلىپ:Convinfobox/prisec3"
• {{convinfobox|375|ml||impoz|32|usoz}} gives "قېلىپ:Convinfobox/priter3"
• {{convinfobox||ml|40|impoz|32|usoz}} gives "قېلىپ:Convinfobox/secter3"

Rounding

As with قېلىپ:Tlf rounding can be done automatically or manually by specifying the precision and/or number of significant figures in the converted value. The number of significant figures can be determined by the parameter sigfig. The precision can be determined by the fifth (if there is no sixth) or seventh (if there is a sixth) unnamed parameter as shown in the examples below.

• {{convinfobox|100|m2||sqft|4}} gives "قېلىپ:Convinfobox/pri2"
• {{convinfobox|100|m2||sqft|sigfig=4}} gives "قېلىپ:Convinfobox/pri2"
• {{convinfobox||ml|40|impoz||usoz|2}} gives "قېلىپ:Convinfobox/sec3"
• {{convinfobox||ml|40|impoz||usoz|sigfig=3}} gives "قېلىپ:Convinfobox/sec3"
• {{convinfobox||kg|10|st|7|lb|3}} gives "قېلىپ:Convinfobox/secter3"
• {{convinfobox||kg|10|st|7|lb|sigfig=5}} gives "قېلىپ:Convinfobox/secter3"