Bcopy - Revision history

Vliedel at 18:55, 13 October 2006

2006-10-13T18:55:10Z

← Older revision		Revision as of 18:55, 13 October 2006
Line 7:		Line 7:

	The ''-z'' switch will zero fill all bytes in ''&source'' that were copied.		The ''-z'' switch will zero fill all bytes in ''&source'' that were copied.

	The ''-c'' switch will chop ''&copy'' to ''N'' + ''M'' bytes.		The ''-c'' switch will chop ''&copy'' to ''N'' + ''M'' bytes.

Vliedel at 18:35, 13 October 2006

2006-10-13T18:35:05Z

← Older revision		Revision as of 18:35, 13 October 2006
Line 1:		Line 1:
	The bcopy command is used to copy a (part of a) [[:Category:Binary Files\|binary file]].		The bcopy command is used to copy a (part of a) [[:Category:Binary Files\|binary file]].
	<nowiki>bcopy [-zc] <&copy> <N> <&source> <S> <M></nowiki>		<nowiki>bcopy [-zc] <&copy> <N> <&source> <S> <M></nowiki>
	This copies M bytes from &source starting at position S to &copy starting at position N.		This copies ''M'' bytes from ''&source'' starting at position ''S'' to ''&copy'' starting at position ''N''.
	If &copy doesn't exist yet, the binary file will be created and zero filled to the ~~Nth~~ byte. If &copy already exists but smaller then N bytes, it will be extended with zeros to the ~~Nth~~ byte. If &copy already exists and is N bytes or larger, the copied bytes will overwrite the old bytes in &copy.		If ''&copy'' doesn't exist yet, the binary file will be created and zero filled to the ''N''th byte. If ''&copy'' already exists but smaller then ''N'' bytes, it will be extended with zeros to the ''N''th byte. If ''&copy'' already exists and is ''N'' bytes or larger, the copied bytes will overwrite the old bytes in ''&copy''.
	If &source is smaller then S + M - 1 bytes and &source is equal or larger then S bytes, then all bytes starting from S to the last byte will be copied. If &source is smaller then S bytes, you will get an error.		If ''&source'' is smaller then ''S'' + ''M'' - 1 bytes and ''&source'' is equal or larger then ''S'' bytes, then all bytes starting from ''S'' to the last byte will be copied. If ''&source'' is smaller then ''S'' bytes, you will get an error.
	You can use M = -1 to copy all bytes starting from byte S to the last byte.		You can use ''M'' = -1 to copy all bytes starting from byte ''S'' to the last byte.

	The -z switch will zero fill all bytes in &source that were copied.		The ''-z'' switch will zero fill all bytes in ''&source'' that were copied.
	The -c switch will chop &copy to N + M bytes.		The ''-c'' switch will chop ''&copy'' to ''N'' + ''M'' bytes.

	== Examples ==		== Examples ==

Vliedel at 18:28, 13 October 2006

2006-10-13T18:28:17Z

← Older revision		Revision as of 18:28, 13 October 2006
Line 12:		Line 12:
	[[bset]] &data 1 65 66 67 68 69		[[bset]] &data 1 65 66 67 68 69
	bcopy &test 1 &data 3 2		bcopy &test 1 &data 3 2
	[[echo]] -a [[$bvar]](&test,1,$bvar(&test,0))		[[echo]] -a [[$bvar]](&test,1,$bvar(&test,0)) returns ''67 68''
	''67 68''
	This will copy the values 67 68 from &data to the first position of &test.		This will copy the values 67 68 from &data to the first position of &test.

Line 19:		Line 18:
	bset &test 1 97		bset &test 1 97
	bcopy &test 5 &data 4 -1		bcopy &test 5 &data 4 -1
	echo -a $bvar(&test,1,$bvar(&test,0))		echo -a $bvar(&test,1,$bvar(&test,0)) returns ''97 0 0 0 68 69''
	''97 0 0 0 68 69''
	This will copy values 68 69 from &data to the fifth postion of &test. Positions 2-4 of &test will be zero filled.		This will copy values 68 69 from &data to the fifth postion of &test. Positions 2-4 of &test will be zero filled.

Line 26:		Line 24:
	bset &test 1 97 98 99 100		bset &test 1 97 98 99 100
	bcopy -z &test 2 &data 3 2		bcopy -z &test 2 &data 3 2
	echo -a $bvar(&data,1,$bvar(&data,0))		echo -a $bvar(&data,1,$bvar(&data,0)) returns ''65 66 0 0 69''
	''65 66 0 0 69''		echo -a $bvar(&test,1,$bvar(&test,0)) returns ''97 67 68 100''
	echo -a $bvar(&test,1,$bvar(&test,0))
	''97 67 68 100''
	This will copy values 67 68 from &data to the second position of &test. The -z switch will replace the copied values 67 68 of &data to zeros. Notice that values 98 99 will be overwritten.		This will copy values 67 68 from &data to the second position of &test. The -z switch will replace the copied values 67 68 of &data to zeros. Notice that values 98 99 will be overwritten.

