{"record":{"id":"25be86203917f629","repo":"bchavez/Bogus","slug":"nameof-ordefault-nameof-defaultweight-of","errorCode":null,"errorMessage":".{nameof(OrDefault)}() {nameof(defaultWeight)} of '{defaultWeight}' must be between 1.0f and 0.0f. ","messagePattern":"\\.(.+?)\\(\\) (.+?) of '(.+?)' must be between 1\\.0f and 0\\.0f\\. ","errorType":"exception","errorClass":"ArgumentOutOfRangeException","httpStatus":null,"severity":"error","filePath":"Source/Bogus/Faker[T].Extensions.cs","lineNumber":61,"sourceCode":"   /// <typeparam name=\"T\">Any nullable type. ie: int?, Guid?, etc.</typeparam>\n   /// <param name=\"f\">The Faker facade. This is usually the f from RuleFor(.., f => lambda).</param>\n   /// <param name=\"nullWeight\">The probability of null occurring. Range [1.0f - 0.0f] (100% and 0%) respectively. For example, if 15% null is desired pass nullWeight = 0.15f.</param>\n   public static T? OrNull<T>(this T value, Faker f, float nullWeight = 0.5f) where T : struct\n   {\n      if (nullWeight is > 1 or < 0) throw new ArgumentOutOfRangeException(nameof(nullWeight), $\".{nameof(OrNull)}() {nameof(nullWeight)} of '{nullWeight}' must be between 1.0f and 0.0f.\");\n      return f.Random.Float() > nullWeight ? new T?(value) : null;\n   }\n\n   /// <summary>\n   /// Helpful extension for creating randomly default(T) values for <seealso cref=\"Faker{T}\"/>.RuleFor() rules.\n   /// Example: .RuleFor(x=>x.Prop, f=>f.Random.Word().OrDefault(f))\n   /// </summary>\n   /// <param name=\"f\">The Faker facade. This is usually the f from f => lambda.</param>\n   /// <param name=\"defaultWeight\">The probability of the default value occurring. Range [1.0f - 0.0f] (100% and 0%) respectively. For example, if 15% default(T) is desired pass defaultWeight = 0.15f.</param>\n   /// <param name=\"defaultValue\">The default value to return.</param>\n   public static T OrDefault<T>(this T value, Faker f, float defaultWeight = 0.5f, T defaultValue = default)\n   {\n      if (defaultWeight is > 1 or < 0) throw new ArgumentOutOfRangeException(nameof(defaultWeight), $\".{nameof(OrDefault)}() {nameof(defaultWeight)} of '{defaultWeight}' must be between 1.0f and 0.0f. \");\n      return f.Random.Float() > defaultWeight ? value : defaultValue;\n   }\n}","sourceCodeStart":43,"sourceCodeEnd":64,"githubUrl":"https://github.com/bchavez/Bogus/blob/6ece18c5c22648ab4606e45a0aaf2f07fc5259e4/Source/Bogus/Faker[T].Extensions.cs#L43-L64","documentation":"OrDefault<T>(this T value, Faker f, float defaultWeight, T defaultValue) throws ArgumentOutOfRangeException if defaultWeight is below 0 or above 1. defaultWeight is the probability of returning defaultValue instead of the generated value; valid range is [0.0, 1.0], default 0.5.","triggerScenarios":"Calling f.Random.Word().OrDefault(f, 1.2f) or .OrDefault(f, -0.5f) in a RuleFor lambda.","commonSituations":"Passing a percentage (e.g. 30) instead of a fraction (0.3), or an unclamped weight from configuration.","solutions":["Pass a fraction in [0.0, 1.0]; for 30% default use 0.3f.","Clamp with Math.Clamp(weight, 0f, 1f) before calling.","Omit the argument to use the 0.5 default."],"exampleFix":"// before\n.RuleFor(x => x.Code, f => f.Random.AlphaNumeric(5).OrDefault(f, 30f))\n\n// after\n.RuleFor(x => x.Code, f => f.Random.AlphaNumeric(5).OrDefault(f, 0.3f))","handlingStrategy":"validation","validationCode":"float defaultWeight = Math.Clamp(rawWeight, 0f, 1f);\nvar v = f.Random.AlphaNumeric(5).OrDefault(f, defaultWeight);","typeGuard":"static bool IsValidWeight(float w) => w >= 0f && w <= 1f;","tryCatchPattern":null,"preventionTips":["Pass a fraction (0.3), not a percent (30).","Clamp externally supplied weights to [0,1].","Omit defaultWeight to use the 0.5 default."],"tags":["faker","ordefault","argument-validation","probability"],"backgroundTag":null,"analyzedSha":"6ece18c5c22648ab4606e45a0aaf2f07fc5259e4","analyzedAt":"2026-08-13T21:08:15.463Z","schemaVersion":2},"datasetVersion":"2026-08-14T00:17:13.853Z"}