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