Функция Len (Visual Basic)

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает целое число, содержащее либо количество знаков в строке, либо количество байтов, необходимых для сохранения переменной.

Public Shared Function Len( _
   ByVal Expression As { Boolean | Byte | SByte | Char | Double |
   Integer | UInteger | Long | ULong | Object | Short | UShort |
   Single | String | DateTime | Decimal } _
) As Integer

Параметры

Expression
Любое допустимое выражение String или имя переменной. Если Expression имеет тип Object, то функция Len возвращает размер объекта, как при записи в файл функцией FilePut.

Заметки

Для переменных определяемого пользователем типа и типа Object функция Len возвращает размер объекта, как при записи в файл функцией FilePut. Если Object содержит String, то возвращается длина строки. Если Object содержит другой тип, то возвращается размер объекта, который будет записан в файл функцией FilePut.

В структурах к строковым полям может быть применен атрибут VBFixedString, чтобы определить размер строки при записи на диск. Функция Len использует атрибут VBFixedString при определении размера переменной Object, если он доступен.

Примечание.
Функция Len, возможно, не сможет определить фактическое число байтов памяти, необходимых при использовании со строками переменной длины в типах данных, определяемых пользователем.

Примечание.
В предыдущих версиях Visual Basic функция LenB возвращала число байтов в строке, а не знаков. В основном она применяется для преобразования строк в приложениях с двухбайтовым набором знаков (DBCS). Все строки текущей версии Visual Basic кодируются в Юникоде, и LenB не поддерживается.

В предыдущих версиях Visual Basic функция LenB возвращала число байтов в строке, а не знаков. В основном она применяется для преобразования строк в приложениях с двухбайтовым набором знаков (DBCS). Все строки текущей версии Visual Basic кодируются в Юникоде, и LenB не поддерживается.

Пример

В данном примере Len используется для возврата числа знаков в строке.

' Initializes variable.
Dim TestString As String = "Hello World"
' Returns 11.
Dim TestLen As Integer = Len(TestString)

Примечания для разработчиков приложений для интеллектуальных устройств

Функция Len принимает в качестве параметров только переменные String и Object. Если Object содержит String, то возвращается длина строки String. Если параметр имеет нулевую ссылку Object, функция возвращает ноль. Если Object содержит другой тип, то создается исключение.