Skip to content

Commit

Permalink
remove string.copy examples (#41994)
Browse files Browse the repository at this point in the history
  • Loading branch information
gewarren authored Aug 2, 2024
1 parent a43acee commit 2a2668e
Show file tree
Hide file tree
Showing 3 changed files with 68 additions and 69 deletions.
3 changes: 1 addition & 2 deletions docs/fundamentals/runtime-libraries/system-string.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ In .NET, a <xref:System.String> object can include embedded null characters, whi

- The value returned by the `strlen` or `wcslen` functions does not necessarily equal <xref:System.String.Length%2A?displayProperty=nameWithType>.

- The string created by the `strcpy_s` or `wcscpy_s` functions is not necessarily identical to the string created by the <xref:System.String.Copy%2A?displayProperty=nameWithType> method.
- The string created by the `strcpy_s` or `wcscpy_s` functions is not necessarily identical to the string being copied.

You should ensure that native C and C++ code that instantiates <xref:System.String> objects, and code that is passed <xref:System.String> objects through platform invoke, don't assume that an embedded null character marks the end of the string.

Expand Down Expand Up @@ -450,7 +450,6 @@ For detailed information about formatting operations and examples, see the <xref
You can call the following <xref:System.String> methods to make a copy of a string:

- <xref:System.String.Clone%2A> returns a reference to an existing <xref:System.String> object.
- <xref:System.String.Copy%2A> creates a copy of an existing string.
- <xref:System.String.CopyTo%2A> copies a portion of a string to a character array.

### Normalize a string
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,47 +2,47 @@
description: "Learn more about: Types of String Manipulation Methods in Visual Basic"
title: "Types of String Manipulation Methods"
ms.date: 07/20/2015
helpviewer_keywords:
helpviewer_keywords:
- "strings [Visual Basic], manipulating [Visual Basic]"
- "string manipulation"
ms.assetid: 905055cd-7f50-48fb-9eed-b0995af1dc1f
---
# Types of String Manipulation Methods in Visual Basic

There are several different ways to analyze and manipulate your strings. Some of the methods are a part of the Visual Basic language, and others are inherent in the `String` class.
## Visual Basic Language and the .NET Framework

Visual Basic methods are used as inherent functions of the language. They may be used without qualification in your code. The following example shows typical use of a Visual Basic string-manipulation command:
[!code-vb[VbVbalrStrings#44](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStrings/VB/Class2.vb#44)]
In this example, the `Mid` function performs a direct operation on `aString` and assigns the value to `bString`.
For a list of Visual Basic string manipulation methods, see [String Manipulation Summary](../../../language-reference/keywords/string-manipulation-summary.md).
### Shared Methods and Instance Methods

You can also manipulate strings with the methods of the `String` class. There are two types of methods in `String`: *shared* methods and *instance* methods.
#### Shared Methods

A shared method is a method that stems from the `String` class itself and does not require an instance of that class to work. These methods can be qualified with the name of the class (`String`) rather than with an instance of the `String` class. For example:
[!code-vb[VbVbalrStrings#45](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStrings/VB/Class2.vb#45)]
In the preceding example, the <xref:System.String.Copy%2A?displayProperty=nameWithType> method is a static method, which acts upon an expression it is given and assigns the resulting value to `bString`.
#### Instance Methods

Instance methods, by contrast, stem from a particular instance of `String` and must be qualified with the instance name. For example:
[!code-vb[VbVbalrStrings#46](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStrings/VB/Class2.vb#46)]
In this example, the <xref:System.String.Substring%2A?displayProperty=nameWithType> method is a method of the instance of `String` (that is, `aString`). It performs an operation on `aString` and assigns that value to `bString`.
For more information, see the documentation for the <xref:System.String> class.
There are several different ways to analyze and manipulate your strings. Some of the methods are a part of the Visual Basic language, and others are inherent in the `String` class.

## Visual Basic Language and the .NET Framework

Visual Basic methods are used as inherent functions of the language. They may be used without qualification in your code. The following example shows typical use of a Visual Basic string-manipulation command:

[!code-vb[VbVbalrStrings#44](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStrings/VB/Class2.vb#44)]

In this example, the `Mid` function performs a direct operation on `aString` and assigns the value to `bString`.

For a list of Visual Basic string manipulation methods, see [String Manipulation Summary](../../../language-reference/keywords/string-manipulation-summary.md).

### Shared Methods and Instance Methods

You can also manipulate strings with the methods of the `String` class. There are two types of methods in `String`: *shared* methods and *instance* methods.

#### Shared Methods

A shared method is a method that stems from the `String` class itself and does not require an instance of that class to work. These methods can be qualified with the name of the class (`String`) rather than with an instance of the `String` class. For example:

[!code-vb[VbVbalrStrings#45](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStrings/VB/Class2.vb#45)]

In the preceding example, the <xref:System.String.Compare%2A?displayProperty=nameWithType> method is a shared method that accepts two instances of `String` as arguments.

#### Instance Methods

Instance methods, by contrast, stem from a particular instance of `String` and must be qualified with the instance name. For example:

[!code-vb[VbVbalrStrings#46](~/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrStrings/VB/Class2.vb#46)]

In this example, the <xref:System.String.Substring%2A?displayProperty=nameWithType> method is a method of the instance of `String` (that is, `aString`). It performs an operation on `aString` and assigns that value to `bString`.

For more information, see the documentation for the <xref:System.String> class.

## See also

- [Introduction to Strings in Visual Basic](introduction-to-strings.md)
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Option Explicit On
Option Explicit On
Option Strict On

Class Class0bb85ddaa37f4a9799b48b344c5437be
Expand All @@ -10,10 +10,10 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet35>
Dim StrArray() As String = {"ABCDEFG", "HIJKLMNOP"}
Dim FindThisString As String = "JKL"

For Each Str As String In StrArray
If Str.Contains(FindThisString) Then
MsgBox("Found " & FindThisString & " at index " &
MsgBox("Found " & FindThisString & " at index " &
Str.IndexOf(FindThisString))
End If
Next
Expand Down Expand Up @@ -42,15 +42,15 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be

Public Sub Method45()
' <snippet45>
Dim aString As String = String.Copy("A literal string")
Dim equal As Boolean = (String.Compare("Hello", "Goodbye") = 0)
' </snippet45>
End Sub

Public Sub Method46()
' <snippet46>
Dim aString As String = "A String"
Dim bString As String

' Assign "String" to bString.
bString = aString.Substring(2, 6)
' </snippet46>
Expand All @@ -60,13 +60,13 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet47>
Dim MyString As String = "This is my string"
Dim stringLength As Integer

' Explicitly set the string to Nothing.
MyString = Nothing

' stringLength = 0
stringLength = Len(MyString)

' This line, however, causes an exception to be thrown.
stringLength = MyString.Length
' </snippet47>
Expand All @@ -85,7 +85,7 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet49>
Dim myString As String = "ABCDE"
Dim myChar As Char

' Assign "D" to myChar.
myChar = myString.Chars(3)
' </snippet49>
Expand All @@ -95,7 +95,7 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet50>
Dim myString As String = "ABCDE"
Dim myInteger As Integer

' Assign 3 to myInteger.
myInteger = myString.IndexOf("D")
' </snippet50>
Expand All @@ -108,7 +108,7 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
Dim cString As String = "C"
Dim dString As String = "D"
Dim myString As String

' Assign "ABCD" to myString.
myString = String.Concat(aString, bString, cString, dString)
' </snippet51>
Expand All @@ -118,31 +118,31 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet52>
Dim myString As String = "UpPeR oR LoWeR cAsE"
Dim newString As String

' newString = "UPPER OR LOWER CASE"
newString = UCase(myString)

' newString = "upper or lower case"
newString = LCase(myString)

' newString = "UPPER OR LOWER CASE"
newString = myString.ToUpper

' newString = "upper or lower case"
newString = myString.ToLower
' </snippet52>
End Sub

Public Sub Method53()
' <snippet53>
Dim spaceString As String =
Dim spaceString As String =
" This string will have the spaces removed "
Dim oneString As String
Dim twoString As String

' This removes all trailing and leading spaces.
oneString = spaceString.Trim

' This also removes all trailing and leading spaces.
twoString = Trim(spaceString)
' </snippet53>
Expand All @@ -161,10 +161,10 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
Dim aString As String = "This is My Str@o@o@ing"
Dim myString As String
Dim anotherString As String

' myString = "This is My String"
myString = aString.Remove(14, 5)

' anotherString = "This is Another String"
anotherString = myString.Replace("My", "Another")
' </snippet55>
Expand All @@ -174,7 +174,7 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet56>
Dim aString As String = "This is My Stng"
Dim myString As String

' Results in a value of "This is My String".
myString = aString.Insert(13, "ri")
' </snippet56>
Expand Down Expand Up @@ -203,13 +203,13 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet59>
Dim aString As String = "Left Center Right"
Dim rString, lString, mString As String

' rString = "Right"
rString = Mid(aString, 13)

' lString = "Left"
lString = Mid(aString, 1, 4)

' mString = "Center"
mString = Mid(aString, 6, 6)
' </snippet59>
Expand All @@ -219,7 +219,7 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet60>
Dim aString As String = "Left Center Right"
Dim subString As String

' subString = "Center"
subString = aString.Substring(5, 6)
' </snippet60>
Expand Down Expand Up @@ -257,11 +257,11 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
Dim OneString As String
Dim TwoString As String
OneString = "one, two, three, four, five"

' Evaluates to "two".
TwoString = OneString.Substring(5, 3)
OneString = "1"

' Evaluates to "11".
TwoString = OneString & "1"
' </snippet64>
Expand All @@ -285,7 +285,7 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' <snippet67>
Dim myString As String = "ABCDE"
Dim myChar As Char

' The value of myChar is "D".
myChar = myString.Chars(3)
' </snippet67>
Expand Down Expand Up @@ -330,7 +330,7 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
' d0dc8317-9ab3-4324-99f7-3f5788c0e72a
' How to: Convert an Array of Bytes into a String in Visual Basic
' <snippet72>
Private Function UnicodeBytesToString(
Private Function UnicodeBytesToString(
ByVal bytes() As Byte) As String

Return System.Text.Encoding.Unicode.GetString(bytes)
Expand All @@ -342,16 +342,16 @@ Class Class0bb85ddaa37f4a9799b48b344c5437be
Public Sub Method73()
' <snippet73>
Dim MyString As String
MyString = "This is the first line of my string." & VbCrLf &
"This is the second line of my string." & VbCrLf &
MyString = "This is the first line of my string." & VbCrLf &
"This is the second line of my string." & VbCrLf &
"This is the third line of my string."
' </snippet73>
End Sub

' f477d35c-a3fc-4a30-b1d4-cd0d353aae1d
' How to: Convert Strings into an Array of Bytes in Visual Basic
' <snippet74>
Private Function UnicodeStringToBytes(
Private Function UnicodeStringToBytes(
ByVal str As String) As Byte()

Return System.Text.Encoding.Unicode.GetBytes(str)
Expand Down

0 comments on commit 2a2668e

Please sign in to comment.