Справка по программе NHRPLC - замена текста в файлах

(Версия 2.0.0)

Описание
Запуск программы
Замена текста
Преобразование кодовой страницы
Особенности программы
Кодовые страницы
Коды возврата
Версии программы

Описание

Программа NHRPLC обрабатывает текстовые файлы: заменяет текст, а также может преобразовывать кодовую страницу. Поддерживает регулярные выражения. Может подставлять как строку, так и текст из файла.

Программа NHRPLC предназначена для использования командными файлами, скриптами, другими программами - все параметры задаются в командной строке.

Запуск программы

Замена текста

nhrplc.exe -s:<строка поиска> [-i] {-t:<строка замены>|-f:<файл замены>[,<кодовая стр.>]} [-cp:<кодовая страница>[,<кодовая стр.>]] <маска>...

  -s:<строка поиска>      
                    Задает строку для поиска. Может быть регулярным выражением.

  -i                Отключает проверку регистра. 
  
  -t:<строка поиска>
                    Задает строку для замены (нельзя задавать одновременно с -f).
  
  -f:<файл>[,<кодовая стр.>]
    <файл>          Задает имя файла с замещающим текстом (нельзя задавать 
	            одновременно с -t). Если путь/имя файла содержит пробелы, необходимо
                    заключить его в кавычки.
    <кодовая стр.>  Задает кодовую страницу файла с замещающим текстом, возможные значения:
                    auto|ansi|oem|unicode. По умолчанию используется значение auto.
					
  -cp:[-cp:<кодовая стр.>[,<кодовая стр.>]]
                    Задаёт исходную и результирующую кодовые страницы файла, 
                    возможные значения: auto|ansi|oem|unicode. 
                    По умолчанию используется значение auto.
					
  <маска>...        Один или несколько файлов, также можно указывать маски с символами * и ?
                    Если в пути или имени файла есть пробелы, необходимо заключать в кавычки.

Преобразование кодовой страницы

nhrplc.exe -cp:<кодовая страница>[,<кодовая стр.>] <маска>...

  -cp:[-cp:<кодовая стр.>[,<кодовая стр.>]]
                    Задаёт кодовые страницы исходного и результирующего файла, 
                    возможные значения: auto|ansi|oem|unicode. 
                    По умолчанию используется значение auto.
					
  <маска>...        Один или несколько файлов, также можно указывать маски с символами * и ?
                    Если в пути или имени файла есть пробелы, необходимо заключать в кавычки.

Краткую справку по программе можно посмотреть, запустив ее с параметром /?.

Особенности программы

Кодовые страницы

Программа поддерживает работу с кодировками ANSI, OEM, Unicode.

Программа может обрабатывать Unicode файлы с BOM (Byte Order Mark) или без BOM, запись Unicode файлов производится с BOM.

Режим auto для существующего файла (исходный текстовый файл или файл замены) означает, что программа сама определяет кодировку файла. При этом программа проверяет, является ли файл Unicode. Если нет, то файл считается ANSI. Автоматическое определение кодировки OEM в программе невозможно.

Режим auto для выходной кодировки означает, что результирующая кодировка будет такой же, как у исходного файла.

Коды возврата

Программа сообщает результат выполнения в коде завершения (errorlevel).
Наиболее типичные возвращаемые коды:
  0                 Файлы обработаны. Если была задана замена текста, то было
                    найдено, по крайней мере, одно вхождение строки поиска.

  1                 Файлы проверены, не найдено ни одного вхождения строки поиска.
                    
  2                 Ошибка: нет доступа к файлу и т.п.

Версии программы

Версия 2.0.0

Версия 1.0.2


Это описание относится к программе nhrplc версии 2.0.0. Примеры использования и обновления находятся на странице программы и на форуме программы.

Программа проверена под Windows XP SP3.