312
правок
Изменения
Материал из Chaotic Onyx
Перейти к навигацииПерейти к поискуНемного перевода
''Это 17-ая глава перевода оригинального руководства по Dream Maker от разработчиков.''
''Это 17-ая глава перевода оригинального руководства по Dream Maker от разработчиков.''
[http://wiki.ss13.ru/index.php?title=All_about_the_code Остальные главы руководства и статьи о программировании на коде BYOND от любителей на русском.]
[[All_about_the_code|Остальные главы руководства и статьи о программировании на коде BYOND от любителей на русском.]]
[http://http://www.byond.com/docs/guide/chap17.html Оригинальная 17-ая глава руководства на английском языке]
[http://www.byond.com/docs/guide/chap17.html Оригинальная 17-ая глава руководства на английском языке]
{{Заготовка|url="[http://www.byond.com/docs/guide/chap17.html ]"}}
{{Заготовка|url="[http://www.byond.com/docs/guide/chap17.html ]"}}
|-
|-
|
|
| Возвращает статус завершения команды Returns the exit status of the command.
| Возвращает статус завершения команды.
|}
|}
====text2file====
====text2file====
''text2file'' instruction is the complement of file2text. It appends a text string to a file. If the file does not exist, it will be created.
''text2file'' дополняет ''file2text''. Она добавляет текстовую строку в файл. Если файл не существует, он будет создан.
{| border="0"
{| border="0"
|-
|-
|
|
| Txt is the text string.
| Txt – текстовая переменная.
|-
|-
|
|
| File is the file to append to.
| File – файл, в который ее нужно добавить.
|}
|}
====file====
====file====
''file'' instruction returns a reference to a file object. The primary use for such an object is with the input/output operators. Outputting a file to a player was discussed in section 11.2.7. It is also possible to send output to a file or get input from a file.
''file'' возвращает ссылку на файл. В основном эта инструкция применяется с операторами ввода/вывода. Вывод файла игроку был обсужден [[DM_Guide_11|в главе 11]]. Кроме того, можно отправлять вывод в файл или получать ввод из файла.
{| border="0"
{| border="0"
|-
|-
|
|
| Path is the name of the file.
| Path – полный путь или имя файла.
|-
|-
|
|
| Returns a reference to the file.
| Возвращает ссылку на файл.
|}
|}
Использование файла в качестве цели для оператора вывода << имеет тот же эффект, как вызов ''text2file ()''.Выходное значение добавляется в файл. Аналогично, чтение данных из файла при помощи оператора >> то же самое, что и ''file2 TXT ()''. Файл загружается в текстовую строку и хранится как указанная переменная.
{| border="0"
{| border="0"
| File << Output
| File << Output
|-
|-
| File >> Variable
| File >> Переменная
|}
|}
====fcopy====
====fcopy====
''fcopy'' instruction copies one file to another. The source file may be a real external file or a file in the cache. If the destination file already exists, it will be replaced.
''fcopy'' копирует один файл в другой. Источник может быть действительным внешним файлом или взят из кэша. Если файл уже существует, то он будет заменен.
{| border="0"
{| border="0"
|-
|-
|
|
| Source is the source file.
| Source – копируемый файл.
|-
|-
|
|
| Dest is the destination file.
| Dest – файл, в который он будет скопирован.
|-
|-
|
|
| Returns 1 on success and 0 on failure.
| Возвращает 1 в случае успеха и 0 в случае ошибки.
|}
|}
====fdel====
====fdel====
''fdel'' instruction deletes a file from the file system.
''fdel'' удалает файл из файловой системы.
{| border="0"
{| border="0"
|-
|-
|
|
| File is the name of the file.
| File – имя файла.
|-
|-
|
|
| Returns 1 on success and 0 on failure.
| Возвращает 1 в случае успеха и 0 в случае ошибки.
|}
|}
Он работает со всеми директориями (так что будьте осторожны, ради бога). В качестве меры предосторожности, он принимает только имена директорий, заканчивающиеся косой чертой "/".
====flist====
====flist====
''flist'' instruction generates a list of files at the specified path in the file system and whose names begin in the specified way.
''flist'' создает список файлов, расположенных в заданной директории, имена которых начинаются с указанных знаков.
{| border="0"
{| border="0"
|-
|-
|
|
| Path is the path to get the listing of.
| Path – путь до директории, список файлов в которой вы хотите получить.
|-
|-
|
|
| Returns a list of files and sub-directories.
| Возвращает список файлов и папок.
|}
|}
Будет приведен только список файлов и папок, находящихся по указанному адресу (т.е. содержимого этих папок в списке не будет). Имена файлов в списке не включают в себя информацию о пути, только имя файла. Папки в списке определяются по символу "/" добавленному к имени.
Путь задается в формате "dir1/dir2/.../file". В списке будут приведены только файлы с именами, совпадающими с "file", так что не забудьте добавить "/" в конце пути, если вы хотите увидеть его содержимое. В противном случае, все, что вы получите, это имя каталога со знаком "/".
===Running other Worlds===
===Запуская другие Миры===
Иногда желательно одному главному миру запускать дочерние миры. Например, у вас может быть основной мир с сайдквестами (подземелья и т.д.), располагающимися в отдельных подмирах. Это может оказаться лучшей оптимизацией, так как редко используемые участки можно активировать только при необходимости.
Предельной формой использования этого метода является сервис хостинга миров, который позволяет пользователям загружать свои собственные файлы мира. Которые затем запускаются и выключаются по мере доступа к ним игроков. Если у вас нет собственного выделенного сетевого соединения, вы можете воспользоваться таким сервисом для хостинга ваших миров.
====startup====
====startup====
''startup'' instruction runs another world. It sleeps until the network address of the new world has been determined.
''startup'' запускает другой мир. Эта инструкция спит пока не будет определен сетевой адрес нового мира.
{| border="0"
{| border="0"
|-
|-
|
|
| File is the dmb file to run.
| File – .dmb файл, который необходимо запустить.
|-
|-
|
|
| Port is the network port to use.
| Port – используемый сетевой порт.
|-
|-
|
|
| Options includes any additional parameters.
| Options включает в себя дополнительные параметры запуска.
|-
|-
|
|
| Returns network address of the new world.
| Возвращает сетевой адрес нового мира.
|}
|}
Сетевой адрес мира состоит из двух частей. Первая, IP адрес машины, на которой он запущен. Вторая, номер порта. Он записывается в текстовую строку вида "ip:port". Указанный порт не должен использоваться любыми другими программами. Стандартное значение – 0 – означает, что может быть использован любой доступный порт.
Дополнительные параметры, которые могут быть указаны, описаны в нижеследующем списке.
*'''-once''' This option automatically shuts down the server when all players have logged off.
*'''-once''' Эта опция автоматически выключает сервер, когда все игроки отключатся.
*'''-log''' This option takes an additional argument which is used as the server's output file. All debugging notices (from proc crashes) and any output sent to world.log is appended to this file. The path to the file is relative to the new server's working directory, which is the location of the .dmb file.
*'''-log''' This option takes an additional argument which is used as the server's output file. All debugging notices (from proc crashes) and any output sent to world.log is appended to this file. The path to the file is relative to the new server's working directory, which is the location of the .dmb file.
*'''-safe''' This option runs the world in a special protective security mode. The world code may only access files in the same directory (or below) as the .dmb file and access to the ''shell'' instruction is disabled. This is the default mode if the world is run from its own safe directory. Such a directory is recognized when it has the same name as the world .dmb file (напр. inferno/inferno.dmb).
*'''-safe''' Эта опция запускает мир в специальном защищенном режиме. Код мира сможет иметь доступ только к файлам в той же директории (и поддиректориях), в которой находится .dmb, а доступ к инструкции ''shell'' запрещен. Это стандартный режим, если мир запускается из его собственной безопасной директории. Such a directory is recognized when it has the same name as the world .dmb file (напр. inferno/inferno.dmb).
*'''-ultrasafe''' This is the same as ''-safe'' except only access to temporary files is allowed. This is the default if the world is not run from its own safe directory.
*'''-ultrasafe''' Эта опция аналогична ''-safe'', за исключениям того что разрешает доступ только ко временным файлам. Это стандартный режим, если мир не запускается из его собственной безопасной директории.
*'''-trusted''' In this mode, all operations are permitted. The world may access files in any directory and may run ''shell'' commands. Of course the operating system may apply restrictions, but BYOND will allow the world to try anything.
*'''-trusted''' В этом моде все операции разрешены. Мир может получать доступ к файлам в любых каталогах и командам ''shell''. Конечно, операционная система может налагать ограничения, но BYOND будет разрешать миру всё.
*'''-params''' The following argument is interpreted as a parameter string as described in [DM_Guide_10|section]. The variable ''world.params'' is initialized from this data. You may use ''params'' multiple times; the individual parameter strings are simply concatenated to form the final result.
*'''-params''' The following argument is interpreted as a parameter string as described in [DM_Guide_10|section]. The variable ''world.params'' is initialized from this data. You may use ''params'' multiple times; the individual parameter strings are simply concatenated to form the final result.
====Control over Child Worlds====
====Control over Child Worlds====
Communication with a child world may be done through ''world.Export()''. In this case, the child world's ''world.Topic()'' procedure is called with a special master flag to indicate that the message came from the world which started it. (See [DM_Guide_8|section] for a review of these procs.)
Communication with a child world may be done through ''world.Export()''. In this case, the child world's ''world.Topic()'' procedure is called with a special master flag to indicate that the message came from the world which started it. (See [[DM_Guide_8|section]] for a review of these procs.)
By default, a child world will respond to the special topics "Del" and "Reboot" by calling ''world.Del()'' and ''world.Reboot()'' respectively. This is only done if the message comes from the master world, since otherwise anyone could send the message and shut your world down.
By default, a child world will respond to the special topics "Del" and "Reboot" by calling ''world.Del()'' and ''world.Reboot()'' respectively. This is only done if the message comes from the master world, since otherwise anyone could send the message and shut your world down.
Another useful topic is "ping", which can be used to determine if a child world is still alive and running.
Another useful topic is "ping", which can be used to determine if a child world is still alive and running.
