1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/kernelhwsrv/userlibandfileserver/fileserver/inc/f32file64.inl Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,562 @@
1.4 +// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
1.5 +// All rights reserved.
1.6 +// This component and the accompanying materials are made available
1.7 +// under the terms of the License "Eclipse Public License v1.0"
1.8 +// which accompanies this distribution, and is available
1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.10 +//
1.11 +// Initial Contributors:
1.12 +// Nokia Corporation - initial contribution.
1.13 +//
1.14 +// Contributors:
1.15 +//
1.16 +// Description:
1.17 +// f32\inc\f32file64.inl
1.18 +//
1.19 +//
1.20 +
1.21 +/**
1.22 +
1.23 + Reads from the file at the current position.
1.24 +
1.25 + This is a synchronous function.
1.26 +
1.27 + Note that when an attempt is made to read beyond the end of the file,
1.28 + no error is returned.
1.29 + The descriptor's length is set to the number of bytes read into
1.30 + it. Therefore, when reading through a file,the end of file has been reached
1.31 + when the descriptor length, as returned by TDesC8::Length(), is zero.
1.32 +
1.33 + @param aDes Descriptor into which binary data is read. Any existing contents
1.34 + are overwritten. On return, its length is set to the number of
1.35 + bytes read.
1.36 + @return KErrNone if successful, otherwise one of the other system-wide error
1.37 + codes.
1.38 +
1.39 + @see TDesC8::Length
1.40 +*/
1.41 +inline TInt RFile64::Read(TDes8& aDes) const
1.42 + {return RFile::Read(aDes);}
1.43 +
1.44 +/**
1.45 +Reads from the file at the current position.
1.46 +
1.47 +This is an asynchronous function.
1.48 +
1.49 +Note that when an attempt is made to read beyond the end of the file,
1.50 +no error is returned.
1.51 +The descriptor's length is set to the number of bytes read into
1.52 +it. Therefore, when reading through a file,the end of file has been reached
1.53 +when the descriptor length, as returned by TDesC8::Length(), is zero.
1.54 +
1.55 +@param aDes Descriptor into which binary data is read. Any existing contents
1.56 + are overwritten. On return, its length is set to the number of
1.57 + bytes read.
1.58 + NB: this function is asynchronous and the request that it
1.59 + represents may not complete until some time after the call
1.60 + to the function has returned. It is important, therefore, that
1.61 + this descriptor remain valid, or remain in scope, until you have
1.62 + been notified that the request is complete.
1.63 +
1.64 +@param aStatus Request status. On completion contains:
1.65 + KErrNone, if successful, otherwise one of the other system-wide error codes.
1.66 +
1.67 +@see TDesC8::Length
1.68 +*/
1.69 +inline void RFile64::Read(TDes8& aDes,TRequestStatus& aStatus) const
1.70 + {RFile::Read(aDes, aStatus);}
1.71 +
1.72 +/**
1.73 +Reads the specified number of bytes of binary data from the file at the current position.
1.74 +
1.75 +This is a synchronous function.
1.76 +
1.77 +Note that when an attempt is made to read beyond the end of the file,
1.78 +no error is returned.
1.79 +The descriptor's length is set to the number of bytes read into
1.80 +it. Therefore, when reading through a file,the end of file has been reached
1.81 +when the descriptor length, as returned by TDesC8::Length(), is zero.
1.82 +Assuming aLength is less than the maximum length of the descriptor, the only circumstance
1.83 +in which Read() can return fewer bytes than requested, is when the end of
1.84 +file is reached or if an error occurs.
1.85 +
1.86 +@param aDes Descriptor into which binary data is read. Any existing
1.87 + contents are overwritten. On return, its length is set to
1.88 + the number of bytes read.
1.89 +
1.90 +@param aLength The number of bytes to be read from the file into the descriptor.
1.91 + If an attempt is made to read more bytes than the descriptor's
1.92 + maximum length, the function returns KErrOverflow.
1.93 + This value must not be negative, otherwise the function
1.94 + returns KErrArgument.
1.95 +
1.96 +@return KErrNone if successful, otherwise one of the other system-wide error
1.97 + codes.
1.98 +*/
1.99 +inline TInt RFile64::Read(TDes8& aDes,TInt aLength) const
1.100 + {return RFile::Read(aDes, aLength);}
1.101 +
1.102 +/**
1.103 +Reads a specified number of bytes of binary data from the file at the current position.
1.104 +
1.105 +This is an asynchronous function.
1.106 +
1.107 +Note that when an attempt is made to read beyond the end of the file,
1.108 +no error is returned.
1.109 +The descriptor's length is set to the number of bytes read into it.
1.110 +Therefore, when reading through a file, the end of file has been reached
1.111 +when the descriptor length, as returned by TDesC8::Length(), is zero.
1.112 +Assuming aLength is less than the maximum length of the descriptor, the only
1.113 +circumstances in which Read() can return fewer bytes than requested is when
1.114 +the end of file is reached or if an error has occurred.
1.115 +
1.116 +@param aDes Descriptor into which binary data is read. Any existing
1.117 + contents are overwritten. On return, its length is set to the
1.118 + number of bytes read.
1.119 + NB: this function is asynchronous and the request that it
1.120 + represents may not complete until some time after the call
1.121 + to the function has returned. It is important, therefore, that
1.122 + this descriptor remain valid, or remain in scope, until you have
1.123 + been notified that the request is complete.
1.124 +
1.125 +@param aLength The number of bytes to be read from the file into the descriptor.
1.126 + If an attempt is made to read more bytes than the descriptor's
1.127 + maximum length, then the function updates aStatus parameter with KErrOverflow.
1.128 + It must not be negative otherwise the function updates aStatus with KErrArgument.
1.129 +
1.130 +@param aStatus Request status. On completion contains KErrNone if successful,
1.131 + otherwise one of the other system-wide error codes.
1.132 +*/
1.133 +inline void RFile64::Read(TDes8& aDes,TInt aLength,TRequestStatus& aStatus) const
1.134 + { RFile::Read( aDes, aLength, aStatus);}
1.135 +
1.136 +/**
1.137 +Writes to the file at the current offset within the file.
1.138 +
1.139 +This is a synchronous function.
1.140 +
1.141 +@param aDes The descriptor from which binary data is written.
1.142 + The function writes the entire contents of aDes to the file.
1.143 +
1.144 +@return KErrNone if successful, otherwise one of the other system-wide error
1.145 + codes.
1.146 +*/
1.147 +inline TInt RFile64::Write(const TDesC8& aDes)
1.148 + {return RFile::Write(aDes);}
1.149 +
1.150 +
1.151 +/**
1.152 +Writes to the file at the current offset within the file.
1.153 +
1.154 +This is an asynchronous function.
1.155 +
1.156 +@param aDes The descriptor from which binary data is written.
1.157 + The function writes the entire contents of aDes to the file.
1.158 + NB: this function is asynchronous and the request that it
1.159 + represents may not complete until some time after the call
1.160 + to the function has returned. It is important, therefore, that
1.161 + this descriptor remain valid, or remain in scope, until you have
1.162 + been notified that the request is complete.
1.163 +
1.164 +@param aStatus Request status. On completion contains KErrNone if successful,
1.165 + otherwise one of the other system-wide error codes.
1.166 +*/
1.167 +inline void RFile64::Write(const TDesC8& aDes,TRequestStatus& aStatus)
1.168 + {RFile::Write(aDes, aStatus);}
1.169 +
1.170 +
1.171 +/**
1.172 +Writes a portion of a descriptor to the file at the current offset within
1.173 +the file.
1.174 +
1.175 +This is a synchronous function.
1.176 +
1.177 +@param aDes The descriptor from which binary data is written.
1.178 +@param aLength The number of bytes to be written from the descriptor.
1.179 + This must not be greater than the length of the descriptor.
1.180 + It must not be negative.
1.181 +
1.182 +@return KErrNone if successful; KErrArgument if aLength is negative;
1.183 + otherwise one of the other system-wide error codes.
1.184 +
1.185 +@panic FSCLIENT 27 in debug mode, if aLength is greater than the length
1.186 + of the descriptor aDes.
1.187 +*/
1.188 +inline TInt RFile64::Write(const TDesC8& aDes,TInt aLength)
1.189 + {return RFile::Write(aDes, aLength);}
1.190 +
1.191 +
1.192 +/**
1.193 +Writes a portion of a descriptor to the file at the current offset
1.194 +within the file.
1.195 +
1.196 +This is an asynchronous function.
1.197 +
1.198 +@param aDes The descriptor from which binary data is written.
1.199 + NB: this function is asynchronous and the request that it
1.200 + represents may not complete until some time after the call
1.201 + to the function has returned. It is important, therefore, that
1.202 + this descriptor remain valid, or remain in scope, until you have
1.203 + been notified that the request is complete.
1.204 +
1.205 +@param aLength The number of bytes to be written from the descriptor.
1.206 + This must not be greater than the length of the descriptor.
1.207 + It must not be negative.
1.208 +
1.209 +@param aStatus Request status. On completion contains KErrNone if successful;
1.210 + KErrArgument if aLength is negative;
1.211 + otherwise one of the other system-wide error codes.
1.212 +*/
1.213 +inline void RFile64::Write(const TDesC8& aDes,TInt aLength,TRequestStatus& aStatus)
1.214 + {RFile::Write(aDes, aLength, aStatus);}
1.215 +
1.216 +/**
1.217 +Reads from the file at the specified offset within the file
1.218 +
1.219 +This is a synchronous function.
1.220 +
1.221 +Note that when an attempt is made to read beyond the end of the file,
1.222 +no error is returned.
1.223 +The descriptor's length is set to the number of bytes read into it.
1.224 +Therefore, when reading through a file, the end of file has been reached
1.225 +when the descriptor length, as returned by TDesC8::Length(), is zero.
1.226 +
1.227 +Note:
1.228 +1. This function over-rides the base class function RFile::Read
1.229 + and inlines the base class RFile::Read.
1.230 +2. The difference is that this function can read beyond 2GB - 1 when
1.231 + aPos + length of aDes is beyond 2GB - 1.
1.232 +3. This function is protected using _F32_STRICT_64_BIT_MIGRATION macro
1.233 + to help migration to 64 bit file addressing. When the macro is defined,
1.234 + this function becomes a private overload and hence use of
1.235 + TInt RFile64::Read(TInt64 aPos,TDes8& aDes) const is recommended.
1.236 +
1.237 +@see TInt RFile::Read(TInt aPos,TDes8& aDes) const
1.238 +@see TInt RFile64::Read(TInt64 aPos,TDes8& aDes) const
1.239 +
1.240 +@param aPos Position of first byte to be read. This is an offset from
1.241 + the start of the file. If no position is specified, reading
1.242 + begins at the current file position.
1.243 + If aPos is beyond the end of the file, the function returns
1.244 + a zero length descriptor.
1.245 +
1.246 +@param aDes The descriptor into which binary data is read. Any existing content
1.247 + is overwritten. On return, its length is set to the number of
1.248 + bytes read.
1.249 +
1.250 +@return KErrNone if successful, otherwise one of the other system-wide error
1.251 + codes.
1.252 +
1.253 +@panic FSCLIENT 19 if aPos is negative.
1.254 +*/
1.255 +
1.256 +inline TInt RFile64::Read(TInt aPos,TDes8& aDes) const
1.257 + {return RFile::Read(aPos, aDes);}
1.258 +
1.259 +/**
1.260 +Reads from the file at the specified offset within the file.
1.261 +
1.262 +This is an asynchronous function.
1.263 +
1.264 +Note that when an attempt is made to read beyond the end of the file,
1.265 +no error is returned.
1.266 +The descriptor's length is set to the number of bytes read into it.
1.267 +Therefore, when reading through a file, the end of file has been reached
1.268 +when the descriptor length, as returned by TDesC8::Length(), is zero.
1.269 +
1.270 +Note:
1.271 +1. This function over-rides the base class function RFile::Read
1.272 + and inlines the base class RFile::Read.
1.273 +2. The difference is that this function can read beyond 2GB - 1 when
1.274 + aPos + length of aDes is beyond 2GB - 1.
1.275 +3. This function is protected using _F32_STRICT_64_BIT_MIGRATION macro
1.276 + to help migration to 64 bit file addressing. When the macro is defined,
1.277 + this function becomes a private overload and hence use of
1.278 + void RFile64::Read(TInt64 aPos,TDes8& aDes,TRequestStatus& aStatus) const is recommended.
1.279 +
1.280 +@see void RFile::Read(TInt aPos,TDes8& aDes,TRequestStatus& aStatus) const
1.281 +@see void RFile64::Read(TInt64 aPos,TDes8& aDes,TRequestStatus& aStatus) const
1.282 +
1.283 +@param aPos Position of first byte to be read. This is an offset from
1.284 + the start of the file. If no position is specified,
1.285 + reading begins at the current file position.
1.286 + If aPos is beyond the end of the file, the function returns
1.287 + a zero length descriptor.
1.288 +
1.289 +@param aDes The descriptor into which binary data is read. Any existing
1.290 + content is overwritten. On return, its length is set to
1.291 + the number of bytes read.
1.292 + NB: this function is asynchronous and the request that it
1.293 + represents may not complete until some time after the call
1.294 + to the function has returned. It is important, therefore, that
1.295 + this descriptor remain valid, or remain in scope, until you have
1.296 + been notified that the request is complete.
1.297 +
1.298 +@param aStatus The request status. On completion, contains an error code of KErrNone
1.299 + if successful, otherwise one of the other system-wide error codes.
1.300 +
1.301 +@panic FSCLIENT 19 if aPos is negative.
1.302 +*/
1.303 +inline void RFile64::Read(TInt aPos,TDes8& aDes,TRequestStatus& aStatus) const
1.304 + {RFile::Read(aPos, aDes, aStatus);}
1.305 +
1.306 +/**
1.307 +Reads the specified number of bytes of binary data from the file at a specified
1.308 +offset within the file.
1.309 +
1.310 +This is a synchronous function.
1.311 +
1.312 +Note that when an attempt is made to read beyond the end of the file,
1.313 +no error is returned.
1.314 +The descriptor's length is set to the number of bytes read into it.
1.315 +Therefore, when reading through a file, the end of file has been reached
1.316 +when the descriptor length, as returned by TDesC8::Length(), is zero.
1.317 +Assuming aLength is less than the maximum length of the descriptor, the only
1.318 +circumstances in which Read() can return fewer bytes than requested is when
1.319 +the end of file is reached or if an error has occurred.
1.320 +
1.321 +Note:
1.322 +1. This function over-rides the base class function RFile::Read
1.323 + and inlines the base class RFile::Read.
1.324 +2. The difference is that this function can read beyond 2GB - 1 when
1.325 + aPos + aLength is beyond 2GB - 1.
1.326 +3. This function is protected using _F32_STRICT_64_BIT_MIGRATION macro
1.327 + to help migration to 64 bit file addressing. When the macro is defined,
1.328 + this function becomes a private overload and hence use of
1.329 + TInt RFile64::Read(TInt64 aPos,TDes8& aDes,TInt aLength) const is recommended.
1.330 +
1.331 +@see TInt RFile::Read(TInt aPos,TDes8& aDes,TInt aLength) const
1.332 +@see TInt RFile64::Read(TInt64 aPos,TDes8& aDes,TInt aLength) const
1.333 +
1.334 +@param aPos Position of first byte to be read. This is an offset from
1.335 + the start of the file. If no position is specified,
1.336 + reading begins at the current file position.
1.337 + If aPos is beyond the end of the file, the function returns
1.338 + a zero length descriptor.
1.339 +
1.340 +@param aDes The descriptor into which binary data is read. Any existing
1.341 + contents are overwritten. On return, its length is set to
1.342 + the number of bytes read.
1.343 +@param aLength The number of bytes to read from the file into the descriptor.
1.344 + If an attempt is made to read more bytes than the descriptor's
1.345 + maximum length, then the function updates aStatus parameter with KErrOverflow.
1.346 + It must not be negative otherwise the function updates aStatus with KErrArgument.
1.347 +
1.348 +@return KErrNone if successful, otherwise one of the other system-wide
1.349 + error codes.
1.350 +
1.351 +@panic FSCLIENT 19 if aPos is negative.
1.352 +*/
1.353 +inline TInt RFile64::Read(TInt aPos,TDes8& aDes,TInt aLength) const
1.354 + {return RFile::Read(aPos, aDes, aLength);}
1.355 +
1.356 +/**
1.357 +Reads the specified number of bytes of binary data from the file at a specified
1.358 +offset within the file.
1.359 +
1.360 +This is an asynchronous function.
1.361 +
1.362 +
1.363 +Note that when an attempt is made to read beyond the end of the file,
1.364 +no error is returned.
1.365 +The descriptor's length is set to the number of bytes read into it.
1.366 +Therefore, when reading through a file, the end of file has been reached
1.367 +when the descriptor length, as returned by TDesC8::Length(), is zero.
1.368 +Assuming aLength is less than the maximum length of the descriptor, the only
1.369 +circumstances in which Read() can return fewer bytes than requested is when
1.370 +the end of file is reached or if an error has occurred.
1.371 +
1.372 +Note:
1.373 +1. This function over-rides the base class function RFile::Read
1.374 + and inlines the base class RFile::Read.
1.375 +2. The difference is that this function can read beyond 2GB - 1 when
1.376 + aPos + aLength is beyond 2GB - 1.
1.377 +3. This function is protected using _F32_STRICT_64_BIT_MIGRATION macro
1.378 + to help migration to 64 bit file addressing. When the macro is defined,
1.379 + this function becomes a private overload and hence use of
1.380 + void RFile64::Read(TInt64 aPos,TDes8& aDes,TInt aLength,TRequestStatus& aStatus) const is recommended.
1.381 +
1.382 +@see void RFile::Read(TInt aPos,TDes8& aDes,TInt aLength,TRequestStatus& aStatus) const
1.383 +@see void RFile64::Read(TInt64 aPos,TDes8& aDes,TInt aLength,TRequestStatus& aStatus) const
1.384 +
1.385 +@param aPos Position of first byte to be read. This is an offset from
1.386 + the start of the file. If no position is specified,
1.387 + reading begins at the current file position.
1.388 + If aPos is beyond the end of the file, the function returns
1.389 + a zero length descriptor.
1.390 +
1.391 +@param aDes The descriptor into which binary data is read. Any existing
1.392 + contents are overwritten. On return, its length is set to
1.393 + the number of bytes read.
1.394 + NB: this function is asynchronous and the request that it
1.395 + represents may not complete until some time after the call
1.396 + to the function has returned. It is important, therefore, that
1.397 + this descriptor remain valid, or remain in scope, until you have
1.398 + been notified that the request is complete.
1.399 +
1.400 +@param aLength The number of bytes to read from the file into the descriptor.
1.401 + If an attempt is made to read more bytes than the descriptor's
1.402 + maximum length, then the function returns KErrOverflow.
1.403 + It must not be negative otherwise the function returns KErrArgument.
1.404 +
1.405 +@param aStatus Request status. On completion contains KErrNone if successful,
1.406 + otherwise one of the other system-wide error codes.
1.407 +
1.408 +@panic FSCLIENT 19 if aPos is negative.
1.409 +*/
1.410 +inline void RFile64::Read(TInt aPos,TDes8& aDes,TInt aLength,TRequestStatus& aStatus) const
1.411 + { RFile::Read(aPos, aDes, aLength, aStatus);}
1.412 +
1.413 +/**
1.414 +Writes to the file at the specified offset within the file
1.415 +
1.416 +This is a synchronous function.
1.417 +
1.418 +Note:
1.419 +1. This function over-rides the base class function RFile::Write
1.420 + and inlines the base class RFile::Write.
1.421 +2. The difference is that this function can write beyond 2GB - 1 when
1.422 + aPos + length of aDes is beyond 2GB - 1.
1.423 +3. This function is protected using _F32_STRICT_64_BIT_MIGRATION macro
1.424 + to help migration to 64 bit file addressing. When the macro is defined,
1.425 + this function becomes a private overload and hence use of
1.426 + TInt RFile64::Write(TInt64 aPos,const TDesC8& aDes) is recommended.
1.427 +
1.428 +@see TInt RFile::Write(TInt aPos,const TDesC8& aDes)
1.429 +@see TInt RFile64::Write(TInt64 aPos,const TDesC8& aDes)
1.430 +
1.431 +@param aPos The offset from the start of the file at which the first
1.432 + byte is written.
1.433 + If a position beyond the end of the file is specified, then
1.434 + the write operation begins at the end of the file.
1.435 + If the position has been locked, then the write fails.
1.436 +
1.437 +@param aDes The descriptor from which binary data is written. The function writes
1.438 + the entire contents of aDes to the file.
1.439 +
1.440 +@return KErrNone if successful, otherwise one of the other system-wide error
1.441 + codes.
1.442 +
1.443 +@panic FSCLIENT 19 if aPos is negative.
1.444 +*/
1.445 +inline TInt RFile64::Write(TInt aPos,const TDesC8& aDes)
1.446 + {return RFile::Write( aPos, aDes);}
1.447 +
1.448 +/**
1.449 +Writes to the file at the specified offset within the file
1.450 +
1.451 +This is an asynchronous function.
1.452 +
1.453 +Note:
1.454 +1. This function over-rides the base class function RFile::Write
1.455 + and inlines the base class RFile::Write.
1.456 +2. The difference is that this function can write beyond 2GB - 1 when
1.457 + aPos + length of aDes is beyond 2GB - 1.
1.458 +3. This function is protected using _F32_STRICT_64_BIT_MIGRATION macro
1.459 + to help migration to 64 bit file addressing. When the macro is defined,
1.460 + this function becomes a private overload and hence use of
1.461 + void RFile64::Write(TInt64 aPos,const TDesC8& aDes,TRequestStatus& aStatus) is recommended.
1.462 +
1.463 +@see void RFile::Write(TInt aPos,const TDesC8& aDes,TRequestStatus& aStatus)
1.464 +@see void RFile64::Write(TInt64 aPos,const TDesC8& aDes,TRequestStatus& aStatus)
1.465 +
1.466 +@param aPos The offset from the start of the file at which the first
1.467 + byte is written.
1.468 + If a position beyond the end of the file is specified, then
1.469 + the write operation begins at the end of the file.
1.470 + If the position has been locked, then the write fails.
1.471 +
1.472 +@param aDes The descriptor from which binary data is written. The function
1.473 + writes the entire contents of aDes to the file.
1.474 + NB: this function is asynchronous and the request that it
1.475 + represents may not complete until some time after the call
1.476 + to the function has returned. It is important, therefore, that
1.477 + this descriptor remain valid, or remain in scope, until you have
1.478 + been notified that the request is complete.
1.479 +
1.480 +@param aStatus Request status. On completion contains KErrNone if successful,
1.481 + otherwise one of the other system-wide error codes.
1.482 +
1.483 +@panic FSCLIENT 19 if aPos is negative.
1.484 +*/
1.485 +inline void RFile64::Write(TInt aPos,const TDesC8& aDes,TRequestStatus& aStatus)
1.486 + {RFile::Write(aPos, aDes, aStatus);}
1.487 +
1.488 +/**
1.489 +Writes the specified number of bytes to the file at the specified offset within the file.
1.490 +
1.491 +This is a synchronous function.
1.492 +
1.493 +Note:
1.494 +1. This function over-rides the base class function RFile::Write
1.495 + and inlines the base class RFile::Write.
1.496 +2. The difference is that this function can write beyond 2GB - 1 when
1.497 + aPos + aLength is beyond 2GB - 1.
1.498 +3. This function is protected using _F32_STRICT_64_BIT_MIGRATION macro
1.499 + to help migration to 64 bit file addressing. When the macro is defined,
1.500 + this function becomes a private overload and hence use of
1.501 + TInt RFile64::Write(TInt64 aPos,const TDesC8& aDes,TInt aLength) is recommended.
1.502 +
1.503 +@see TInt RFile::Write(TInt aPos,const TDesC8& aDes,TInt aLength)
1.504 +@see TInt RFile64::Write(TInt64 aPos,const TDesC8& aDes,TInt aLength)
1.505 +
1.506 +@param aPos The offset from the start of the file at which the first
1.507 + byte is written.
1.508 + If a position beyond the end of the file is specified, then
1.509 + the write operation begins at the end of the file.
1.510 + If the position has been locked, then the write fails.
1.511 +
1.512 +@param aDes The descriptor from which binary data is written.
1.513 +@param aLength The number of bytes to be written from aDes .
1.514 + It must not be negative.
1.515 +
1.516 +@return KErrNone if successful; KErrArgument if aLength is negative;
1.517 + otherwise one of the other system-wide error codes.
1.518 +
1.519 +@panic FSCLIENT 19 if aPos is negative.
1.520 +*/
1.521 +inline TInt RFile64::Write(TInt aPos,const TDesC8& aDes,TInt aLength)
1.522 + {return RFile::Write(aPos, aDes, aLength);}
1.523 +
1.524 +/**
1.525 +Writes the specified number of bytes to the file at the specified offset within the file.
1.526 +
1.527 +This is an asynchronous function.
1.528 +
1.529 +Note:
1.530 +1. This function over-rides the base class function RFile::Write
1.531 + and inlines the base class RFile::Write.
1.532 +2. The difference is that this function can write beyond 2GB - 1 when
1.533 + aPos + aLength is beyond 2GB - 1.
1.534 +3. This function is protected using _F32_STRICT_64_BIT_MIGRATION macro
1.535 + to help migration to 64 bit file addressing. When the macro is defined,
1.536 + this function becomes a private overload and hence use of
1.537 + void RFile64::Write(TInt64 aPos,const TDesC8& aDes,TRequestStatus& aStatus) is recommended.
1.538 +
1.539 +@see void RFile::Write(TInt aPos,const TDesC8& aDes,TRequestStatus& aStatus)
1.540 +@see void RFile64::Write(TInt64 aPos,const TDesC8& aDes,TRequestStatus& aStatus)
1.541 +
1.542 +@param aPos The offset from the start of the file at which the first
1.543 + byte is written.
1.544 + If a position beyond the end of the file is specified, then
1.545 + the write operation begins at the end of the file.
1.546 + If the position has been locked, then the write fails.
1.547 +
1.548 +@param aDes The descriptor from which binary data is written.
1.549 + NB: this function is asynchronous and the request that it
1.550 + represents may not complete until some time after the call
1.551 + to the function has returned. It is important, therefore, that
1.552 + this descriptor remain valid, or remain in scope, until you have
1.553 + been notified that the request is complete.
1.554 +
1.555 +@param aLength The number of bytes to be written from aDes.
1.556 + It must not be negative.
1.557 +
1.558 +@param aStatus Request status. On completion contains KErrNone if successful;
1.559 + KErrArgument if aLength is negative;
1.560 + otherwise one of the other system-wide error codes.
1.561 +
1.562 +@panic FSCLIENT 19 if aPos is negative.
1.563 +*/
1.564 +inline void RFile64::Write(TInt aPos,const TDesC8& aDes,TInt aLength,TRequestStatus& aStatus)
1.565 + {RFile::Write(aPos, aDes, aLength, aStatus);}