{"id":51303,"date":"2010-02-14T00:01:00","date_gmt":"2010-02-14T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2010\/02\/14\/hey-scripting-guy-weekend-scripter-using-functions-to-convert-weight-measurements-part-2\/"},"modified":"2010-02-14T00:01:00","modified_gmt":"2010-02-14T00:01:00","slug":"hey-scripting-guy-weekend-scripter-using-functions-to-convert-weight-measurements-part-2","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-weekend-scripter-using-functions-to-convert-weight-measurements-part-2\/","title":{"rendered":"Hey, Scripting Guy! Weekend Scripter: Using Functions to Convert Weight Measurements (Part 2)"},"content":{"rendered":"

\"Bookmark<\/a><\/p>\n

 <\/p>\n

Microsoft Scripting Guy Ed Wilson here. I am still hanging out down here in Murrells Inlet, South Carolina, in the United States of America. The laid-back, relaxed attitude has allowed me time to reflect on the new Weekend Scripter series I am writing. The following seagull picture I took seems to reflect this deep thought. Looks pensive, no?<\/p>\n<\/p>\n

\"Image<\/font><\/span><\/a><\/p>\n

Yesterday<\/span><\/a>, I added the ConvertTo-Pounds<\/b> function to the ConversionModule.psm1 module. In that function, multiple parameters were created to allow the conversion of different units of measurement to pounds. The same technique will be used now to add a ConvertTo-Liters<\/b> function to the ConversionModule.psm1 module. I have incremented the name of the ConversionModule.psm1 module to allow for easy version tracking during this project. Before copying the module to the modules directory, I have been deleting the previous version of the module to make it easy to load and test the cmdlets. <\/p>\n

The new ConvertTo-Liters<\/b> function is seen here.<\/p>\n

ConvertTo-Liters<\/p>\n

<\/strong><\/p>\n

Function ConvertTo-Liters
{
 <\/span><#
  <\/span>.Synopsis
    <\/span>Converts cubic centimeters, cubic feet, gallons, pints, and quarts into liters
   <\/span>.Description
    <\/span>The ConvertTo-Liters function will accept an input in 
    c<\/span>ubic centimeters, cubic feet, gallons, pints, and quarts and convert to liters.
   <\/span>.Example
    <\/span>ConvertTo-Liters -cCentimeter 100
    <\/span>Converts 100 cubic centimeters into liters
   <\/span>.Example
    <\/span>ConvertTo-Liters -cFeet 10
    <\/span>Converts 10 cubic feet into liters
   <\/span>.Example
  <\/span>  <\/span>ConvertTo-Liters -Gallon 1
    <\/span>Converts 1 gallon into liters
   <\/span>.Example
    <\/span>ConvertTo-Liters -pint 5
    <\/span>Converts 5 pints into liters
   <\/span>.Example
    <\/span>ConvertTo-Liters -quart 5
    <\/span>Converts 5 quarts into liters
   <\/span>.Parameter cCentimeter
    <\/span>The number of cubic centimeters to be converted
   <\/span>.Parameter cFeet
    <\/span>The number of cubic feet to be converted
   <\/span>.Parameter Gallon
    <\/span>The number of gallons to be converted
   <\/span>.Parameter Pint
    <\/span>The number of pints to be converted
   <\/span>.Parameter Quart
    <\/span>The number of quarts to be converted
   <\/span>.Inputs
    <\/span>[double]
   <\/span>.Outputs
    <\/span>[string]
   <\/span>.Notes
    <\/span>NAME:  <\/span>ConvertTo-Liters
    <\/span>AUTHOR: Ed Wilson
    <\/span>AUTHOR BOOK: Windows PowerShell 2.0 Best Practices, Microsoft Press 2010
    <\/span>LASTEDIT: 2\/9\/2010
    <\/span>KEYWORDS: WeekEnd Scripter, modules, getting started
   <\/span>.Link
     <\/span>Http:\/\/www.ScriptingGuys.com
     <\/span>Http:\/\/www.bit.ly\/HSGBlog
 <\/span>#>
 <\/span>#Requires -Version 2.0
 <\/span>[CmdletBinding()]
 <\/span>param(
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$cCentimeter,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$cFeet,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$Gallon,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
    <\/span>  <\/span>[Double]
      <\/span>$Quart,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$Pint          <\/span>
) #end param<\/p>\n

  <\/span>If($cCentimeter)
    <\/span>{ “$cCentimeter cubic centimeters equals $($cCentimeter * [math]::pow(10,-3)) liters” }
  <\/span>If($cFeet)
    <\/span>{ “$cFeet cubic feet equals $($cFeet * 28.316) liters” }
  <\/span>If($Gallon)
    <\/span>{ “$Gallon gallons equals $($Gallon * 3.7853) liters” }
  <\/span>If($Quart)
    <\/span>{ “$Quart quarts equals $($Quart * 0.94633) liters” }
   <\/span>If($Pint)
    <\/span>{ “$Pint pints equals $($Pint * 0.47316) liters” }
} #end ConvertTo-Liters<\/p>\n

<\/font><\/font><\/span><\/p>\n

The ConvertTo-Liters<\/b> function will accept cubic centimeters, cubic feet, gallons, quarts, and pints for input. It will perform a conversion and display the result in liters. The cubic centimeters and the cubic feet parameters use cCentimeter<\/b> and cFeet<\/b> for their parameter names. Most of the work involved in creating the ConvertTo-Liters<\/b> function is similar to the ConvertTo-Pounds<\/b> function that was created yesterday. The one thing that is a bit different is found in the conversion to cubic centimeters. The formula is cCentimeter * 10-3 <\/sup><\/b>. To do that, you need to use the pow<\/b> static method from the system.math<\/b> .NET Framework class, which is documented on MSDN and provides a number of static methods<\/font><\/a>. The pow<\/b> <\/i>static method is used to create powers. To access a static method from the system.math<\/b> class, put the word math<\/b> in square brackets and use double colons to call the method. This is seen here:<\/p>\n

PS C:> 25 * [math]::pow(10,-3)
0.025
PS C:><\/p>\n

<\/font><\/span><\/p>\n

After the new function has been added to the ConversionModule<\/b>, the function can be accessed as seen in the following image.<\/p>\n

\"Image<\/p>\n

The complete ConversionModuleV4.psm1 module is seen here.<\/p>\n

ConversionModuleV4.psm1<\/p>\n

<\/strong><\/p>\n

Function ConvertTo-Liters
{
 <\/span><#
  <\/span>.Synopsis
    C<\/span>onverts cubic centimeters, cubic feet, gallons, pints, and quarts into liters
   <\/span>.Description
    <\/span>The ConvertTo-Liters function will accept an input in 
    c<\/span>ubic centimeters, cubic feet, gallons, pints, and quarts and convert to liters.
   <\/span>.Example
    <\/span>ConvertTo-Liters -cCentimeter 100
    <\/span>Converts 100 cubic centimeters into liters
   <\/span>.Example
    <\/span>ConvertTo-Liters -cFeet 10
    <\/span>Converts 10 cubic feet into liters
   <\/span>.Example
    <\/span>ConvertTo-Liters -Gallon 1
    <\/span>Converts 1 gallon into liters
   <\/span>.Example
    <\/span>ConvertTo-Liters -pint 5
    <\/span>Converts 5 pints into liters
   <\/span>.Example
    <\/span>ConvertTo-Liters -quart 5
    <\/span>Converts 5 quarts into liters
   <\/span>.Parameter cCentimeter
    <\/span>The number of cubic centimeters to be converted
   <\/span>.Parameter cFeet
    <\/span>The number of cubic feet to be converted
   <\/span>.Parameter Gallon
    <\/span>The number of gallons to be converted
   <\/span>.Parameter Pint
    <\/span>The number of pints to be converted
   <\/span>.Parameter Quart
   <\/span> <\/span>The number of quarts to be converted
   <\/span>.Inputs
    <\/span>[double]
   <\/span>.Outputs
    <\/span>[string]
   <\/span>.Notes
    <\/span>NAME:  <\/span>ConvertTo-Liters
    <\/span>AUTHOR: Ed Wilson
    <\/span>AUTHOR BOOK: Windows PowerShell 2.0 Best Practices, Microsoft Press 2010
    <\/span>LASTEDIT: 2\/9\/2010
    <\/span>KEYWORDS: WeekEnd Scripter, modules, getting started
   <\/span>.Link
     <\/span>Http:\/\/www.ScriptingGuys.com
     <\/span>Http:\/\/www.bit.ly\/HSGBlog
 <\/span>#>
 <\/span>#Requires -Version 2.0
 <\/span>[CmdletBinding()]
 <\/span>param(
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
  <\/span>    <\/span>$cCentimeter,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$cFeet,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$Gallon,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$Quart,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$Pint          <\/span>
) #end param<\/p>\n

  <\/span>If($cCentimeter)
    <\/span>{ “$cCentimeter cubic centimeters equals $($cCentimeter * [math]::pow(10,-3)) liters” }
  <\/span>If($cFeet)
    <\/span>{ “$cFeet cubic feet equals $($cFeet * 28.316) liters” }
  <\/span>If($Gallon)
    <\/span>{ “$Gallon gallons equals $($Gallon * 3.7853) liters” }
  <\/span>If($Quart)
    <\/span>{ “$Quart quarts equals $($Quart * 0.94633) liters” }
   <\/span>If($Pint)
    <\/span>{ “$Pint pints equals $($Pint * 0.47316) liters” }
} #end ConvertTo-Liters<\/p>\n

Function ConvertTo-Pounds
{
 <\/span><#
  <\/span>.Synopsis
    <\/span>Converts tons, ounces, kilograms, or metric tons into pounds
   <\/span>.Description
    <\/span>The ConvertTo-Pounds function will accept an input in
    <\/span>tons, ounces, kilograms or metric tons and convert the result into pounds.
   <\/span>.Example
    <\/span>ConvertTo-Pounds -ton 1
    <\/span>Converts 1 ton into pounds
   <\/span>.Example
    <\/span>ConvertTo-Pounds -ounce 1000
    <\/span>Converts 1000 ounces into pounds
   <\/span>.Example
    <\/span>ConvertTo-Pounds -kilogram 1
    <\/span>Converts 1 kilograms into pounds
   <\/span>.Example
    <\/span>ConvertTo-Pounds -metricTon 1
    <\/span>Converts 1 metricTon into pounds
   <\/span>.Parameter ton
    <\/span>The number of tons to be converted
   <\/span>.Parameter ounce
    <\/span>The number of ounces to be converted
   <\/span>.Parameter kilogram
    <\/span>The number of kilograms to be converted
   <\/span>.Parameter metricTon
    <\/span>The number of metricTons to be converted
   <\/span>.Inputs
    <\/span>[double]
   <\/span>.Outputs
    <\/span>[string]
   <\/span>.Notes
    <\/span>NAME:  <\/span>ConvertTo-Pounds
    <\/span>AUTHOR: Ed Wilson
    <\/span>AUTHOR BOOK: Windows PowerShell 2.0 Best Practices, Microsoft Press 2010
    <\/span>LASTEDIT: 1\/31\/2010
    <\/span>KEYWORDS: WeekEnd Scripter, modules, getting started
   <\/span>.Link
     <\/span>Http:\/\/www.ScriptingGuys.com
     <\/span>Http:\/\/www.bit.ly\/HSGBlog
 <\/span>#>
 <\/span>#Requires -Version 2.0
 <\/span>[CmdletBinding()]
 <\/span>param(
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$Ton,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$Ounce,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
 <\/span>     <\/span>[Double]
      <\/span>$KiloGram,
      <\/span>[Parameter(Mandatory = $false,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$MetricTon     <\/span>
) #end param
  <\/span>If($ton)
    <\/span>{ “$ton tons equals $($ton * 2000) pounds” }
&nbs\np; <\/span>If($ounce)
    <\/span>{ “$ounce ounces equals $($ounce * 0.0625) pounds” }
  <\/span>If($kilogram)
    <\/span>{ “$kilogram kilograms equals $($kilogram * 2.205) pounds” }
  <\/span>If($metricTon)
    <\/span>{ “$metricTon metric tons equals $($metricTon * 2205) pounds” }
} #end ConvertTo-Pounds<\/p>\n

Function ConvertTo-Meters
{
 <\/span><#
  <\/span>.Synopsis
    <\/span>Converts feet into meters
   <\/span>.Description
    <\/span>The ConvertTo-Meters function accepts a value in feet and
    <\/span>returns a string indicating the number of meters.
   <\/span>.Example
    <\/span>ConvertTo-Meters 1
    <\/span>Converts 1 foot into meters
   <\/span>.Parameter feet
    <\/span>The number of feet to be converted
   <\/span>.Inputs
    <\/span>[double]
   <\/span>.Outputs
    <\/span>[string]
   <\/span>.Notes
    <\/span>NAME:  <\/span>ConvertTo-Meters
    <\/span>AUTHOR: Ed Wilson
    <\/span>AUTHOR BOOK: Windows PowerShell 2.0 Best Practices, Microsoft Press 2010
    <\/span>LASTEDIT: 1\/31\/2010
    <\/span>KEYWORDS: WeekEnd Scripter, modules, getting started
   <\/span>.Link
     <\/span>Http:\/\/www.ScriptingGuys.com
     <\/span>Http:\/\/www.bit.ly\/HSGBlog
 <\/span>#Requires -Version 2.0
 <\/span>#>
 <\/span>[CmdletBinding()]
 <\/span>param(
      <\/span>[Parameter(Mandatory = $true,Position = 0,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$feet
) #end param
  <\/span>“$feet feet equals $($feet*.31) meters”
} #end ConvertTo-Meters<\/p>\n

Function ConvertTo-Feet
{
 <\/span><#
  <\/span>.Synopsis
    <\/span>Converts meters into feet
  <\/span>.Description
    <\/span>The ConvertTo-Feet function accepts a value in meters and
    <\/span>returns a string indicating the number of feet.
   <\/span>.Example
    <\/span>ConvertTo-Feet 1
    <\/span>Converts 1 meter into feet
   <\/span>.Parameter meters
    <\/span>The number of meters to be converted into feet
   <\/span>.Inputs
    <\/span>[double]
   <\/span>.Outputs
    <\/span>[string]
   <\/span>.Notes
    <\/span>NAME:  <\/span>ConvertTo-Feet
    <\/span>AUTHOR: Ed Wilson
    <\/span>LASTEDIT: 1\/31\/2010
    <\/span>KEYWORDS: WeekEnd Scripter, modules, getting started
   <\/span>.Link
     <\/span>Http:\/\/www.ScriptingGuys.com
 <\/span>#Requires -Version 2.0
 <\/span>#>
 <\/span>[CmdletBinding()]
 <\/span>param(
      <\/span>[Parameter(Mandatory = $true,Position = 0,valueFromPipeline=$true)]
      <\/span>[Double]
      <\/span>$meters
) #end param
 <\/span>“$meters meters equals $($meters * 3.28) feet”
} #end ConvertTo-Feet<\/p>\n

Function ConvertTo-Fahrenheit
{
 <\/span><#
  <\/span>.Synopsis
    <\/span>Converts Celsius into Fahrenheit
  <\/span>.Description
    <\/span>The ConvertTo-Fahrenheit function accepts a value in Celsius and
    <\/span>returns a string indicating the temperature in Fahrenheit.
   <\/span>.Example
    <\/span>ConvertTo-Fahrenheit 1
    <\/span>Converts 1 degree Celsius into Fahrenheit
   <\/span>.Parameter celsius
    <\/span>The  <\/span>temperature to be converted into Fahrenheit
   <\/span>.Inputs
    <\/span>[double]
   <\/span>.Outputs
<\/span><\/font><\/font><\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

  Microsoft Scripting Guy Ed Wilson here. I am still hanging out down here in Murrells Inlet, South Carolina, in the United States of America. The laid-back, relaxed attitude has allowed me time to reflect on the new Weekend Scripter series I am writing. The following seagull picture I took seems to reflect this deep […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[51,52,3,4,61,45],"class_list":["post-51303","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-modules","tag-scripting-guy","tag-scripting-techniques","tag-weekend-scripter","tag-windows-powershell"],"acf":[],"blog_post_summary":"

  Microsoft Scripting Guy Ed Wilson here. I am still hanging out down here in Murrells Inlet, South Carolina, in the United States of America. The laid-back, relaxed attitude has allowed me time to reflect on the new Weekend Scripter series I am writing. The following seagull picture I took seems to reflect this deep […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51303","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=51303"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51303\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=51303"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=51303"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=51303"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}