[Excel]文字列の中から任意の文字を抽出するEXTRUCTカスタムワークシート関数

コード

下記のコードを全てコピーし、標準モジュール等に貼り付けて下さい。下記のコード表示欄の右上に「Copy」ボタンがありますのでご使用下さい。なお、標準モジュールが何だか分からない方は、 Excelのカスタムワークシート関数を使用する方法 を参照して下さい。

' [Excel]文字列の中から任意の文字を抽出するEXTRUCTカスタムワークシート関数 
' Copyright (c) 2020-2024  黒箱 
' This software is released under the MIT License;. 
' このソフトウェアはMITライセンスの下でリリースされています。 

'* @fn Public Function EXTRUCT(ByRef Text As String, ByVal CharsToExtruct As String, Optional ByVal RangeSpecification As Boolean = False) As Variant
'* @brief 文字列の中から、指定した一連の文字のみを抽出して返します。
'* @param[in] Text 抽出対象の文字列を指定します。
'* @param[in] CharsToExtruct 抽出文字を指定します。2つ以上の文字は1つの文字列で指定します。
'* @param[in] RangeSpecification 抽出文字を範囲指定(例：a-z)する場合はTRUE、範囲指定しない場合はFALSEを指定します。省略した場合、FALSEを指定します。
'* @return Variant 抽出した文字列を返します。
'* @details 文字列の中から、指定した一連の文字のみを抽出して返します。第3引数RangeSpecificationにTRUEを指定することで、第2引数CharsToExtructに範囲指定が可能になります。例えば、全ての英数字を抽出したい場合は"a-zA-Z0-9"を指定します。
'*
Public Function EXTRUCT(ByRef Text As String, ByVal CharsToExtruct As String, Optional ByVal RangeSpecification As Boolean = False) As Variant

    If (Text = "") Then Exit Function

    Dim i As Long
    Dim Char As String
    Dim Result As String

    Dim TextLength As Long: TextLength = Len(Text)

    '抽出文字が1文字の場合の処理
    If (Len(CharsToExtruct) = 1) Then
        
        For i = 1 To TextLength
            Char = Mid(Text, i, 1)
            If (Char = CharsToExtruct) Then Result = Result & Char
        Next
        
        EXTRUCT = Result
        Exit Function
    End If
    
    
    '抽出文字が2文字以上の場合、対象文字を先頭から1文字ずつ Like [charlist]で比較し、不要文字を除去する。
    
    'CharsToExtructにハイフンが含まれる場合、かつ範囲指定(例：a-z)が無効の場合、Like演算子の副作用を防ぐためハイフンを末尾に移動。
    Dim CharsToExtructPattern As String
    If Not (RangeSpecification) Then
        If (CharsToExtruct Like "*-*") Then
            CharsToExtruct = Replace(CharsToExtruct, "-", "") & "-"
        End If
    End If
    
    'CharToExtructに角カッコ ]  が含まれる場合、[charlist]の角かっこが途中で閉じてしまうため、個別に比較する
    If (CharsToExtruct Like "*]*") Then
        CharsToExtructPattern = "[" & Replace(CharsToExtruct, "]", "") & "]"
        For i = 1 To TextLength
        
            Char = Mid(Text, i, 1)
            If (Char Like CharsToExtructPattern) Then
                Result = Result & Char
            ElseIf (Char = "]") Then
                Result = Result & Char
            End If
        Next

    Else
        CharsToExtructPattern = "[" & CharsToExtruct & "]"
        For i = 1 To TextLength
            Char = Mid(Text, i, 1)
            If (Char Like CharsToExtructPattern) Then Result = Result & Char
        Next
    End If

    EXTRUCT = Result

End Function