Повертає значення типу String, у якому зазначений вкладений рядок замінено на інший вкладений рядок указану кількість разів.
Синтаксис
Replace(expression, find, replace [, start ] [, count ] [, compare ] )
Синтаксис функції Replace має такі аргументи:
| Аргумент | Опис |
|---|---|
| expression | Обов’язковий аргумент. Рядковий вираз із вкладеним рядком, який потрібно замінити. |
| find | Обов’язковий аргумент. Вкладений рядок, який потрібно знайти. |
| replace | Обов’язковий аргумент. Вкладений рядок на заміну. |
| start | — необов’язковий аргумент. Розташування у виразі , з якого має починатися пошук вкладеного рядка. Якщо цей аргумент пропущено, приймається значення 1. |
| count | Необов’язковий аргумент. Кількість замін вкладеного рядка, які потрібно зробити. Якщо цей аргумент пропущено, приймається його стандартне значення –1 (потрібно виконати всі можливі заміни). |
| compare | — необов’язковий аргумент. Числове значення, яке вказує тип порівняння, який слід використовувати під час обчислення підрядків. Значення див. в розділі Настройки. |
Параметри
Аргумент compare може мати такі значення:
| Константа | Значення | Опис |
|---|---|---|
| vbUseCompareOption | –1 | Виконує порівняння за допомогою параметра оператора Option Compare. |
| vbBinaryCompare | 0 | Виконує двійкове порівняння. |
| vbTextCompare | 1 | Виконує текстове порівняння. |
| vbDatabaseCompare | 2 | Лише Microsoft Office Access 2007. Виконує порівняння на основі відомостей у базі даних. |
Значення, що повертаються
Функція Replace повертає такі значення:
| Умова | Значення, що повертається |
|---|---|
| вираз має нульову довжину | Рядок нульової довжини ("") |
| виразмає Null-значення | Помилка. |
| find is zero-length | Копія виразу. |
| replace is zero-length | Копію виразу з усіма екземплярами пошуку видалено. |
| Почати>Len(вираз) | Рядок нульової довжини. Заміна рядка починається з позиції, яку позначено початковим екраном. |
| кількість : 0 | Копія виразу. |
Примітки
Повернуте значення функції Replace – це рядок із виконаними замінами, який починається з позиції, указаної на початку , і завершується в кінці рядка виразу . Це не копія вихідного рядка від початку до кінця.
Приклад
| Вираз | Результати. |
|---|---|
| SELECT ProductID, Replace(ProductID;"PRO","Продукт") AS ReplaceID FROM ProductSales; | Повертає "Ідентифікатор товару", знаходить "PRO" в "ProductID" і замінює "Продукт" і відображає результат у стовпці ReplaceID. |