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