WorksheetFunction.FindB method (Excel)

Find 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.

Syntax

expression.FindB (Arg1, Arg2, Arg3)

expression A variable that represents a WorksheetFunction object.

Parameters

Name Required/Optional Data type Description
Arg1 Required String Find_text - the text you want to find.
Arg2 Required String Within_text - the text containing the text that you want to find.
Arg3 Optional Variant 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.

Return value

Double

Remarks

Find 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 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 sets 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 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 and SearchB.

If find_text is "" (empty text), Find 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 and FindB return the #VALUE! error value.

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

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

Use start_num to skip a specified number of characters. Using Find 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 begins with character 8, finds find_text at the next character, and returns the number 9.

Find always returns the number of characters from the start of within_text, counting the characters that you skip if start_num is greater than 1.

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.