Процедуры и функции работы со строками

Строкой считается любой набор печатаемых символов. Строки-константы представляют собой набор символов, в кавычках. Например, "это строка".
Работа со строками может пригодится, когда есть возможность проанализировать текст в приложении, либо организовать ввод-вывод информации.

Содержание

INIREAD

Синтаксис

INIREAD ("filename", "parname", ["section"]) - строковая функция; считывает параметр из INI файла


Параметры

filename - имя файла
parname - имя параметра
section - название секции


Пример 

$str = INIREAD("config.ini", "var")
print($str)


Примечания

По умолчанию section имеет значение "default"

INIWRITE

Синтаксис

INIWRITE ("filename", "parname", "value", ["section"]) - записывает параметр в INI файл


Параметры

filename - имя файла
parname - имя параметра
value - значение
section - название секции


Пример 

INIWRITE("config.ini", "var", "23")


Примечания

По умолчанию section имеет значение "default"


STRLEN

Синтаксис

STRLEN ("str") - числовая функция; возвращает длину строки в символах


Параметры

str - входная строка


Пример 

print( strlen("lol") ) // результат "3"

STRCUT

Синтаксис

STRCUT ("str", begin, size) - строковая функция; возвращает кусок строки


Параметры

str - входная строка
begin - позиция начала копирования
size - количество копируемых символов


Пример 

print( strcut("hello2000", 6, 2 ) ) // результат "20"

STRCUT2

Синтаксис

STRCUT2 ("str", begin, end) - строковая функция; возвращает кусок строки


Параметры

str - входная строка
begin - позиция начала копирования
end - позиция конца копирования


Пример 

print( strcut2("hello2000", 2, 5 ) ) // результат "ello"

STRFILTER

Синтаксис

STRFILTER ("str", "set", mode) - строковая функция; возвращает отфильтрованную строку


Параметры

str - входная строка
set - набор символов маски
mode - режим фильтрации

Если режим будет задан как 0, то из входной строки будут вырезаны все символы, указанные в маске
Если режим будет задан как 1, то из входной строки будут вырезаны все символы, кроме указанных в маске


Пример 

print( strfilter("hello2000", "20", 0 ) ) // результат "hello"

print( strfilter("hello2000", "20", 1 ) ) // результат "2000"

STRPOS

Синтаксис

STRPOS ("str", "substr") - числовая функция; возвращает позицию подстроки в строке


Параметры

str - строка
substr - подстрока


Пример 

$search = "mind"
$r = strpos("where is my mind", $search) 
print($r) // результат 13 (с 13 символа начинается подстрока)

STRCONCAT

Синтаксис

STRCONCAT ("str1", "str2", ...) - строковая функция; возвращает объединенную строку


Параметры

str1, str2, ... - входные строки


Пример 

print( StrConcat("hello", "2000", "!!!" ) ) // результат "hello2000!!!"

STRREPLACE

Синтаксис

STRREPLACE ("str", "substr1", "substr2") - строковая функция; возвращает строку str, в которой подстрока str1 заменена на строку str2


Параметры

str - входная строка
str1 - заменяемая подстрока
str2 - заменяющая строка


Пример 

$s = STRREPLACE("Hello, %username%!!!", "%username%", "John")
print($s) // результат "Hello, John!!!"

STRREADLN

Синтаксис

STRREADLN ("file", strn) - строковая функция; считывает строку из файла


Параметры

file - имя файла
strn - номер строки в файле


Пример 

print( StrReadln("input.txt", 5 ) ) // результат (пятая строка из этого файла)

STRWRITELN

Синтаксис

STRWRITELN ("file", "str", [rewrite]) - записывает строку в конец файла


Параметры

file - имя файла
str - строка
rewrite - необязательный параметр; флаг перезаписи


Пример 

// Этот код записывает в файл "out.txt" строки вида "Random:N", где N - случайное число от 1 до 9
StrWriteln("out.txt", StrConcat("Random:", rnd(1,9)) )


Примечания

Если файла с таким именем еще не существует, он будет создан в директории проекта
Если rewrite = 1, то перед записью строки все содержимое файла будет удалено

STRMD5

Синтаксис

