After a long holiday break, some travel and a few training classes its time to get back in the swing of things. Today I have a relatively simple function, that if nothing else demonstrates how to use object methods. The challenge is to take a string of text and convert it into title case; so that \"great expectations\" becomes \"Great Expectations\".<\/p>\n
To accomplish this, all I need to do is get the first letter of each string and invoke the string object's ToUpper() method. But before I can do that I need to break the title string into an array of individual words which is easily accomplished using the Split() method.
\n[cc lang=\"PowerShell\"]
\nPS S:\\> $t=\"gone with the wind\"
\nPS S:\\> foreach ($w in $t.split()) {$w}
\ngone
\nwith
\nthe
\nwind
\n[\/cc]
\nNow I have to convert the first letter of each word to upper case and then append the rest of the word. I'll use the SubString() method.
\n[cc lang=\"PowerShell\"]
\nPS S:\\> foreach ($w in $t.split()) {$w.substring(0,1).ToUpper()+$w.Substring(1)}
\nGone
\nWith
\nThe
\nWind
\n[\/cc]
\nI don't really like using concatenation but it works here but I still have an array. I need to tell PowerShell to treat the entire array as a single string.
\n[cc lang=\"PowerShell\"]
\nPS S:\\> [string]$title=foreach ($w in $t.split()) {$w.substring(0,1).ToUpper()+$w.Substring(1)}
\nPS S:\\> $title
\nGone With The Wind
\n[\/cc]
\nThe actual conversion only takes a single line of PowerShell, but I went ahead and created an advanced function called ConvertTo-TitleCase to make it easier to use.
\n[cc lang=\"PowerShell\"]
\nFunction ConvertTo-TitleCase {<\/p>\n
<#\n .Synopsis\n Convert a string to title case. \n .Description\n Take a string and return a version in title case where each word is capitalized.\n .Parameter Text\n The string you wish to convert to title case.\n .Example\n PS C:\\> ConvertTo-TitleCase \"a tale of two cities\"
\n A Tale Of Two Cities<\/p>\n
.Notes
\n NAME: ConvertTo-TitleCase-
\n VERSION: 1.0
\n AUTHOR: Jeffery Hicks
\n LASTEDIT: 1\/10\/2011<\/p>\n
Learn more with a copy of Windows PowerShell 2.0: TFM (SAPIEN Press 2010)<\/p>\n
.Link
\n Http:\/\/jdhitsolutions.com\/blog<\/p>\n
.Link
\n Out-String<\/p>\n
.Inputs
\n [string]
\n .Outputs
\n [string]<\/p>\n
#><\/p>\n
[cmdletBinding()]<\/p>\n
Param(
\n[Parameter(Position=0,Mandatory=$True,ValueFromPipeline=$True)]
\n[ValidateNotNullOrEmpty()]
\n[string[]]$Text<\/p>\n
)<\/p>\n
Begin
\n {
\n Write-Verbose -Message \"Starting $($myinvocation.mycommand)\"<\/p>\n
} #close Begin<\/p>\n
Process {
\n ForEach ($string in $Text)
\n {
\n \tWrite-Verbose -Message \"Processing $string\"<\/p>\n
\t#split the string into indvidual words
\n \t$tmp=$string.Split()<\/p>\n
\t#define an array to hold modified results
\n \t$out=@()
\n \tforeach ($word in $tmp)
\n \t{
\n\t #take the first letter of each word and make it upper case,
\n\t #then append the rest of the word
\n $out+=\"{0}{1}\" -f $word.SubString(0,1).ToUpper(),$word.substring(1)
\n \t}<\/p>\n
\t#write the results
\n \tWrite-Output ($out -as [string])
\n }
\n } #close process<\/p>\n
End
\n {
\n Write-Verbose -Message \"Ending $($myinvocation.mycommand)\"
\n } #close End<\/p>\n