Line 35:		Line 31:
	bset &test 1 97 98 99 100		bset &test 1 97 98 99 100
	bcopy -c &test 2 &data 3 2		bcopy -c &test 2 &data 3 2
	echo -a $bvar(&test,1,$bvar(&test,0))		echo -a $bvar(&test,1,$bvar(&test,0)) returns ''97 67 68''
	''97 67 68''
	This will copy values 67 68 from &data to the second position of &test. The -c switch will chop value 100.		This will copy values 67 68 from &data to the second position of &test. The -c switch will chop value 100.

	[[Category:Binary Files]]		[[Category:Binary Files]]
	[[Category:Commands]]		[[Category:Commands]]

Vliedel at 17:56, 13 October 2006

2006-10-13T17:56:53Z

← Older revision		Revision as of 17:56, 13 October 2006
Line 38:		Line 38:
	''97 67 68''		''97 67 68''
	This will copy values 67 68 from &data to the second position of &test. The -c switch will chop value 100.		This will copy values 67 68 from &data to the second position of &test. The -c switch will chop value 100.

			[[Category:Binary Files]]
			[[Category:Commands]]

Vliedel at 17:55, 13 October 2006

2006-10-13T17:55:10Z

← Older revision		Revision as of 17:55, 13 October 2006
Line 25:		Line 25:
	bset &data 1 65 66 67 68 69		bset &data 1 65 66 67 68 69
	bset &test 1 97 98 99 100		bset &test 1 97 98 99 100
	bcopy -z &test 2 &data 4 2		bcopy -z &test 2 &data 3 2
	echo -a $bvar(&data,1,$bvar(&data,0))		echo -a $bvar(&data,1,$bvar(&data,0))
	''65 66 67 0 0''		''65 66 0 0 69''
	echo -a $bvar(&test,1,$bvar(&test,0))		echo -a $bvar(&test,1,$bvar(&test,0))
	''97 68 69 100''		''97 67 68 100''
	This will copy values 68 69 from &data to the second position of &test. The -z switch will ~~zero fill~~ the copied values 68 69 of &data. Notice that values 98 99 will be overwritten.		This will copy values 67 68 from &data to the second position of &test. The -z switch will replace the copied values 67 68 of &data to zeros. Notice that values 98 99 will be overwritten.

	bset &data 1 65 66 67 68 69		bset &data 1 65 66 67 68 69

Vliedel at 17:50, 13 October 2006

2006-10-13T17:50:15Z

← Older revision		Revision as of 17:50, 13 October 2006
Line 13:		Line 13:
	bcopy &test 1 &data 3 2		bcopy &test 1 &data 3 2
	[[echo]] -a [[$bvar]](&test,1,$bvar(&test,0))		[[echo]] -a [[$bvar]](&test,1,$bvar(&test,0))
			''67 68''
	This will copy the values 67 68 from &data to the first position of &test.		This will copy the values 67 68 from &data to the first position of &test.

Line 19:		Line 20:
	bcopy &test 5 &data 4 -1		bcopy &test 5 &data 4 -1
	echo -a $bvar(&test,1,$bvar(&test,0))		echo -a $bvar(&test,1,$bvar(&test,0))
	This will copy values 68 69 from &data to the fifth postion of &test. Positions 2-4 of &test will be zero filled. ~~The echo will return: 97 0 0 0 68 69~~		''97 0 0 0 68 69''
			This will copy values 68 69 from &data to the fifth postion of &test. Positions 2-4 of &test will be zero filled.

	bset &data 1 65 66 67 68 69		bset &data 1 65 66 67 68 69
Line 25:		Line 27:
	bcopy -z &test 2 &data 4 2		bcopy -z &test 2 &data 4 2
	echo -a $bvar(&data,1,$bvar(&data,0))		echo -a $bvar(&data,1,$bvar(&data,0))
			''65 66 67 0 0''
	echo -a $bvar(&test,1,$bvar(&test,0))		echo -a $bvar(&test,1,$bvar(&test,0))
	This will copy values 68 69 from &data to the second position of &test. The -z switch will zero fill the copied values 68 69 of &data. Notice that values 98 99 will be overwritten. ~~The first echo will return: 65 66 67 0 0. The second echo will return: 97 68 69 100~~		''97 68 69 100''
			This will copy values 68 69 from &data to the second position of &test. The -z switch will zero fill the copied values 68 69 of &data. Notice that values 98 99 will be overwritten.

	bset &data 1 65 66 67 68 69		bset &data 1 65 66 67 68 69
Line 32:		Line 36:
	bcopy -c &test 2 &data 3 2		bcopy -c &test 2 &data 3 2
	echo -a $bvar(&test,1,$bvar(&test,0))		echo -a $bvar(&test,1,$bvar(&test,0))
	This will copy values 67 68 from &data to the second position of &test. The -c switch will chop value 100. ~~The echo will return: 97 67 68~~		''97 67 68''
			This will copy values 67 68 from &data to the second position of &test. The -c switch will chop value 100.