STRMD5 ("str") - строковая функция; возвращает md5 хеш для входной строки


Параметры

str - строка


Пример 

print( strmd5("123") ) // 202CB962AC59075B964B07152D234B70

STRSEPARATE

Синтаксис

STRSEPARATE ("str", "substr", $arr) - разбивает строку на подстроки, которые помещаются в массив


Параметры

str - входная строка
substr - строка-разделитель
$arr - выходной массив


Пример 

$str = "one,two,three"
strseparate($str, ",", $arr)
print($arr[1]) // "two"

FROMCLIP

Синтаксис

FROMCLIP () - строковая функция; возвращает строку, находящуюся в буфере обмена Windows


Параметры

отсутствуют


Пример 

// обратите внимание что пустые скобки все равно ставятся
logwrite( FROMCLIP() )

TOCLIP

Синтаксис

TOCLIP ("str") - помещает текст сообщения в буфер обмена


Параметры

str - строка, содержащая текст сообщения

HTTPGET

Синтаксис

HTTPGET ("url", ["headers", ...]) - строковая функция; возвращает результат web-запроса


Параметры

url - запрос
headers - дополнительные заголовки запроса

Пример 

// код вернет последную паблик версию Clickermann (можете проверить в браузере)
$str = httpget("http://crapware.aidf.org/version/clickermann.php")


// тот же запрос, но с добавленным заголовком Referrer
$str = httpget("http://crapware.aidf.org/version/clickermann.php", "Referrer: http://crapware.aidf.org")


print($str)

Примечания

Функция запрашивает данные по протоколу HTTP. Следовательно пока удаленный сервер не ответит (или не истечет таймаут), функция не завершится.
Так же функция может использоваться для отправки командных запросов (запросов с параметрами) удаленному серверу (запросы типа http://somegame.ru/index.php?act=go_to_work&player_id=12345). В любом случае, даже если возвращаемая строка не важна, функция должна вызываться как функция (см. пример)

TFREAD

Синтаксис

TFREAD ("file", str_n) - строковая функция; считывает строку из файла


Параметры

file - имя файла
str_n - номер строки в файле


Пример 

print( TFRead("input.txt", 5 ) )

TFREADARR

Синтаксис

TFREADARR ("file", $arr) - записывает файл в массив


Параметры

file - имя файла
$arr - массив


Пример 

TFReadArr("C:\out.txt", $arr )
print( $arr[0] )
print( $arr[1] )

Примечания

Входной файл считывается построчно, каждая строка помещается в отдельный элемент массива

TFWRITE

Синтаксис

TFWRITE ("file", "str", [str_n]) - записывает строку в файл


Параметры

file - имя файла
str - строка
str_n - необязательный параметр; номер строки в файле


Пример 

TFWrite("input.txt", "Hello" )

Примечания

Новая строка записывается в файл на позицию str_n. При этом все строки (включая ту, которая была ранее на этой позиции) сдвигаются вниз. Если параметр str_n не задан, то новая строка добавляется в конец файла.

TFWRITEARR

Синтаксис

TFWRITEARR ("file", $arr) - записывает массив в файл


Параметры

file - имя файла
$arr - массив


Пример 

$arr[0] = "one"
$arr[1] = "two"
TFWriteArr("C:\out.txt", $arr )

Примечания

Выходной файл формируется построчно, каждый элемент массива будет помещен в отдельную строку текстового файла

TFDELETE

Синтаксис

TFDELETE ("file", str_n) - удаляет строку из файла


Параметры

file - имя файла
str_n - номер строки в файле


Пример 

TFDelete("input.txt", 2)

Примечания

При удалении все строки ниже удаляемой сдвигаются вверх.

TFCLEAR

Синтаксис

TFCLEAR ("file", [flag]) - очищает файл


Параметры

file - имя файла
flag - необязательный параметр; флаг удаления файла


Пример 

TFClear("input.txt")

Примечания

Если параметр flag = 1, то файл удаляется с жесткого диска, если нет, то просто очищается

TFCOUNT

Синтаксис

TFCOUNT ("file") - числовая функция; возвращает кол-во строк в файле


Параметры

file - имя файла


Пример 

print ( TFCount("input.txt") )