Many hyperlinks are disabled.
Use anonymous login
to enable hyperlinks.
Overview
Comment: | Document the SQLiteString class. In the SQLiteString.ProbeForUtf8ByteLength method, make sure the limit is greater than zero. |
---|---|
Downloads: | Tarball | ZIP archive |
Timelines: | family | ancestors | descendants | both | virtualTables |
Files: | files | file ages | folders |
SHA1: |
3fbdd30433204f882229201857b6f80b |
User & Date: | mistachkin 2013-06-25 07:44:13.096 |
Context
2013-06-25
| ||
08:24 | Move byte array handling methods to the SQLiteBytes class. Remove superfluous ValueArrayFromSizeAndIntPtr method from the SQLiteMarshal class. More work on docs. check-in: 75dd5c847a user: mistachkin tags: virtualTables | |
07:44 | Document the SQLiteString class. In the SQLiteString.ProbeForUtf8ByteLength method, make sure the limit is greater than zero. check-in: 3fbdd30433 user: mistachkin tags: virtualTables | |
06:58 | Document the SQLiteMemory class. check-in: 3b2c842774 user: mistachkin tags: virtualTables | |
Changes
Changes to System.Data.SQLite/SQLiteModule.cs.
︙ | |||
3493 3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525 3526 3527 3528 3529 3530 3531 3532 3533 3534 3535 3536 3537 3538 3539 3540 3541 3542 3543 | 3493 3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525 3526 3527 3528 3529 3530 3531 3532 3533 3534 3535 3536 3537 3538 3539 3540 3541 3542 3543 3544 3545 3546 3547 3548 3549 3550 3551 3552 3553 3554 3555 3556 3557 3558 3559 3560 3561 3562 3563 3564 3565 3566 3567 3568 3569 3570 3571 3572 3573 3574 3575 3576 3577 3578 3579 3580 3581 3582 3583 3584 3585 3586 3587 3588 3589 3590 3591 3592 3593 3594 3595 3596 3597 3598 3599 3600 3601 3602 3603 3604 3605 3606 3607 3608 3609 3610 3611 3612 3613 3614 3615 3616 3617 3618 3619 3620 3621 3622 3623 3624 3625 3626 3627 3628 3629 3630 3631 3632 3633 3634 3635 3636 3637 3638 3639 3640 3641 3642 3643 3644 3645 3646 3647 3648 3649 | + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + | /////////////////////////////////////////////////////////////////////////// #region SQLiteString Static Class internal static class SQLiteString { #region Private Constants /// <summary> /// This is the maximum possible length for the native UTF-8 encoded /// strings used with the SQLite core library. /// </summary> private static int ThirtyBits = 0x3fffffff; /////////////////////////////////////////////////////////////////////// /// <summary> /// This is the <see cref="Encoding" /> object instance used to handle /// conversions from/to UTF-8. /// </summary> private static readonly Encoding Utf8Encoding = Encoding.UTF8; #endregion /////////////////////////////////////////////////////////////////////// #region UTF-8 Encoding Helper Methods /// <summary> /// Converts the specified managed string into the UTF-8 encoding and /// returns the array of bytes containing its representation in that /// encoding. /// </summary> /// <param name="value"> /// The managed string to convert. /// </param> /// <returns> /// The array of bytes containing the representation of the managed /// string in the UTF-8 encoding or null upon failure. /// </returns> public static byte[] GetUtf8BytesFromString( string value ) { if (value == null) return null; return Utf8Encoding.GetBytes(value); } /////////////////////////////////////////////////////////////////////// /// <summary> /// Converts the specified array of bytes representing a string in the /// UTF-8 encoding and returns a managed string. /// </summary> /// <param name="bytes"> /// The array of bytes to convert. /// </param> /// <returns> /// The managed string or null upon failure. /// </returns> public static string GetStringFromUtf8Bytes( byte[] bytes ) { if (bytes == null) return null; #if !PLATFORM_COMPACTFRAMEWORK return Utf8Encoding.GetString(bytes); #else return Utf8Encoding.GetString(bytes, 0, bytes.Length); #endif } #endregion /////////////////////////////////////////////////////////////////////// #region UTF-8 String Helper Methods /// <summary> /// Probes a native pointer to a string in the UTF-8 encoding for its /// terminating NUL character, within the specified length limit. /// </summary> /// <param name="pValue"> /// The native NUL-terminated string pointer. /// </param> /// <param name="limit"> /// The maximum length of the native string, in bytes. /// </param> /// <returns> /// The length of the native string, in bytes -OR- zero if the length /// could not be determined. /// </returns> public static int ProbeForUtf8ByteLength( IntPtr pValue, int limit ) { int length = 0; |
︙ | |||
3588 3589 3590 3591 3592 3593 3594 3595 3596 3597 3598 3599 3600 3601 | 3658 3659 3660 3661 3662 3663 3664 3665 3666 3667 3668 3669 3670 3671 3672 3673 3674 3675 3676 3677 3678 3679 3680 3681 3682 3683 | + + + + + + + + + + + + | } return String.Empty; } /////////////////////////////////////////////////////////////////////// /// <summary> /// Converts the specified managed string into a native NUL-terminated /// UTF-8 string pointer using memory obtained from the SQLite core /// library. /// </summary> /// <param name="value"> /// The managed string to convert. /// </param> /// <returns> /// The native NUL-terminated UTF-8 string pointer or /// <see cref="IntPtr.Zero" /> upon failure. /// </returns> public static IntPtr Utf8IntPtrFromString( string value ) { if (value == null) return IntPtr.Zero; |
︙ | |||
3618 3619 3620 3621 3622 3623 3624 3625 3626 3627 3628 3629 3630 3631 3632 3633 3634 3635 3636 3637 3638 3639 3640 3641 3642 3643 3644 3645 3646 3647 3648 | 3700 3701 3702 3703 3704 3705 3706 3707 3708 3709 3710 3711 3712 3713 3714 3715 3716 3717 3718 3719 3720 3721 3722 3723 3724 3725 3726 3727 3728 3729 3730 3731 3732 3733 3734 3735 3736 3737 3738 3739 3740 3741 3742 3743 3744 3745 3746 3747 3748 3749 3750 3751 | + + + + + + + + + + + + + + + + + + + + + | return result; } #endregion /////////////////////////////////////////////////////////////////////// #region UTF-8 String Array Helper Methods /// <summary> /// Converts an array of native NUL-terminated UTF-8 string pointers /// into an array of managed strings. /// </summary> /// <param name="pValues"> /// The array of native NUL-terminated UTF-8 string pointers. /// </param> /// <returns> /// The array of managed strings or null upon failure. /// </returns> public static string[] StringArrayFromUtf8IntPtrArray( IntPtr[] pValues ) { if (pValues == null) return null; string[] result = new string[pValues.Length]; for (int index = 0; index < result.Length; index++) result[index] = StringFromUtf8IntPtr(pValues[index]); return result; } /////////////////////////////////////////////////////////////////////// /// <summary> /// Converts an array of managed strings into an array of native /// NUL-terminated UTF-8 string pointers. /// </summary> /// <param name="values"> /// The array of managed strings to convert. /// </param> /// <returns> /// The array of native NUL-terminated UTF-8 string pointers or null /// upon failure. /// </returns> public static IntPtr[] Utf8IntPtrArrayFromStringArray( string[] values ) { if (values == null) return null; |
︙ |