| ... | ... | @@ -2288,7 +2288,7 @@ or |
| 2288 | 2288 | {#code|test_aligned_struct_fields.zig#} |
| 2289 | 2289 | |
| 2290 | 2290 | <p> |
| 2291 | | Equating packed structs results in a comparison of the backing integer, |
| 2291 | Equating packed structs results in a comparison of the backing integer, |
| 2292 | 2292 | and only works for the `==` and `!=` operators. |
| 2293 | 2293 | </p> |
| 2294 | 2294 | {#code|test_packed_struct_equality.zig#} |
| ... | ... | @@ -4086,7 +4086,7 @@ fn performFn(start_value: i32) i32 { |
| 4086 | 4086 | special-case syntax. |
| 4087 | 4087 | </p> |
| 4088 | 4088 | <p> |
| 4089 | | Here is an example of a generic {#syntax#}List{#endsyntax#} data structure. |
| 4089 | Here is an example of a generic {#syntax#}List{#endsyntax#} data structure. |
| 4090 | 4090 | </p> |
| 4091 | 4091 | {#code|generic_data_structure.zig#} |
| 4092 | 4092 | |
| ... | ... | @@ -4291,10 +4291,10 @@ pub fn print(self: *Writer, arg0: []const u8, arg1: i32) !void { |
| 4291 | 4291 | <pre>{#syntax#}@addrSpaceCast(ptr: anytype) anytype{#endsyntax#}</pre> |
| 4292 | 4292 | <p> |
| 4293 | 4293 | Converts a pointer from one address space to another. The new address space is inferred |
| 4294 | | based on the result type. Depending on the current target and address spaces, this cast |
| 4295 | | may be a no-op, a complex operation, or illegal. If the cast is legal, then the resulting |
| 4296 | | pointer points to the same memory location as the pointer operand. It is always valid to |
| 4297 | | cast a pointer between the same address spaces. |
| 4294 | based on the result type. Depending on the current target and address spaces, this cast |
| 4295 | may be a no-op, a complex operation, or illegal. If the cast is legal, then the resulting |
| 4296 | pointer points to the same memory location as the pointer operand. It is always valid to |
| 4297 | cast a pointer between the same address spaces. |
| 4298 | 4298 | </p> |
| 4299 | 4299 | {#header_close#} |
| 4300 | 4300 | {#header_open|@addWithOverflow#} |
| ... | ... | @@ -4307,7 +4307,7 @@ pub fn print(self: *Writer, arg0: []const u8, arg1: i32) !void { |
| 4307 | 4307 | <pre>{#syntax#}@alignCast(ptr: anytype) anytype{#endsyntax#}</pre> |
| 4308 | 4308 | <p> |
| 4309 | 4309 | {#syntax#}ptr{#endsyntax#} can be {#syntax#}*T{#endsyntax#}, {#syntax#}?*T{#endsyntax#}, or {#syntax#}[]T{#endsyntax#}. |
| 4310 | | Changes the alignment of a pointer. The alignment to use is inferred based on the result type. |
| 4310 | Changes the alignment of a pointer. The alignment to use is inferred based on the result type. |
| 4311 | 4311 | </p> |
| 4312 | 4312 | <p>A {#link|pointer alignment safety check|Incorrect Pointer Alignment#} is added |
| 4313 | 4313 | to the generated code to make sure the pointer is aligned as promised.</p> |
| ... | ... | @@ -4384,7 +4384,7 @@ comptime { |
| 4384 | 4384 | <pre>{#syntax#}@bitCast(value: anytype) anytype{#endsyntax#}</pre> |
| 4385 | 4385 | <p> |
| 4386 | 4386 | Converts a value of one type to another type. The return type is the |
| 4387 | | inferred result type. |
| 4387 | inferred result type. |
| 4388 | 4388 | </p> |
| 4389 | 4389 | <p> |
| 4390 | 4390 | Asserts that {#syntax#}@sizeOf(@TypeOf(value)) == @sizeOf(DestType){#endsyntax#}. |
| ... | ... | @@ -4740,41 +4740,41 @@ fn cmpxchgWeakButNotAtomic(comptime T: type, ptr: *T, expected_value: T, new_val |
| 4740 | 4740 | </p> |
| 4741 | 4741 | {#see_also|@cVaArg|@cVaCopy|@cVaEnd#} |
| 4742 | 4742 | {#header_close#} |
| 4743 | | |
| 4743 | |
| 4744 | 4744 | {#header_open|@deprecated#} |
| 4745 | 4745 | <pre>{#syntax#}@deprecated(value: anytype) @TypeOf(value){#endsyntax#}</pre> |
| 4746 | 4746 | <pre>{#syntax#}@deprecated() void{#endsyntax#}</pre> |
| 4747 | 4747 | <p> |
| 4748 | | Used to mark a given code path as deprecated. It evaluates to the same value |
| 4749 | | passed in as argument, or the void value when given none. |
| 4748 | Used to mark a given code path as deprecated. It evaluates to the same value |
| 4749 | passed in as argument, or the void value when given none. |
| 4750 | 4750 | </p> |
| 4751 | 4751 | <p> |
| 4752 | 4752 | As an example, a library that wishes to move or rename a declaration, while |
| 4753 | | deprecating usage of the old name can use {#syntax#}@deprecated{#endsyntax#} like so: |
| 4754 | | </p> |
| 4753 | deprecating usage of the old name can use {#syntax#}@deprecated{#endsyntax#} like so: |
| 4754 | </p> |
| 4755 | 4755 | {#syntax_block|zig|root.zig#} |
| 4756 | 4756 | pub const fooToBar = @deprecated(bar.fromFoo); // moved |
| 4757 | 4757 | {#end_syntax_block#} |
| 4758 | 4758 | |
| 4759 | 4759 | <p> |
| 4760 | 4760 | By default it is a <b>compile error</b> to reference deprecated code in |
| 4761 | | a module defined by the root package, while it is not in modules defined |
| 4762 | | by dependencies. This behavior can be overridden for the entire dependency |
| 4763 | | tree by passing {#syntax#}-fallow-deprecated{#endsyntax#} or |
| 4764 | | {#syntax#}-fno-allow-deprecated{#endsyntax#} to {#syntax#}zig build{#endsyntax#}. |
| 4761 | a module defined by the root package, while it is not in modules defined |
| 4762 | by dependencies. This behavior can be overridden for the entire dependency |
| 4763 | tree by passing {#syntax#}-fallow-deprecated{#endsyntax#} or |
| 4764 | {#syntax#}-fno-allow-deprecated{#endsyntax#} to {#syntax#}zig build{#endsyntax#}. |
| 4765 | 4765 | </p> |
| 4766 | 4766 | <p> |
| 4767 | | Usage of this builtin is meant to help <i>direct</i> consumers discover (and remove) |
| 4768 | | their dependance on deprecated code during the grace period before a deprecated |
| 4769 | | functionality is turned into a {#syntax#}@compileError{#endsyntax#} or |
| 4770 | | removed entirely. |
| 4767 | Usage of this builtin is meant to help <i>direct</i> consumers discover (and remove) |
| 4768 | their dependance on deprecated code during the grace period before a deprecated |
| 4769 | functionality is turned into a {#syntax#}@compileError{#endsyntax#} or |
| 4770 | removed entirely. |
| 4771 | 4771 | </p> |
| 4772 | 4772 | |
| 4773 | | <p> |
| 4773 | <p> |
| 4774 | 4774 | Using {#syntax#}@deprecated{#endsyntax#} without an argument can be useful inside of blocks: |
| 4775 | | </p> |
| 4775 | </p> |
| 4776 | 4776 | {#code|test_deprecated_builtin.zig#} |
| 4777 | | |
| 4777 | |
| 4778 | 4778 | {#header_close#} |
| 4779 | 4779 | |
| 4780 | 4780 | {#header_open|@divExact#} |
| ... | ... | @@ -4891,8 +4891,8 @@ pub const fooToBar = @deprecated(bar.fromFoo); // moved |
| 4891 | 4891 | <pre>{#syntax#}@errorCast(value: anytype) anytype{#endsyntax#}</pre> |
| 4892 | 4892 | <p> |
| 4893 | 4893 | Converts an error set or error union value from one error set to another error set. The return type is the |
| 4894 | | inferred result type. Attempting to convert an error which is not in the destination error |
| 4895 | | set results in safety-checked {#link|Illegal Behavior#}. |
| 4894 | inferred result type. Attempting to convert an error which is not in the destination error |
| 4895 | set results in safety-checked {#link|Illegal Behavior#}. |
| 4896 | 4896 | </p> |
| 4897 | 4897 | {#header_close#} |
| 4898 | 4898 | |
| ... | ... | @@ -4971,7 +4971,7 @@ pub const fooToBar = @deprecated(bar.fromFoo); // moved |
| 4971 | 4971 | <pre>{#syntax#}@floatFromInt(int: anytype) anytype{#endsyntax#}</pre> |
| 4972 | 4972 | <p> |
| 4973 | 4973 | Converts an integer to the closest floating point representation. The return type is the inferred result type. |
| 4974 | | To convert the other way, use {#link|@intFromFloat#}. This operation is legal |
| 4974 | To convert the other way, use {#link|@intFromFloat#}. This operation is legal |
| 4975 | 4975 | for all values of all integer types. |
| 4976 | 4976 | </p> |
| 4977 | 4977 | {#header_close#} |
| ... | ... | @@ -5063,7 +5063,7 @@ pub const fooToBar = @deprecated(bar.fromFoo); // moved |
| 5063 | 5063 | <pre>{#syntax#}@intCast(int: anytype) anytype{#endsyntax#}</pre> |
| 5064 | 5064 | <p> |
| 5065 | 5065 | Converts an integer to another integer while keeping the same numerical value. |
| 5066 | | The return type is the inferred result type. |
| 5066 | The return type is the inferred result type. |
| 5067 | 5067 | Attempting to convert a number which is out of range of the destination type results in |
| 5068 | 5068 | safety-checked {#link|Illegal Behavior#}. |
| 5069 | 5069 | </p> |
| ... | ... | @@ -5316,7 +5316,7 @@ pub const fooToBar = @deprecated(bar.fromFoo); // moved |
| 5316 | 5316 | <pre>{#syntax#}@ptrFromInt(address: usize) anytype{#endsyntax#}</pre> |
| 5317 | 5317 | <p> |
| 5318 | 5318 | Converts an integer to a {#link|pointer|Pointers#}. The return type is the inferred result type. |
| 5319 | | To convert the other way, use {#link|@intFromPtr#}. Casting an address of 0 to a destination type |
| 5319 | To convert the other way, use {#link|@intFromPtr#}. Casting an address of 0 to a destination type |
| 5320 | 5320 | which in not {#link|optional|Optional Pointers#} and does not have the {#syntax#}allowzero{#endsyntax#} attribute will result in a |
| 5321 | 5321 | {#link|Pointer Cast Invalid Null#} panic when runtime safety checks are enabled. |
| 5322 | 5322 | </p> |
Andrew Kelley <andrew@ziglang.org> 2025-02-25 22:42:04-08:00
test