PT-BR/fileCreate - Revision history

Lettify at 17:26, 20 December 2023

2023-12-20T17:26:36Z

← Older revision		Revision as of 17:26, 20 December 2023
Line 23:		Line 23:

	===Retorno===		===Retorno===
	Se tiver tido sucesso na execução, retorna um '''arquivo''' que poderá ser usado com outras funções do tipo ([[PT-BR/fileWrite\|fileWrite]], [[PT-BR/fileClose:fileClose]]...). E retorna '''false''' se algum erro tiver ocorrido.		Se tiver tido sucesso na execução, retorna um '''arquivo''' que poderá ser usado com outras funções do tipo ([[PT-BR/fileWrite\|fileWrite]], [[PT-BR/fileClose\|fileClose]]...). E retorna '''false''' se algum erro tiver ocorrido.

	==Exemplo==		==Exemplo==

Lettify at 17:26, 20 December 2023

2023-12-20T17:26:20Z

← Older revision		Revision as of 17:26, 20 December 2023
Line 3:		Line 3:

	Cria um novo arquivo em um diretório do resource. Se já existir algum arquivo com o nome e caminho especificado, então haverá uma substituição para este novo arquivo vazio criado.		Cria um novo arquivo em um diretório do resource. Se já existir algum arquivo com o nome e caminho especificado, então haverá uma substituição para este novo arquivo vazio criado.
	{{BR/Nota\|Para prevenir perdas de memória, certifique que está fechando o arquivo com [[PT-BR/fileClose:fileClose]] depois de aberto e trabalhado com esse arquivo.}}		{{BR/Nota\|Para prevenir perdas de memória, certifique que está fechando o arquivo com [[PT-BR/fileClose\|fileClose]] depois de aberto e trabalhado com esse arquivo.}}
	{{BR/Nota\|As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos de configuração. É recomendado usar as [[Shared_Scripting_Functions#XML_functions\|funções XML]].}}		{{BR/Nota\|As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos de configuração. É recomendado usar as [[Shared_Scripting_Functions#XML_functions\|funções XML]].}}
	{{BR/Tip\|Se você não quiser compartilhar o conteúdo do arquivo criado com outros servidores, nomeie o caminho do arquivo com '''@''' no início. Veja a página [[filepath]] para entender melhor.}}		{{BR/Tip\|Se você não quiser compartilhar o conteúdo do arquivo criado com outros servidores, nomeie o caminho do arquivo com '''@''' no início. Veja a página [[filepath]] para entender melhor.}}

Lettify at 17:22, 20 December 2023

2023-12-20T17:22:25Z

← Older revision		Revision as of 17:22, 20 December 2023
Line 3:		Line 3:

	Cria um novo arquivo em um diretório do resource. Se já existir algum arquivo com o nome e caminho especificado, então haverá uma substituição para este novo arquivo vazio criado.		Cria um novo arquivo em um diretório do resource. Se já existir algum arquivo com o nome e caminho especificado, então haverá uma substituição para este novo arquivo vazio criado.
	{{BR/Nota\|Para prevenir perdas de memória, certifique que está fechando o arquivo com [[fileClose]] depois de aberto e trabalhado com esse arquivo.}}		{{BR/Nota\|Para prevenir perdas de memória, certifique que está fechando o arquivo com [[PT-BR/fileClose:fileClose]] depois de aberto e trabalhado com esse arquivo.}}
	{{BR/Nota\|As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos de configuração. É recomendado usar as [[Shared_Scripting_Functions#XML_functions\|funções XML]].}}		{{BR/Nota\|As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos de configuração. É recomendado usar as [[Shared_Scripting_Functions#XML_functions\|funções XML]].}}
	{{BR/Tip\|Se você não quiser compartilhar o conteúdo do arquivo criado com outros servidores, nomeie o caminho do arquivo com '''@''' no início. Veja a página [[filepath]] para entender melhor.}}		{{BR/Tip\|Se você não quiser compartilhar o conteúdo do arquivo criado com outros servidores, nomeie o caminho do arquivo com '''@''' no início. Veja a página [[filepath]] para entender melhor.}}
Line 23:		Line 23:

	===Retorno===		===Retorno===
	Se tiver tido sucesso na execução, retorna um '''arquivo''' que poderá ser usado com outras funções do tipo ([[fileWrite]], [[fileClose]]...). E retorna '''false''' se algum erro tiver ocorrido.		Se tiver tido sucesso na execução, retorna um '''arquivo''' que poderá ser usado com outras funções do tipo ([[PT-BR/fileWrite\|fileWrite]], [[PT-BR/fileClose:fileClose]]...). E retorna '''false''' se algum erro tiver ocorrido.

	==Exemplo==		==Exemplo==
Line 35:		Line 35:
	</syntaxhighlight>		</syntaxhighlight>

	Observe que você não pode simplesmente fazer isso <code>fileWrite("test.txt", "File content")</code>. Em vez disso, as funções que manipulam os arquivos operam na variável '''arquivo''', que é um tipo de ''objeto especial'' representando um arquivo aberto. A função [[fileCreate]] cria um arquivo, abre ele e retorna o resultado deste arquivo.		Observe que você não pode simplesmente fazer isso <code>fileWrite("test.txt", "File content")</code>. Em vez disso, as funções que manipulam os arquivos operam na variável '''arquivo''', que é um tipo de ''objeto especial'' representando um arquivo aberto. A função [[PT-BR/fileCreate\|fileCreate]] cria um arquivo, abre ele e retorna o resultado deste arquivo.

	E também é importante lembrar de fechar um arquivo depois que você finalizar tudo o que precisa fazer nele, especialmente se você está definindo ou escrevendo novos valores nesse arquivo. Se você não fechar o arquivo e o resource travar de alguma forma, todas as mudanças no arquivo podem ser perdidas.		E também é importante lembrar de fechar um arquivo depois que você finalizar tudo o que precisa fazer nele, especialmente se você está definindo ou escrevendo novos valores nesse arquivo. Se você não fechar o arquivo e o resource travar de alguma forma, todas as mudanças no arquivo podem ser perdidas.

Lettify: Created page with "NOTOC {{BR/Funcao compartilhada}} Cria um novo arquivo em um diretório do resource. Se já existir algum arquivo com o nome e caminho especificado, então haverá uma substituição para este novo arquivo vazio criado. {{BR/Nota|Para prevenir perdas de memória, certifique que está fechando o arquivo com fileClose depois de aberto e trabalhado com esse arquivo.}} {{BR/Nota|As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos..."

2023-12-20T17:13:50Z

Created page with "__NOTOC__ {{BR/Funcao compartilhada}} Cria um novo arquivo em um diretório do resource. Se já existir algum arquivo com o nome e caminho especificado, então haverá uma substituição para este novo arquivo vazio criado. {{BR/Nota|Para prevenir perdas de memória, certifique que está fechando o arquivo com fileClose depois de aberto e trabalhado com esse arquivo.}} {{BR/Nota|As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos..."

New page

__NOTOC__
{{BR/Funcao compartilhada}}

Cria um novo arquivo em um diretório do resource. Se já existir algum arquivo com o nome e caminho especificado, então haverá uma substituição para este novo arquivo vazio criado.
{{BR/Nota|Para prevenir perdas de memória, certifique que está fechando o arquivo com [[fileClose]] depois de aberto e trabalhado com esse arquivo.}}
{{BR/Nota|As funções que manipulam arquivos não devem ser utilizadas para implementar arquivos de configuração. É recomendado usar as [[Shared_Scripting_Functions#XML_functions|funções XML]].}}
{{BR/Tip|Se você não quiser compartilhar o conteúdo do arquivo criado com outros servidores, nomeie o caminho do arquivo com '''@''' no início. Veja a página [[filepath]] para entender melhor.}}

==Sintaxe==
<syntaxhighlight lang="lua">
file fileCreate ( string filePath )
</syntaxhighlight>
{{PT-BR/POO|Esta é uma função estática abaixo da classe File.|[[File]].new}}

{{PT-BR/New feature/item|9.0156|1.5.6|11865|
{{PT-BR/POO|Esta é uma função estática abaixo da classe File. Se usar '''File(...)''' para abrir um arquivo e esse mesmo não existir, então a função tentará criar um novo arquivo.|[[File]].new}}
|RU}}

===Argumentos necessários===
*'''filePath:''' O [[filepath|caminho]] do arquivo a ser criado seguindo o seguinte formato: '''":resourceName/path"'''. '''resourceName''' é o nome do resource do arquivo que vai estar lá, e '''path''' é o caminho do arquivo relativo ao diretório do resource.
:Por exemplo, se você quiser criar um arquivo chamado 'meuarquivo.txt' no resource 'mapcreato', isso poderá ser criado de um outro resource desta forma: ''fileCreate(":mapcreator/meuarquivo.txt")''
:Já se o arquivo estiver no resource atual, apenas o caminho é necessário, ex.: ''fileCreate("meuarquivo.txt")''

===Retorno===
Se tiver tido sucesso na execução, retorna um '''arquivo''' que poderá ser usado com outras funções do tipo ([[fileWrite]], [[fileClose]]...). E retorna '''false''' se algum erro tiver ocorrido.

==Exemplo==
Este exemplo cria um arquivo de texto no resource atual e escreve um pequeno texto nele.
<syntaxhighlight lang="lua">
local newFile = fileCreate("test.txt") -- tenta criar um novo arquivo
if (newFile) then -- verifica se a criação foi um sucesso
fileWrite(newFile, "This is a test file!") -- escreve uma linha de texto
fileClose(newFile) -- fecha o arquivo assim que terminar de trabalhar nele
end
</syntaxhighlight>

Observe que você não pode simplesmente fazer isso <code>fileWrite("test.txt", "File content")</code>. Em vez disso, as funções que manipulam os arquivos operam na variável '''arquivo''', que é um tipo de ''objeto especial'' representando um arquivo aberto. A função [[fileCreate]] cria um arquivo, abre ele e retorna o resultado deste arquivo.

E também é importante lembrar de fechar um arquivo depois que você finalizar tudo o que precisa fazer nele, especialmente se você está definindo ou escrevendo novos valores nesse arquivo. Se você não fechar o arquivo e o resource travar de alguma forma, todas as mudanças no arquivo podem ser perdidas.
Se o arquivo já existir, um novo vai ser criado no lugar.

==Veja também==
{{PT-BR/File functions}}