Initializing help system before first use

s3objectexists

s3objectexists


Purpose
Checks if an S3 object exists
Synopsis
function s3objectexists(bucket:s3bucket, objectkey:text):boolean
Arguments
bucket 
The s3bucket object describing the bucket to access
objectkey 
The key of the object to check
Return value
true if an object with the given key exists in the bucket, false if it does not.
Example
declarations
  ifexists: boolean
end-declarations
ifexists := s3objectexists(mybucket,"my/file.dat")
if s3status(mybucket)<>S3_OK then
  writeln("Error returned by S3: ",s3getlasterror(mybucket))
  exit(1)
end-if
if ifexists then
  writeln("Object exists")
else
  writeln("Object does not exist")
end-if
Further information
1. After calling, check the value of s3status for any errors.
2. If the s3bucket has a configured keyprefix, it will be prepended to the objectkey passed in.
Related topics