Vliedel at 17:37, 13 October 2006

2006-10-13T17:37:15Z

← Older revision		Revision as of 17:37, 13 October 2006
Line 17:		Line 17:
	bset &data 1 65 66 67 68 69		bset &data 1 65 66 67 68 69
	bset &test 1 97		bset &test 1 97
	bcopy &test 4 &data ~~5 2~~		bcopy &test 5 &data 4 -1
	echo -a $bvar(&test,1,$bvar(&test,0))		echo -a $bvar(&test,1,$bvar(&test,0))
	This will copy ~~value~~ 69 from &data to the ~~fourth~~ postion of &test. ~~Position~~ 2 ~~and 3~~ of &test will be zero filled. The echo will return: 97 0 0 69		This will copy values 68 69 from &data to the fifth postion of &test. Positions 2-4 of &test will be zero filled. The echo will return: 97 0 0 0 68 69

	bset &data 1 65 66 67 68 69		bset &data 1 65 66 67 68 69
	bset &test 1 97 98 99 100		bset &test 1 97 98 99 100
	bcopy &test 2 &data 4 2		bcopy -z &test 2 &data 4 2
			echo -a $bvar(&data,1,$bvar(&data,0))
	echo -a $bvar(&test,1,$bvar(&test,0))		echo -a $bvar(&test,1,$bvar(&test,0))
	This will copy values 68 69 from &data to the second position of &test. Notice that values 98 99 will be overwritten. The echo will return: 97 68 69 100		This will copy values 68 69 from &data to the second position of &test. The -z switch will zero fill the copied values 68 69 of &data. Notice that values 98 99 will be overwritten. The first echo will return: 65 66 67 0 0. The second echo will return: 97 68 69 100

			bset &data 1 65 66 67 68 69
			bset &test 1 97 98 99 100
			bcopy -c &test 2 &data 3 2
			echo -a $bvar(&test,1,$bvar(&test,0))
			This will copy values 67 68 from &data to the second position of &test. The -c switch will chop value 100. The echo will return: 97 67 68

Vliedel at 16:16, 13 October 2006

2006-10-13T16:16:37Z

← Older revision		Revision as of 16:16, 13 October 2006
Line 10:		Line 10:

	== Examples ==		== Examples ==
	[[bset]] &data 65 66 67 68 69		[[bset]] &data 1 65 66 67 68 69
	bcopy &test 1 &data 3 2		bcopy &test 1 &data 3 2
	[[echo]] -a $bvar(&test,1,$bvar(&test,0))		[[echo]] -a [[$bvar]](&test,1,$bvar(&test,0))
	This will copy the values 67 68 from &data to &test.		This will copy the values 67 68 from &data to the first position of &test.

			bset &data 1 65 66 67 68 69
			bset &test 1 97
			bcopy &test 4 &data 5 2
			echo -a $bvar(&test,1,$bvar(&test,0))
			This will copy value 69 from &data to the fourth postion of &test. Position 2 and 3 of &test will be zero filled. The echo will return: 97 0 0 69

			bset &data 1 65 66 67 68 69
			bset &test 1 97 98 99 100
			bcopy &test 2 &data 4 2
			echo -a $bvar(&test,1,$bvar(&test,0))
			This will copy values 68 69 from &data to the second position of &test. Notice that values 98 99 will be overwritten. The echo will return: 97 68 69 100

Vliedel at 16:04, 13 October 2006

2006-10-13T16:04:55Z

← Older revision		Revision as of 16:04, 13 October 2006
Line 8:		Line 8:
	The -z switch will zero fill all bytes in &source that were copied.		The -z switch will zero fill all bytes in &source that were copied.
	The -c switch will chop &copy to N + M bytes.		The -c switch will chop &copy to N + M bytes.

			== Examples ==
			[[bset]] &data 65 66 67 68 69
			bcopy &test 1 &data 3 2
			[[echo]] -a $bvar(&test,1,$bvar(&test,0))
			This will copy the values 67 68 from &data to &test.

Cail: corrected binary files-link

2006-09-29T08:42:25Z

corrected binary files-link

← Older revision		Revision as of 08:42, 29 September 2006
Line 1:		Line 1:
	The bcopy command is used to copy a (part of a) [[Binary Files\|binary file]].		The bcopy command is used to copy a (part of a) [[:Category:Binary Files\|binary file]].
	<nowiki>bcopy [-zc] <&copy> <N> <&source> <S> <M></nowiki>		<nowiki>bcopy [-zc] <&copy> <N> <&source> <S> <M></nowiki>
	This copies M bytes from &source starting at position S to &copy starting at position N.		This copies M bytes from &source starting at position S to &copy starting at position N.