WorksheetFunction.FindB(String, String, Object) Method

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Find(String, String, Object) and FindB locate one text string within a second text string, and return the number of the starting position of the first text string from the first character of the second text string.

public double FindB (string Arg1, string Arg2, object Arg3);

Public Function FindB (Arg1 As String, Arg2 As String, Optional Arg3 As Object) As Double

Parameters

Arg1

String

Find_text - the text you want to find.

Arg2

String

Within_text - the text containing the text you want to find.

Arg3

Object

Start_num - specifies the character at which to start the search. The first character in within_text is character number 1. If you omit start_num, it is assumed to be 1.

Returns

Double

Remarks

Important: Find(String, String, Object) is intended for use with languages that use the single-byte character set (SBCS), whereas FindB is intended for use with languages that use the double-byte character set (DBCS). The default language setting on your computer affects the return value in the following way:

• Find(String, String, Object) always counts each character, whether single-byte or double-byte, as 1, no matter what the default language setting is.
• FindB counts each double-byte character as 2 when you have enabled the editing of a language that supports DBCS and then set it as the default language. Otherwise, FindB counts each character as 1.

The languages that support DBCS include Japanese, Chinese (Simplified), Chinese (Traditional), and Korean.

Find(String, String, Object) and FindB are case sensitive and don't allow wildcard characters. If you don't want to do a case sensitive search or use wildcard characters, you can use Search(String, String, Object) and SearchB(String, String, Object).

If find_text is "" (empty text), Find(String, String, Object) matches the first character in the search string (that is, the character numbered start_num or 1).

Find_text cannot contain any wildcard characters.

If find_text does not appear in within_text, Find(String, String, Object) and FindB return the #VALUE! error value.

If start_num is not greater than zero, Find(String, String, Object) and FindB return the #VALUE! error value.

If start_num is greater than the length of within_text, Find(String, String, Object) and FindB return the #VALUE! error value.

Use start_num to skip a specified number of characters. Using Find(String, String, Object) as an example, suppose you are working with the text string "AYF0093.YoungMensApparel". To find the number of the first "Y" in the descriptive part of the text string, set start_num equal to 8 so that the serial-number portion of the text is not searched. Find(String, String, Object) begins with character 8, finds find_text at the next character, and returns the number 9. Find(String, String, Object) always returns the number of characters from the start of within_text, counting the characters you skip if start_num is greater than 1.