Функция Replace
Возвращает строку, которая является подстрокой строкового выражения, начинающегося с начальной позиции (по умолчанию — 1), в которой указанная подстрока была заменена другой подстрокой указанное количество раз.
Синтаксис
Replace(expression, find, replace, [ start, [ count, [ compare ]]])
Синтаксис функции Replace содержит следующие именованные аргументы:
| Part | Описание |
|---|---|
| выражение | Обязательно. Строковое выражение, содержащее заменяемую подстроку. |
| Найти | Обязательно. Искомая подстрока. |
| Заменить | Обязательно. Подстрока замены. |
| start | Необязательно. Начальная позиция для поиска и возврата подстроки выражения . Если элемент опущен, предполагается, что он равен 1. |
| count | Необязательный параметр. Число выполняемых замен подстроки. Если этот параметр опущен, значение по умолчанию — -1, то есть выполните все возможные подстановки. |
| compare | Необязательно. Числовое значение, указывающее тип сравнения, который будет использоваться при оценке подстрок. Значения см. в разделе "Параметры". |
Параметры
Аргумент compare может принимать следующие значения:
| Константа | Значение | Описание |
|---|---|---|
| vbUseCompareOption | –1 | Выполняет сравнение, используя параметр оператора Option Compare. |
| vbBinaryCompare | 0 | Выполняется двоичное сравнение. |
| vbTextCompare | 1 | Выполняется текстовое сравнение. |
| vbDatabaseCompare | 2 | Только Microsoft Access. Выполняется сравнение на основе сведений из базы данных. |
Возвращаемые значения
Функция Replace возвращает следующие значения:
| Если | Функция "Replace" возвращает |
|---|---|
| Элемент expression имеет нулевую длину | Пустая строка ("") |
| Элемент expression равен Null | Ошибка. |
| Элемент find имеет нулевую длину | Копия expression. |
| Элемент replace имеет нулевую длину | Копия выражения с удаленными вхождениями поиска . |
| Начать>Len(выражение) | Строка нулевой длины. Замена строк начинается с позиции, указанной в начале. |
| Элемент count равен 0 | Копия expression. |
Замечания
Возвращаемое значение функции Replace — это строка с подстановками, которая начинается с позиции, указанной start , и завершается в конце строки выражения . Это не копия исходной строки от начала до конца.
См. также
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.